*Ta zawartość została przetłumaczona przy użyciu narzędzi AI (w wersji beta) i może zawierać błędy. Aby wyświetlić tę stronę w języku angielskim, kliknij tutaj.

DataStore

Reprezentuje przechowywanie danych.

Atrybuty

pathstring

Ścieżka zasobów przechowalni danych.

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

createTimestring
Tylko dane wyjściowe

Data stworzenia czasu, gdy przechowywanie danych zostało utworzone. Ten ciąg jest sformatowany jako Timestamp.

idstring
Tylko dane wyjściowe

ID przechowalni danych. Pasuje do ostatniego segmentu ścieżki.

Podstawowy adres URL
https://apis.roblox.com
Zasób DataStore
{

  "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

Zwraca listę magazynów danych.

Zakresy
universe-datastores.control:list
ŻądanieParametry ścieżki
universe_idstring
Wymagane

ID wszechświata.

Parametry zapytania
maxPageSizenumber

Maksymalna liczba przechowywanych danych, które należy zwrócić.Usługa może zwrócić mniej niż tę wartość.Jeśli nie zostanie określone, zwracane jest maksymalnie 10 magazynów danych.Maksymalna wartość wynosi 100, a wyższe wartości są ustawione na 100.

pageTokenstring

Żeton strony, otrzymany z poprzedniego wezwania, aby odzyskać następną stronę.

Podczas paginowania wszystkie pozostałe parametry dostarczone do następnego wezwania muszą pasować do wezwania, które dostarczyło token strony.

filterstring

Pole to można ustawić w celu filtrowania zasobów zwrotnych.

Pole filter wspiera bardzo mały podzbiór CEL:

  • Wspierany jest tylko pole id.
  • Dostępna jest tylko funkcja startsWith ; nie są wspierane żadne inne operatorzy ani wbudowane.

Przykładowy filtr: id.startsWith("foo").

Odpowiedź:

Lista DataStore w kolekcjamacierzystej.

dataStoresarray<DataStore>

Magazyny danych z określonego wszechświata.

nextPageTokenstring

Token, który możesz wysłać jako parametr pageToken w celu odzyskania następnej strony. Jeśli to pole zostanie pominięte, nie ma następnych stron.

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}'
Odpowiedź:
{

  "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

Tworzy nowy zapis obrazu przechowywanych danych w doświadczeniu.

Po wykonaniu kopii zapasowej następna pisanie do każdego klucza w doświadczeniu utworzy zarchiwizowaną kopię poprzednich danych, niezależnie od czasu ostatniej pisania.

W rzeczywistości wszystkie dane obecne w momencie wykonania kopii zapasowej są gwarantowane do dostępności jako zarchiwizowana kopia zapasowa przez co najmniej 30 dni.

Przyjęcia można wykonać raz na dzień UTC, na doświadczenie.Jeśli najnowszy zapis został wykonany w tym samym dniu UTC, ta operacja jest bezoperacyjna, a czas najnowszego zapisu zostanie zwrócony.

Aby uzyskać więcej informacji na temat korzystania z punktów kontrolnych, zobacz przewodnik Data Stores Engine.

Zakresy
universe-datastores.control:snapshot
ŻądanieParametry ścieżki
universe_idstring
Wymagane

ID wszechświata.

Treść żądania
Odpowiedź:

Zwraca, czy został wykonany nowy zapis obrazu i czas najnowszego zapisu po operacji (niezależnie od tego, czy został wykonany nowy zapis obrazu).

newSnapshotTakenboolean

Czy nowy zapis został wykonany przez tę operację. (Tylko jeden zapis może zostać wykonany na każde doświadczenie na dzień UTC.).

latestSnapshotTimestring

Czas najnowszego zapisu po operacji (niezależnie od tego, czy nowy zapis został utworzony). Czas ten zawsze jest zwracany w UTC. Ten ciąg jest sformatowany jako Timestamp.

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 '{}'
Odpowiedź:
{

  "newSnapshotTaken": true,

  "latestSnapshotTime": "2023-07-05T12:34:56Z"

}