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

DataStore

Repräsentiert einen Store.

Attribute

pathstring

Der Ressourcenpfad des Store.

Format: universes/{universe_id}/data-stores/{data_store_id}.

createTimestring
Nur Ausgabe

Der Zeitpunkt, an dem der Datenspeicher erstellt wurde. Dieser String ist als Zeitstempel formatiert.

idstring
Nur Ausgabe

Die ID des Store. Stimmt dem letzten Segment des Pfads überein.

Basis-URL

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

{
"path": "universes/123/data-stores/some-data-store",
"createTime": "2023-07-05T12:34:56Z",
"id": "string"
}

DataStore

List Data Stores
Beta

GET /cloud/v2/universes/{universe_id}/data-stores

Gibt eine Liste von Datenlagern zurück.

Bereiche
universe-datastores.control:list
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

Anfrageparameter
maxPageSizenumber

Die maximale Anzahl der zu zurückbenden Datenlagern.Der Dienst könnte weniger als diesen Wert zurückgeben.Wenn nicht spezifiziert, werden höchstens 10 Datenspeicher 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.

filterstring

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

Das Feld filter unterstützt einen sehr kleinen Teil von CEL:

  • Nur das Feld id wird unterstützt.
  • Nur die startsWith-Funktion ist verfügbar; keine anderen Betreiber oder Builds werden unterstützt.

Filter: id.startsWith("foo").

Rückmeldung

Eine Liste von Datenspeichern in der übergeordneten Sammlungen.

dataStoresarray<DataStore>

Die Datenspeicher aus dem angegebenen Universum.

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}/data-stores

curl -L -X GET 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores?maxPageSize=10&pageToken={string}&filter={string}' \
-H 'x-api-key: {your-api-key}'
Rückmeldung

{
"dataStores": [
{
"path": "universes/123/data-stores/some-data-store",
"createTime": "2023-07-05T12:34:56Z",
"id": "string"
}
],
"nextPageToken": "string"
}

DataStore

Snapshot Data Stores
Beta

POST /cloud/v2/universes/{universe_id}/data-stores:snapshot

Macht einen neuen Snapshot der Datenstores in einem Erlebnis.

Nach einem Snapshot erstellt die nächste Schrift an jeden Schlüssel im Erlebnis eine versionierte Sicherung der vorherigen Daten, unabhängig von der Zeit des letzten Schreibens.

Tatsächlich werden alle Daten, die zum Zeitpunkt des Snapshots verfügbar sind, garantiert, für mindestens 30 Tage als versioniertes Backup verfügbar zu sein.

Schnappschüsse können einmal pro UTC-Tag, pro Erlebnis, gemacht werden.Wenn der neueste Snapshot innerhalb desselben UTC-Tages aufgenommen wurde, ist diese Operation eine No-Op und die Zeit des neuesten Snapshots wird zurückgegeben.

Für weitere Informationen zur Verwendung von Schnappschüssen siehe den Data Stores Engine-Leitfaden.

Bereiche
universe-datastores.control:snapshot
AnfragePfadparameter
universe_idstring
Erforderlich

Die Universum-ID.

Text anfordern
Rückmeldung

Gibt zurück, ob ein neuer Snapshot aufgenommen wurde und die Zeit des neuesten Snapshots nach der Operation (unabhängig davon, ob ein neuer Snapshot aufgenommen wurde).

newSnapshotTakenboolean

Ob ein neuer Snapshot durch diese Operation erstellt wurde. (Es kann nur ein Snapshot pro Erlebnis pro UTC-Tag erstellt werden.).

latestSnapshotTimestring

Die Zeit des neuesten Snapshots nach der Operation (unabhängig davon, ob ein neuer Snapshot erstellt wurde). Diese Zeit wird immer in UTC zurückgegeben. Dieser String ist als Zeitstempel formatiert.

POST /cloud/v2/universes/{universe_id}/data-stores:snapshot

curl -L -X POST 'https://apis.roblox.com/cloud/v2/universes/{universe_id}/data-stores:snapshot' \
-H 'x-api-key: {your-api-key}' \
-H 'Content-Type: application/json' \
--data '{}'
Rückmeldung

{
"newSnapshotTaken": true,
"latestSnapshotTime": "2023-07-05T12:34:56Z"
}