*此内容使用人工智能（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
仅输出

物品的过期时间。. 此字符串格式为 FieldMask。

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。.

pageTokenstring

从前一次调用收到的页面代币，用于检索后续页面。

当页面分页时，所有其他参数提供给后续调用的必须与提供页面代币的调用匹配。.

orderBystring

如果指定，结果按指定的字段进行排序。

值必须是分开列出的字段列表，带有可选的每个字段“ desc”后缀，以排序从下向上而不是从上向下的值。您可以使用 . 运营符访问子领域。

结果可以按照以下字段进行排序：id。

例子：“id desc”.

filterstring

该字段可以设置以便筛选返回的资源。

过滤符合共同表达语言 (CEL)。仅支持 id 和 sortKey 字段。在操作者方面，只有 < , > 和 && 被允许'

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

答复

父集合中的 MemoryStoreSortedMapItems 列表。

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

从指定的 MemoryStoreSortedMap 中的 MemoryStoreSortedMap 项。.

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 破坏特殊字符，则必须将 id 编码为 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"

}