資料儲存的資源路徑。
格式：universes/{universe_id}/data-stores/{data_store_id}.
*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。
DataStore
代表數據存儲。
特性
基本網址
https://apis.roblox.comDataStore資源
{
"path": "universes/123/data-stores/some-data-store",
"createTime": "2023-07-05T12:34:56Z",
"id": "string"
}DataStore
列出資料儲存庫
GET /cloud/v2/universes/{universe_id}/data-stores
返回一個列表的數據儲存。
universe-datastores.control:list
請求路徑參數宇宙ID。.
要返回的最大數量資料儲存。服務可能會返回少於此值。如果未指定，最多返回 10 個資料儲存。最大值為 100，高於 100 的值設為 100。.
從以前的呼叫中收到的頁面代幣，用於取回後續頁面。
當頁面分頁時，所有其他參數提供給後續呼叫的頁面代幣必須與提供頁面代幣的呼叫匹配。.
此欄位可設為過濾返回的資源。
田支持非常小的CEL子集：
- 只有 id 欄位被支援。
- 只有 startsWith 功能可用；沒有其他運作者或預製件支持。
範例過濾器：id.startsWith("foo").
回應dataStoresarray<DataStore> nextPageTokenstring
父集合中的數據儲存列表。
指定宇宙的數據儲存。.
您可以將其作為pageToken參數發送到回收下一頁的代幣。如果此欄位被忽略，就沒有後續頁面。.
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}'回應
{
"dataStores": [
{
"path": "universes/123/data-stores/some-data-store",
"createTime": "2023-07-05T12:34:56Z",
"id": "string"
}
],
"nextPageToken": "string"
}DataStore
快照數據儲存
POST /cloud/v2/universes/{universe_id}/data-stores:snapshot
在體驗中捕捉新的資料儲存狀態。
在快照之後，下一次寫入體驗中的每個鍵將創建版本備份的前一個數據，無論最後寫入的時間如何。
事實上，在截圖時現有的所有數據都會被保證至少在 30 天內作為版本備份可用。
每個經驗每天 UTC 可以進行一次截圖。如果最新的快照在同一個 UTC 日期內取得，這個操作是無操作的，最新快照的時間將被返回。
有關使用截圖的更多信息，請參閱數據儲存引擎指南。
universe-datastores.control:snapshot
請求路徑參數宇宙ID。.
回應newSnapshotTakenboolean latestSnapshotTimestring
返回是否擷取了新的快照，以及操作後最新快照的時間（無論是否擷取新的快照）。
此操作是否取得了新的截圖。(每天 UTC 只能取得一個截圖).
操作後最新的快照時間（無論是否創建了新快照）。此時間總是以 UTC 返回。. 此字串的格式為 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 '{}'回應
{
"newSnapshotTaken": true,
"latestSnapshotTime": "2023-07-05T12:34:56Z"
}