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

MemoryStoreSortedMapItem

Representa un elemento dentro de una estructura de mapa ordenada.

Atributos

pathstring

El camino de recursos del elemento de mapa ordenado del almacén de memoria.

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

valueJSON value

El valor del artículo.

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

etagstring
Solo salida

La etiqueta generada por el servidor de un artículo.

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

El nombre del artículo.

Uno de los siguientes para sortKey:

stringSortKeystring

El artículo se ordenará lexicográficamente de acuerdo con esta cadena.

numericSortKeynumber

El artículo se ordenará según este número.

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

Lista de almacén de memoria ordenada de elementos del mapa
Beta

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

Obtiene y devuelve elementos en el mapa con un orden y un filtro dados.

Ámbitos
universe.memory-store.sorted-map:read
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

sorted_map_idstring
Obligatorio

El ID de mapa ordenado.

Parámetros de consulta
maxPageSizenumber

El número máximo de elementos del mapa almacenados en memoria para devolver.El servicio podría devolver menos que este valor.Si no se especifica, se devuelven al menos 1 artículo de mapa ordenado de almacén de memoria.El valor máximo es 100 y los valores más altos se establecen en 100.

pageTokenstring

Una ficha de página, recibida de una llamada anterior, para recuperar una página posterior.

Al paginar, todos los demás parámetros proporcionados a la llamada siguiente deben coincidir con la llamada que proporcionó el token de página.

orderBystring

Si se especifica, los resultados se ordenan según los campos especificados.

Los valores deben ser una lista separada por comas de campos, con un sufijo "desc" opcional por campo para ordenar por valores descendientes en lugar de ascendentes.Puedes acceder a subcampos con un operador ..

Los resultados se pueden ordenar por los siguientes campos: id.

Ejemplo: "id desc".

filterstring

Este campo se puede configurar para filtrar los recursos devueltos.

La filtración se ajusta al idioma de expresión común (CEL).Solo se admiten los campos id y sortKey .En términos de operadores, solo se permiten <, > y &&

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

Respuesta

Una lista de elementos de MemoryStoreSortedMap en la colección padre.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

Los elementos del mapa ordenado de la memoria del almacén especificado del almacén de memoria ordenada.

nextPageTokenstring

Una token que puedes enviar como parámetro pageToken para recuperar la siguiente página. Si este campo se omite, no hay páginas posteriores.

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

  "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

Crear elemento de mapa ordenado de almacén de memoria
Beta

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

Crea el elemento de mapa especificado si no existe.

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

La identificación del universo.

sorted_map_idstring
Obligatorio

El ID de mapa ordenado.

Parámetros de consulta
idstring

El ID para usar en el elemento de mapa ordenado del almacén de memoria, que se convertirá en el camino de recursos final del elemento de mapa ordenado del almacén de memoria.

Este valor debe ser una cadena de caracteres de 1 a 127 que soporte caracteres alfanuméricos y especiales.Este ID es sensible a mayúsculas y minúsculas.El ID debe estar codificado como URL si contiene cualquier URL que rompa caracteres especiales.

Solicitar cuerpoMemoryStoreSortedMapItem
RespuestaMemoryStoreSortedMapItem
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"

}'
Respuesta
{

  "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

Obtener elemento de mapa ordenado de almacén de memoria
Beta

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

Obtiene y devuelve el valor de la clave dada en el mapa.

Ámbitos
universe.memory-store.sorted-map:read
SolicitudParámetros de ruta
universe_idstring
Obligatorio

La identificación del universo.

sorted_map_idstring
Obligatorio

El ID de mapa ordenado.

item_idstring
Obligatorio

El ID del artículo.

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

  "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

Eliminar elemento del mapa ordenado del almacén de memoria
Beta

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

Elimina el elemento especificado del mapa.

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

La identificación del universo.

sorted_map_idstring
Obligatorio

El ID de mapa ordenado.

item_idstring
Obligatorio

El ID del artículo.

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

Actualizar el elemento del mapa ordenado del almacén de memoria
Beta

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

Actualiza el elemento de mapa especificado.

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

La identificación del universo.

sorted_map_idstring
Obligatorio

El ID de mapa ordenado.

item_idstring
Obligatorio

El ID del artículo.

Parámetros de consulta
allowMissingboolean

Si se establece en verdadero y no se encuentra el elemento de mapa almacenado en memoria, se crea un elemento de mapa almacenado en memoria ordenado.

Solicitar cuerpoMemoryStoreSortedMapItem
RespuestaMemoryStoreSortedMapItem
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"

}'
Respuesta
{

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

}