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

MemoryStoreSortedMapItem

Repräsentiert ein Element innerhalb einer sortierten Kartenstruktur.

Attribute

pathstring

Der Ressourcenpfad des Speicherstores sortierte Kartenartikel.

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

valueJSON value

Der Wert des Elements.

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

etagstring
Nur Ausgabe

Der vom Server generierte Tag eines 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

Der Name des Elements.

Eins der folgenden für sortKey:

stringSortKeystring

Das Element wird alphabetisch nach dieser Zeichenkette sortiert.

numericSortKeynumber

Das Element wird nach dieser Nummer sortiert.

Basis-URL

https://apis.roblox.com
Die MemoryStoreSortedMapItem-Ressource

{
"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 Speicherort sortierte Kartenartikel
Beta

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

Holen und geben Sie Elemente auf der Karte mit einer bestimmten Reihenfolge und einem Filter zurück.

Bereiche
universe.memory-store.sorted-map:read
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

sorted_map_idstring
Erforderlich

Die sortierte Karten-ID.

Anfrageparameter
maxPageSizenumber

Die maximale Anzahl von Speicherstoff-sortierten Kartenartikeln, die zurückgegeben werden.Der Dienst könnte weniger als diesen Wert zurückgeben.Wenn nicht spezifiziert, werden bei maximal 1 Speicherstelle sortierte Kartenelemente zurückgegeben.Der maximale Wert beträgt 100, und höhere Werte werden auf 100 festgelegt.

pageTokenstring

Ein Seiten-Token, das von einer früheren Anruf erhalten wurde, um eine nachfolgende Seite abzurufen.

Wenn Seiten nummeriert werden, müssen alle anderen Parameter, die der nachfolgenden Anruf bereitgestellt hat, dem Anruf entsprechen, der das Seiten-Token bereitgestellt hat.

orderBystring

Wenn angegeben, werden die Ergebnisse entsprechend der angegebenen Felder sortiert.

Werte müssen eine getrennte Liste von Feldern mit einem optionalen, pro-Feld-Präfix "desc" sein, um nach absteigenden Werten zu sortieren, anstatt nach steigenden Werten.Du kannst Unterfelder mit einem . Operator zugreifen.

Ergebnisse können nach den folgenden Feldern sortiert werden: id.

Beispiel: "id desc".

filterstring

Dieses Feld kann festgelegt werden, um die zurückgegebenen Ressourcen zu filtern.

Filtern entspricht Common Expression Language (CEL).Nur die Felder id und sortKey werden unterstützt.In Bezug auf Betreiber sind nur <, > und && erlaubt'

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

Rückmeldung

Eine Liste von MemoryStoreSortedMapItems in der übergeordneten Sammlung.

memoryStoreSortedMapItemsarray<MemoryStoreSortedMapItem>

Die MemoryStoreSortedMapItems aus dem angegebenen MemoryStoreSortedMap.

nextPageTokenstring

Ein Token, das du als pageToken-Parameter senden kannst, um die nächste Seite abzurufen. Wenn dieses Feld ausgelassen wird, gibt es keine nachfolgenden Seiten.

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

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

Erstellen einer sortierten Speicherstandskarte Gegenstand
Beta

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

Erstellt das angegebene Karten-Item, wenn es nicht existiert.

Bereiche
universe.memory-store.sorted-map:write
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

sorted_map_idstring
Erforderlich

Die sortierte Karten-ID.

Anfrageparameter
idstring

Die ID, die für die Sortierungskarte des Speicherlagers verwendet wird, die die endgültige Komponente des Speicherlagersortierungs-Kartenpfads werden wird.

Dieser Wert sollte eine 1-127-Zeichenfolge sein, die alphanumerische und spezielle Zeichen unterstützt.Diese ID ist kapitelspezifisch.Die ID muss mit einer URL verschlüsselt werden, wenn sie irgendwelche URL-Zerbrechungszeichen enthält.

Text anfordernMemoryStoreSortedMapItem
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ückmeldung

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

Holen Sie sich Memory Store sortierte Karten-Item
Beta

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

Holt sich und gibt den Wert des angegebenen Schlüssels in der Karte zurück.

Bereiche
universe.memory-store.sorted-map:read
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

sorted_map_idstring
Erforderlich

Die sortierte Karten-ID.

item_idstring
Erforderlich

Die Artikel-ID.

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

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

Löschen Sie Speicherstoff-Sortiertes Karten-Item
Beta

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

Löscht das angegebene Element von der Karte.

Bereiche
universe.memory-store.sorted-map:write
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

sorted_map_idstring
Erforderlich

Die sortierte Karten-ID.

item_idstring
Erforderlich

Die Artikel-ID.

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

Aktualisieren Sie die sortierte Map-Item des Speicherlagers
Beta

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

Aktualisiert das angegebene Karten-Element.

Bereiche
universe.memory-store.sorted-map:write
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

sorted_map_idstring
Erforderlich

Die sortierte Karten-ID.

item_idstring
Erforderlich

Die Artikel-ID.

Anfrageparameter
allowMissingboolean

Wenn auf wahr gesetzt und der Speicherstore sortierte Kartenartikel nicht gefunden wird, wird ein Speicherstore sortierter Kartenartikel erstellt.

Text anfordernMemoryStoreSortedMapItem
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ückmeldung

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