*Questo contenuto è tradotto usando AI (Beta) e potrebbe contenere errori. Per visualizzare questa pagina in inglese, clicca qui.

MemoryStoreQueueItem

Rappresenta un oggetto all'interno di una struttura di coda.

Attributi

pathstring

Il percorso risorsa dell'elemento della coda del magazzino di memoria.

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

dataJSON value

Il valore dell'elemento della coda.

Un valore JSON può essere null, boolean, string, number, array, or object.

prioritynumber

La priorità dell'elemento della coda.

Uno dei seguenti per expiration:

ttlstring
Solo input

Il TTL per l'elemento.

expireTimestring
Solo output

Il tempo di scadenza dell'elemento. Questa stringa è formattata come Timestamp.

idstring
Solo output

Il nome dell'elemento.

URL di base
https://apis.roblox.com
Risorsa 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

Crea oggetto della coda del magazzino di memoria
Beta

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

Crea un nuovo elemento della coda.

Se ttl è impostato, l'elemento verrà rimosso automaticamente dalla coda dopo l'intervallo di tempo specificato.

Se un numero priority viene impostato, l'elemento verrà inserito nella coda in base al valore di priorità.Più alto è il valore, più vicino alla parte anteriore della coda sarà l'elemento.Se i valori di priorità sono gli stessi, l'elemento verrà inserito dopo i valori esistenti con la stessa priorità.

Campi
universe.memory-store.queue:write
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

queue_idstring
Necessario

L'ID della coda.

Corpo della richiestaMemoryStoreQueueItem
RispostaMemoryStoreQueueItem
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"

}'
Risposta
{

  "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

Scarta gli elementi della coda del magazzino di memoria
Beta

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

Scarta legge gli elementi dalla parte anteriore della coda.

Prende un readId da una precedente operazione Read.

Campi
universe.memory-store.queue:discard
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

queue_idstring
Necessario

L'ID della coda.

Corpo della richiesta
readIdstring

Il readId della precedente operazione di lettura per cui scartare gli elementi letti.

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

Leggi gli elementi della coda del magazzino di memoria
Beta

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

Restituisce il numero specificato di oggetti alla fine della coda.

Campi
universe.memory-store.queue:dequeue
RichiestaParametri percorso
universe_idstring
Necessario

L'ID dell'universo.

queue_idstring
Necessario

L'ID della coda.

Parametri query
countnumber

Il numero di elementi da leggere dalla coda Se non specificato, 1 elemento verrà restituito. Il valore massimo è 200; i valori superiori a 200 verranno coarti a 200.

allOrNothingboolean

Se all_or_nothing è vero e il numero richiesto di oggetti non è disponibile, restituirà un errore 404.

Altrimenti, restituirà il percorso e read_id dell'operazione di lettura e un elenco degli elementi della MemoryStoreQueue.

invisibilityWindowstring

Finestra di invisibilità per gli elementi letti, in secondi.

Gli elementi letti sono invisibili durante la durata della finestra di invisibilità durante le letture successive.

Deve essere scritto in secondi maggiori di 0 e terminare con s .

Predefinito a 30s .

Risposta

Restituisce il numero specificato di oggetti alla fine della coda.

readIdstring

Un identificatore dell'operazione di lettura

Questo può essere passato a :discard per contrassegnare gli elementi come elaborati.

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

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

    }

  ]

}