*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.

MemoryStoreQueueItem

Mewakili item dalam struktur antrian.

Atribut

pathstring

Jalur sumber daya item antrian penyimpanan memori.

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

dataJSON value

Nilai dari item antrian.

Nilai JSON dapat berupa null, boolean, string, number, array, atau object.

prioritynumber

Prioritas item antrian.

Salah satu dari yang berikut untuk expiration:

ttlstring
Hanya Input

The TTL untuk item.

expireTimestring
Hanya Output

Waktu kedaluwarsa item. String ini diformat sebagai Timestamp.

idstring
Hanya Output

Nama item.

Base URL
https://apis.roblox.com
Resource 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

Buat Item Antrian Toko Memori
Beta

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

Membuat item antrian baru.

Jika ttl diatur, item akan otomatis dihapus dari antrian setelah rentang waktu yang ditentukan.

Jika nilai numerik priority ditetapkan, item akan dimasukkan ke dalam antrian berdasarkan nilai prioritas.Semakin tinggi nilainya, semakin dekat ke depan antrian item akan menjadi.Jika nilai prioritas sama maka item akan dimasukkan setelah nilai yang ada dengan prioritas yang sama.

Cakupan
universe.memory-store.queue:write
Batas
  • Kunci API: 1000 permintaan per menit di semua kunci API untuk pengguna atau grup

Catatan: Batas permintaan dapat lebih rendah selama periode traffic yang tinggi. Beberapa endpoint memiliki batas permintaan tambahan. Pelajari selengkapnya tentang batas permintaan.

PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

queue_idstring
Diperlukan

ID antrian.

Request BodyMemoryStoreQueueItem
ResponsMemoryStoreQueueItem
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"

}'
Respons
{

  "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

Lenyapkan Item Antrian Penyimpanan Memori
Beta

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

Discard membaca item dari depan antrian.

Mengambil readId dari operasi sebelumnya Read .

Cakupan
universe.memory-store.queue:discard
Batas
  • Kunci API: 1000 permintaan per menit di semua kunci API untuk pengguna atau grup

Catatan: Batas permintaan dapat lebih rendah selama periode traffic yang tinggi. Beberapa endpoint memiliki batas permintaan tambahan. Pelajari selengkapnya tentang batas permintaan.

PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

queue_idstring
Diperlukan

ID antrian.

Request Body
readIdstring

The readId dari operasi baca sebelumnya untuk menyingkirkan item baca.

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

Baca Item Antrian Toko Memori
Beta

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

Kembalikan jumlah item yang ditentukan di depan antrian.

Cakupan
universe.memory-store.queue:dequeue
Batas
  • Kunci API: 1000 permintaan per menit di semua kunci API untuk pengguna atau grup

Catatan: Batas permintaan dapat lebih rendah selama periode traffic yang tinggi. Beberapa endpoint memiliki batas permintaan tambahan. Pelajari selengkapnya tentang batas permintaan.

PermintaanParameter Jalur
universe_idstring
Diperlukan

ID alam semesta.

queue_idstring
Diperlukan

ID antrian.

Parameter Kueri
countnumber

Jumlah item yang akan dibaca dari antrian Jika tidak ditentukan, 1 item akan dikembalikan. Nilai maksimum adalah 200; nilai di atas 200 akan dipaksa ke 200.

allOrNothingboolean

Jika all_or_nothing benar dan nomor objek yang diminta tidak tersedia, akan mengembalikan Kesalahan 404.

Jika tidak, akan mengembalikan jalur dan read_id dari operasi baca dan daftar item MemoriStoreQueue.

invisibilityWindowstring

Jendela tidak terlihat untuk item dibaca, dalam beberapa detik.

Item yang dibaca tidak terlihat selama durasi jendela tidak terlihat selama periode.

Ini harus ditulis dalam beberapa detik lebih besar dari 0 dan berakhir dengan s.

Default ke 30s.

Respons

Kembalikan jumlah item yang ditentukan di depan antrian.

readIdstring

Pengenal operasi baca

Ini dapat dikirim ke :discard untuk menandai item sebagai diproses.

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}'
Respons
{

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

    }

  ]

}