KRM API backup.gdc.goog/v1

backup.gdc.goog/v1

Sauvegarde

Définit le schéma de l'API Backup.

Apparaît dans :BackupList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind Backup
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec BackupSpec
status BackupStatus

BackupConfig

Représente un type de message interne qui définit la configuration de la création d'une sauvegarde à partir de ce plan de sauvegarde.

Apparaît dans : - BackupPlanSpec - BackupSpec

Champ Description
backupScope BackupScope Champ d'application de la sélection des ressources d'une sauvegarde. Par exemple, all_namespaces, les espaces de noms sélectionnés et les applications sélectionnées. Vous devez spécifier une seule valeur pour backup_scope. La valeur BackupScope doit être l'un des types suivants : BackupConfig_AllNamespaces, BackupConfig_SelectedNamespaces ou BackupConfig_SelectedApplications.
chaîne backupRepository Nom de la ressource BackupRepository identifiant le stockage secondaire pour cette ressource BackupPlan.
includeVolumeData booléen Indique si les données de volume sont sauvegardées. Si cette valeur n'est pas définie, la valeur par défaut est False.
includeSecrets booléen Indique si les secrets sont sauvegardés. Si cette valeur n'est pas définie, la valeur par défaut est False.
encryptionKey EncryptionKey Une clé de chiffrement. Ce champ n'est pas modifiable.
volumeStrategy VolumeStrategy Compromis à faire lors de la sauvegarde des volumes.

BackupInfo

Représente le nom et l'état d'une sauvegarde dans le champ RecentBackups .

Apparaît dans :BackupPlanStatus

Champ Description
chaîne name Nom de la sauvegarde.
state BackupState État de la sauvegarde la plus récente.

BackupList

Contient une liste de sauvegardes.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind BackupList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau Backup items

BackupPlan

Définit le schéma de l'API BackupPlan.

Apparaît dans : - BackupPlanList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind BackupPlan
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec BackupPlanSpec
status BackupPlanStatus

BackupPlanList

Contient une liste de plans de sauvegarde.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind BackupPlanList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau BackupPlan items

BackupPlanSpec

Définit l'état souhaité d'un plan de sauvegarde.

Apparaît dans :BackupPlan

Champ Description
chaîne clusterName Nom du cluster contenant les données sauvegardées par ce plan de sauvegarde. Par défaut, il s'agit du cluster dans lequel ce plan de sauvegarde est créé.
backupSchedule Programmer Création de sauvegardes planifiées dans ce plan de sauvegarde.
backupConfig BackupConfig Configuration de sauvegarde de ce plan de sauvegarde.
retentionPolicy RetentionPolicy Cycle de vie des sauvegardes créées dans le cadre de ce plan.
chaîne description Chaîne descriptive spécifiée par l'utilisateur pour ce plan de sauvegarde.
deactivated booléen Indique si le forfait a été désactivé. Si vous définissez ce champ sur "True", le forfait est verrouillé. Aucune autre modification n'est autorisée, y compris dans le champ "Désactivé". Cela empêche également la création de nouvelles sauvegardes dans ce forfait, qu'elles soient manuelles ou planifiées. La valeur par défaut est "False".

BackupPlanStatus

Définit l'état observé d'un plan de sauvegarde.

Apparaît dans :BackupPlan

Champ Description
lastBackupTime Heure Code temporel de la sauvegarde la plus récente.
nextBackupTime Heure Code temporel de la prochaine sauvegarde planifiée.
state État État actuel du forfait de sauvegarde.
lastBackupState BackupState État de la sauvegarde la plus récente.
chaîne lastBackupStateReason Description lisible des raisons pour lesquelles la dernière sauvegarde est dans l'état actuel.
errorStatus ErrorStatus Les erreurs les plus récentes avec les heures observées incluses.
Tableau Condition conditions "Conditions" représente les observations de l'état actuel de ce plan de sauvegarde.
Tableau BackupInfo recentBackups Sauvegardes les plus récentes créées par le plan de sauvegarde.

BackupRepository

Définit le schéma de l'API BackupRepository.

Apparaît dans :BackupRepositoryList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind BackupRepository
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec BackupRepositorySpec
status BackupRepositoryStatus

BackupRepositoryList

Contient une liste de ressources de dépôt de sauvegarde.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind BackupRepositoryList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items Tableau BackupRepository

BackupRepositoryManager

BackupRepositoryManager est le schéma de l'API backuprepositorymanagers.

Apparaît dans :BackupRepositoryManagerList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind BackupRepositoryManager
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec BackupRepositoryManagerSpec
status BackupRepositoryManagerStatus

BackupRepositoryManagerList

BackupRepositoryManagerList contient une liste de BackupRepositoryManager

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind BackupRepositoryManagerList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau BackupRepositoryManager items

BackupRepositoryManagerSpec

BackupRepositoryManagerSpec définit l'état souhaité de BackupRepositoryManager.

Apparaît dans :BackupRepositoryManager

Champ Description
backupRepositorySpec BackupRepositorySpec BackupRepositorySpec contient tous les détails nécessaires pour créer un dépôt de sauvegarde dans un cluster d'utilisateur. Notez que le champ ImportPolicy de BackupRepositorySpec ne sera pas respecté ici. Le BackupRepository créé sera "ReadWrite" si le cluster dans lequel il est créé est le ReadWriteCluster. Il sera défini sur "ReadOnly" si le cluster dans lequel il est créé figure dans la liste ReadOnlyClusters. Ce champ n'est pas modifiable.
readWriteCluster NamespacedName ReadWriteCluster spécifie le cluster unique (baremetal.cluster.gke.io/Cluster) autorisé à créer un dépôt de sauvegarde ReadWrite à l'aide des données du champ BackupRepositorySpec. Un dépôt ReadWrite peut être utilisé pour planifier/créer des sauvegardes, des plans de sauvegarde et des restaurations. Il appartient effectivement au cluster dans lequel il est créé. REMARQUE : Un BackupRepository ne peut être utilisé en lecture/écriture que par un seul cluster k8s. Ce champ est modifiable.
readOnlyClusters Tableau NamespacedName ReadOnlyClusters spécifie la liste des clusters (baremetal.cluster.gke.io/Cluster) autorisés à créer un dépôt de sauvegarde en lecture seule à l'aide des données du champ BackupRepositorySpec. Un dépôt ReadOnly ne peut être utilisé que pour importer et afficher des sauvegardes. Vous ne pouvez pas créer de sauvegardes ni de ressources dans ce dépôt, mais vous pouvez utiliser et référencer des sauvegardes en lecture seule pour la restauration. Destiné à importer des sauvegardes depuis un autre cluster pour une restauration inter-clusters. Il n'y a aucune restriction sur la fréquence à laquelle un BackupRepository peut être utilisé en lecture seule. Ce champ est modifiable.

BackupRepositoryManagerStatus

BackupRepositoryManagerStatus définit l'état observé de BackupRepositoryManager.

Apparaît dans :BackupRepositoryManager

Champ Description
Entier backupCount BackupCount correspond au nombre total de sauvegardes créées dans le bucket de stockage vers lequel pointe BackupRepositorySpec.
Entier backupPlanCount BackupPlanCount correspond au nombre total de plans de sauvegarde créés dans le bucket de stockage vers lequel pointe BackupRepositorySpec.
Entier restoreCount RestoreCount correspond au nombre total de restaurations créées dans le bucket de stockage vers lequel pointe BackupRepositorySpec.
Entier restorePlanCount RestorePlanCount correspond au nombre total de plans de restauration créés dans le bucket de stockage vers lequel pointe BackupRepositorySpec.
Tableau ClusterStatus clusterStatuses "ClusterStatuses" contient l'état actuel de la création du dépôt de sauvegarde souhaité dans chaque cluster. La liste contient une entrée pour tous les clusters spécifiés dans la liste ReadOnlyClusters, ainsi que pour le ReadWriteCluster. La création réussie d'un dépôt de sauvegarde dans un cluster est indiquée par l'entrée correspondante dans le tableau ClusterStatuses, dont la condition "Ready" est définie sur "True". Dans le cas contraire, elle est définie sur "False".
conditions Condition Les conditions indiquent si le gestionnaire de dépôts de sauvegarde et les dépôts de sauvegarde qu'il a créés sont en bon état.
errorStatus ErrorStatus Les erreurs les plus récentes issues du rapprochement avec les heures observées sont incluses.

BackupRepositorySpec

Définit l'état souhaité du dépôt de sauvegarde.

Apparaît dans :BackupRepository

Champ Description
secretReference SecretReference Référence à un code secret d'accès qui dépend du système de stockage de votre choix. Ce secret est utilisé pour les requêtes envoyées à ce point de terminaison. Par exemple, un secret d'accès S3.
chaîne endpoint Point de terminaison utilisé pour accéder au dépôt de sauvegarde. Dans le cas de Google Private Cloud, il s'agit du point de terminaison S3 qui permet d'accéder au projet locataire.
type RepositoryType Type de dépôt de sauvegarde. Par exemple, S3 ou Google Cloud Storage. indique à l'agent le système de stockage ou l'API à utiliser.
s3Options S3Options Données utilisées pour configurer l'accès à une ressource BackupRepo compatible avec S3.
importPolicy ImportPolicy Règle qui détermine si ce dépôt de sauvegarde est en lecture seule ou en lecture/écriture.
importSubstitution ImportSubstitution Ce champ détermine s'il faut remplacer le nom du dépôt de sauvegarde des ressources importées par ce nom de dépôt de sauvegarde.
force booléen Spécifie l'action qu'un dépôt de sauvegarde en lecture et écriture effectue si le bucket de stockage avec lequel il est initialisé a déjà été revendiqué par un autre dépôt de sauvegarde. Si la valeur est True, le nouveau dépôt de sauvegarde revendique toujours la propriété du bucket de stockage en remplaçant le fichier sentinelle existant par le sien. Si la valeur est False, la création du nouveau dépôt de sauvegarde échoue et une erreur s'affiche. La valeur par défaut est False. Cette option ne doit être utilisée que si le fichier sentinelle remplacé ne dispose plus de dépôt de sauvegarde. Dans le cas contraire, ce dépôt de sauvegarde passe à l'état d'erreur, ce qui peut entraîner des effets secondaires indésirables.

BackupRepositoryStatus

Définit l'état observé d'un dépôt de sauvegarde.

Apparaît dans :BackupRepository

Champ Description
chaîne sentinelEtag Champ qui associe un dépôt de sauvegarde au fichier sentinelle dont il est propriétaire.
reconciliationError ReconciliationError Erreurs survenues lors de la dernière tentative de réconciliation pour le dépôt de sauvegarde.
chaîne reconciliationErrorMessage Messages d'erreur qui ont pu se produire lors du rapprochement.
errorStatus ErrorStatus Les erreurs les plus récentes issues du rapprochement avec les heures observées sont incluses.
initialImportDone booléen Indique si l'importation initiale de ce dépôt de sauvegarde est terminée ou non.
Tableau Condition conditions "Conditions" représente les observations de l'état actuel de ce dépôt de sauvegarde. Types de conditions connus : prêt.

BackupRetentionPolicy

Représente la règle de conservation d'une sauvegarde.

Apparaît dans : - ClusterBackupSpec

Champ Description
Entier deleteLockDays Nombre de jours à partir de la création de cette sauvegarde pour lesquels la suppression est bloquée. Pour les sauvegardes créées automatiquement à partir d'une planification de sauvegarde, ce champ est défini sur la valeur ClusterBackupPlan.RetentionPolicy.backup_delete_block_days. Pour les sauvegardes créées manuellement et pour lesquelles ce champ n'est pas spécifié, le service attribue la valeur ClusterBackupPlan.RetentionPolicy.backup_delete_block_days. Si une sauvegarde est créée et que la valeur de ce champ est inférieure à celle de ClusterBackupPlan.RetentionPolicy.backup_delete_block_days, le service renvoie une réponse non valide. Ce champ doit être une valeur entière comprise entre 0-90. Ce champ ne doit être incrémenté que par une requête de mise à jour. Dans le cas contraire, le service renvoie une réponse non valide. Notez que ce champ ne s'applique qu'aux sauvegardes dont l'état est Succeeded.
Entier retainDays Nombre de jours pendant lesquels conserver la sauvegarde de ce cluster, après quoi elle sera automatiquement supprimée. Elle est calculée à partir de la valeur create_time de la sauvegarde du cluster. Si ce champ n'est pas spécifié ou s'il est défini sur 0, cela signifie que la sauvegarde n'est pas supprimée automatiquement. Pour les sauvegardes de cluster créées automatiquement à partir d'une planification, ce champ est défini sur la valeur ClusterBackupPlan.RetentionPolicy.backup_retain_days. Pour les sauvegardes créées manuellement et pour lesquelles ce champ n'est pas spécifié, le service attribue la valeur ClusterBackupPlan.RetentionPolicy.backup_retain_days. Si une sauvegarde est créée avec une valeur de ce champ inférieure à celle de delete_lock_days, le service renvoie une réponse non valide. Ce champ ne doit être incrémenté que par une requête de mise à jour. Dans le cas contraire, le service renvoie une réponse non valide.

BackupScope

Définit les espaces de noms et les applications à sauvegarder.

Apparaît dans :BackupConfig, RestoreConfig

Champ Description
allNamespaces booléen Indique si tous les espaces de noms sont sauvegardés. Si la valeur est définie sur True, cela indique que tous les espaces de noms doivent être sauvegardés.
selectedNamespaces Espaces de noms Liste des espaces de noms à sauvegarder.
selectedApplications NamespacedNames Liste des applications à sauvegarder.

BackupSpec

Définit l'état souhaité de la sauvegarde.

Apparaît dans :Sauvegarde

Champ Description
chaîne clusterName Nom du cluster sauvegardé. Par défaut, il s'agit du cluster dans lequel cette sauvegarde est créée.
chaîne backupPlanName Nom du plan de sauvegarde à partir duquel cette sauvegarde a été créée.
backupConfig BackupConfig Configuration utilisée lorsque cette sauvegarde est générée à partir du plan de sauvegarde donné. Cette valeur doit être copiée à partir du plan de sauvegarde à l'origine de cette sauvegarde, et non à partir d'une référence. Ce champ ne doit pas être défini par l'utilisateur, mais uniquement par le planificateur de forfaits de sauvegarde et la ressource ManualBackupRequest.
chaîne description Description facultative de la sauvegarde (chaîne). Ce champ n'a aucune incidence sur le fonctionnement.
manual booléen Indique si la ressource de sauvegarde a été créée manuellement. Si la valeur est True, cette sauvegarde a été créée manuellement. Si la valeur est False, cette sauvegarde a été créée automatiquement à partir du calendrier du plan de sauvegarde.
Entier deleteLockDays Nombre de jours à partir de la create_time de cette sauvegarde pendant lesquels la suppression est bloquée. Pour les sauvegardes créées automatiquement à partir d'une planification de sauvegarde, ce champ est défini sur la valeur BackupPlan.RetentionPolicy.backup_delete_block_days. Pour les sauvegardes créées manuellement et pour lesquelles ce champ n'est pas spécifié, le service attribue la valeur BackupPlan.RetentionPolicy.backup_delete_block_days. Si une sauvegarde est créée et que la valeur de ce champ est inférieure à celle de BackupPlan.RetentionPolicy.backup_delete_block_days, le service renvoie une réponse non valide. Ce champ doit être une valeur entière comprise entre 0-90. Ce champ ne doit être incrémenté que par une requête de mise à jour. Dans le cas contraire, le service renvoie une réponse non valide. Notez que ce champ ne s'applique qu'aux sauvegardes dont l'état est Succeeded. Valeur par défaut : 0
Entier retainDays Nombre de jours pendant lesquels cette sauvegarde doit être conservée avant d'être automatiquement supprimée. Elle est calculée à partir de la create_time de la sauvegarde. Si ce champ n'est pas spécifié ou s'il est défini sur 0, cela signifie que la sauvegarde n'est pas supprimée automatiquement. Pour les sauvegardes créées automatiquement à partir d'une planification de sauvegarde, la valeur BackupPlan.RetentionPolicy.backup_retain_days est attribuée à ce champ. Pour les sauvegardes créées manuellement et pour lesquelles ce champ n'est pas spécifié, le service attribue la valeur BackupPlan.RetentionPolicy.backup_retain_days. Si une sauvegarde est créée avec une valeur de ce champ inférieure à celle de delete_lock_days, le service renvoie une réponse non valide. Ce champ ne doit être incrémenté que par une requête de mise à jour. Dans le cas contraire, le service renvoie une réponse non valide. Valeur par défaut : 0

BackupStatus

Définit l'état observé d'une sauvegarde.

Apparaît dans :Sauvegarde

Champ Description
clusterMetadata ClusterMetadata Métadonnées du cluster.
jobCreated booléen Indique si un job de sauvegarde a été créé pour cette sauvegarde.
state BackupState État actuel de la sauvegarde.
chaîne reason Description lisible des raisons pour lesquelles la sauvegarde est dans l'état actuel.
errorStatus ErrorStatus Les erreurs les plus récentes avec les heures observées incluses.
Tableau Condition conditions "Conditions" représente les observations de l'état actuel de cette sauvegarde. Types de conditions connus : réussie
createTime Heure Horodatage de la création de cette ressource de sauvegarde. Il peut être converti à partir de RFC 3339 et en RFC 3339.
updateTime Heure Horodatage de la dernière mise à jour de ce plan de sauvegarde. Il peut être converti à partir de RFC 3339 et en RFC 3339.
Entier resourceCount Nombre total de ressources sauvegardées.
Entier volumeCount Nombre total de volumes sauvegardés.
Entier sizeBytes Taille totale, mesurée en octets.
Entier podCount Nombre total de pods de charge de travail sauvegardés.
Entier systemPodCount Nombre total de pods système sauvegardés. Ces pods sont exclus de la facturation.
Entier vmCount Nombre total de machines virtuelles sauvegardées.
deleteLockExpireTime Heure Heure d'expiration du verrou de suppression. Il s'agit d'un champ de sortie uniquement, calculé à partir de la valeur combinée de create_time et delete_lock_days. Il est mis à jour en conséquence lorsque le champ delete_lock_days d'une sauvegarde est modifié. Notez que ce champ ne s'applique qu'aux sauvegardes dont l'état est Succeeded.
retainExpireTime Heure Heure à laquelle la sauvegarde est automatiquement supprimée. Il s'agit d'un champ de sortie uniquement, calculé à partir de la valeur combinée de create_time et retain_days. Il est mis à jour en conséquence lorsque le champ retain_days d'une sauvegarde est modifié.
completeTime Heure Heure de fin de la sauvegarde.

ClusterBackup

Apparaît dans :ClusterBackupList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterBackup
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ClusterBackupSpec
status ClusterBackupStatus

ClusterBackupConfig

Représente un type de message interne qui définit la configuration de la création d'une sauvegarde à partir de ce plan de sauvegarde.

Apparaît dans :ClusterBackupPlanSpec, ClusterBackupSpec

Champ Description
backupScope BackupScope Champ d'application de la sélection des ressources d'une sauvegarde. Par exemple, all_namespaces, les espaces de noms sélectionnés et les applications sélectionnées. Vous devez spécifier une seule valeur pour backup_scope. La valeur BackupScope doit être l'un des types suivants : BackupConfig_AllNamespaces, BackupConfig_SelectedNamespaces ou BackupConfig_SelectedApplications.
chaîne backupRepositoryName Nom de la ressource BackupRepositoryRef identifiant le stockage secondaire pour cette ressource ClusterBackupPlan.
chaîne clusterBackupRepositoryName Nom de la ressource ClusterBackupRepositoryRef identifiant le stockage secondaire pour cette ressource ClusterBackupPlan.
includeVolumeData booléen Indique si les données de volume sont sauvegardées. Si cette valeur n'est pas définie, la valeur par défaut est false.
includeSecrets booléen Indique si les secrets sont sauvegardés. Si cette valeur n'est pas définie, la valeur par défaut est false.
volumeStrategy VolumeStrategy Type de sauvegarde de volume à effectuer.

ClusterBackupList

Représente une liste de sauvegardes de cluster.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterBackupList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau ClusterBackup items

ClusterBackupPlan

Apparaît dans : - ClusterBackupPlanList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterBackupPlan
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ClusterBackupPlanSpec
status BackupPlanStatus

ClusterBackupPlanList

Représente une liste de ClusterBackups

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterBackupPlanList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items ClusterBackupPlan

ClusterBackupPlanSpec

Représente une API qui encapsule la ressource personnalisée backupv1.BackupPlan. Ils sont presque identiques, mais certains champs sont omis de manière sélective.

Apparaît dans :ClusterBackupPlan

Champ Description
targetCluster TargetCluster Cluster qui sera sauvegardé.
backupSchedule Programmer Création de sauvegardes planifiées dans ce plan de sauvegarde.
clusterBackupConfig ClusterBackupConfig Configuration de sauvegarde de ce plan de sauvegarde.
retentionPolicy RetentionPolicy Cycle de vie des sauvegardes créées dans le cadre de ce plan.
chaîne description Chaîne descriptive spécifiée par l'utilisateur pour ce plan de sauvegarde.
deactivated booléen Indique si le forfait a été désactivé. Si vous définissez ce champ sur "true", le forfait est verrouillé. Aucune autre modification n'est autorisée, y compris dans le champ "désactivé". Cela empêche également la création de nouvelles sauvegardes dans ce forfait, qu'elles soient manuelles ou planifiées. La valeur par défaut est "false".

ClusterBackupRepository

Définit le schéma de l'API ClusterBackupRepository.

Apparaît dans : - ClusterBackupRepositoryList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterBackupRepository
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ClusterBackupRepositorySpec
status ClusterBackupRepositoryStatus

ClusterBackupRepositoryList

Contient une liste de ressources ClusterBackupRepository.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterBackupRepositoryList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items Tableau ClusterBackupRepository

ClusterBackupRepositorySpec

Définit l'état souhaité de la ressource ClusterBackupRepositorySpec.

Apparaît dans :ClusterBackupRepository

Champ Description
secretReference SecretReference Référence à un code secret d'accès qui dépend du système de stockage de votre choix. Ce secret est utilisé pour les requêtes envoyées à ce point de terminaison. Par exemple, un secret d'accès S3.
chaîne endpoint Point de terminaison utilisé pour accéder au dépôt de sauvegarde du cluster.
type RepositoryType Type de dépôt de sauvegarde du cluster. Par exemple, S3 ou Google Cloud Storage. indique à l'agent le système de stockage ou l'API à utiliser.
s3Options S3Options Données utilisées pour configurer l'accès à une ressource BackupRepo compatible avec S3.
importPolicy ImportPolicy Règle qui détermine si ce dépôt de sauvegarde est en lecture seule ou en lecture/écriture.
force booléen Spécifie l'action qu'un dépôt de sauvegarde en lecture et écriture effectue si le bucket de stockage avec lequel il est initialisé a déjà été revendiqué par un autre dépôt de sauvegarde. Si la valeur est True, le nouveau dépôt de sauvegarde revendique toujours la propriété du bucket de stockage en remplaçant le fichier sentinelle existant par le sien. Si la valeur est False, la création du nouveau dépôt de sauvegarde échoue et une erreur s'affiche. La valeur par défaut est False. Cette option ne doit être utilisée que si le fichier sentinelle remplacé ne dispose plus de dépôt de sauvegarde. Dans le cas contraire, ce dépôt de sauvegarde passe à l'état d'erreur, ce qui peut entraîner des effets secondaires indésirables.

ClusterBackupRepositoryStatus

Définit l'état observé de la ressource ClusterBackupRepository.

Apparaît dans :ClusterBackupRepository

Champ Description
chaîne sentinelEtag Champ qui associe un dépôt de sauvegarde au fichier sentinelle dont il est propriétaire.
reconciliationError ReconciliationError Erreurs survenues lors de la dernière tentative de réconciliation pour le dépôt de sauvegarde.
chaîne reconciliationErrorMessage Messages d'erreur qui ont pu se produire lors du rapprochement.
errorStatus ErrorStatus Les erreurs les plus récentes issues du rapprochement avec les heures observées sont incluses.
Tableau Condition conditions Spécifie l'état du dépôt de sauvegarde du cluster. Les conditions acceptées incluent InitialImportDone, Ready et Deprecated.

ClusterBackupSpec

Représente une API qui encapsule la ressource personnalisée backupv1.Backup. Ils sont presque identiques, mais certains champs sont omis de manière sélective.

Apparaît dans :ClusterBackup

Champ Description
targetCluster TargetCluster Nom du cluster qui sera sauvegardé.
chaîne clusterBackupPlanName Nom du plan de sauvegarde du cluster à partir duquel cette sauvegarde a été créée.
backupConfig ClusterBackupConfig Configuration utilisée lorsque cette sauvegarde est générée à partir du plan de sauvegarde donné. Cette valeur doit être copiée à partir du plan de sauvegarde du cluster par lequel cette sauvegarde de cluster a été générée, et non à partir d'une référence. Ce champ ne doit pas être défini par l'utilisateur, mais uniquement par le planificateur de forfaits de sauvegarde et la ressource ManualBackupRequest.
chaîne description Description facultative de la sauvegarde sous forme de chaîne. Ce champ n'a aucune incidence sur le fonctionnement.
manual booléen Indique si la ressource de sauvegarde du cluster a été créée manuellement. Si la valeur est True, cette sauvegarde a été créée manuellement. Si la valeur est False, cette sauvegarde de cluster a été créée automatiquement à partir du calendrier du plan de sauvegarde.
retentionPolicy BackupRetentionPolicy Règle de conservation pour la sauvegarde.

ClusterBackupStatus

Définit l'état observé d'une sauvegarde de cluster.

Apparaît dans :ClusterBackup

Champ Description
clusterMetadata ClusterMetadata Métadonnées du cluster.
Tableau Condition conditions Spécifie l'état de la sauvegarde du cluster. Les conditions acceptées incluent JobCreated et Succeeded.
jobCreated booléen Indique si un job de sauvegarde a été créé pour cette sauvegarde de cluster.
state BackupState État actuel de la sauvegarde du cluster.
chaîne stateReason Description lisible des raisons pour lesquelles la sauvegarde est dans l'état actuel.
errorStatus ErrorStatus Les erreurs les plus récentes avec les heures observées incluses.
createTime Heure Horodatage de la création de cette ressource de sauvegarde. Il peut être converti à partir de RFC 3339 et en RFC 3339.
updateTime Heure Horodatage de la dernière mise à jour de cette sauvegarde de cluster. Il peut être converti à partir de RFC 3339 et en RFC 3339.
Entier resourceCount Nombre total de ressources sauvegardées.
Entier volumeCount Nombre total de volumes sauvegardés.
Entier sizeBytes Taille totale, mesurée en octets.
Entier podCount Nombre total de pods de charge de travail sauvegardés.
deleteLockExpireTime Heure Heure d'expiration du verrou de suppression. Il s'agit d'un champ de sortie uniquement, calculé à partir de la valeur combinée de create_time et delete_lock_days. Il est mis à jour en conséquence lorsque le champ delete_lock_days d'une sauvegarde de cluster est modifié. Notez que ce champ ne s'applique qu'aux sauvegardes de cluster dont l'état est Succeeded.
retainExpireTime Heure Heure à laquelle la sauvegarde du cluster est automatiquement supprimée. Il s'agit d'un champ de sortie uniquement, calculé à partir de la valeur combinée de create_time et retain_days. Il est mis à jour en conséquence lorsque le champ retain_days d'une sauvegarde de cluster est modifié.
completeTime Heure Heure de fin de la sauvegarde du cluster.

ClusterMetadata

Représente les métadonnées du cluster.

Apparaît dans :BackupStatus

Champ Description
chaîne clusterName Nom du cluster source à partir duquel la sauvegarde a été créée.
chaîne k8sVersion Version du serveur Kubernetes.
platformVersion PlatformVersion Types de versions de plate-forme pouvant être attribués à PlatformVersion. Par exemple, GpcVersion.

ClusterResourceConflictPolicy

Type sous-jacent : string Comportement de restauration des ressources de cluster sans espace de noms à suivre en cas de conflit.

Apparaît dans :RestoreConfig, RestorePolicies

ClusterResourceSelection

Représente la sélection de ressources sans espace de noms à restaurer.

Apparaît dans : - RestoreConfig - RestoreResourceSelection

Champ Description
Tableau GroupKind selectedGroupKinds Liste des ressources GroupKind. Une ressource sans espace de noms doit être incluse dans la liste des ressources GroupKind spécifiées. Notez que même si les ressources PersistentVolume ne sont pas associées à un espace de noms, elles sont traitées séparément. Pour en savoir plus, consultez VolumeDataRestorePolicy. La spécification d'un PersistentVolume GroupKind dans cette liste n'a aucune incidence sur la restauration ou non d'un PersistentVolume.

ClusterRestore

Définit le schéma de l'API ClusterRestore.

Apparaît dans : - ClusterRestoreList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterRestore
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ClusterRestoreSpec
status ClusterRestoreStatus

ClusterRestoreConfig

Définit la configuration d'un ClusterRestore.

Apparaît dans : - ClusterRestorePlanSpec - ClusterRestoreSpec

Champ Description
volumeDataRestorePolicy VolumeDataRestorePolicy Règle à utiliser pour la restauration des données de volume. Fournit une valeur par défaut de NO_VOLUME_DATA_RESTORATION si aucune valeur n'est spécifiée.
clusterResourceConflictPolicy ClusterResourceConflictPolicy Règle qui résout les conflits lors de la restauration des ressources à l'échelle du cluster. Cette requête n'est pas valide si ce champ a une valeur de CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED et que cluster_resource_restore_scope est spécifié.
namespacedResourceRestoreMode NamespacedResourceRestoreMode Mode de restauration à utiliser pour les ressources d'espace de noms. La requête n'est pas valide si ce champ a une valeur de NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED et que namespaced_resource_restore_scope est spécifié.
clusterResources ClusterResourceSelection Ressources sans espace de noms à restaurer. Si ce champ n'est pas spécifié, aucune ressource de cluster n'est restaurée. Notez que même si les ressources PersistentVolume ne sont pas associées à un espace de noms, elles sont traitées séparément. Pour en savoir plus, consultez la ressource VolumeDataRestorePolicy. La spécification d'un PersistentVolume GroupKind dans cette liste ne détermine pas si un PersistentVolume est restauré.
Tableau GroupKind namespacedResourceAllowlist Ressources en espace de noms spécifiques à restaurer. Si elle est définie, seules les ressources définies dans cette allowlist sont restaurées.
namespacedResourceRestoreScope BackupScope Ressources d'espace de noms sélectionnées à restaurer. L'une des entrées doit être spécifiée avec un Type valide. Les valeurs Type valides pouvant être attribuées à restoreScope sont AllNamespaces, SelectedNamespaces ou SelectedApplications.
Tableau SubstitutionRule substitutionRules Règles suivies lors de la substitution des ressources Kubernetes sauvegardées. Une liste vide signifie qu'aucune substitution n'aura lieu. Les règles de substitution sont appliquées de manière séquentielle dans l'ordre défini. Cet ordre est important, car les modifications apportées par une règle peuvent avoir un impact sur la logique de correspondance de la règle suivante. Vous ne pouvez spécifier qu'un seul élément SubstitutionRules ou TransformationRules pour une opération de restauration donnée.
Tableau TransformationRule transformationRules Règles suivies lors de la transformation des ressources Kubernetes sauvegardées. Une liste vide signifie qu'aucune transformation n'aura lieu. Les règles de transformation sont appliquées de manière séquentielle dans l'ordre défini. Cet ordre est important, car les modifications apportées par une règle peuvent avoir un impact sur la logique de correspondance d'une règle ultérieure. Vous ne pouvez spécifier qu'un seul élément SubstitutionRules ou TransformationRules pour une opération de restauration donnée.
chaîne clusterBackupRepositoryRef Nom du dépôt de sauvegarde du cluster qui identifie le dépôt pour la ressource de restauration. Ce champ doit être associé en mode lecture/écriture. Si ce champ n'est pas fourni, il sera sélectionné selon la logique suivante : 1. Si la sauvegarde à partir de laquelle nous effectuons la restauration pointe vers un dépôt en lecture/écriture dans le cluster actuel, ce dépôt est sélectionné. 2. Si la sauvegarde à partir de laquelle nous effectuons une restauration pointe vers un dépôt en lecture seule, un dépôt en lecture et écriture du cluster est sélectionné et utilisé.

ClusterRestoreList

Représente une liste de restaurations de clusters.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterRestoreList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau ClusterRestore items

ClusterRestorePlan

Définit le schéma de l'API ClusterRestorePlan.

Apparaît dans :ClusterRestorePlanList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterRestorePlan
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ClusterRestorePlanSpec
status RestorePlanStatus

ClusterRestorePlanList

Représente une liste de ressources ClusterRestorePlan.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterRestorePlanList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items ClusterRestorePlan

ClusterRestorePlanSpec

Représente une API qui encapsule la ressource personnalisée backupv1.RestorePlan. Ils sont presque identiques, mais certains champs sont omis de manière sélective. Définit l'état souhaité de "ClusterRestorePlan".

Apparaît dans :ClusterRestorePlan

Champ Description
targetCluster TargetCluster Cluster dans lequel les données seront restaurées.
chaîne clusterBackupPlanName Nom du plan de sauvegarde de cluster à partir duquel les sauvegardes de cluster peuvent être utilisées comme source pour les restaurations de cluster créées à l'aide de ce ClusterRestorePlan. Ce champ est obligatoire et immuable.
ClusterRestoreConfig clusterRestoreConfig Configuration de la restauration du cluster pour ce plan de restauration de cluster.
chaîne description Chaîne descriptive spécifiée par l'utilisateur pour ce plan de restauration de cluster.

ClusterRestoreSpec

Représente une API qui encapsule la ressource personnalisée backupv1.Restore. Définit l'état souhaité d'un ClusterRestore.

Apparaît dans :ClusterRestore

Champ Description
targetCluster TargetCluster Cluster dans lequel les données seront restaurées.
chaîne clusterBackupName Nom de la sauvegarde du cluster, qui doit se trouver dans le même espace de noms que la restauration du cluster.
chaîne clusterRestorePlanName Nom du plan de restauration de cluster à partir duquel cette restauration de cluster a hérité de sa ressource ClusterRestoreConfig.
ClusterRestoreConfig clusterRestoreConfig Configuration de la restauration du cluster.
chaîne description Description facultative de la restauration du cluster. Cela n'a aucune incidence sur les fonctionnalités.
filter Filtre Le filtre peut être utilisé pour affiner davantage la sélection des ressources à restaurer dans le cluster au-delà du champ d'application à granularité large défini dans ClusterRestorePlan.

ClusterRestoreStatus

Définit l'état observé d'une restauration de cluster.

Apparaît dans :ClusterRestore

Champ Description
Tableau Condition conditions Spécifie l'état de la restauration du cluster. Les conditions acceptées incluent JobCreated et Succeeded.
state RestoreState État actuel de la restauration du cluster.
chaîne stateReason Description lisible des raisons pour lesquelles la restauration du cluster est dans l'état actuel.
errorStatus ErrorStatus Les erreurs les plus récentes avec les heures observées incluses.
Entier resourcesRestoredCount Nombre de ressources restaurées lors de cette action de restauration du cluster.
Entier resourcesExcludedCount Nombre de ressources exclues de cette action de restauration du cluster.
Entier resourcesFailedCount Nombre de ressources qui n'ont pas pu être restaurées lors de cette action de restauration du cluster.
Entier restoredVolumesCount Nombre de volumes restaurés lors de cette action de restauration de cluster.
startTime Heure Heure de création du processus de restauration du cluster.
completeTime Heure Heure de fin du processus de restauration du cluster.

ClusterStatus

ClusterStatus contient l'état de la création du dépôt de sauvegarde pour un cluster donné.

Apparaît dans :BackupRepositoryManagerStatus

Champ Description
cluster NamespacedName
Tableau Condition conditions

ClusterVolumeBackup

Définit le schéma de l'API ClusterVolumeBackup.

Apparaît dans :ClusterVolumeBackupList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterVolumeBackup
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ClusterVolumeBackupSpec
status ClusterVolumeBackupStatus

ClusterVolumeBackupList

Contient une liste de ressources ClusterVolumeBackup.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterVolumeBackupList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items Tableau ClusterVolumeBackup

ClusterVolumeBackupSpec

Définit l'état souhaité d'une sauvegarde de volume de cluster.

Apparaît dans :ClusterVolumeBackup

Champ Description
cluster TargetCluster Nom du cluster pour lequel cette sauvegarde de volume de cluster conserve les données.
chaîne clusterBackupName Nom de la sauvegarde associée. Chaque sauvegarde de volume de cluster doit être associée à une sauvegarde. Il se trouvera toujours dans le même espace de noms.
chaîne clusterBackupPlanName Nom du plan de sauvegarde à partir duquel la sauvegarde associée a été créée. Il se trouvera toujours dans le même espace de noms.
sourcePVC TypedObjectReference Demande de volume persistant source à partir de laquelle la sauvegarde du volume de cluster est effectuée.

ClusterVolumeBackupStatus

Définit l'état observé d'une sauvegarde de volume de cluster.

Apparaît dans :ClusterVolumeBackup

Champ Description
chaîne volumeBackupHandle Handle de sauvegarde de volume de cluster sous-jacent, qui identifie de manière unique une sauvegarde de volume de cluster dans un dépôt de sauvegarde. Ce handle n'a pas de format unifié et est traité comme une chaîne opaque.
format VolumeBackupFormat Format de sauvegarde de volume de cluster. Par exemple, PD, Portable, etc.
Entier storageBytes Taille de la sauvegarde du volume du cluster dans l'espace de stockage des sauvegardes. Pour les sauvegardes incrémentielles, cette valeur peut changer de manière dynamique si l'une des sauvegardes de volume précédentes a été supprimée.
Entier diskSizeBytes Taille minimale du disque sur lequel cette sauvegarde de volume peut être restaurée.
state VolumeBackupState État actuel de la sauvegarde du volume.
chaîne message Message lisible indiquant pourquoi la sauvegarde est dans cet état.
completeTime Heure Code temporel indiquant la date à laquelle cette ressource ClusterVolumeBackup a été terminée, au format texte RFC 3339.
Tableau Condition conditions Spécifie l'état de la sauvegarde du volume du cluster.

ClusterVolumeRestore

Représente une API qui encapsule la ressource personnalisée backupv1.VolumeRestore. Définit le schéma de l'API ClusterVolumeRestore.

Apparaît dans : - ClusterVolumeRestoreList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterVolumeRestore
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ClusterVolumeRestoreSpec
status VolumeRestoreStatus

ClusterVolumeRestoreList

Représente une liste de ressources ClusterVolumeRestore.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ClusterVolumeRestoreList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau ClusterVolumeRestore items

ClusterVolumeRestoreSpec

Définit l'état souhaité d'une restauration de volume de cluster.

Apparaît dans :ClusterVolumeRestore

Champ Description
targetCluster TargetCluster Nom du cluster dans lequel le volume sera restauré.
chaîne clusterRestoreName Nom de la ressource de restauration de cluster qui a créé cette restauration de volume de cluster.
chaîne clusterVolumeBackupName Nom de la ressource de sauvegarde du volume de cluster que nous restaurons.
targetPvc NamespacedName Ressource PersistentVolumeClaim cible à restaurer.

DeleteBackupRequest

Définit le schéma de l'API DeleteBackupRequest.

Apparaît dans :DeleteBackupRequestList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind DeleteBackupRequest
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec DeleteBackupRequestSpec
status DeleteBackupRequestStatus

DeleteBackupRequestList

Contient une liste de ressources DeleteBackupRequest.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind DeleteBackupRequestList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items Tableau DeleteBackupRequest

DeleteBackupRequestSpec

Définit l'état souhaité de la ressource DeleteBackupRequest.

Apparaît dans :DeleteBackupRequest

Champ Description
chaîne backupName Nom de la sauvegarde à supprimer. Notez que la sauvegarde doit exister dans le même espace de noms que la ressource DeleteBackupRequest.

DeleteBackupRequestStatus

Définit l'état observé de la ressource DeleteBackupRequest.

Apparaît dans :DeleteBackupRequest

Champ Description
timeToExpire Heure Heure d'expiration de la ressource.
statusField StatusFields État de l'état observé de la ressource DeleteBackupRequest.

DeleteClusterBackupRequest

Définit le schéma de l'API DeleteClusterBackupRequest.

Apparaît dans : - DeleteClusterBackupRequestList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind DeleteClusterBackupRequest
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec DeleteClusterBackupRequestSpec
status DeleteClusterBackupRequestStatus

DeleteClusterBackupRequestList

Contient une liste de ressources DeleteBackupRequest.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind DeleteClusterBackupRequestList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items DeleteClusterBackupRequest array

DeleteClusterBackupRequestSpec

Définit l'état souhaité de la ressource DeleteClusterBackupRequest.

Apparaît dans :DeleteClusterBackupRequest

Champ Description
chaîne clusterBackupRef Nom de la ressource ClusterBackup à supprimer. Notez que la ressource ClusterBackup doit exister dans le même espace de noms que la ressource DeleteClusterBackupRequest.

DeleteClusterBackupRequestStatus

Définit l'état observé de la ressource DeleteClusterBackupRequest.

Apparaît dans :DeleteClusterBackupRequest

Champ Description
timeToExpire Heure Heure d'expiration de la ressource.
statusField StatusFields État de l'état observé de la ressource DeleteClusterBackupRequest.

EncryptionKey

Définit une clé de chiffrement. Pour la version Preview, seuls les KMS Google Cloud Platform sont acceptés.

Apparaît dans :BackupConfig, RestoreConfig

Champ Description
chaîne gcpKMSEncryptionKey Clé de chiffrement Google KMS au format projects/<project>/locations/<location>/keyRings/<key-ring>/cryptoKeys/<key>.

Filtre

Définit le filtre de restauration ultraprécise.

Apparaît dans : - ManualRestoreRequestSpec - RestoreSpec

Champ Description
inclusionFilters Tableau ResourceSelector Sélectionne les ressources à restaurer. Si cette option est spécifiée, seules les ressources correspondant à inclusion_filters seront sélectionnées pour la restauration. Une ressource est sélectionnée si elle correspond à un ResourceSelector des inclusion_filters.
exclusionFilters Tableau ResourceSelector Exclut les ressources de la restauration. Si cette option est spécifiée, une ressource ne sera pas restaurée si elle correspond à un ResourceSelector des exclusion_filters.

ImportPolicy

Type sous-jacent : string Règle qui détermine si ce dépôt de sauvegarde est en lecture seule ou en lecture/écriture.

Apparaît dans :BackupRepositorySpec

ImportSubstitution

Indique si nous remplaçons le nom du dépôt de sauvegarde sur les ressources importées.

Apparaît dans :BackupRepositorySpec

Champ Description
substituteBRName booléen

ManualBackupRequest

Définit le schéma de l'API ManualBackupRequest.

Apparaît dans :ManualBackupRequestList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ManualBackupRequest
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ManualBackupRequestSpec
status ManualBackupRequestStatus

ManualBackupRequestList

Contient une liste de ressources ManualBackupRequest.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ManualBackupRequestList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau ManualBackupRequest items

ManualBackupRequestSpec

Définit l'état souhaité d'une ressource ManualBackupRequest.

Apparaît dans :ManualBackupRequest

Champ Description
chaîne backupName Nom de la sauvegarde manuelle à créer.
chaîne backupPlanName Nom du plan de sauvegarde à partir duquel la ressource BackupConfig est extraite.
chaîne description Chaîne descriptive spécifiée par l'utilisateur pour la sauvegarde créée par cette ressource ManualBackupRequest.
Entier deleteLockDays Nombre de jours à partir de la create_time de cette sauvegarde pendant lesquels la suppression est bloquée. Pour les sauvegardes créées automatiquement à partir d'une planification, ce champ est défini sur la valeur BackupPlan.RetentionPolicy.backup_delete_block_days. Si une sauvegarde est créée sans que ce champ soit spécifié, la valeur BackupPlan.RetentionPolicy.backup_delete_block_days lui est attribuée. Si cette sauvegarde est créée avec ce champ défini sur une valeur inférieure à celle de BackupPlan.RetentionPolicy.backup_delete_block_days, l'agent renvoie une réponse non valide. La valeur de ce champ doit être comprise dans 0-90. Ce champ ne doit être augmenté que par une demande de mise à jour, sinon l'agent renvoie une réponse non valide. Notez que ce champ ne s'applique qu'aux sauvegardes dont l'état est Succeeded. Valeur par défaut : 0
Entier retainDays Nombre de jours pendant lesquels cette sauvegarde doit être conservée avant d'être automatiquement supprimée. Si ce champ n'est pas spécifié ou s'il est défini sur 0, cela signifie que la sauvegarde n'est pas supprimée automatiquement. Pour les sauvegardes créées automatiquement à partir d'un calendrier de sauvegarde, ce champ est défini sur la valeur BackupPlan.RetentionPolicy.backup_default_retain_days. Pour les sauvegardes créées pour lesquelles ce champ n'est pas spécifié, l'agent utilise la valeur BackupPlan.RetentionPolicy.backup_default_retain_days. Si ce champ est défini sur une valeur inférieure à delete_lock_days, la création d'une sauvegarde génère une réponse non valide de l'agent. Ce champ ne doit être augmenté que dans une demande de mise à jour. Sinon, l'agent renvoie immédiatement une réponse non valide. Valeur par défaut : 0

ManualBackupRequestStatus

Définit l'état observé d'une ressource ManualBackupRequest.

Apparaît dans :ManualBackupRequest

Champ Description
timeToExpire Heure Heure à laquelle la ressource doit expirer.
statusField StatusFields État de l'état observé de la ressource ManualBackupRequest.
chaîne statusMessage statusMessage est un message d'erreur pour la ressource ManualBackupRequest.

ManualClusterBackupRequest

Définit le schéma de l'API ManualClusterBackupRequest.

Apparaît dans :ManualClusterBackupRequestList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ManualClusterBackupRequest
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ManualClusterBackupRequestSpec
status ManualClusterBackupRequestStatus

ManualClusterBackupRequestList

Contient une liste de ressources ManualClusterBackupRequest.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ManualClusterBackupRequestList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items ManualClusterBackupRequest array

ManualClusterBackupRequestSpec

Définit l'état souhaité d'une ressource ManualClusterBackupRequest.

Apparaît dans :ManualClusterBackupRequest

Champ Description
chaîne clusterBackupName Nom de la sauvegarde du cluster à créer. Il est créé dans le même espace de noms que la ressource ManualClusterBackupRequest.
chaîne clusterBackupPlanRef Nom du plan de sauvegarde du cluster à partir duquel la ressource ClusterBackupConfig est extraite. Notez que le plan de sauvegarde du cluster doit exister dans le même espace de noms que la ressource ManualClusterBackupRequest.
chaîne description Chaîne descriptive spécifiée par l'utilisateur pour la sauvegarde du cluster créée par cette ressource ManualClusterBackupRequest.
Entier deleteLockDays Nombre de jours à partir de la create_time de cette sauvegarde pendant lesquels la suppression est bloquée. Pour les sauvegardes créées automatiquement à partir d'une planification, ce champ est défini sur la valeur BackupPlan.RetentionPolicy.backup_delete_block_days. Si un Backup est créé sans que ce champ soit spécifié, la valeur BackupPlan.RetentionPolicy.backup_delete_block_days lui est attribuée. Si ce Backup est créé avec ce champ défini sur une valeur inférieure à celle de ClusterBackupPlan.RetentionPolicy.backup_delete_block_days, l'agent renvoie une réponse non valide. La valeur de ce champ doit être comprise dans 0-90. Ce champ ne doit être augmenté que par une demande de mise à jour, sinon l'agent renvoie une réponse non valide. Notez que ce champ ne s'applique qu'aux sauvegardes dont l'état est Succeeded.
Entier retainDays Nombre de jours pendant lesquels cette sauvegarde doit être conservée avant d'être automatiquement supprimée. Si ce champ n'est pas spécifié ou s'il est défini sur 0, cela signifie que la sauvegarde n'est pas supprimée automatiquement. Pour les sauvegardes créées automatiquement à partir d'un calendrier de sauvegarde, ce champ est défini sur la valeur BackupPlan.RetentionPolicy.backup_default_retain_days. Pour les sauvegardes créées pour lesquelles ce champ n'est pas spécifié, l'agent utilise la valeur ClusterBackupPlan.RetentionPolicy.backup_default_retain_days. Si ce champ est défini sur une valeur inférieure à delete_lock_days, la création d'une sauvegarde génère une réponse non valide de l'agent. Ce champ ne doit être augmenté que dans une demande de mise à jour. Sinon, l'agent renvoie immédiatement une réponse non valide.

ManualClusterBackupRequestStatus

Définit l'état observé d'une ressource ManualClusterBackupRequest.

Apparaît dans :ManualClusterBackupRequest

Champ Description
timeToExpire Heure Heure d'expiration de la ressource.
statusField StatusFields État observé d'une ressource ManualClusterBackupRequest.

ManualClusterRestoreRequest

Définit le schéma de l'API ManualClusterRestoreRequest.

Apparaît dans :ManualClusterRestoreRequestList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ManualClusterRestoreRequest
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ManualClusterRestoreRequestSpec
status ManualRestoreRequestStatus

ManualClusterRestoreRequestList

Représente une liste de ressources ManualClusterRestoreRequest.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ManualClusterRestoreRequestList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items ManualClusterRestoreRequest array

ManualClusterRestoreRequestSpec

Définit l'état souhaité d'une ressource ManualClusterRestoreRequest.

Apparaît dans :ManualClusterRestoreRequest

Champ Description
chaîne clusterRestoreName Nom de la restauration de cluster à créer.
chaîne clusterRestorePlanName Nom du plan de restauration du cluster à partir duquel extraire la ressource ClusterRestoreConfig.
chaîne clusterBackupName Nom de la sauvegarde du cluster en cours de restauration. Notez que le plan de restauration et la sauvegarde du cluster doivent exister dans le même espace de noms que la ressource ManualClusterRestoreRequest.
chaîne description Chaîne descriptive spécifiée par l'utilisateur pour la restauration du cluster créée par cette ressource ManualClusterRestoreRequest.
filter Filtrer Filtre permettant d'affiner davantage la sélection des ressources de la restauration du cluster au-delà du champ d'application à granularité large défini dans ClusterRestorePlan.

ManualRestoreRequest

Définit le schéma de l'API ManualRestoreRequest.

Apparaît dans :ManualRestoreRequestList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ManualRestoreRequest
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec ManualRestoreRequestSpec
status ManualRestoreRequestStatus

ManualRestoreRequestList

Contient une liste de ressources ManualRestoreRequest.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ManualRestoreRequestList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items Tableau ManualRestoreRequest

ManualRestoreRequestSpec

Définit l'état souhaité d'une ressource ManualRestoreRequest.

Apparaît dans :ManualRestoreRequest

Champ Description
chaîne restoreName Nom de la restauration manuelle à créer.
chaîne restorePlanName Nom du plan de restauration à partir duquel extraire la ressource RestoreConfig.
chaîne backupName Nom de la sauvegarde en cours de restauration.
chaîne description Chaîne descriptive spécifiée par l'utilisateur pour la restauration créée par cette ressource ManualRestoreRequest.
filter Filtrer Filtre qui peut être utilisé pour affiner davantage la sélection des ressources de la restauration au-delà du champ d'application à granularité large défini dans le RestorePlan.

ManualRestoreRequestStatus

Définit l'état observé de la ressource ManualRestoreRequest.

Apparaît dans :ManualRestoreRequest

Champ Description
timeToExpire Heure Heure à laquelle la ressource doit expirer.
statusField StatusFields État observé d'une ressource ManualRestoreRequest.

NamespacedName

Définit un nom dans un espace de noms spécifique.

Apparaît dans : - NamespacedNames - NamespacedResourceSelection - VolumeBackupSpec - VolumeRestoreSpec

Champ Description
chaîne namespace Espace de noms de la ressource dans Kubernetes.
chaîne name Nom de la ressource dans Kubernetes.

NamespacedNames

Apparaît dans :BackupScope

Champ Description
namespacedNames Tableau NamespacedName Liste de noms associés à un espace de noms.

NamespacedResourceRestoreMode

Type sous-jacent : string Comportement de restauration pour les ressources d'espace de noms.

Apparaît dans :RestoreConfig, RestorePolicies

NamespacedResourceSelection

Définit la sélection des ressources d'espace de noms à restaurer. L'une des valeurs suivantes doit être spécifiée avec un Type correspondant :

`AllNamespaces`, `SelectedNamespaces`, or `SelectedApplications`.

Apparaît dans :RestoreResourceSelection

Champ Description
type NamespacedResourceSelectionType Type de sélection à utiliser.
allNamespaces booléen Indique s'il faut restaurer toutes les ressources d'espace de noms dans la sauvegarde. Il n'est pas possible de laisser ce champ non spécifié ou de le définir sur False avec Type défini sur NamespacedResourceSelectionType.AllNamespaces.
Tableau de chaînes selectedNamespaces Liste des espaces de noms sélectionnés à restaurer. Si une valeur est fournie avec Type défini sur NamespacedResourceSelectionType.SelectedNamespaces, les ressources avec un espace de noms d'origine figurant dans la liste spécifiée sont restaurées. Notez que si vous spécifiez une chaîne vide dans cette liste, les ressources de cluster sans espace de noms ne seront pas restaurées. Pour restaurer les ressources du cluster, consultez ClusterResourceSelection.
selectedApplications Tableau NamespacedName Liste des ressources ProtectedApplication sélectionnées à restaurer. Si une valeur est fournie et que Type est défini sur NamespacedResourceSelectionType.SelectedApplications, les ressources appartenant à l'une des applications listées sont restaurées.

NamespacedResourceSelectionType

Type sous-jacent : string Type de sélection des ressources avec espace de noms.

Apparaît dans :NamespacedResourceSelection

Espaces de noms

Apparaît dans :BackupScope

Champ Description
Tableau de chaînes namespaces Liste des espaces de noms.

ObjectStorageBackupConfig

Configure les sauvegardes du stockage d'objets.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind ObjectStorageBackupConfig
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
source ObjectStorageEndpoint Stockage d'objets source à sauvegarder.
target ObjectStorageEndpoint Cible dans laquelle la sauvegarde est écrite.
timestamp booléen Spécifie si chaque transfert doit être stocké dans un sous-chemin horodaté du bucket. Si la valeur est True, la structure est YYYY-MM-DD-hh:mm:ss. Cela permet de stocker les copies d'une sauvegarde prises à différents moments. La valeur par défaut est False.

ObjectStorageEndpoint

Représente un point de terminaison de stockage d'objets ainsi que les identifiants permettant d'y accéder.

Apparaît dans :ObjectStorageBackupConfig

Champ Description
chaîne endpoint Point de terminaison utilisé pour accéder au stockage d'objets. Par exemple, https://s3.svc.
chaîne bucket Bucket dans le point de terminaison pour la référence de portée.
secretReference SecretReference Référence aux identifiants d'accès S3 utilisés pour accéder au stockage d'objets.

PlatformVersion

Définit la version de la plate-forme.

Apparaît dans : ClusterMetadata

Champ Description
chaîne gpcVersion Version Google Private Cloud.

ReconciliationError

Type sous-jacent : string Erreurs survenues lors de la dernière tentative de rapprochement pour le dépôt de sauvegarde.

Apparaît dans :BackupRepositoryStatus

RepositoryType

Type sous-jacent : string Type de point de terminaison en cours d'écriture.

Apparaît dans :BackupRepositorySpec

ResourceFilter

Définit les règles permettant de filtrer la liste des ressources candidates pour lesquelles fournir des règles de transformation. Tous les champs avec ResourceFilter sont facultatifs. Si vous ne spécifiez aucun champ ResourceFilter, toutes les ressources correspondront.

Apparaît dans :TransformationRule

Champ Description
Tableau de chaînes namespaces Liste des espaces de noms cibles auxquels une règle de transformation s'appliquera. L'espace de noms d'origine d'une ressource doit correspondre à l'un des noms de la liste pour être considéré comme un candidat à la transformation. Une chaîne vide est attendue dans la liste pour que toute ressource sans espace de noms soit prise en compte. Si ce paramètre est vide, tous les espaces de noms sont pris en compte.
Tableau GroupKind groupKinds Liste des ressources GroupKind cibles auxquelles une règle de transformation s'appliquera. La ressource GroupKind d'origine d'une ressource doit correspondre à l'une des ressources GroupKind spécifiées dans la liste pour être considérée comme un candidat à la transformation. Si ce champ est vide, toutes les ressources GroupKind sont prises en compte. Notez qu'une ressource doit répondre aux exigences Namespaces et GroupKinds pour être considérée comme un candidat à la transformation.
chaîne jsonPath Représentation sous forme de chaîne du chemin d'accès dans le fichier JSON qui mène aux champs de la ressource cible pour le filtrage. La documentation JSONPath est disponible sur https://github.com/json-path/JsonPath/blob/master/README.md. Les formats JSONPath peuvent être testés en ligne (par exemple, https://jsonpath.com/).

ResourceSelector

Définit ResourceSelector pour le filtre de restauration ultraprécis

Apparaît dans :Filter

Champ Description
groupKind GroupKind Sélectionne les ressources à l'aide de leurs GroupKinds Kubernetes. Si elle est spécifiée, seules les ressources du GroupKind fourni seront sélectionnées.
chaîne name Sélectionne les ressources à l'aide de leur nom de ressource. Si cette option est spécifiée, seules les ressources portant le nom indiqué seront sélectionnées.
chaîne namespace Sélectionne les ressources à l'aide de leurs espaces de noms. Cela ne s'applique qu'aux ressources à portée d'espace de noms et ne peut pas être utilisé pour sélectionner des ressources à portée de cluster. Si un espace de noms est spécifié, seules les ressources de cet espace seront sélectionnées. Si aucune portée n'est spécifiée, le filtre s'appliquera aux ressources à l'échelle du cluster et à celles à l'échelle de l'espace de noms (par exemple, le nom ou le libellé). La ressource d'espace de noms elle-même ne sera restaurée que si des ressources de l'espace de noms sont restaurées.
labels object (keys:string, values:string) Sélectionne les ressources à l'aide des libellés Kubernetes. Si elle est spécifiée, une ressource ne sera sélectionnée que si elle possède toutes les étiquettes fournies et que toutes les valeurs d'étiquette correspondent.

Restaurer

Définit le schéma de l'API Restore.

Apparaît dans :RestoreList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind Restore
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec RestoreSpec
status RestoreStatus

RestoreConfig

Définit la configuration d'une restauration.

Apparaît dans : - RestorePlanSpec - RestoreSpec

Champ Description
volumeDataRestorePolicy VolumeDataRestorePolicy Règle à utiliser pour la restauration des données de volume. Fournit une valeur par défaut de NO_VOLUME_DATA_RESTORATION si aucune valeur n'est spécifiée.
clusterResourceConflictPolicy ClusterResourceConflictPolicy Règle qui résout les conflits lors de la restauration des ressources à l'échelle du cluster. La requête n'est pas valide si ce champ n'est pas spécifié. Cette requête n'est pas valide si ce champ a une valeur de CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED et que cluster_resource_restore_scope est spécifié.
namespacedResourceRestoreMode NamespacedResourceRestoreMode Mode de restauration à utiliser pour les ressources d'espace de noms. La requête n'est pas valide si ce champ n'est pas spécifié. La requête n'est pas valide si ce champ a une valeur de NAMESPACED_RESOURCE_RESTORE_MODE_UNSPECIFIED et que namespaced_resource_restore_scope est spécifié.
clusterResources ClusterResourceSelection Ressources sans espace de noms à restaurer. Si ce champ n'est pas spécifié, aucune ressource de cluster n'est restaurée. Notez que même si les ressources PersistentVolume ne sont pas associées à un espace de noms, elles sont traitées séparément. Pour en savoir plus, consultez la ressource VolumeDataRestorePolicy. La spécification d'un PersistentVolume GroupKind dans cette liste ne détermine pas si un PersistentVolume est restauré.
Tableau GroupKind namespacedResourceAllowlist Ressources en espace de noms spécifiques à restaurer. Si elle est définie, seules les ressources définies dans cette allowlist sont restaurées.
restoreScope BackupScope Ressources d'espace de noms sélectionnées à restaurer. L'une des entrées doit être spécifiée avec un Type valide. Les valeurs Type valides pouvant être attribuées à restoreScope sont AllNamespaces, SelectedNamespaces ou SelectedApplications.
Tableau SubstitutionRule substitutionRules Règles suivies lors de la substitution des ressources Kubernetes sauvegardées. Une liste vide signifie qu'aucune substitution n'aura lieu. Les règles de substitution sont appliquées de manière séquentielle dans l'ordre défini. Cet ordre est important, car les modifications apportées par une règle peuvent avoir un impact sur la logique de correspondance de la règle suivante. Vous ne pouvez spécifier qu'un seul élément SubstitutionRules ou TransformationRules pour une opération de restauration donnée.
Tableau TransformationRule transformationRules Règles suivies lors de la transformation des ressources Kubernetes sauvegardées. Une liste vide signifie qu'aucune transformation n'aura lieu. Les règles de transformation sont appliquées de manière séquentielle dans l'ordre défini. Cet ordre est important, car les modifications apportées par une règle peuvent avoir un impact sur la logique de correspondance d'une règle ultérieure. Vous ne pouvez spécifier qu'un seul élément SubstitutionRules ou TransformationRules pour une opération de restauration donnée.
chaîne backupRepository Nom du dépôt de sauvegarde qui identifie le dépôt pour la ressource de restauration. Ce champ doit être associé en mode lecture/écriture. Notez que ce dépôt de sauvegarde peut être différent de celui de la sauvegarde à laquelle cette restauration fait référence. Si ce champ n'est pas fourni, il sera sélectionné selon la logique suivante : 1. Si la sauvegarde à partir de laquelle nous effectuons la restauration pointe vers un dépôt en lecture/écriture dans le cluster actuel, ce dépôt est sélectionné. 2. Si la sauvegarde à partir de laquelle nous effectuons une restauration pointe vers un dépôt en lecture seule, un dépôt en lecture et écriture du cluster est sélectionné et utilisé.
encryptionKey EncryptionKey Une clé de chiffrement. Ce champ n'est pas modifiable.

RestoreList

Contient une liste de ressources Restore.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind RestoreList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau Restaurer items

RestorePlan

Définit le schéma de l'API RestorePlan.

Apparaît dans :RestorePlanList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind RestorePlan
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec RestorePlanSpec
status RestorePlanStatus

RestorePlanList

Contient une liste de ressources RestorePlan.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind RestorePlanList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
items RestorePlan

RestorePlanSpec

Définit l'état souhaité du plan de restauration.

Apparaît dans :RestorePlan

Champ Description
chaîne backupPlanName Nom du plan de sauvegarde à partir duquel les sauvegardes peuvent être utilisées comme source pour les restaurations créées à l'aide de ce plan de restauration. Ce champ est obligatoire et immuable.
restoreConfig RestoreConfig Configuration de la restauration de ce plan de restauration.
chaîne clusterName Nom du cluster qui contiendra les données restaurées par ce plan de restauration. Par défaut, il s'agit du cluster dans lequel le plan de restauration est créé.
chaîne description Chaîne descriptive spécifiée par l'utilisateur pour ce plan de restauration.

RestorePlanStatus

Définit l'état observé d'un plan de restauration.

Apparaît dans :RestorePlan

Champ Description
lastRestoreTime Heure Code temporel de la restauration la plus récente.
state StatusFields État actuel du plan de restauration.

RestoreSpec

Définit l'état souhaité d'une restauration.

Apparaît dans :Restore

Champ Description
chaîne backupName Nom complet de la ressource de sauvegarde à partir de laquelle cette ressource Restore effectue la restauration.
chaîne restorePlanName Nom du plan de restauration à partir duquel cette restauration a hérité de sa ressource RestoreConfig.
chaîne clusterName Nom du cluster contenant les données restaurées par cette restauration. Par défaut, il s'agit du cluster dans lequel la restauration a été créée.
restoreConfig RestoreConfig Configuration de la restauration.
chaîne description Description facultative de la sauvegarde. Cela n'a aucune incidence sur les fonctionnalités.
filter Filtrer Le filtre peut être utilisé pour affiner la sélection des ressources de la restauration au-delà du champ d'application à granularité large défini dans le RestorePlan.

RestoreState

Type sous-jacent : string

Apparaît dans :RestoreStatus

RestoreStatus

Définit l'état observé d'une restauration.

Apparaît dans :Restore

Champ Description
state RestoreState État actuel de la restauration.
chaîne stateReason Description lisible des raisons pour lesquelles la restauration est dans l'état actuel.
errorStatus ErrorStatus Les erreurs les plus récentes avec les heures observées incluses.
Tableau Condition conditions "Conditions" représente les observations de l'état actuel de cette restauration. Types de conditions connus : réussie
jobCreated booléen Indique si un job de restauration a été créé pour cette restauration.
Entier resourcesRestoredCount Nombre de ressources restaurées lors de cette action de restauration.
Entier resourcesExcludedCount Nombre de ressources exclues de cette action de restauration.
Entier resourcesFailedCount Nombre de ressources qui n'ont pas pu être restaurées lors de cette action de restauration.
Entier restoredVolumesCount Nombre de volumes restaurés lors de cette action de restauration.
startTime Heure Heure de création du processus de restauration.
completeTime Heure Heure de fin du processus de restauration.

RetentionPolicy

Définit une règle qui détermine quand supprimer automatiquement les sauvegardes créées dans le cadre de ce plan de sauvegarde, un nombre minimal de jours de conservation des sauvegardes au niveau du plan, un nombre minimal de sauvegardes à conserver au niveau du plan et un verrouillage pour interdire toute mise à jour de la règle.

Apparaît dans :BackupPlanSpec

Champ Description
Entier backupDeleteLockDays Nombre de jours pendant lesquels la suppression d'une sauvegarde créée dans ce plan de sauvegarde est bloquée. Valeur par défaut : 0 Ce champ doit être une valeur entière comprise entre 0-90. Une sauvegarde créée dans le cadre de ce plan de sauvegarde ne peut pas être supprimée tant qu'elle n'a pas atteint la valeur combinée de create_time et backup_delete_lock_days. La modification de ce champ du plan de sauvegarde n'affecte pas les sauvegardes existantes. Les sauvegardes créées après une mise à jour réussie héritent automatiquement de la nouvelle valeur.
Entier backupRetainDays Nombre de jours après lequel le service supprime une sauvegarde. Si cette valeur est spécifiée, une sauvegarde créée selon ce plan de sauvegarde sera automatiquement supprimée une fois l'ancienneté requise atteinte (create_time + backup_retain_days). Si aucune valeur n'est spécifiée, les sauvegardes créées selon ce plan de sauvegarde ne sont pas soumises à la suppression automatique. La modification de ce champ n'a aucune incidence sur les sauvegardes existantes. Les sauvegardes créées après une mise à jour réussie héritent automatiquement de la nouvelle valeur. Notez que si vous spécifiez une valeur pour backup_retain_days inférieure à backup_delete_lock_days au moment de la création ou de la mise à jour, elle sera considérée comme non valide et la demande sera immédiatement rejetée.
locked booléen Indique si la règle de conservation de ce plan de sauvegarde est verrouillée. Si la valeur est définie sur True, aucune autre modification n'est autorisée pour cette règle, y compris pour le champ locked lui-même. Valeur par défaut : False
Entier numBackupsToRetain Nombre de sauvegardes à conserver. Si cette valeur est spécifiée, les sauvegardes les plus anciennes du plan de sauvegarde ayant atteint la valeur combinée de create_time et backup_delete_lock_days are automatically deleted after the total number of backups under this backup plan reaches the value ofnum_backups_to_retain`. Si cette valeur n'est pas spécifiée, les sauvegardes créées selon ce plan de sauvegarde peuvent ou non être soumises à une suppression automatique en fonction de "backup_retain_days". La modification de ce champ affecte les sauvegardes existantes du plan de sauvegarde. Notez que num_backups_to_retain doit être supérieur ou égal au nombre de sauvegardes pouvant être créées dans backup_delete_lock_days.

S3Options

Définit les options d'appel à un point de terminaison S3 pour le dépôt de sauvegarde.

Apparaît dans :BackupRepositorySpec

Champ Description
chaîne bucket Bucket du point de terminaison dans lequel importer les sauvegardes.
chaîne region Région d'un point de terminaison donné. La mise en forme dépend du système de stockage.
forcePathStyle booléen Indique s'il faut forcer les URL de style chemin d'accès pour les objets. Par exemple, https://s3.amazonaws.com// au lieu de https://.s3.amazonaws.com/.
chaîne serverSideEncryption Algorithme de chiffrement côté serveur utilisé pour stocker les objets. Par exemple, AES256 oraws:kms.
chaîne kmsKeyId ID de clé KMS à utiliser pour le stockage d'objets si le chiffrement côté serveur utilise KMS.

Programmation

Représente un type de message interne qui définit une planification cron.

Apparaît dans :BackupPlanSpec

Champ Description
chaîne cronSchedule Planification de chaîne Cron sur laquelle une opération est exécutée.
paused booléen Indique si l'opération planifiée est inactive ou active. Si la valeur est définie sur True, l'opération planifiée sera inactive. Valeur par défaut : True
Entier maxConcurrency Spécifie le nombre maximal de sauvegardes planifiées actives pouvant exister simultanément dans un plan de sauvegarde. Si cette valeur est spécifiée, le nombre de sauvegardes planifiées de ce plan de sauvegarde qui peuvent être actives à un moment donné ne doit pas dépasser cette valeur. Si aucune valeur n'est spécifiée, la valeur par défaut est 2.

État

Type sous-jacent : string Valeur indiquant l'état actuel du plan de sauvegarde.

Apparaît dans :BackupPlanStatus

SubstitutionRule

Définit les règles de substitution.

Apparaît dans :RestoreConfig

Champ Description
target SubstitutionTarget Critères de correspondance qui vérifient si une ressource est une candidate à la substitution et si ses champs correspondent à la valeur JSONPath fournie.
chaîne originValuePattern Chaîne de modèle d'expression régulière appliquée à la valeur JSON correspondant à la valeur Target fournie. Si aucune valeur n'est spécifiée, la valeur d'origine est toujours remplacée par la valeur NewValue spécifiée. Notez qu'une chaîne vide est un modèle d'expression régulière légitime et est traitée comme n'importe quelle autre chaîne.
chaîne newValue Valeur souhaitée au format chaîne à substituer.

SubstitutionTarget

Définit les règles des candidats cibles pour la substitution.

Apparaît dans :SubstitutionRule

Champ Description
Tableau de chaînes namespaces Liste des espaces de noms cibles auxquels une règle de substitution est appliquée. L'espace de noms d'origine d'une ressource doit correspondre à l'un des noms de la liste pour être considéré comme un candidat à la substitution. Pour qu'une ressource sans espace de noms soit prise en compte, une chaîne vide doit être fournie. Si ce paramètre est vide, tous les espaces de noms sont pris en compte.
Tableau GroupKind groupKinds Liste des ressources GroupKind cibles auxquelles s'applique une règle de substitution. La ressource GroupKind d'origine d'une ressource doit correspondre à l'une des ressources GroupKind spécifiées dans la liste pour être considérée comme un candidat à la substitution. Si ce champ est vide, toutes les ressources GroupKind sont prises en compte. Notez qu'une ressource doit répondre aux exigences relatives à l'espace de noms et à GroupKind pour être considérée comme un candidat à la substitution.
chaîne jsonPath Représentation sous forme de chaîne du chemin JSON qui mène aux champs de la ressource cible, qui sont au format JSON pour la substitution.

TargetCluster

Représente un cluster dont les données seront sauvegardées ou restaurées.

Apparaît dans : - ClusterBackupPlanSpec - ClusterBackupSpec - ClusterRestorePlanSpec - ClusterRestoreSpec - ClusterVolumeBackupSpec - ClusterVolumeRestoreSpec

Champ Description
targetClusterType TargetClusterType Type de cluster
targetClusterName TypedLocalObjectReference Dans le cas d'un UserCluster, le nom fait référence à un cluster GDC dans le même espace de noms sous le groupe clusters.cluster.gdc.goog. Pour l'API Management, ce champ doit être vide.

TargetClusterType

Type sous-jacent : string

Apparaît dans :TargetCluster

TransformationRule

Définit les règles de transformation à l'aide de jsonPatch.

Apparaît dans :RestoreConfig

Champ Description
fieldActions Tableau TransformationRuleAction Liste des opérations à effectuer sur les ressources candidates en fonction de la RFC JSON Patch.
resourceFilter ResourceFilter Critères de correspondance à vérifier pour déterminer si une ressource est une candidate à la transformation. Notez qu'une valeur resourceFilter vide ou blanche correspond à toutes les ressources.

TransformationRuleAction

Représente l'action que l'utilisateur souhaite effectuer pour transformer une ressource.

Apparaît dans :TransformationRule

Champ Description
op TransformationRuleOperation Type d'action que l'utilisateur souhaite effectuer dans le cadre de la transformation des ressources lors d'une opération de restauration. La liste des opérations valides est disponible à l'adresse https://www.rfc-editor.org/rfc/rfc6902#section-4.4.
chaîne from Représentation JSON d'un chemin d'accès dans le fichier JSON qui mène aux champs de la ressource cible pour les opérations de déplacement et de copie.
chaîne path Représentation JSON d'un chemin d'accès dans le fichier JSON qui mène aux champs de la ressource cible pour certaines opérations.
chaîne value Valeur souhaitée au format chaîne à utiliser pour la transformation.

TransformationRuleOperation

Type sous-jacent : string Opération prévue pour une règle de transformation.

Apparaît dans :TransformationRuleAction

VMBackupJobList

Contient une liste de sauvegardes.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind VMBackupJobList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau VMBackupJob items

VMBackupJobSpec

Définit l'état souhaité de la sauvegarde.

Apparaît dans :VMBackupJob

Champ Description
backupRef NamespacedName Nom de la sauvegarde du plan de contrôle à laquelle le job de sauvegarde de VM est associé. Le nom est immuable.
vmRef NamespacedName Référence de la VM sauvegardée par ce CR. Cette référence peut être nulle si la sauvegarde est une sauvegarde de disque.
Tableau VMDisk vmDiskRefs Liste des disques de VM sauvegardés par ce CR
volumeBackupRefs objet (clés : chaîne, valeurs : VolumeBackup) Mappage du nom de la sauvegarde de volume à la structure VolumeBackup sous cette sauvegarde. Ces données sont intégrées à VMBackupJob et ne sont pas présentes dans le cluster.
chaîne description Description facultative de la sauvegarde (chaîne). Ce champ n'a aucune incidence sur le fonctionnement.
manual booléen Indique si la ressource de sauvegarde a été créée manuellement. Si la valeur est True, cette sauvegarde a été créée manuellement. Si la valeur est False, cette sauvegarde a été créée automatiquement à partir du calendrier du plan de sauvegarde.
Entier deleteLockDays Nombre de jours à partir de la create_time de cette sauvegarde pendant lesquels la suppression est bloquée. Pour les sauvegardes créées automatiquement à partir d'une planification de sauvegarde, ce champ est défini sur la valeur BackupPlan.RetentionPolicy.backup_delete_block_days. Pour les sauvegardes créées manuellement et pour lesquelles ce champ n'est pas spécifié, le service attribue la valeur BackupPlan.RetentionPolicy.backup_delete_block_days. Si une sauvegarde est créée et que la valeur de ce champ est inférieure à celle de BackupPlan.RetentionPolicy.backup_delete_block_days, le service renvoie une réponse non valide. Ce champ doit être une valeur entière comprise entre 0-90. Ce champ ne doit être incrémenté que par une requête de mise à jour. Dans le cas contraire, le service renvoie une réponse non valide. Notez que ce champ ne s'applique qu'aux sauvegardes dont l'état est Succeeded. Valeur par défaut : 0
Entier retainDays Nombre de jours pendant lesquels cette sauvegarde doit être conservée avant d'être automatiquement supprimée. Elle est calculée à partir de la create_time de la sauvegarde. Si ce champ n'est pas spécifié ou s'il est défini sur 0, cela signifie que la sauvegarde n'est pas supprimée automatiquement. Pour les sauvegardes créées automatiquement à partir d'une planification de sauvegarde, la valeur BackupPlan.RetentionPolicy.backup_retain_days est attribuée à ce champ. Pour les sauvegardes créées manuellement et pour lesquelles ce champ n'est pas spécifié, le service attribue la valeur BackupPlan.RetentionPolicy.backup_retain_days. Si une sauvegarde est créée avec une valeur de ce champ inférieure à celle de delete_lock_days, le service renvoie une réponse non valide. Ce champ ne doit être incrémenté que par une requête de mise à jour. Dans le cas contraire, le service renvoie une réponse non valide. Valeur par défaut : 0

VMBackupJobStatus

Définit l'état observé d'une sauvegarde.

Apparaît dans :VMBackupJob

Champ Description
state VMBackupJobState État actuel de la sauvegarde.
chaîne reason Description lisible des raisons pour lesquelles la sauvegarde est dans l'état actuel.
errorStatus ErrorStatus Les erreurs les plus récentes avec les heures observées incluses.
Tableau Condition conditions "Conditions" représente les observations de l'état actuel de ce VMBackupJob. Types de conditions connus : réussie
createTime Heure Horodatage de la création de cette ressource VMBackupJob. Il peut être converti à partir de RFC 3339 et en RFC 3339.
snapshotTime Heure Code temporel de la création de l'instantané de tous les disques de la ressource VMBackupJob. Il peut être converti à partir de RFC 3339 et en RFC 3339.
updateTime Heure Horodatage de la dernière mise à jour de cette VMBackupJob. Il peut être converti à partir de RFC 3339 et en RFC 3339.
Entier volumeCount Nombre total de volumes sauvegardés.
Entier retryCount Nombre total de tentatives requises pour sauvegarder cette VM/ce disque de VM
deleteLockExpireTime Heure Heure d'expiration du verrou de suppression. Il s'agit d'un champ de sortie uniquement, calculé à partir de la valeur combinée de create_time et delete_lock_days. Il est mis à jour en conséquence lorsque le champ delete_lock_days d'une sauvegarde est modifié. Notez que ce champ ne s'applique qu'aux sauvegardes dont l'état est Succeeded.
retainExpireTime Heure Heure à laquelle la sauvegarde est automatiquement supprimée. Il s'agit d'un champ de sortie uniquement, calculé à partir de la valeur combinée de create_time et retain_days. Il est mis à jour en conséquence lorsque le champ retain_days d'une sauvegarde est modifié.
completeTime Heure Heure de fin de la sauvegarde.

VMDisk

Apparaît dans :VMBackupJobSpec

Champ Description
chaîne namespace Espace de noms dans lequel réside le disque de la VM
chaîne name Nom du disque de la VM
chaîne pvcName Nom de la PVC sous-jacente
uid UID UID du PVC utilisé par ce champ pour obtenir ce VMBackupJob spécifique à partir de l'UID du PVC
Entier sizeBytes Taille totale, mesurée en octets.

VolumeBackup

Définit le schéma de l'API VolumeBackup.

Apparaît dans : - VMBackupJobSpec - VolumeBackupList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind VolumeBackup
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec VolumeBackupSpec
status VolumeBackupStatus

VolumeBackupFormat

Type sous-jacent : string Énumération qui spécifie le format de la sauvegarde du volume.

Apparaît dans :VolumeBackupStatus

VolumeBackupList

Contient une liste de ressources VolumeBackup.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind VolumeBackupList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau VolumeBackup items

VolumeBackupSpec

Définit l'état souhaité d'une sauvegarde de volume.

Apparaît dans :VolumeBackup

Champ Description
chaîne clusterName Nom du cluster pour lequel cette sauvegarde de volume conserve les données. Par défaut, il s'agit du cluster dans lequel cette sauvegarde de volume est créée.
chaîne backupName Nom de la sauvegarde associée. Chaque sauvegarde de volume doit être associée à une sauvegarde.
chaîne backupPlanName Nom du plan de sauvegarde à partir duquel la sauvegarde associée a été créée.
sourcePVC NamespacedName Demande de volume persistant source à partir de laquelle la sauvegarde du volume est effectuée.
chaîne volumeBackupHandle Handle de sauvegarde de volume sous-jacent qui identifie de manière unique une sauvegarde de volume dans un dépôt de sauvegardes de volumes. Ce handle n'a pas de format unifié et est traité comme une chaîne opaque. OBSOLÈTE : utilisez plutôt le champ "status" (état).

VolumeBackupState

Type sous-jacent : string Énumération qui suggère l'état actuel d'une sauvegarde de volume.

Apparaît dans :VolumeBackupStatus

VolumeBackupStatus

Définit l'état observé d'une sauvegarde de volume.

Apparaît dans :VolumeBackup

Champ Description
chaîne volumeBackupHandle Handle de sauvegarde de volume sous-jacent, qui identifie de manière unique une sauvegarde de volume dans un dépôt de sauvegarde de volume. Ce handle n'a pas de format unifié et est traité comme une chaîne opaque.
format VolumeBackupFormat Format de sauvegarde de volume. Par exemple, PD, Portable, etc.
Entier storageBytes Taille de la sauvegarde du volume dans l'espace de stockage des sauvegardes. Pour les sauvegardes incrémentielles, cette valeur peut changer de manière dynamique si l'une des sauvegardes de volume précédentes a été supprimée.
Entier diskSizeBytes Taille minimale du disque sur lequel cette sauvegarde de volume peut être restaurée.
state VolumeBackupState État actuel de la sauvegarde du volume.
chaîne message Message lisible indiquant pourquoi la sauvegarde est dans cet état.
completeTime Heure Code temporel indiquant la date à laquelle cette ressource VolumeBackup a été terminée, au format texte RFC 3339.
errorStatus ErrorStatus Les erreurs les plus récentes avec les heures observées incluses.
Tableau Condition conditions "Conditions" représente les observations de l'état actuel de ce VolumeBackup.

VolumeDataRestorePolicy

Type sous-jacent : string Les différentes règles de restauration des données de volume.

Apparaît dans :RestoreConfig, RestorePolicies

VolumeRestore

Définit le schéma de l'API VolumeRestore.

Apparaît dans :VolumeRestoreList

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind VolumeRestore
metadata ObjectMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
spec VolumeRestoreSpec
status VolumeRestoreStatus

VolumeRestoreList

Contient une liste de ressources VolumeRestore.

Champ Description
chaîne apiVersion backup.gdc.goog/v1
chaîne kind VolumeRestoreList
metadata ListMeta Reportez-vous à la documentation de l'API Kubernetes pour connaître les champs de metadata.
Tableau VolumeRestore items

VolumeRestoreSpec

Définit l'état souhaité d'une restauration de volume.

Apparaît dans :VolumeRestore

Champ Description
chaîne clusterName Nom du cluster contenant les données de cette restauration de volume. Par défaut, il s'agit du cluster dans lequel cette restauration de volume est créée.
chaîne restoreName Nom de la ressource de restauration qui a créé cette restauration de volume.
chaîne volumeBackupName Nom de la ressource de sauvegarde de volume que nous restaurons.
targetPvc NamespacedName Ressource PersistentVolumeClaim cible à restaurer.

VolumeRestoreStatus

Définit l'état observé d'une restauration de volume.

Apparaît dans :VolumeRestore

Champ Description
chaîne volumeBackupHandle Handle de sauvegarde de volume sous-jacent, qui identifie de manière unique une sauvegarde de volume dans un dépôt de sauvegarde de volume. Ce handle n'a pas de format unifié et est traité comme une chaîne opaque.
state VolumeRestoreState État actuel de la restauration du volume.
chaîne stateMessage Description lisible de l'état actuel.
Tableau Condition conditions "Conditions" représente les observations de l'état actuel de cette restauration de volume. Types de conditions connus : prêt.
completeTime Heure Heure de fin du processus de restauration du volume.

VolumeStrategy

Type sous-jacent : string Compromis à utiliser lors de la sauvegarde des volumes.

Apparaît dans :BackupConfig