*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

DataStore

Veri mağazatemsil eder.

Nitelikler

pathstring

Veri depolamasının kaynak yolu.

Biçim: universes/{universe_id}/data-stores/{data_store_id}.

createTimestring
Yalnızca Çıkış

Veri depoları oluşturulduğunda tarih ve saat. Bu dizi Timestamp olarak biçimlendirilmiş.

idstring
Yalnızca Çıkış

Veri depolama mağazakimliği. Yolu son bölümüne eşleşir.

Taban URL
https://apis.roblox.com
DataStore Kaynağı
{

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

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

  "id": "string"

}

DataStore

List Data Stores
Beta

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

Bir dizi veri depolarını döndürür.

Kapsamlar
universe-datastores.control:list
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

Sorgu Parametreleri
maxPageSizenumber

Geri döndürülecek maksimum veri depoları sayısı.Hizmet bu değerden daha azını iade edebilir.Belirtilmediğinde, en fazla 10 veri depoları döndürülür.Maksimum değer 100'dür ve daha yüksek değerler 100 olarak ayarlanır.

pageTokenstring

Bir önceki çağrıdan alınan bir sayfa jetonu, sonraki bir sayfa almak için.

Sayfa numaralandırırken, sonraki çağrıya verilen tüm diğer parametler, sayfa jetonu sağlayan çağrıya eşleşmelidir.

filterstring

Bu alan, döndürülen kaynakları filtrelemek için ayarlanabilir.

The filter alanı, çok küçük bir CEL altkümesini destekler:

  • Sadece id alanı desteklenir.
  • Sadece startsWith fonksiyonu mevcuttur; başka operatörler veya yerleşikler desteklenmez.

Örnek filtre: id.startsWith("foo").

Yanıt

Ebeveyn koleksiyonundaki DataStoreların bir listesi.

dataStoresarray<DataStore>

Belirtilen Evren'den Veri Depoları.

nextPageTokenstring

Bir sonraki sayfayı almak için bir pageToken çözümleyici olarak gönderebileceğiniz bir jeton. Bu alan atlanırsa, sonraki sayfalar yoktur.

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}'
Yanıt
{

  "dataStores": [

    {

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

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

      "id": "string"

    }

  ],

  "nextPageToken": "string"

}

DataStore

Snapshot Data Stores
Beta

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

Deneyimdeki veri depolarının yeni bir yerindeki fotoğrafını alır.

Bir anlık görüntüden sonra, deneyimdeki her anahtara yapılan bir sonraki yazma, son yazmanın saati ne olursa olsun önceki verilerin sürümlü bir yedek kopyasını oluşturur.

Aslında, anlık görüntü sırasında mevcut olan tüm verilerin en az 30 gün boyunca versiyonlu bir yedek olarak kullanılabilir olması garanti edilir.

Fotoğraflar UTC gününde bir kez, deneyim başına alınabilir.En son yedek kopya aynı UTC gününde alındıysa, bu işlem bir no-op ve en son yedek kopyanın süresi iade edilir.

Yapılan güncellemeler hakkında daha fazla bilgi için Veri Depolama Motoru rehberine bakın.

Kapsamlar
universe-datastores.control:snapshot
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

Talep Gövdesi
Yanıt

Yeni bir yer imi alındığını ve operasyon sonrası en son yer iminin zamanını döndürür (yeni bir yer imi alındıysa buna rağmen).

newSnapshotTakenboolean

Bu işlem tarafından yeni bir yer imi alındı mı? (Her deney için UTC günü başına yalnızca bir yer imi alınabilir.).

latestSnapshotTimestring

Operasyonun ardından en son güncellemenin zamanı (yeni bir güncelleme oluşturulduysa bile). Bu zaman UTC'de daima iade edilir. Bu dizi Timestamp olarak biçimlendirilmiş.

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 '{}'
Yanıt
{

  "newSnapshotTaken": true,

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

}