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

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

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 设置为 true,指定的时间间隔后,项目将自动从队列中删除。

如果设置了数字 priority,项目将根据优先级值插入队列。值越高,项目就越接近队列的前端。如果优先级值相同,则该项将插入到与优先级相同的现有值之后。

范围
universe.memory-store.queue:write
请求路径参数
universe_idstring
必填

宇宙ID。.

queue_idstring
必填

队列ID。.

请求正文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"
}
]
}