Method: projects.locations.services.restore

Restaure un service à partir d'une sauvegarde.

Requête HTTP

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

Paramètres de chemin

Paramètres
service

string

Obligatoire. Nom de ressource relatif du service Metastore à exécuter pour la restauration, au format suivant:

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

L'autorisation IAM suivante est requise pour la ressource service indiquée :

  • metastore.services.restore

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON
{
  "backup": string,
  "backupLocation": string,
  "restoreType": enum (RestoreType),
  "requestId": string
}
Champs
backup

string

Facultatif. Nom de ressource relatif de la sauvegarde du service Metastore à partir de laquelle effectuer la restauration, au format suivant:

projects/{projectId}/locations/{locationId}/services/{serviceId}/backups/{backupId}. Valeur incompatible avec backupLocation. Un seul des deux doit être défini.

L'autorisation IAM suivante est requise pour la ressource backup indiquée :

  • metastore.backups.use
backupLocation

string

Facultatif. URI Cloud Storage spécifiant l'emplacement des artefacts de sauvegarde, à savoir les fichiers Avro de sauvegarde sous "avro/", backup_metastore.json et service.json, au format suivant:

gs://<path_to_backup>. Valeur incompatible avec backup. Un seul des deux doit être défini.

restoreType

enum (RestoreType)

Facultatif. Type de restauration. Si cette valeur n'est pas spécifiée, elle prend la valeur par défaut de METADATA_ONLY.

requestId

string

Facultatif. ID de requête. Spécifiez un ID de requête unique pour que le serveur ignore la requête si elle est terminée. Le serveur ignore les requêtes ultérieures qui fournissent un ID de requête en double pendant au moins 60 minutes après la première requête.

Par exemple, si une requête initiale expire, suivie d'une autre requête avec le même ID de requête, le serveur ignore la deuxième requête pour éviter la création d'engagements en double.

L'ID de requête doit être un UUID valide. Un UUID nul (00000000-0000-0000-0000-000000000000) n'est pas accepté.

Corps de la réponse

Si la requête aboutit, le corps de la réponse contient une instance de Operation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.