Skip to content

Commit 8009a73

Browse files
feat(gkebackup): update the api
#### gkebackup:v1 The following keys were added: - schemas.BackupConfigDetails (Total Keys: 14) - schemas.BackupPlan.properties.backupChannel (Total Keys: 2) - schemas.BackupPlanDetails.properties.backupConfigDetails (Total Keys: 2) - schemas.BackupPlanDetails.properties.retentionPolicyDetails (Total Keys: 2) - schemas.RestorePlan.properties.restoreChannel (Total Keys: 2) - schemas.RetentionPolicyDetails (Total Keys: 6)
1 parent 7a10adc commit 8009a73

File tree

4 files changed

+133
-1
lines changed

4 files changed

+133
-1
lines changed

docs/dyn/gkebackup_v1.projects.locations.backupChannels.backupPlanBindings.html

Lines changed: 50 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -109,10 +109,35 @@ <h3>Method Details</h3>
109109
{ # A BackupPlanBinding binds a BackupPlan with a BackupChannel. This resource is created automatically when a BackupPlan is created using a BackupChannel. This also serves as a holder for cross-project fields that need to be displayed in the current project.
110110
&quot;backupPlan&quot;: &quot;A String&quot;, # Output only. Immutable. The fully qualified name of the BackupPlan bound with the parent BackupChannel. `projects/*/locations/*/backupPlans/{backup_plan}`
111111
&quot;backupPlanDetails&quot;: { # Contains metadata about the backup plan/backup. # Output only. Contains details about the backup plan/backup.
112+
&quot;backupConfigDetails&quot;: { # BackupConfigDetails defines the configuration of Backups created via this BackupPlan. # Output only. Contains details about the BackupConfig of Backups created via this BackupPlan.
113+
&quot;allNamespaces&quot;: True or False, # Output only. If True, include all namespaced resources
114+
&quot;encryptionKey&quot;: { # Defined a customer managed encryption key that will be used to encrypt Backup artifacts. # Output only. This defines a customer managed encryption key that will be used to encrypt the &quot;config&quot; portion (the Kubernetes resources) of Backups created via this plan. Default (empty): Config backup artifacts will not be encrypted.
115+
&quot;gcpKmsEncryptionKey&quot;: &quot;A String&quot;, # Optional. Google Cloud KMS encryption key. Format: `projects/*/locations/*/keyRings/*/cryptoKeys/*`
116+
},
117+
&quot;includeSecrets&quot;: True or False, # Output only. This flag specifies whether Kubernetes Secret resources should be included when they fall into the scope of Backups. Default: False
118+
&quot;includeVolumeData&quot;: True or False, # Output only. This flag specifies whether volume data should be backed up when PVCs are included in the scope of a Backup. Default: False
119+
&quot;selectedApplications&quot;: { # A list of namespaced Kubernetes resources. # Output only. If set, include just the resources referenced by the listed ProtectedApplications.
120+
&quot;namespacedNames&quot;: [ # Optional. A list of namespaced Kubernetes resources.
121+
{ # A reference to a namespaced resource in Kubernetes.
122+
&quot;name&quot;: &quot;A String&quot;, # Optional. The name of the Kubernetes resource.
123+
&quot;namespace&quot;: &quot;A String&quot;, # Optional. The Namespace of the Kubernetes resource.
124+
},
125+
],
126+
},
127+
&quot;selectedNamespaces&quot;: { # A list of Kubernetes Namespaces. # Output only. If set, include just the resources in the listed namespaces.
128+
&quot;namespaces&quot;: [ # Optional. A list of Kubernetes Namespaces.
129+
&quot;A String&quot;,
130+
],
131+
},
132+
},
112133
&quot;lastSuccessfulBackup&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the last successful Backup created under this BackupPlan. `projects/*/locations/*/backupPlans/*/backups/*`
113134
&quot;lastSuccessfulBackupTime&quot;: &quot;A String&quot;, # Output only. Completion time of the last successful Backup. This is sourced from a successful Backup&#x27;s complete_time field.
114135
&quot;nextScheduledBackupTime&quot;: &quot;A String&quot;, # Output only. Start time of next scheduled backup under this BackupPlan by either cron_schedule or rpo config. This is sourced from BackupPlan.
115136
&quot;protectedPodCount&quot;: 42, # Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.
137+
&quot;retentionPolicyDetails&quot;: { # RetentionPolicyDetails defines a Backup retention policy for a BackupPlan. # Output only. Contains details about the RetentionPolicy of Backups created via this BackupPlan.
138+
&quot;backupDeleteLockDays&quot;: 42, # Optional. Minimum age for Backups created via this BackupPlan (in days). This field MUST be an integer value between 0-90 (inclusive). A Backup created under this BackupPlan will NOT be deletable until it reaches Backup&#x27;s (create_time + backup_delete_lock_days). Updating this field of a BackupPlan does NOT affect existing Backups under it. Backups created AFTER a successful update will inherit the new value. Default: 0 (no delete blocking)
139+
&quot;backupRetainDays&quot;: 42, # Optional. The default maximum age of a Backup created via this BackupPlan. This field MUST be an integer value &gt;= 0 and &lt;= 365. If specified, a Backup created under this BackupPlan will be automatically deleted after its age reaches (create_time + backup_retain_days). If not specified, Backups created under this BackupPlan will NOT be subject to automatic deletion. Default: 0 (no automatic deletion)
140+
},
116141
&quot;rpoRiskLevel&quot;: 42, # Output only. A number that represents the current risk level of this BackupPlan from RPO perspective with 1 being no risk and 5 being highest risk.
117142
&quot;state&quot;: &quot;A String&quot;, # Output only. State of the BackupPlan.
118143
},
@@ -148,10 +173,35 @@ <h3>Method Details</h3>
148173
{ # A BackupPlanBinding binds a BackupPlan with a BackupChannel. This resource is created automatically when a BackupPlan is created using a BackupChannel. This also serves as a holder for cross-project fields that need to be displayed in the current project.
149174
&quot;backupPlan&quot;: &quot;A String&quot;, # Output only. Immutable. The fully qualified name of the BackupPlan bound with the parent BackupChannel. `projects/*/locations/*/backupPlans/{backup_plan}`
150175
&quot;backupPlanDetails&quot;: { # Contains metadata about the backup plan/backup. # Output only. Contains details about the backup plan/backup.
176+
&quot;backupConfigDetails&quot;: { # BackupConfigDetails defines the configuration of Backups created via this BackupPlan. # Output only. Contains details about the BackupConfig of Backups created via this BackupPlan.
177+
&quot;allNamespaces&quot;: True or False, # Output only. If True, include all namespaced resources
178+
&quot;encryptionKey&quot;: { # Defined a customer managed encryption key that will be used to encrypt Backup artifacts. # Output only. This defines a customer managed encryption key that will be used to encrypt the &quot;config&quot; portion (the Kubernetes resources) of Backups created via this plan. Default (empty): Config backup artifacts will not be encrypted.
179+
&quot;gcpKmsEncryptionKey&quot;: &quot;A String&quot;, # Optional. Google Cloud KMS encryption key. Format: `projects/*/locations/*/keyRings/*/cryptoKeys/*`
180+
},
181+
&quot;includeSecrets&quot;: True or False, # Output only. This flag specifies whether Kubernetes Secret resources should be included when they fall into the scope of Backups. Default: False
182+
&quot;includeVolumeData&quot;: True or False, # Output only. This flag specifies whether volume data should be backed up when PVCs are included in the scope of a Backup. Default: False
183+
&quot;selectedApplications&quot;: { # A list of namespaced Kubernetes resources. # Output only. If set, include just the resources referenced by the listed ProtectedApplications.
184+
&quot;namespacedNames&quot;: [ # Optional. A list of namespaced Kubernetes resources.
185+
{ # A reference to a namespaced resource in Kubernetes.
186+
&quot;name&quot;: &quot;A String&quot;, # Optional. The name of the Kubernetes resource.
187+
&quot;namespace&quot;: &quot;A String&quot;, # Optional. The Namespace of the Kubernetes resource.
188+
},
189+
],
190+
},
191+
&quot;selectedNamespaces&quot;: { # A list of Kubernetes Namespaces. # Output only. If set, include just the resources in the listed namespaces.
192+
&quot;namespaces&quot;: [ # Optional. A list of Kubernetes Namespaces.
193+
&quot;A String&quot;,
194+
],
195+
},
196+
},
151197
&quot;lastSuccessfulBackup&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the last successful Backup created under this BackupPlan. `projects/*/locations/*/backupPlans/*/backups/*`
152198
&quot;lastSuccessfulBackupTime&quot;: &quot;A String&quot;, # Output only. Completion time of the last successful Backup. This is sourced from a successful Backup&#x27;s complete_time field.
153199
&quot;nextScheduledBackupTime&quot;: &quot;A String&quot;, # Output only. Start time of next scheduled backup under this BackupPlan by either cron_schedule or rpo config. This is sourced from BackupPlan.
154200
&quot;protectedPodCount&quot;: 42, # Output only. The number of Kubernetes Pods backed up in the last successful Backup created via this BackupPlan.
201+
&quot;retentionPolicyDetails&quot;: { # RetentionPolicyDetails defines a Backup retention policy for a BackupPlan. # Output only. Contains details about the RetentionPolicy of Backups created via this BackupPlan.
202+
&quot;backupDeleteLockDays&quot;: 42, # Optional. Minimum age for Backups created via this BackupPlan (in days). This field MUST be an integer value between 0-90 (inclusive). A Backup created under this BackupPlan will NOT be deletable until it reaches Backup&#x27;s (create_time + backup_delete_lock_days). Updating this field of a BackupPlan does NOT affect existing Backups under it. Backups created AFTER a successful update will inherit the new value. Default: 0 (no delete blocking)
203+
&quot;backupRetainDays&quot;: 42, # Optional. The default maximum age of a Backup created via this BackupPlan. This field MUST be an integer value &gt;= 0 and &lt;= 365. If specified, a Backup created under this BackupPlan will be automatically deleted after its age reaches (create_time + backup_retain_days). If not specified, Backups created under this BackupPlan will NOT be subject to automatic deletion. Default: 0 (no automatic deletion)
204+
},
155205
&quot;rpoRiskLevel&quot;: 42, # Output only. A number that represents the current risk level of this BackupPlan from RPO perspective with 1 being no risk and 5 being highest risk.
156206
&quot;state&quot;: &quot;A String&quot;, # Output only. State of the BackupPlan.
157207
},

docs/dyn/gkebackup_v1.projects.locations.backupPlans.html

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -125,6 +125,7 @@ <h3>Method Details</h3>
125125
The object takes the form of:
126126

127127
{ # Defines the configuration and scheduling for a &quot;line&quot; of Backups.
128+
&quot;backupChannel&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the BackupChannel to be used to create a backup. This field is set only if the cluster being backed up is in a different project. `projects/*/locations/*/backupChannels/*`
128129
&quot;backupConfig&quot;: { # BackupConfig defines the configuration of Backups created via this BackupPlan. # Optional. Defines the configuration of Backups created via this BackupPlan.
129130
&quot;allNamespaces&quot;: True or False, # If True, include all namespaced resources
130131
&quot;encryptionKey&quot;: { # Defined a customer managed encryption key that will be used to encrypt Backup artifacts. # Optional. This defines a customer managed encryption key that will be used to encrypt the &quot;config&quot; portion (the Kubernetes resources) of Backups created via this plan. Default (empty): Config backup artifacts will not be encrypted.
@@ -282,6 +283,7 @@ <h3>Method Details</h3>
282283
An object of the form:
283284

284285
{ # Defines the configuration and scheduling for a &quot;line&quot; of Backups.
286+
&quot;backupChannel&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the BackupChannel to be used to create a backup. This field is set only if the cluster being backed up is in a different project. `projects/*/locations/*/backupChannels/*`
285287
&quot;backupConfig&quot;: { # BackupConfig defines the configuration of Backups created via this BackupPlan. # Optional. Defines the configuration of Backups created via this BackupPlan.
286288
&quot;allNamespaces&quot;: True or False, # If True, include all namespaced resources
287289
&quot;encryptionKey&quot;: { # Defined a customer managed encryption key that will be used to encrypt Backup artifacts. # Optional. This defines a customer managed encryption key that will be used to encrypt the &quot;config&quot; portion (the Kubernetes resources) of Backups created via this plan. Default (empty): Config backup artifacts will not be encrypted.
@@ -428,6 +430,7 @@ <h3>Method Details</h3>
428430
{ # Response message for ListBackupPlans.
429431
&quot;backupPlans&quot;: [ # The list of BackupPlans matching the given criteria.
430432
{ # Defines the configuration and scheduling for a &quot;line&quot; of Backups.
433+
&quot;backupChannel&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the BackupChannel to be used to create a backup. This field is set only if the cluster being backed up is in a different project. `projects/*/locations/*/backupChannels/*`
431434
&quot;backupConfig&quot;: { # BackupConfig defines the configuration of Backups created via this BackupPlan. # Optional. Defines the configuration of Backups created via this BackupPlan.
432435
&quot;allNamespaces&quot;: True or False, # If True, include all namespaced resources
433436
&quot;encryptionKey&quot;: { # Defined a customer managed encryption key that will be used to encrypt Backup artifacts. # Optional. This defines a customer managed encryption key that will be used to encrypt the &quot;config&quot; portion (the Kubernetes resources) of Backups created via this plan. Default (empty): Config backup artifacts will not be encrypted.
@@ -535,6 +538,7 @@ <h3>Method Details</h3>
535538
The object takes the form of:
536539

537540
{ # Defines the configuration and scheduling for a &quot;line&quot; of Backups.
541+
&quot;backupChannel&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the BackupChannel to be used to create a backup. This field is set only if the cluster being backed up is in a different project. `projects/*/locations/*/backupChannels/*`
538542
&quot;backupConfig&quot;: { # BackupConfig defines the configuration of Backups created via this BackupPlan. # Optional. Defines the configuration of Backups created via this BackupPlan.
539543
&quot;allNamespaces&quot;: True or False, # If True, include all namespaced resources
540544
&quot;encryptionKey&quot;: { # Defined a customer managed encryption key that will be used to encrypt Backup artifacts. # Optional. This defines a customer managed encryption key that will be used to encrypt the &quot;config&quot; portion (the Kubernetes resources) of Backups created via this plan. Default (empty): Config backup artifacts will not be encrypted.

docs/dyn/gkebackup_v1.projects.locations.restorePlans.html

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -134,6 +134,7 @@ <h3>Method Details</h3>
134134
&quot;a_key&quot;: &quot;A String&quot;,
135135
},
136136
&quot;name&quot;: &quot;A String&quot;, # Output only. The full name of the RestorePlan resource. Format: `projects/*/locations/*/restorePlans/*`.
137+
&quot;restoreChannel&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the RestoreChannel to be used to create a RestorePlan. This field is set only if the `backup_plan` is in a different project than the RestorePlan. Format: `projects/*/locations/*/restoreChannels/*`
137138
&quot;restoreConfig&quot;: { # Configuration of a restore. # Required. Configuration of Restores created via this RestorePlan.
138139
&quot;allNamespaces&quot;: True or False, # Restore all namespaced resources in the Backup if set to &quot;True&quot;. Specifying this field to &quot;False&quot; is an error.
139140
&quot;clusterResourceConflictPolicy&quot;: &quot;A String&quot;, # Optional. Defines the behavior for handling the situation where cluster-scoped resources being restored already exist in the target cluster. This MUST be set to a value other than CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED if cluster_resource_restore_scope is not empty.
@@ -333,6 +334,7 @@ <h3>Method Details</h3>
333334
&quot;a_key&quot;: &quot;A String&quot;,
334335
},
335336
&quot;name&quot;: &quot;A String&quot;, # Output only. The full name of the RestorePlan resource. Format: `projects/*/locations/*/restorePlans/*`.
337+
&quot;restoreChannel&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the RestoreChannel to be used to create a RestorePlan. This field is set only if the `backup_plan` is in a different project than the RestorePlan. Format: `projects/*/locations/*/restoreChannels/*`
336338
&quot;restoreConfig&quot;: { # Configuration of a restore. # Required. Configuration of Restores created via this RestorePlan.
337339
&quot;allNamespaces&quot;: True or False, # Restore all namespaced resources in the Backup if set to &quot;True&quot;. Specifying this field to &quot;False&quot; is an error.
338340
&quot;clusterResourceConflictPolicy&quot;: &quot;A String&quot;, # Optional. Defines the behavior for handling the situation where cluster-scoped resources being restored already exist in the target cluster. This MUST be set to a value other than CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED if cluster_resource_restore_scope is not empty.
@@ -521,6 +523,7 @@ <h3>Method Details</h3>
521523
&quot;a_key&quot;: &quot;A String&quot;,
522524
},
523525
&quot;name&quot;: &quot;A String&quot;, # Output only. The full name of the RestorePlan resource. Format: `projects/*/locations/*/restorePlans/*`.
526+
&quot;restoreChannel&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the RestoreChannel to be used to create a RestorePlan. This field is set only if the `backup_plan` is in a different project than the RestorePlan. Format: `projects/*/locations/*/restoreChannels/*`
524527
&quot;restoreConfig&quot;: { # Configuration of a restore. # Required. Configuration of Restores created via this RestorePlan.
525528
&quot;allNamespaces&quot;: True or False, # Restore all namespaced resources in the Backup if set to &quot;True&quot;. Specifying this field to &quot;False&quot; is an error.
526529
&quot;clusterResourceConflictPolicy&quot;: &quot;A String&quot;, # Optional. Defines the behavior for handling the situation where cluster-scoped resources being restored already exist in the target cluster. This MUST be set to a value other than CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED if cluster_resource_restore_scope is not empty.
@@ -668,6 +671,7 @@ <h3>Method Details</h3>
668671
&quot;a_key&quot;: &quot;A String&quot;,
669672
},
670673
&quot;name&quot;: &quot;A String&quot;, # Output only. The full name of the RestorePlan resource. Format: `projects/*/locations/*/restorePlans/*`.
674+
&quot;restoreChannel&quot;: &quot;A String&quot;, # Output only. The fully qualified name of the RestoreChannel to be used to create a RestorePlan. This field is set only if the `backup_plan` is in a different project than the RestorePlan. Format: `projects/*/locations/*/restoreChannels/*`
671675
&quot;restoreConfig&quot;: { # Configuration of a restore. # Required. Configuration of Restores created via this RestorePlan.
672676
&quot;allNamespaces&quot;: True or False, # Restore all namespaced resources in the Backup if set to &quot;True&quot;. Specifying this field to &quot;False&quot; is an error.
673677
&quot;clusterResourceConflictPolicy&quot;: &quot;A String&quot;, # Optional. Defines the behavior for handling the situation where cluster-scoped resources being restored already exist in the target cluster. This MUST be set to a value other than CLUSTER_RESOURCE_CONFLICT_POLICY_UNSPECIFIED if cluster_resource_restore_scope is not empty.

0 commit comments

Comments
 (0)