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

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
僅限輸出

項目的名稱。.

基本網址
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

創建記憶體儲存隊列項目
Beta

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

丟棄記憶體儲存隊列項目
Beta

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

閱讀記憶體儲存隊列項目
Beta

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

如果 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"

    }

  ]

}