*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.

MemoryStoreQueueItem

Representa un artículo dentro de una estructura de cola.

Atributos

pathstring

El camino de recursos del elemento de la cola del almacén de memoria.

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

dataJSON value

El valor del elemento de la cola.

Un valor JSON puede ser null, boolean, string, number, array, u object.

prioritynumber

La prioridad del elemento de cola.

Uno de los siguientes para expiration:

ttlstring
Solo entrada

El TTL para el artículo.

expireTimestring
Solo salida

El tiempo de expiración del artículo. Esta cadena está formateada como Timestamp.

idstring
Solo salida

El nombre del artículo.

URL base

https://apis.roblox.com
El recurso 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

Crear elemento de cola de almacén de memoria
Beta

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

Crea un nuevo elemento de cola.

Si ttl está configurado, el artículo se eliminará automáticamente de la cola después del período de tiempo especificado.

Si se establece un número priority numérico, el artículo se insertará en la cola en función del valor de prioridad.Cuanto mayor sea el valor, más cerca estará el artículo de la parte delantera de la cola.Si los valores de prioridad son los mismos, se insertará el artículo después de los valores existentes con la misma prioridad.

Ámbitos
universe.memory-store.queue:write
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

queue_idstring
Obligatorio

La ID de la cola.

Solicitar cuerpoMemoryStoreQueueItem
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"
}'
Respuesta

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

Desechar elementos de la cola del almacén de memoria
Beta

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

Los descartes leen artículos desde el frente de la cola.

Toma una readId de una operación anterior Read.

Ámbitos
universe.memory-store.queue:discard
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

queue_idstring
Obligatorio

La ID de la cola.

Solicitar cuerpo
readIdstring

El readId de la operación de lectura anterior para la cual descartar artículos de lectura.

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

Leer elementos de la cola del almacén de memoria
Beta

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

Devuelve el número especificado de artículos al frente de la cola.

Ámbitos
universe.memory-store.queue:dequeue
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

queue_idstring
Obligatorio

La ID de la cola.

Parámetros de consulta
countnumber

El número de artículos para leer de la cola Si no se especifica, se devolverá 1 artículo. El valor máximo es 200; los valores por encima de 200 se verán obligados a 200.

allOrNothingboolean

Si all_or_nothing es verdadero y el número solicitado de objetos no está disponible, devolverá un error 404.

De lo contrario, devolverá el camino y el ID de lectura de la operación de lectura y una lista de los elementos de la cola de almacén de memoria.

invisibilityWindowstring

Ventana de invisibilidad para artículos leídos, en segundos.

Los elementos leídos son invisibles en lecturas posteriores durante la duración de la ventana de invisibilidad.

Debe escribirse en segundos mayores a 0 y terminar con s .

Por defecto a 30s.

Respuesta

Devuelve el número especificado de artículos al frente de la cola.

readIdstring

Un identificador de la operación de lectura

Esto se puede pasar a :discard para marcar los elementos como procesados.

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}'
Respuesta

{
"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"
}
]
}