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

MemoryStoreQueueItem

Représente un élément dans une structure de file d'attente.

Attributs

pathstring

Le chemin de ressource de l'élément de file d'attente du magasin de mémoire.

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

dataJSON value

La valeur de l'élément de la file d'attente.

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

prioritynumber

La priorité de l'élément de la file d'attente.

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
Sortie seule

Le nom de l'élément.

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

Créer un élément de la file d'attente du magasin de mémoire
Bêta

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

Crée un nouvel élément de file d'attente.

Si ttl est défini, l'élément sera automatiquement retiré de la file d'attente après l'intervalle de temps spécifié.

Si un nombre priority est défini, l'élément sera inséré dans la file d'attente en fonction de la valeur de priorité.Plus la valeur est élevée, plus l'élément sera proche du début de la file d'attente.Si les valeurs de priorité sont identiques, l'élément sera inséré après les valeurs existantes avec la même priorité.

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

L'ID de l'univers.

queue_idstring
Requis

L'ID de la file d'attente.

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

}'
Réponse
{

  "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

Jeter les éléments de la file d'attente du magasin de mémoire
Bêta

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

Les jetons rejettent les articles lus de l'avant de la file d'attente.

Prend une readId de l'opération précédente Read.

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

L'ID de l'univers.

queue_idstring
Requis

L'ID de la file d'attente.

Corps de la requête
readIdstring

Le readId de l'opération de lecture précédente pour laquelle rejeter les éléments lus.

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

Lire les éléments de la file d'attente du magasin de mémoire
Bêta

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

Renvoie le nombre spécifié d'articles en amont de la file d'attente.

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

L'ID de l'univers.

queue_idstring
Requis

L'ID de la file d'attente.

Paramètres de requête
countnumber

Le nombre d'éléments à lire dans la file d'attente Si non spécifié, 1 élément sera retourné. La valeur maximale est 200 ; les valeurs au-dessus de 200 seront forcées à 200.

allOrNothingboolean

Si all_or_nothing est vrai et que le nombre d'objets demandé n'est pas disponible, il renvoie une erreur 404.

Sinon, renverra le chemin et le ID de lecture de l'opération de lecture et une liste des éléments de la file d'attente de stockage de mémoire.

invisibilityWindowstring

Fenêtre d'invisibilité pour les articles lus, en secondes.

Les articles lus sont invisibles lors des lectures suivantes pendant la durée de la fenêtre d'invisibilité.

Il doit être écrit en secondes supérieures à 0 et se terminer par s .

Par défaut à 30s.

Réponse

Renvoie le nombre spécifié d'articles en amont de la file d'attente.

readIdstring

Un identifiant de l'opération de lecture

Cela peut être transmis à :discard afin de marquer les éléments comme traités.

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

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

    }

  ]

}