Method: projects.locations.services.restore

Stellt einen Dienst aus einer Sicherung wieder her.

HTTP-Anfrage

POST https://metastore.googleapis.com/v1beta/{service}:restore

Pfadparameter

Parameter
service

string

Pflichtangabe. Der relative Ressourcenname des Metastore-Dienstes, für den die Wiederherstellung ausgeführt werden soll, im folgenden Format:

projects/{projectId}/locations/{locationId}/services/{serviceId}.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource service erforderlich:

  • metastore.services.restore

Anfragetext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung 
{
  "backup": string,
  "backupLocation": string,
  "restoreType": enum (RestoreType),
  "requestId": string
}
Felder
backup

string

Optional. Der relative Ressourcenname der Metastore-Dienstsicherung, aus der wiederhergestellt werden soll, im folgenden Format:

projects/{projectId}/locations/{locationId}/services/{serviceId}/backups/{backupId}. Schließt sich mit backupLocation gegenseitig aus. Es muss genau eine der beiden Optionen festgelegt sein.

Für die Autorisierung ist die folgende IAM-Berechtigung für die angegebene Ressource backup erforderlich:

  • metastore.backups.use
backupLocation

string

Optional. Ein Cloud Storage-URI, der den Speicherort der Sicherungsartefakte angibt, nämlich die Sicherungs-Avro-Dateien unter „avro/“, „backup_metastore.json“ und „service.json“, im folgenden Format:

gs://<path_to_backup>. Schließt sich mit backup gegenseitig aus. Es muss genau eine der beiden Optionen festgelegt sein.
restoreType

enum (RestoreType)

Optional. Die Art der Wiederherstellung. Wenn nicht angegeben, lautet die Standardeinstellung METADATA_ONLY.
requestId

string

Optional. Eine Anfrage-ID. Geben Sie eine eindeutige Anfrage-ID an, damit der Server die Anfrage ignorieren kann, falls sie bereits abgeschlossen wurde. Der Server ignoriert nachfolgende Anfragen mit einer doppelten Anfrage-ID für mindestens 60 Minuten nach der ersten Anfrage.

Wenn beispielsweise bei einer ersten Anfrage eine Zeitüberschreitung auftritt und dann eine weitere Anfrage mit derselben Anfrage-ID folgt, ignoriert der Server die zweite Anfrage, um das Erstellen doppelter Zusagen zu verhindern.

Die Anfrage-ID muss eine gültige UUID sein. Eine UUID mit Nullen (00000000-0000-0000-0000-000000000000) wird nicht unterstützt.

Antworttext

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

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht.