Method: projects.databases.restore

Tworzy nową bazę danych przez przywrócenie danych z istniejącej kopii zapasowej.

Nowa baza danych musi znajdować się w tym samym regionie chmury lub w wielu regionach co istniejąca kopia zapasowa. Działa to podobnie jak [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase], ale zamiast tworzyć nową pustą bazę danych, tworzona jest nowa baza danych o jej typie, konfiguracji indeksu i dokumentach z istniejącej kopii zapasowej.

long-running operation może służyć do śledzenia postępu przywracania, a typem pola metadata operacji jest RestoreDatabaseMetadata. Jeśli przywrócenie się udało, typ response to Database. Dopóki nie zakończy się LRO, nie będzie można odczytać ani zapisać nowej bazy danych.

Żądanie HTTP

POST https://firestore.googleapis.com/v1/{parent=projects/*}/databases:restore

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Wymagane. Projekt, w którym ma zostać przywrócona baza danych. Format to projects/{projectId}.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis JSON 
{
  "databaseId": string,

  // Union field source can be only one of the following:
  "backup": string
  // End of list of possible types for union field source.
}
Pola
databaseId

string

Wymagane. Identyfikator używany dla bazy danych, który stanie się ostatnim komponentem nazwy zasobu bazy danych. Ten identyfikator bazy danych nie może być powiązany z istniejącą bazą danych.

Ta wartość powinna mieć od 4 do 63 znaków. Prawidłowe znaki to /[a-z][0-9]-/, w tym pierwszy znak litera, a ostatnia litera lub cyfra. Nie może mieć postaci /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.

„(domyślnie)” identyfikator bazy danych również jest prawidłowy.

Pole sumy source.

source może mieć tylko jedną z tych wartości:
backup

string

Kopia zapasowa, z której chcesz przywrócić dane. Musi pochodzić z tego samego projektu co projekt nadrzędny.

Format to: projects/{projectId}/locations/{location}/backups/{backup}

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała instancję Operation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

Więcej informacji znajdziesz w artykule o uwierzytelnianiu (w języku angielskim).