*Nội dung này được dịch bằng AI (Beta) và có thể có lỗi. Để xem trang này bằng tiếng Anh, hãy nhấp vào đây.

MemoryStoreQueueItem

Đại diện cho một mục trong cấu trúc hàng đợi.

Thuộc Tính

pathstring

Con đường tài nguyên của mục trong hàng đợi kho lưu trữ bộ nhớ.

Định dạng: universes/{universe_id}/memory-store/queues/{memory_store_queue_id}/items/{memory_store_queue_item_id}.

dataJSON value

Giá trị của mục hàng đợi.

Giá trị JSON có thể là null, boolean, string, number, array hoặc object.

prioritynumber

Ưu tiên của mục hàng đợi.

Một trong những thông tin sau đây cho expiration:

ttlstring
Chỉ Nhập

TTL cho mục.

expireTimestring
Chỉ Xuất

Thời gian hết hạn của mục. Chuỗi này được định dạng là Dấu thời gian.

idstring
Chỉ Xuất

Tên của mục.

URL Cơ Sở
https://apis.roblox.com
Tài nguyên 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

Tạo Vật phẩm Chờ Kho lưu trữ Bộ nhớ
Bản Beta

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

Tạo một mục hàng đợi mới.

Nếu ttl được đặt, mục sẽ tự động bị xóa khỏi hàng đợi sau khoảng thời gian được chỉ định.

Nếu một số lượng priority được đặt, mục sẽ được chèn vào hàng đợi dựa trên giá trị ưu tiên.Giá trị càng cao, càng gần với phía trước của hàng đợi, mục sẽ càng được.Nếu giá trị ưu tiên giống nhau thì mục sẽ được chèn sau các giá trị hiện có có cùng ưu tiên.

Phạm Vi
universe.memory-store.queue:write
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

queue_idstring
Bắt Buộc

ID hàng đợi.

Yêu Cầu Cơ ThểMemoryStoreQueueItem
Phản HồiMemoryStoreQueueItem
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"

}'
Phản Hồi
{

  "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

Bỏ các vật phẩm trong hàng chờ Kho lưu trữ bộ nhớ
Bản Beta

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

Discard đọc các mục từ phía trước của hàng đợi.

Lấy một readId từ một hoạt động trước Read.

Phạm Vi
universe.memory-store.queue:discard
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

queue_idstring
Bắt Buộc

ID hàng đợi.

Yêu Cầu Cơ Thể
readIdstring

The readId của hoạt động đọc trước đó mà để loại bỏ các mục đọc.

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

Đọc các mục trong hàng chờ Kho lưu trữ bộ nhớ
Bản Beta

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

Trả về số lượng vật phẩm được chỉ định tại phía trước của hàng đợi.

Phạm Vi
universe.memory-store.queue:dequeue
Yêu CầuTham Số Đường Dẫn
universe_idstring
Bắt Buộc

ID của vũ trụ.

queue_idstring
Bắt Buộc

ID hàng đợi.

Tham Số Truy Vấn
countnumber

Số lượng vật phẩm để đọc từ hàng đợi Nếu không được xác định, 1 vật phẩm sẽ được trả lại. Giá trị tối đa là 200; các giá trị trên 200 sẽ bị buộc thành 200.

allOrNothingboolean

Nếu all_or_nothing là đúng và số lượng đối tượng yêu cầu không có sẵn, sẽ trả về lỗi 404.

Nếu không, sẽ trả lại con đường và read_id của hoạt động đọc và một danh sách các vật phẩm của MemoryStoreQueue.

invisibilityWindowstring

Cửa sổ vô hình cho các mục đã đọc, trong vài giây.

Các mục đã đọc không thể nhìn thấy trong các đọc tiếp theo trong thời gian cửa sổ vô hình.

Nó phải được viết trong vài giây lớn hơn 0 và kết thúc bằng s .

Mặc định là 30s .

Phản Hồi

Trả về số lượng vật phẩm được chỉ định tại phía trước của hàng đợi.

readIdstring

Một nhận dạng của hoạt động đọc

Điều này có thể được chuyển cho :discard để đánh dấu các mục đã xử lý.

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}'
Phản Hồi
{

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

    }

  ]

}