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}.
*Este contenido se traduce usando la IA (Beta) y puede contener errores. Para ver esta página en inglés, haz clic en aquí.
Representa un artículo dentro de una estructura de cola.
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}.
El valor del elemento de la cola.
Un valor JSON puede ser null, boolean, string, number, array, u object.
La prioridad del elemento de cola.
El TTL para el artículo.
El tiempo de expiración del artículo. Esta cadena está formateada como Timestamp.
El nombre del artículo.
https://apis.roblox.com
{
"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"
}
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.
La identificación del universo.
La ID de la cola.
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"
}'
{
"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"
}
Los descartes leen artículos desde el frente de la cola.
Toma una readId de una operación anterior Read.
La identificación del universo.
La ID de la cola.
El readId de la operación de lectura anterior para la cual descartar artículos de lectura.
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"
}'
Devuelve el número especificado de artículos al frente de la cola.
La identificación del universo.
La ID de la cola.
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.
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.
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.
Devuelve el número especificado de artículos al frente de la cola.
Un identificador de la operación de lectura
Esto se puede pasar a :discard para marcar los elementos como procesados.
Los elementos leídos de la cola.
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}'
{
"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"
}
]
}