Method: projects.databases.restore

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

Nowa baza danych musi być w tym samym regionie chmury lub w wielu regionach co bieżąca kopia zapasowa. Działa to podobnie do [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase] z tym wyjątkiem, że zamiast tworzyć nową pustą bazę danych, tworzona jest nowa baza danych z typem bazy danych, konfiguracją indeksu i dokumentami z istniejącej kopii zapasowej.

long-running operation może służyć do śledzenia postępu przywracania (pole metadata operacji to RestoreDatabaseMetadata). Jeśli przywracanie się udało, typ response to Database. Dopóki proces LRO nie zostanie ukończony, nowa baza danych nie będzie dostępna do odczytu ani zapisu.

Żą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 chcesz przywrócić bazę danych. Format: 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 przez bazę 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.

Powinna ona mieć od 4 do 63 znaków. Prawidłowe znaki to /[a-z][0-9]-/ , gdzie pierwszy znak to litera, a ostatnia litera lub cyfra. Nie może być jak identyfikator UUID /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/.

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

Pole sumy source.

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

string

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

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

Treść odpowiedzi

W przypadku powodzenia treść odpowiedzi obejmuje wystąpienie elementu Operation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów OAuth:

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

Więcej informacji znajdziesz w artykule Omówienie uwierzytelniania.