*Bu içerik, yapay zekâ (beta) kullanılarak çevrildi ve hatalar içerebilir. Sayfayı İngilizce görüntülemek için buraya tıkla.

MemoryStoreQueueItem

Sıra yapısı içinde bir öğeyi temsil eder.

Nitelikler

pathstring

Hafıza depolama sırası öğesinin kaynak yolu.

Biçim: universes/{universe_id}/memory-store/queues/{memory_store_queue_id}/items/{memory_store_queue_item_id}.

dataJSON value

Sıra öğesinin değeri.

JSON değeri null, boolean, string, number, array ya da object olabilir.

prioritynumber

Sıra öğesinin önceliği.

expiration için şunlardan biri:

ttlstring
Yalnızca Giriş

Öğe için TTL.

expireTimestring
Yalnızca Çıkış

Öğenin sona erme süresi. Bu dizi Timestamp olarak biçimlendirilmiş.

idstring
Yalnızca Çıkış

Öğenin adı.

Taban URL
https://apis.roblox.com
MemoryStoreQueueItem Kaynağı
{

  "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

Hafıza Deposu Sıra Öğesi Oluştur
Beta

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

Yeni bir sıra öğesi oluşturur.

Eğer ttl ayarlanırsa, öğe belirtilen süre aralığından sonra otomatik olarak sıradan kaldırılır.

Bir sayısal priority belirlenirse, öğe öncelik değerine göre sıraya eklenecektir.Değer ne kadar yüksekse, öğe sırayın önüne o kadar yakın olacaktır.Öncelik değerleri aynıysa, öğe aynı öncelikteki mevcut değerlerin ardından girilecektir.

Kapsamlar
universe.memory-store.queue:write
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

queue_idstring
Gerekli

Sıra ID'si.

Talep GövdesiMemoryStoreQueueItem
YanıtMemoryStoreQueueItem
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"

}'
Yanıt
{

  "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

Hafıza Depolama Sıra Öğelerini Reddet
Beta

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

Reddetme, sıra önündeki öğeleri okur.

Önceki bir readId operasyonundan bir Read alır.

Kapsamlar
universe.memory-store.queue:discard
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

queue_idstring
Gerekli

Sıra ID'si.

Talep Gövdesi
readIdstring

Okunacak öğeleri atlamak için önceki okuma işleminden kalan 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

Hafıza Deposu Sıra Öğelerini Okuyun
Beta

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

Sırayın önünde belirtilen sayıda öğeyi döndürür.

Kapsamlar
universe.memory-store.queue:dequeue
TalepYol Parametreleri
universe_idstring
Gerekli

Evren kimliği.

queue_idstring
Gerekli

Sıra ID'si.

Sorgu Parametreleri
countnumber

Sıradan okunacak öğe sayısı Eğer belirtilmezse, 1 öğe iade edilecektir. Maksimum değer 200'dir; 200'in üzerindeki değerler 200'e zorlanacaktır.

allOrNothingboolean

Eğer all_or_nothing doğruysa ve talep edilen nesne sayısı mevcut değilse, bir 404 Hatası döndürür.

Aksi takdirde, okuma işleminin yolunu ve okuma_id'sini ve MemoryStoreQueue öğelerinin bir listesini iade edecektir.

invisibilityWindowstring

Öğeler okunduğunda görünmezlik penceresi, saniyeler içinde.

Okuyucu öğeler, görünmezlik penceresi süresi boyunca sonraki okumalarda görünmezdir.

Saniyelerden 0'dan büyük ve s ile bitmelidir.

Varsayılan değeri 30s dir.

Yanıt

Sırayın önünde belirtilen sayıda öğeyi döndürür.

readIdstring

Okuma işleminin tanımlayıcısı

Bu, öğelerin işlendiğini işaretlemek için :discard 'ye geçirilebilir.

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}'
Yanıt
{

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

    }

  ]

}