*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

DataStore

Mewakili penyimpanan data.

Atribut

pathstring

Jalur sumber daya dari penyimpan data.

Format: universes/{universe_id}/data-stores/{data_store_id}.

createTimestring
Hanya Output

Stempel waktu saat penyimpanan data dibuat. String ini diformat sebagai Timestamp.

idstring
Hanya Output

ID dari penyimpanan data. Sesuai dengan segmen terakhir dari jalur.

Base URL
https://apis.roblox.com
Resource DataStore
{

  "path": "universes/123/data-stores/some-data-store",

  "createTime": "2023-07-05T12:34:56Z",

  "id": "string"

}

DataStore

Toko Data Daftar
Beta

GET /cloud/v2/universes/{universe_id}/data-stores

Kembalikan daftar penyimpanan data.

Cakupan
universe-datastores.control:list
Batas
  • Kunci API: 5000 permintaan per menit di semua kunci API untuk pengguna atau grup

Catatan: Batas permintaan dapat lebih rendah selama periode traffic yang tinggi. Beberapa endpoint memiliki batas permintaan tambahan. Pelajari selengkapnya tentang batas permintaan.

PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

Parameter Kueri
maxPageSizenumber

Jumlah maksimum penyimpanan data untuk dikembalikan.Layanan mungkin kembali kurang dari nilai ini.Jika tidak ditentukan, paling banyak 10 penyimpanan data dikembalikan.Nilai maksimum adalah 100 dan nilai yang lebih tinggi ditetapkan ke 100.

pageTokenstring

Token halaman, diterima dari panggilan sebelumnya, untuk mengambil halaman berikutnya.

Saat paginasi, semua parameter lain yang disediakan untuk panggilan berikutnya harus cocok dengan panggilan yang memberikan token halaman.

filterstring

Bidang ini dapat ditetapkan untuk memfilter sumber daya yang dikembalikan.

Bidang filter mendukung subset yang sangat kecil dari CEL:

  • Hanya bidang id yang didukung.
  • Hanya fungsi startsWith yang tersedia; tidak ada operator lain atau built-in yang didukung.

Contoh filter: id.startsWith("foo").

Respons

Daftar DataStores dalam koleksi orang tua.

dataStoresarray<DataStore>

DataStores dari alam semesta yang ditentukan.

nextPageTokenstring

Token yang dapat Anda kirim sebagai parameter pageToken untuk mengambil halaman berikutnya. Jika bidang ini diabaikan, tidak ada halaman berikutnya.

GET /cloud/v2/universes/{universe_id}/data-stores
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores?maxPageSize=10&pageToken={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
Respons
{

  "dataStores": [

    {

      "path": "universes/123/data-stores/some-data-store",

      "createTime": "2023-07-05T12:34:56Z",

      "id": "string"

    }

  ],

  "nextPageToken": "string"

}

DataStore

Penyimpanan Data Snapshot
Beta

POST /cloud/v2/universes/{universe_id}/data-stores:snapshot

Mengambil snapshot baru dari penyimpanan data dalam pengalaman.

Setelah snapshot, penulisan berikutnya ke setiap kunci dalam pengalaman akan membuat cadangan berversi data sebelumnya, terlepas dari waktu penulisan terakhir.

Sebenarnya, semua data saat ini pada saat pemotretan dijamin tersedia sebagai cadangan berversi selama setidaknya 30 hari.

Screenshot dapat diambil sekali per hari UTC, per pengalaman.Jika snapshot terbaru diambil dalam hari UTC yang sama, operasi ini adalah tanpa op dan waktu snapshot terbaru akan dikembalikan.

Untuk informasi lebih lanjut tentang menggunakan snapshot, lihat panduan Penyimpanan Data.

Cakupan
universe-datastores.control:snapshot
Batas
  • Kunci API: 60 permintaan per menit di semua kunci API untuk pengguna atau grup

Catatan: Batas permintaan dapat lebih rendah selama periode traffic yang tinggi. Beberapa endpoint memiliki batas permintaan tambahan. Pelajari selengkapnya tentang batas permintaan.

PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

Request Body
Respons

Kembalikan apakah snapshot baru diambil dan waktu snapshot terbaru setelah operasi (terlepas dari apakah snapshot baru diambil).

newSnapshotTakenboolean

Apakah snapshot baru diambil oleh operasi ini. (Hanya satu snapshot yang dapat diambil per pengalaman per hari UTC.).

latestSnapshotTimestring

Waktu snapshot terbaru setelah operasi (terlepas dari apakah snapshot baru dibuat). Waktu ini selalu dikembalikan dalam UTC. String ini diformat sebagai Timestamp.

POST /cloud/v2/universes/{universe_id}/data-stores:snapshot
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores:snapshot' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{}'
Respons
{

  "newSnapshotTaken": true,

  "latestSnapshotTime": "2023-07-05T12:34:56Z"

}