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

MemoryStoreQueueItem

キュー構造内のアイテムを表現します。

属性

pathstring

メモリストストアのキューアイテムのリソースパス。

形式: universes/{universe_id}/memory-store/queues/{memory_store_queue_id}/items/{memory_store_queue_item_id}.

dataJSON value

キューアイテムの値。.

JSON 値は、 null、 boolean、 string、 number、 array、 object にはできません。

prioritynumber

キューアイテムの優先度。.

以下のうちの一つの expiration:

ttlstring
入力のみ

アイテムの TTL。.

expireTimestring
出力のみ

アイテムの有効期限。. この文字列は Timestamp としてフォーマットされています。

idstring
出力のみ

アイテムの名前。.

ベース URL
https://apis.roblox.com
MemoryStoreQueueItem リソース
{

  "path": "universes/123/memory-store/queues/some-memory-store-queue-id/items/some-memory-store-queue-item-id",

  "data": "JSON value",

  "priority": "number",

  "ttl": "3s",

  "id": "string"

}

MemoryStoreQueueItem

メモリストアのキューアイテムを作成する
ベータ版

POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items

新しいキューアイテムを作成します。

ttl が設定されている場合、指定された時間間後にアイテムが自動的にキューから削除されます。

数字の priority が設定されると、アイテムは優先度値に基づいてキューに挿入されます。値が高いほど、キューの前にアイテムが近づく。優先度値が同じ場合は、既存の優先度の値の後にアイテムが挿入されます。

範囲
universe.memory-store.queue:write
リクエストパスのパラメータ
universe_idstring
必須

ユニバースID。.

queue_idstring
必須

キューID。.

リクエスト本文MemoryStoreQueueItem
レスポンスMemoryStoreQueueItem
POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items' \

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

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

  --data '{

  "data": "JSON value",

  "priority": "number",

  "ttl": "3s"

}'
レスポンス
{

  "path": "universes/123/memory-store/queues/some-memory-store-queue-id/items/some-memory-store-queue-item-id",

  "data": "JSON value",

  "priority": "number",

  "id": "string"

}

MemoryStoreQueueItem

メモリストアのキューアイテムを削除する
ベータ版

POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:discard

ディスカードは、キューの前からアイテムを読み込みます。

以前の readId 操作から Read を取ります。

範囲
universe.memory-store.queue:discard
リクエストパスのパラメータ
universe_idstring
必須

ユニバースID。.

queue_idstring
必須

キューID。.

リクエスト本文
readIdstring

読み込みアイテムを削除するための前の読み込み操作の readId.

POST /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:discard
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:discard' \

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

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

  --data '{

  "readId": "string"

}'

MemoryStoreQueueItem

メモリストアのキューアイテムを読む
ベータ版

GET /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:read

キューの前方に指定された数のアイテムを返します。

範囲
universe.memory-store.queue:dequeue
リクエストパスのパラメータ
universe_idstring
必須

ユニバースID。.

queue_idstring
必須

キューID。.

クエリのパラメータ
countnumber

キューから読み込むアイテムの数 指定されない場合は、1アイテムが返されます。最大値は 200 です。200 以上の値は 200 に強制されます。.

allOrNothingboolean

if all_or_nothing が真であり、リクエストされたオブジェクトの数が利用できない場合、404 エラーが返されます。

そうでない場合、読み込み操作のパスと read_id と MemoryStoreQueue のアイテムのリストを返します。.

invisibilityWindowstring

アイテムの読み込み時の非表示ウィンドウ、数秒。

読み込まれたアイテムは、不可視性期間中の後続の読み込みでは見えません。

秒で 0 より大きい値で書かれ、s で終わらなければなりません。

デフォルトは 30s 。.

レスポンス

キューの前方に指定された数のアイテムを返します。

readIdstring

読み込み操作の識別子

これを処理済みのアイテムとしてマークするために、:discard にパスできます。.

GET /cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:read
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/queues/{queue_id}/items:read?count={integer}&allOrNothing={boolean}&invisibilityWindow={string}' \

  -H 'x-api-key: {your-api-key}'
レスポンス
{

  "readId": "string",

  "items": [

    {

      "path": "universes/123/memory-store/queues/some-memory-store-queue-id/items/some-memory-store-queue-item-id",

      "data": "JSON value",

      "priority": "number",

      "id": "string"

    }

  ]

}