REST Resource: projects.locations.restorePlans.restores

Ressource : Restore

Représente à la fois une requête de restauration d'une partie d'une sauvegarde dans un cluster GKE cible et un enregistrement de l'opération de restauration elle-même. ID suivant : 18.

Représentation JSON 
{
  "name": string,
  "uid": string,
  "createTime": string,
  "updateTime": string,
  "description": string,
  "backup": string,
  "cluster": string,
  "restoreConfig": {
    object (RestoreConfig)
  },
  "labels": {
    string: string,
    ...
  },
  "state": enum (State),
  "stateReason": string,
  "completeTime": string,
  "resourcesRestoredCount": integer,
  "resourcesExcludedCount": integer,
  "resourcesFailedCount": integer,
  "volumesRestoredCount": integer,
  "etag": string
}
Champs
name

string

Uniquement en sortie. Nom complet de la ressource Restore. Format : projects/*/locations/*/restorePlans/*/restores/*
uid

string

Uniquement en sortie. Identifiant unique global généré par le serveur au format UUID.
createTime

string (Timestamp format)

Uniquement en sortie. Horodatage lors de la création de cette ressource Restore.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
updateTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la dernière mise à jour de la ressource Restore.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
description

string

Chaîne descriptive spécifiée par l'utilisateur pour cette restauration.
backup

string

Obligatoire. Immuable. Référence à l'objet Backup utilisé en tant que source à partir de laquelle cette ressource Restore sera restaurée. Notez que cette sauvegarde doit être une sous-ressource de l'élément backupPlan de la ressource RestorePlan. Format : projects/*/locations/*/backupPlans/*/backups/*.
cluster

string

Uniquement en sortie. Cluster cible dans lequel cette ressource Restore restaurera les données. Formats valides :

  • projects/*/locations/*/clusters/*
  • projects/*/zones/*/clusters/*

Hérité de la valeur cluster du parent RestorePlan.
restoreConfig

object (RestoreConfig)

Uniquement en sortie. Configuration de la ressource Restore. Hérité du restoreConfig du parent RestorePlan.
labels

map (key: string, value: string)

Ensemble d'étiquettes personnalisées fournies par l'utilisateur.

Objet contenant une liste de paires "key": value. Exemple : { "name": "wrench", "mass": "1.3kg", "count": "3" }.
state

enum (State)

Uniquement en sortie. État actuel de la ressource Restore.
stateReason

string

Uniquement en sortie. Description lisible des raisons pour lesquelles la ressource Restore est dans son état actuel.
completeTime

string (Timestamp format)

Uniquement en sortie. Horodatage de la fin de l'opération de restauration.

Horodatage au format RFC3339 UTC "Zulu", avec une résolution de l'ordre de la nanoseconde et jusqu'à neuf chiffres décimaux. Exemples : "2014-10-02T15:01:23Z" et "2014-10-02T15:01:23.045123456Z".
resourcesRestoredCount

integer

Uniquement en sortie. Nombre de ressources restaurées pendant l'exécution de la restauration.
resourcesExcludedCount

integer

Uniquement en sortie. Nombre de ressources exclues lors de l'exécution de la restauration.
resourcesFailedCount

integer

Uniquement en sortie. Nombre de ressources dont la restauration a échoué lors de l'exécution de la restauration.
volumesRestoredCount

integer

Uniquement en sortie. Nombre de volumes restaurés pendant l'exécution de la restauration.
etag

string

Uniquement en sortie. etag permet d'effectuer un contrôle de simultanéité positive, pour éviter que les mises à jour simultanées d'une restauration ne s'écrasent les unes les autres. Afin d'éviter les situations de concurrence, il est fortement suggéré que les systèmes utilisent etag dans le cycle lecture-modification-écriture pour effectuer des mises à jour de restaurations : un etag est renvoyé dans la réponse à restores.get, et les systèmes doivent mettre cet élément dans la requête destinée à restores.patch ou restores.delete de sorte à s'assurer que leur modification sera appliquée à la même version de la stratégie.

État

Valeurs possibles pour l'état de la ressource Restore.

Enums
STATE_UNSPECIFIED La ressource Restore est en cours de création.
CREATING La ressource Restore a été créée et la ressource Kubernetes RestoreJob associée a été injectée dans le cluster cible.
IN_PROGRESS L'agent gkebackup du cluster a commencé à exécuter l'opération de restauration.
SUCCEEDED L'opération de restauration a bien été effectuée. Les charges de travail restaurées ne sont peut-être pas encore opérationnelles.
FAILED Échec de l'opération de restauration.
DELETING Cette ressource Restore est en cours de suppression.

Méthodes

create

 Crée une ressource Restore pour le RestorePlan donné.

delete

 Supprime une ressource Restore existante.

get

 Récupère les détails d'une seule ressource Restore.

getIamPolicy

 Récupère la stratégie de contrôle d'accès d'une ressource.

list

 Répertorie les ressources Restore pour un RestorePlan donné.

patch

 Mettre à jour une ressource Restore.

setIamPolicy

 Définit la stratégie de contrôle d'accès de la ressource spécifiée.

testIamPermissions

 Renvoie les autorisations qu'un appelant a sur la ressource spécifiée.