*Ce contenu est traduit en utilisant l'IA (Beta) et peut contenir des erreurs. Pour consulter cette page en anglais, clique ici.

MemoryStoreSortedMapItem

Représente un élément dans une structure de carte triée.

Attributs

pathstring

Le chemin de ressource de la carte triée du magasin de mémoire.

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

valueJSON value

La valeur de l'élément.

Une valeur JSON peut être null, boolean, string, number, array, ou object.

etagstring
Sortie seule

La balise générée par le serveur d'un article.

Un des éléments suivants pour expiration:

ttlstring
Entrée seule

Le TTL pour l'élément.

expireTimestring
Sortie seule

Le temps d'expiration de l'élément. Ce string est formatée en tant que Timestamp.

idstring

Le nom de l'élément.

Un des éléments suivants pour sortKey:

stringSortKeystring

L'élément sera trié lexicographiquement selon cette chaîne.

numericSortKeynumber

L'élément sera trié selon ce nombre.

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

Liste des éléments de carte triés du stock de mémoire
Bêta

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

Obtient et retourne des éléments dans la carte avec un ordre et un filtre donnés.

Périmètres d'application
universe.memory-store.sorted-map:read
RequêteParamètres du chemin
universe_idstring
Requis

L'ID de l'univers.

sorted_map_idstring
Requis

L'ID de la carte triée.

Paramètres de requête
maxPageSizenumber

Le nombre maximum d'éléments de carte triés dans le stock de mémoire à retourner.Le service peut retourner moins que cette valeur.Si non spécifié, au maximum 1 article de carte trié par mémoire est retourné.La valeur maximale est de 100 et les valeurs plus élevées sont réglées sur 100.

pageTokenstring

Un jeton de page, reçu d'un appel précédent, pour récupérer une page suivante.

Lors de la pagination, tous les autres paramètres fournis à l'appel suivant doivent correspondre à l'appel qui a fourni le jeton de page.

orderBystring

Si spécifié, les résultats sont triés selon les champs spécifiés.

Les valeurs doivent être une liste séparée par une virgule de champs, avec un suffixe "desc" facultatif par champ pour trier par des valeurs décroissantes plutôt que par des valeurs ascendantes.Vous pouvez accéder à des sous-champs avec un opérateur ..

Les résultats peuvent être triés par les champs suivants : id.

Exemple : "id desc".

filterstring

Ce champ peut être défini afin de filtrer les ressources renvoyées.

Le filtrage se conforme au langage d'expression commun (CEL).Seuls les champs id et sortKey sont pris en charge.En termes d'opérateurs, seuls <, > et && sont autorisés'

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

Réponse

Une liste d'éléments de MemoryStoreSortedMap dans la collection parent.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

Les éléments de la carte mémoire triée du stockage mémoire spécifié MemoryStoreSortedMap.

nextPageTokenstring

Un jeton que vous pouvez envoyer en tant que pageToken paramètre pour récupérer la page suivante. Si ce champ est omis, il n'y a pas de pages suivantes.

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}'
Réponse
{

  "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

Créer un élément de carte de stockage de mémoire trié
Bêta

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

Crée l'élément de carte spécifié s'il n'existe pas.

Périmètres d'application
universe.memory-store.sorted-map:write
RequêteParamètres du chemin
universe_idstring
Requis

L'ID de l'univers.

sorted_map_idstring
Requis

L'ID de la carte triée.

Paramètres de requête
idstring

L'ID à utiliser pour l'élément de carte de stockage de mémoire trié, qui deviendra le chemin de ressource final de l'élément de carte de stockage de mémoire trié.

Cette valeur doit être une chaîne de caractères de 1 à 127 qui prend en charge les caractères alphanumériques et spéciaux.Cet ID est sensible à la casse.L'ID doit être encodé en URL s'il contient des caractères spéciaux de rupture d'URL.

Corps de la requêteMemoryStoreSortedMapItem
RéponseMemoryStoreSortedMapItem
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"

}'
Réponse
{

  "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

Obtenir l'élément de carte trié du magasin de mémoire
Bêta

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

Obtient et renvoie la valeur de la clé donnée dans la carte.

Périmètres d'application
universe.memory-store.sorted-map:read
RequêteParamètres du chemin
universe_idstring
Requis

L'ID de l'univers.

sorted_map_idstring
Requis

L'ID de la carte triée.

item_idstring
Requis

L'ID de l'élément.

RéponseMemoryStoreSortedMapItem
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}'
Réponse
{

  "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

Supprimer l'élément de carte trié du magasin de mémoire
Bêta

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

Supprime l'élément spécifié de la carte.

Périmètres d'application
universe.memory-store.sorted-map:write
RequêteParamètres du chemin
universe_idstring
Requis

L'ID de l'univers.

sorted_map_idstring
Requis

L'ID de la carte triée.

item_idstring
Requis

L'ID de l'élément.

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

Mettre à jour l'élément de carte trié du magasin de mémoire
Bêta

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

Mise à jour de l'élément de carte spécifié.

Périmètres d'application
universe.memory-store.sorted-map:write
RequêteParamètres du chemin
universe_idstring
Requis

L'ID de l'univers.

sorted_map_idstring
Requis

L'ID de la carte triée.

item_idstring
Requis

L'ID de l'élément.

Paramètres de requête
allowMissingboolean

Si la valeur est définie sur vrai et que l'élément de carte mémoire trié n'est pas trouvé, un élément de carte mémoire trié est créé.

Corps de la requêteMemoryStoreSortedMapItem
RéponseMemoryStoreSortedMapItem
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"

}'
Réponse
{

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

}