*此內容是使用 AI（Beta 測試版）翻譯，可能含有錯誤。若要以英文檢視此頁面，請按一下這裡。

MemoryStoreSortedMapItem

代表排序地圖結構中的項目。

特性

pathstring

記憶庫排序地圖項目的資源路徑。

格式：universes/{universe_id}/memory-store/sorted-maps/{memory_store_sorted_map_id}/items/{memory_store_sorted_map_item_id}.

valueJSON value

項目的值。.

JSON 值可為「null」、「boolean」、「string」、「number」、「array」或「object」。

etagstring
僅限輸出

伺服器生成的項目標籤。.

expiration 請選擇其中一項：

ttlstring
僅限輸入

項目的 TTL。.

expireTimestring
僅限輸出

項目的過期時間。. 此字串的格式為 Timestamp。

idstring

項目的名稱。.

sortKey 請選擇其中一項：

stringSortKeystring

項目將依此字串排序列出。.

numericSortKeynumber

項目將依此數字排序。.

基本網址
https://apis.roblox.com
MemoryStoreSortedMapItem資源
{

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "ttl": "3s",

  "id": "string",

  "stringSortKey": "string"

}

MemoryStoreSortedMapItem

列出記憶體儲存排序地圖項目
Beta

GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items

獲取並返回地圖上的項目，以指定的順序和過濾器。

範圍
universe.memory-store.sorted-map:read
請求路徑參數
universe_idstring
需要

宇宙ID。.

sorted_map_idstring
需要

排序的地圖ID。.

查詢參數
maxPageSizenumber

返回的記憶體儲存排序項目最大數量。服務可能會返回少於此值。如果未指定，最多返回 1 個記憶體儲存排序項目。最大值為 100，高於 100 的值設為 100。.

pageTokenstring

從以前的呼叫中收到的頁面代幣，用於取回後續頁面。

當頁面分頁時，所有其他參數提供給後續呼叫的頁面代幣必須與提供頁面代幣的呼叫匹配。.

orderBystring

如果指定，結果依指定的欄位進行排序。

值必須是分開列出的字段列表，並具有可選的每個字段的「 desc」後綴，以排序比值上升而不是下降的值。您可以使用 . 運作符存取子字段。

結果可以依據以下欄位進行排序：id。

範例：「id desc」.

filterstring

此欄位可設為過濾返回的資源。

過濾符合普通表達語言(CEL)。只有 id 和 sortKey 欄位被支持。在操作者方面，只有 <、> 和 && 被允許'

例子：id > "key-001" && id < "key-100".

回應

父集合中的 MemoryStoreSortedMapItems 列表。

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

指定的記憶體儲存排序地圖項目的記憶體儲存排序地圖。.

nextPageTokenstring

您可以將其作為pageToken參數發送到回收下一頁的代幣。如果此欄位被忽略，就沒有後續頁面。.

GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items?maxPageSize=1&pageToken={string}&orderBy={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
回應
{

  "memoryStoreSortedMapItems": [

    {

      "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

      "value": "JSON value",

      "etag": "string",

      "id": "string",

      "stringSortKey": "string"

    }

  ],

  "nextPageToken": "string"

}

MemoryStoreSortedMapItem

創建記憶體儲存排序地圖項目
Beta

POST /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items

如果不存在，創建指定的地圖項目。

範圍
universe.memory-store.sorted-map:write
請求路徑參數
universe_idstring
需要

宇宙ID。.

sorted_map_idstring
需要

排序的地圖ID。.

查詢參數
idstring

用於記憶存儲排序地圖項目的ID，將成為記憶存儲排序地圖項目資源路徑的最終組成部分。

此值應為 1-127 個字元字串，支持字母和特殊字符。此ID是區分大小寫的。如果包含任何破碎特殊字符的網址，必須使用 URL 編碼來轉換為 URL。.

請求主體MemoryStoreSortedMapItem
回應MemoryStoreSortedMapItem
POST /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items?id=Hello!' \

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

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

  --data '{

  "value": "JSON value",

  "ttl": "3s",

  "id": "string",

  "stringSortKey": "string"

}'
回應
{

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "id": "string",

  "stringSortKey": "string"

}

MemoryStoreSortedMapItem

取得記憶體儲存排序地圖項目
Beta

GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}

獲取並返回地圖中給定鍵值。

範圍
universe.memory-store.sorted-map:read
請求路徑參數
universe_idstring
需要

宇宙ID。.

sorted_map_idstring
需要

排序的地圖ID。.

item_idstring
需要

項目ID。.

回應MemoryStoreSortedMapItem
GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}' \

  -H 'x-api-key: {your-api-key}'
回應
{

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "id": "string",

  "stringSortKey": "string"

}

MemoryStoreSortedMapItem

刪除記憶體儲存排序地圖項目
Beta

DELETE /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}

從地圖中刪除指定項目。

範圍
universe.memory-store.sorted-map:write
請求路徑參數
universe_idstring
需要

宇宙ID。.

sorted_map_idstring
需要

排序的地圖ID。.

item_idstring
需要

項目ID。.

DELETE /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}
curl -L -X DELETE 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}' \

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

MemoryStoreSortedMapItem

更新記憶體儲存排序地圖項目
Beta

PATCH /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}

更新指定的地圖項目。

範圍
universe.memory-store.sorted-map:write
請求路徑參數
universe_idstring
需要

宇宙ID。.

sorted_map_idstring
需要

排序的地圖ID。.

item_idstring
需要

項目ID。.

查詢參數
allowMissingboolean

如果設為真，且找不到記憶體儲存排序的地圖項目，則會創建一個記憶體儲存排序的地圖項目。.

請求主體MemoryStoreSortedMapItem
回應MemoryStoreSortedMapItem
PATCH /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}?allowMissing={boolean}' \

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

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

  --data '{

  "value": "JSON value",

  "ttl": "3s",

  "id": "string",

  "stringSortKey": "string"

}'
回應
{

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "id": "string",

  "stringSortKey": "string"

}