*Este conteúdo é traduzido por IA (Beta) e pode conter erros. Para ver a página em inglês, clique aqui.

MemoryStoreQueueItem

Representa um item dentro de uma estrutura de fila.

Atributos

pathstring

O caminho de recursos do item da fila do armazenamento de memória.

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

dataJSON value

O valor do item da fila.

Um valor JSON pode ser null, boolean, string, number, array, ou object.

prioritynumber

A prioridade do item da fila.

Um dos seguintes para expiration:

ttlstring
Apenas entrada

O TTL para o item.

expireTimestring
Apenas saída

O tempo de expiração do item. Esta cadeia de caracteres é formatada como um Timestamp.

idstring
Apenas saída

O nome do item.

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

Criar Item na Fila de Armazenamento de Memória
Beta

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

Cria um novo item na fila.

Se ttl for definido, o item será removido automaticamente da fila após o período de tempo especificado.

Se um número priority for definido, o item será inserido na fila com base no valor de prioridade.Quanto maior o valor, mais perto da frente da fila o item estará.Se os valores de prioridade forem os mesmos, o item será inserido após os valores existentes com a mesma prioridade.

Escopos
universe.memory-store.queue:write
SolicitaçãoParâmetros de endereço
universe_idstring
Obrigatório

O ID do universo.

queue_idstring
Obrigatório

O ID da fila.

Requisitar corpoMemoryStoreQueueItem
RespostaMemoryStoreQueueItem
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"

}'
Resposta
{

  "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

Descartar Itens da Fila do Armazenamento de Memória
Beta

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

Descartes leem itens de entrada da frente da fila.

Leva um readId de uma operação anterior Read.

Escopos
universe.memory-store.queue:discard
SolicitaçãoParâmetros de endereço
universe_idstring
Obrigatório

O ID do universo.

queue_idstring
Obrigatório

O ID da fila.

Requisitar corpo
readIdstring

O readId da operação de leitura anterior para a qual descartar itens de leitura.

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

Leia Itens da Fila da Loja de Memória
Beta

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

Retorna o número especificado de itens na frente da fila.

Escopos
universe.memory-store.queue:dequeue
SolicitaçãoParâmetros de endereço
universe_idstring
Obrigatório

O ID do universo.

queue_idstring
Obrigatório

O ID da fila.

Parâmetros da consulta
countnumber

O número de itens a serem lidos da fila Se não especificado, 1 item será retornado. O valor máximo é 200; valores acima de 200 serão forçados a 200.

allOrNothingboolean

Se all_or_nothing for verdadeiro e o número solicitado de objetos não estiver disponível, retornará um erro 404.

Caso contrário, retornará o caminho e o read_id da operação de leitura e uma lista dos itens da fila de armazenamento de memória.

invisibilityWindowstring

Janela de invisibilidade para itens lidos, em segundos.

Itens lidos são invisíveis em leituras subsequentes durante a duração da janela de invisibilidade.

Deve ser escrito em segundos maiores que 0 e terminar com s.

Padrão para 30s .

Resposta

Retorna o número especificado de itens na frente da fila.

readIdstring

Identificador da operação de leitura

Isso pode ser passado para :discard a fim de marcar os itens como processados.

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

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

    }

  ]

}