*Dieser Inhalt wurde mit KI (Beta) übersetzt und kann Fehler enthalten. Um diese Seite auf Englisch zu sehen, klicke hier.

MemoryStoreQueueItem

Repräsentiert ein Element innerhalb einer Warteschlangenstruktur.

Attribute

pathstring

Der Ressourcenpfad des Speicherstoff-Warteschlangenartikels.

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

dataJSON value

Der Wert des Warteschlangen-Elements.

Ein JSON-Wert kann null, boolean, string, number, array oder object sein.

prioritynumber

Die Priorität des Warteschlangen-Elements.

Eins der folgenden für expiration:

ttlstring
Nur Eingabe

Die TTL für das Element.

expireTimestring
Nur Ausgabe

Die Verfallszeit des Elements. Dieser String ist als Zeitstempel formatiert.

idstring
Nur Ausgabe

Der Name des Elements.

Basis-URL
https://apis.roblox.com
Die MemoryStoreQueueItem-Ressource
{

  "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

Erstellen von Speicherstoff-Warteschlangen-Artikel
Beta

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

Erstellt ein neues Warteschlangen-Element.

Wenn ttl festgelegt ist, wird das Element nach dem angegebenen Zeitintervall automatisch aus der Warteschlange entfernt.

Wenn ein numerischer priority festgelegt wird, wird der Artikel basierend auf dem Prioritätenwert in die Warteschlange eingefügt.Je höher der Wert, desto näher an der Spitze der Warteschlange wird das Element sein.Wenn die Prioritätenwerte gleich sind, wird das Element nach vorhandenen Werten mit derselben Priorität eingefügt.

Bereiche
universe.memory-store.queue:write
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

queue_idstring
Erforderlich

Die Schlangen-ID.

Text anfordernMemoryStoreQueueItem
RückmeldungMemoryStoreQueueItem
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ückmeldung
{

  "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

Speicherstoff-Warteschlangen-Artikel verwerfen
Beta

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

Discard liest Artikel von der Vorderseite der Warteschlange.

Nimmt eine readId von einer früheren Read Operation.

Bereiche
universe.memory-store.queue:discard
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

queue_idstring
Erforderlich

Die Schlangen-ID.

Text anfordern
readIdstring

Die readId der vorherigen Lesevoperation, für die gelesene Elemente verworfen werden sollen.

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

Lesen Sie Speicherstoff-Warteschlangen-Artikel
Beta

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

Gibt die angegebene Anzahl von Artikeln an der Spitze der Warteschlange zurück.

Bereiche
universe.memory-store.queue:dequeue
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

queue_idstring
Erforderlich

Die Schlangen-ID.

Anfrageparameter
countnumber

Die Anzahl der Artikel, die aus der Warteschlange gelesen werden, Wenn nicht spezifiziert, wird 1 Artikel zurückgegeben. Der maximale Wert ist 200; Werte über 200 werden auf 200 gezwungen.

allOrNothingboolean

Wenn all_or_nothing wahr ist und die angeforderte Anzahl von Objekten nicht verfügbar ist, gibt es eine 404-Fehler zurück.

Ansonsten gibt er den Pfad und read_id der Les操作 und eine Liste der MemoryStoreQueue-Artikel zurück.

invisibilityWindowstring

Unsichtbarkeitsfenster für gelesene Artikel, in Sekunden.

Gelesene Elemente sind bei späteren Lesungen während der Zeit des Unsichtbarkeitsfensters unsichtbar.

Es muss in Sekunden geschrieben werden, die größer als 0 sind und mit s enden.

Standard auf 30s.

Rückmeldung

Gibt die angegebene Anzahl von Artikeln an der Spitze der Warteschlange zurück.

readIdstring

Eine Identifikator der Les操作

Dies kann an :discard übergeben werden, um die Artikel als verarbeitet zu markieren.

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ückmeldung
{

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

    }

  ]

}