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

MemoryStoreSortedMapItem

Representa um item dentro de uma estrutura de mapa ordenada.

Atributos

pathstring

O caminho de recursos da memória do armazenamento de mapa classificado.

Formato: universes/{universe_id}/memory-store/sorted-maps/{memory_store_sorted_map_id}/items/{memory_store_sorted_map_item_id}.

valueJSON value

O valor do item.

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

etagstring
Apenas saída

A tag gerada pelo servidor de um item.

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

O nome do item.

Um dos seguintes para sortKey:

stringSortKeystring

O item será classificado lexicograficamente de acordo com essa string.

numericSortKeynumber

O item será classificado de acordo com esse número.

URL base
https://apis.roblox.com
O recurso MemoryStoreSortedMapItem
{

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "ttl": "3s",

  "id": "string",

  "stringSortKey": "string"

}

MemoryStoreSortedMapItem

Listar Itens de Mapa Ordenados da Loja de Memória
Beta

GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items

Obtém e retorna itens no mapa com uma ordem e filtro dados.

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

O ID do universo.

sorted_map_idstring
Obrigatório

O ID do mapa classificado.

Parâmetros da consulta
maxPageSizenumber

O número máximo de itens de mapa armazenados de memória para retornar.O serviço pode retornar menos que esse valor.Se não especificado, no máximo 1 item de mapa ordenado de armazenamento de memória é retornado.O valor máximo é 100 e valores mais altos são definidos como 100.

pageTokenstring

Um token de página, recebido de uma chamada anterior, para recuperar uma página posterior.

Ao paginar, todos os outros parâmetros fornecidos à chamada posterior devem corresponder à chamada que forneceu o token da página.

orderBystring

Se especificado, os resultados são ordenados de acordo com os campos especificados.

Os valores devem ser uma lista separada por vírgula de campos, com um sufixo "desc" opcional por campo para classificar por valores decrescentes em vez de ascendentes.Você pode acessar subcampos com um operador ..

Os resultados podem ser ordenados pelos seguintes campos: id.

Exemplo: "id desc".

filterstring

Este campo pode ser definido para filtrar os recursos retornados.

A filtragem conforma-se com o Common Expression Language (CEL).Apenas os campos id e sortKey são suportados.Em termos de operadores, apenas <, > e && são permitidos'

Exemplo: id > "key-001" && id < "key-100".

Resposta

Uma lista de Itens de Mapa de MemóriaOrganizada na coleção pai.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

Os itens do Mapa de Memória Organizado da MemoryStoreSortedMap especificada.

nextPageTokenstring

Um token que você pode enviar como um parâmetro pageToken para recuperar a próxima página. Se este campo for omitido, não há páginas subsequentes.

GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items?maxPageSize=1&pageToken={string}&orderBy={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
Resposta
{

  "memoryStoreSortedMapItems": [

    {

      "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

      "value": "JSON value",

      "etag": "string",

      "id": "string",

      "stringSortKey": "string"

    }

  ],

  "nextPageToken": "string"

}

MemoryStoreSortedMapItem

Criar Item de Mapa de Armazenamento de Memória Ordenado
Beta

POST /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items

Cria o item de mapa especificado se ele não existir.

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

O ID do universo.

sorted_map_idstring
Obrigatório

O ID do mapa classificado.

Parâmetros da consulta
idstring

O ID para usar no mapa de armazenamento de memória classificado, que se tornará o caminho de recursos final do mapa de armazenamento de memória classificado.

Este valor deve ser uma string de caracteres de 1 a 127 que suporte caracteres alfanuméricos e especiais.Este ID é sensível a maiúsculas e minúsculas.O ID deve ser codificado em URL se contiver qualquer URL quebrando caracteres especiais.

Requisitar corpoMemoryStoreSortedMapItem
RespostaMemoryStoreSortedMapItem
POST /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items?id=Hello!' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "value": "JSON value",

  "ttl": "3s",

  "id": "string",

  "stringSortKey": "string"

}'
Resposta
{

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "id": "string",

  "stringSortKey": "string"

}

MemoryStoreSortedMapItem

Obter item de mapa ordenado da Loja de Memória
Beta

GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}

Obtém e retorna o valor da chave dada no mapa.

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

O ID do universo.

sorted_map_idstring
Obrigatório

O ID do mapa classificado.

item_idstring
Obrigatório

O ID do item.

RespostaMemoryStoreSortedMapItem
GET /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}' \

  -H 'x-api-key: {your-api-key}'
Resposta
{

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "id": "string",

  "stringSortKey": "string"

}

MemoryStoreSortedMapItem

Excluir Item de Mapa Ordenado da Loja de Memória
Beta

DELETE /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}

Exclui o item especificado do mapa.

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

O ID do universo.

sorted_map_idstring
Obrigatório

O ID do mapa classificado.

item_idstring
Obrigatório

O ID do item.

DELETE /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}
curl -L -X DELETE 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}' \

  -H 'x-api-key: {your-api-key}'

MemoryStoreSortedMapItem

Atualizar Item de Mapa Ordenado da Loja de Memória
Beta

PATCH /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}

Atualiza o item de mapa especificado.

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

O ID do universo.

sorted_map_idstring
Obrigatório

O ID do mapa classificado.

item_idstring
Obrigatório

O ID do item.

Parâmetros da consulta
allowMissingboolean

Se definido como verdadeiro e o item de mapa ordenado da armazenagem de memória não for encontrado, um item de mapa ordenado da armazenagem de memória é criado.

Requisitar corpoMemoryStoreSortedMapItem
RespostaMemoryStoreSortedMapItem
PATCH /cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/memory-store/sorted-maps/{sorted_map_id}/items/{item_id}?allowMissing={boolean}' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "value": "JSON value",

  "ttl": "3s",

  "id": "string",

  "stringSortKey": "string"

}'
Resposta
{

  "path": "universes/123/memory-store/sorted-maps/some-memory-store-sorted-map-id/items/some-memory-store-sorted-map-item-id",

  "value": "JSON value",

  "etag": "string",

  "id": "string",

  "stringSortKey": "string"

}