内存存储队列项目的资源路径。
格式:universes/{universe_id}/memory-store/queues/{memory_store_queue_id}/items/{memory_store_queue_item_id}.
*此内容使用人工智能(Beta)翻译,可能包含错误。若要查看英文页面,请点按 此处。
代表队列结构中的物品。
内存存储队列项目的资源路径。
格式:universes/{universe_id}/memory-store/queues/{memory_store_queue_id}/items/{memory_store_queue_item_id}.
队列项目的值。.
JSON 值可以是 “null”、“boolean”、“string”、“number”、“array” 或 “object”。
队列项目的优先级。.
项目的 TTL。.
物品的过期时间。. 此字符串格式为 FieldMask。
项目的名称。.
https://apis.roblox.com
{
"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"
}
创建一个新的队列项目。
如果 ttl 设置为 true,指定的时间间隔后,项目将自动从队列中删除。
如果设置了数字 priority,项目将根据优先级值插入队列。值越高,项目就越接近队列的前端。如果优先级值相同,则该项将插入到与优先级相同的现有值之后。
宇宙ID。.
队列ID。.
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"
}
丢弃从队列的前端读取项目。
从以前的 readId 操作中获取一个 Read 。
宇宙ID。.
队列ID。.
以前阅读操作的 readId 用于丢弃阅读项目。.
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"
}'
返回队列前的指定数量的项目。
宇宙ID。.
队列ID。.
从队列中阅读的项目数量 如果未指定,将返回 1 项。最大值为 200;超过 200 的值将强制为 200。.
如果 all_or_nothing 是真的,请求的对象数量不可用,将返回 404 错误。
否则,将返回阅读操作的路径和 read_id 以及 MemoryStoreQueue 项目列表。.
在几秒钟内阅读物品的隐形窗口。
阅读到的物品在隐形窗口期间的后续阅读中是不可见的。
它必须在 0 秒以上的时间写入,并以 s 结束。
默认为 30s .
返回队列前的指定数量的项目。
阅读操作的标识符
这可以传递到 :discard 以标记已处理的项目。.
从队列中阅读的项目.
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"
}
]
}