Method: projects.databases.restore

Erstellt eine neue Datenbank durch Wiederherstellung aus einer vorhandenen Sicherung.

Die neue Datenbank muss sich in derselben Cloud-Region oder am multiregionalen Standort wie die vorhandene Sicherung befinden. Das Verhalten ähnelt [FirestoreAdmin.CreateDatabase][google.firestore.admin.v1.CreateDatabase], mit dem Unterschied, dass anstelle einer neuen leeren Datenbank eine neue Datenbank mit dem Datenbanktyp, der Indexkonfiguration und Dokumenten aus einer vorhandenen Sicherung erstellt wird.

Mit long-running operation kann der Fortschritt der Wiederherstellung verfolgt werden. Der Feldtyp metadata des Vorgangs ist RestoreDatabaseMetadata. Bei einer erfolgreichen Wiederherstellung ist der Typ response der Database. Die neue Datenbank kann erst gelesen oder beschreibt werden, wenn der LRO abgeschlossen ist.

HTTP-Anfrage

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

Die URL verwendet die Syntax der gRPC-Transcodierung.

Pfadparameter

Parameter
parent

string

Erforderlich. Das Projekt, in dem die Datenbank wiederhergestellt werden soll. Format ist projects/{projectId}.

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "databaseId": string,

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

string

Erforderlich. Die für die Datenbank zu verwendende ID, die die letzte Komponente des Ressourcennamens der Datenbank darstellt. Diese Datenbank-ID darf nicht mit einer vorhandenen Datenbank verknüpft sein.

Dieser Wert muss zwischen 4 und 63 Zeichen lang sein. Gültige Zeichen sind /[a–z][0–9]-/, wobei das erste Zeichen ein Buchstabe und das letzte Zeichen ein Buchstabe oder eine Ziffer ist. Darf nicht UUID-ähnlicher /[0-9a-f]{8}(-[0-9a-f]{4}){3}-[0-9a-f]{12}/ sein.

Datenbank-ID „(Standard)“ ist ebenfalls gültig.

Union-Feld source.

Für source ist nur einer der folgenden Werte zulässig:
backup

string

Sicherung für Wiederherstellung. Muss aus demselben Projekt wie das übergeordnete Element stammen.

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

Antworttext

Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext eine Instanz von Operation.

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.