*このコンテンツは、ベータ版のAI（人工知能）を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

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

アイテムはこの番号に従って並べ替えられます。.

ベース URL
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

メモリストアのソートされたマップアイテムリスト
ベータ版

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」付きのオプションのフィールドごとの「 desc」サフィックスで、上から下に並べ替えるのではなく、下から上に並べ替えるためのフィールドのリストでなければなりません。Values must be a comma-separated list of fields, with an optional, per-field "desc" suffix to sort by descending rather than ascending values.. オペレータでサブフィールドにアクセスできます。

結果は次のフィールドで並べ替えることができます: 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

メモリストアのソートマップアイテムを作成
ベータ版

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

メモリストアのソートマップアイテムを取得
ベータ版

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

メモリストアのソートマップアイテムを削除
ベータ版

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

メモリストアのソートマップアイテムを更新
ベータ版

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"

}