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

OrderedDataStoreEntry

Ein Schlüssel-Wert-Eintrag in einem geordneten Datenlagers.

Attribute

pathstring

Der Ressourcenpfad des bestellten Datenlagereintrags.

Format: universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{ordered_data_store_scope_id}/entries/{ordered_data_store_entry_id}.

valuenumber

Der Wert des Eintrags.

Immer auf die nächste Ganzzahl gerundet.

idstring
Nur Ausgabe

Der Name des Eintrags.

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

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Listen geordnete Datenspeicher-Einträge
Beta

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries

Gibt eine Liste von Einträgen aus einem bestellten Datenlagers zurück.

Bereiche
universe.ordered-data-store.scope.entry:read
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

ordered_data_store_idstring
Erforderlich

Die bestellte Datenbank-ID.

scope_idstring
Erforderlich

Die ID des Bereichs.

Anfrageparameter
maxPageSizenumber

Die maximale Anzahl von bestellten Datenlagerspeicher-Einträgen, die zurückzukehren sind.Der Dienst könnte weniger als diesen Wert zurückgeben.Wenn nicht spezifiziert, werden höchstens 10 bestellte Datenspeicher-Einträge 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: Wert.

Beispiel: "value desc".

filterstring

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

Wir unterstützen zwei Vergleichsoperatoren für diese Operation: <= und >=. Diese Vergleichsoperatoren fungieren als minValue und maxValue für die zurückgegebenen Werte.Wenn für einen Wert zwischen einem minValue und maxValue gefiltert werden muss, kann der Benutzer den logischen Operator && verwenden.Alle Token in der Filterausdrückung müssen durch einen einzigen Leerzeichen getrennt werden.

Beispiele für Filter: entry <= 10 ; entry >= 10 && entry <= 30.

Rückmeldung

Eine Liste von OrderedDataStoreEntries in der übergeordneten Sammlung.

orderedDataStoreEntriesarray<OrderedDataStoreEntry>

Die bestellten Datenspeicher-Einträge aus dem angegebenen bestellten Datenspeicher-Bereich.

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}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries?maxPageSize=10&pageToken={string}&orderBy={string}&filter={string}' \

  -H 'x-api-key: {your-api-key}'
Rückmeldung
{

  "orderedDataStoreEntries": [

    {

      "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

      "value": "number",

      "id": "string"

    }

  ],

  "nextPageToken": "string"

}

OrderedDataStoreEntry

Erstellen einer sortierten Datenbank-Einheit
Beta

POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries

Erstellt einen Eintrag mit der angegebenen ID und dem Wert.

Gibt eine 400-Schlechte-Anfrage zurück, wenn der Eintrag existiert.

Bereiche
universe.ordered-data-store.scope.entry:write
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

ordered_data_store_idstring
Erforderlich

Die bestellte Datenbank-ID.

scope_idstring
Erforderlich

Die ID des Bereichs.

Anfrageparameter
idstring

Die ID, die für den bestellten Datenspeicher-Eintrag verwendet wird, der die letzte Komponente des Ressourcenpfads des bestellten Datenspeicher-Eintrags wird.

Dieser Wert sollte eine 1-63-Zeichenzeichenfolge sein. Wir empfehlen dringend, nur kleine Buchstaben, numerische Zahlen und Unterstriche zu verwenden.

Text anfordernOrderedDataStoreEntry
RückmeldungOrderedDataStoreEntry
POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries?id=my-entry' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "value": "number"

}'
Rückmeldung
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Holen Sie sich einen Bestellten Datenstore-Eintrag
Beta

GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

Holen Sie sich den angegebenen Eintrag.

Bereiche
universe.ordered-data-store.scope.entry:read
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

ordered_data_store_idstring
Erforderlich

Die bestellte Datenbank-ID.

scope_idstring
Erforderlich

Die ID des Bereichs.

entry_idstring
Erforderlich

Die Eintrags-ID.

RückmeldungOrderedDataStoreEntry
GET /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}' \

  -H 'x-api-key: {your-api-key}'
Rückmeldung
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Datenspeicher-Eintrag in geordneter Reihenfolge löschen
Beta

DELETE /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

Löscht den angegebenen Eintrag.

Bei Erfolg gibt es 200 OK zurück. Wenn der Eintrag nicht existiert, gibt es 404 nicht gefunden zurück.

Bereiche
universe.ordered-data-store.scope.entry:write
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

ordered_data_store_idstring
Erforderlich

Die bestellte Datenbank-ID.

scope_idstring
Erforderlich

Die ID des Bereichs.

entry_idstring
Erforderlich

Die Eintrags-ID.

DELETE /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X DELETE 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}' \

  -H 'x-api-key: {your-api-key}'

OrderedDataStoreEntry

Aufgerufener Datenlagerspeicher aktualisieren
Beta

PATCH /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}

Aktualisiert den Wert eines Eintrags.

Bereiche
universe.ordered-data-store.scope.entry:write
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

ordered_data_store_idstring
Erforderlich

Die bestellte Datenbank-ID.

scope_idstring
Erforderlich

Die ID des Bereichs.

entry_idstring
Erforderlich

Die Eintrags-ID.

Anfrageparameter
allowMissingboolean

Wenn auf wahr gesetzt und der bestellte Datenlagereintrag nicht gefunden wird, wird ein bestellter Datenlagereintrag erstellt.

Text anfordernOrderedDataStoreEntry
RückmeldungOrderedDataStoreEntry
PATCH /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}
curl -L -X PATCH 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}?allowMissing={boolean}' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "value": "number"

}'
Rückmeldung
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}

OrderedDataStoreEntry

Erhöhte Auftrags-Datenspeicher-Einheit
Beta

POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment

Erhöht den Wert des angegebenen Eintrags. Sowohl der vorhandene Wert als auch die Erhöhungsmenge müssen Zahlen sein.

Wenn der Eintrag nicht existiert, erstellt er einen Eintrag mit dem angegebenen Wert.

Bekanntes Problem: Der Wert kann über die gültige Range von Werten hinaus erhöht werden.Wenn dies passiert, wird der zurückgegebene Wert an die gültige Reichweite angepasst, aber der Backend kann den ursprünglichen Wert beibehalten.Dieses Verhalten wird aus Gründen der Rückwärtskompatibilität aufrechterhalten, kann sich aber in einer zukünftigen Version dieser API ändern.

Bereiche
universe.ordered-data-store.scope.entry:write
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

ordered_data_store_idstring
Erforderlich

Die bestellte Datenbank-ID.

scope_idstring
Erforderlich

Die ID des Bereichs.

entry_idstring
Erforderlich

Die Eintrags-ID.

Text anfordern
amountnumber

Die Menge, mit der der Eintragswert erhöht wird. Sowohl der vorhandene Wert als auch die Erhöhungsmenge müssen Zahlen sein.

RückmeldungOrderedDataStoreEntry
POST /cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment
curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/ordered-data-stores/{ordered_data_store_id}/scopes/{scope_id}/entries/{entry_id}:increment' \

  -H 'x-api-key: {your-api-key}' \

  -H 'Content-Type: application/json' \

  --data '{

  "amount": "number"

}'
Rückmeldung
{

  "path": "universes/123/ordered-data-stores/some-ordered-data-store-id/scopes/some-ordered-data-store-scope-id/entries/some-ordered-data-store-entry-id",

  "value": "number",

  "id": "string"

}