Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit 4e469bf

Browse files
committedMar 18, 2025
feat(gkebackup): update the api
#### gkebackup:v1 The following keys were added: - resources.projects.resources.locations.resources.backupPlans.resources.backups.methods.list.parameters.returnPartialSuccess (Total Keys: 2) - schemas.Backup.properties.satisfiesPzi (Total Keys: 2) - schemas.Backup.properties.satisfiesPzs (Total Keys: 2) - schemas.ListBackupsResponse.properties.unreachable (Total Keys: 2) - schemas.VolumeBackup.properties.satisfiesPzi (Total Keys: 2) - schemas.VolumeBackup.properties.satisfiesPzs (Total Keys: 2)
1 parent ce44d00 commit 4e469bf

3 files changed

+51
-3
lines changed
 

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

+14-2
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,7 @@ <h2>Instance Methods</h2>
9898
<code><a href="#getIamPolicy">getIamPolicy(resource, options_requestedPolicyVersion=None, x__xgafv=None)</a></code></p>
9999
<p class="firstline">Gets the access control policy for a resource. Returns an empty policy if the resource exists and does not have a policy set.</p>
100100
<p class="toc_element">
101-
<code><a href="#list">list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
101+
<code><a href="#list">list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
102102
<p class="firstline">Lists the Backups for a given BackupPlan.</p>
103103
<p class="toc_element">
104104
<code><a href="#list_next">list_next()</a></code></p>
@@ -160,6 +160,8 @@ <h3>Method Details</h3>
160160
&quot;resourceCount&quot;: 42, # Output only. The total number of Kubernetes resources included in the Backup.
161161
&quot;retainDays&quot;: 42, # Optional. The age (in days) after which this Backup will be automatically deleted. Must be an integer value &gt;= 0: - If 0, no automatic deletion will occur for this Backup. - If not 0, this must be &gt;= delete_lock_days and &lt;= 365. Once a Backup is created, this value may only be increased. Defaults to the parent BackupPlan&#x27;s backup_retain_days value.
162162
&quot;retainExpireTime&quot;: &quot;A String&quot;, # Output only. The time at which this Backup will be automatically deleted (calculated from create_time + retain_days).
163+
&quot;satisfiesPzi&quot;: True or False, # Output only. [Output Only] Reserved for future use.
164+
&quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
163165
&quot;selectedApplications&quot;: { # A list of namespaced Kubernetes resources. # Output only. If set, the list of ProtectedApplications whose resources were included in the Backup.
164166
&quot;namespacedNames&quot;: [ # Optional. A list of namespaced Kubernetes resources.
165167
{ # A reference to a namespaced resource in Kubernetes.
@@ -295,6 +297,8 @@ <h3>Method Details</h3>
295297
&quot;resourceCount&quot;: 42, # Output only. The total number of Kubernetes resources included in the Backup.
296298
&quot;retainDays&quot;: 42, # Optional. The age (in days) after which this Backup will be automatically deleted. Must be an integer value &gt;= 0: - If 0, no automatic deletion will occur for this Backup. - If not 0, this must be &gt;= delete_lock_days and &lt;= 365. Once a Backup is created, this value may only be increased. Defaults to the parent BackupPlan&#x27;s backup_retain_days value.
297299
&quot;retainExpireTime&quot;: &quot;A String&quot;, # Output only. The time at which this Backup will be automatically deleted (calculated from create_time + retain_days).
300+
&quot;satisfiesPzi&quot;: True or False, # Output only. [Output Only] Reserved for future use.
301+
&quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
298302
&quot;selectedApplications&quot;: { # A list of namespaced Kubernetes resources. # Output only. If set, the list of ProtectedApplications whose resources were included in the Backup.
299303
&quot;namespacedNames&quot;: [ # Optional. A list of namespaced Kubernetes resources.
300304
{ # A reference to a namespaced resource in Kubernetes.
@@ -385,7 +389,7 @@ <h3>Method Details</h3>
385389
</div>
386390

387391
<div class="method">
388-
<code class="details" id="list">list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, x__xgafv=None)</code>
392+
<code class="details" id="list">list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
389393
<pre>Lists the Backups for a given BackupPlan.
390394

391395
Args:
@@ -394,6 +398,7 @@ <h3>Method Details</h3>
394398
orderBy: string, Optional. Field by which to sort the results.
395399
pageSize: integer, Optional. The target number of results to return in a single response. If not specified, a default value will be chosen by the service. Note that the response may include a partial list and a caller should only rely on the response&#x27;s next_page_token to determine if there are more instances left to be queried.
396400
pageToken: string, Optional. The value of next_page_token received from a previous `ListBackups` call. Provide this to retrieve the subsequent page in a multi-page list of results. When paginating, all other parameters provided to `ListBackups` must match the call that provided the page token.
401+
returnPartialSuccess: boolean, Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field will be populated.
397402
x__xgafv: string, V1 error format.
398403
Allowed values
399404
1 - v1 error format
@@ -437,6 +442,8 @@ <h3>Method Details</h3>
437442
&quot;resourceCount&quot;: 42, # Output only. The total number of Kubernetes resources included in the Backup.
438443
&quot;retainDays&quot;: 42, # Optional. The age (in days) after which this Backup will be automatically deleted. Must be an integer value &gt;= 0: - If 0, no automatic deletion will occur for this Backup. - If not 0, this must be &gt;= delete_lock_days and &lt;= 365. Once a Backup is created, this value may only be increased. Defaults to the parent BackupPlan&#x27;s backup_retain_days value.
439444
&quot;retainExpireTime&quot;: &quot;A String&quot;, # Output only. The time at which this Backup will be automatically deleted (calculated from create_time + retain_days).
445+
&quot;satisfiesPzi&quot;: True or False, # Output only. [Output Only] Reserved for future use.
446+
&quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
440447
&quot;selectedApplications&quot;: { # A list of namespaced Kubernetes resources. # Output only. If set, the list of ProtectedApplications whose resources were included in the Backup.
441448
&quot;namespacedNames&quot;: [ # Optional. A list of namespaced Kubernetes resources.
442449
{ # A reference to a namespaced resource in Kubernetes.
@@ -459,6 +466,9 @@ <h3>Method Details</h3>
459466
},
460467
],
461468
&quot;nextPageToken&quot;: &quot;A String&quot;, # A token which may be sent as page_token in a subsequent `ListBackups` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.
469+
&quot;unreachable&quot;: [ # Locations that could not be reached.
470+
&quot;A String&quot;,
471+
],
462472
}</pre>
463473
</div>
464474

@@ -518,6 +528,8 @@ <h3>Method Details</h3>
518528
&quot;resourceCount&quot;: 42, # Output only. The total number of Kubernetes resources included in the Backup.
519529
&quot;retainDays&quot;: 42, # Optional. The age (in days) after which this Backup will be automatically deleted. Must be an integer value &gt;= 0: - If 0, no automatic deletion will occur for this Backup. - If not 0, this must be &gt;= delete_lock_days and &lt;= 365. Once a Backup is created, this value may only be increased. Defaults to the parent BackupPlan&#x27;s backup_retain_days value.
520530
&quot;retainExpireTime&quot;: &quot;A String&quot;, # Output only. The time at which this Backup will be automatically deleted (calculated from create_time + retain_days).
531+
&quot;satisfiesPzi&quot;: True or False, # Output only. [Output Only] Reserved for future use.
532+
&quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
521533
&quot;selectedApplications&quot;: { # A list of namespaced Kubernetes resources. # Output only. If set, the list of ProtectedApplications whose resources were included in the Backup.
522534
&quot;namespacedNames&quot;: [ # Optional. A list of namespaced Kubernetes resources.
523535
{ # A reference to a namespaced resource in Kubernetes.

‎docs/dyn/gkebackup_v1.projects.locations.backupPlans.backups.volumeBackups.html

+4
Original file line numberDiff line numberDiff line change
@@ -122,6 +122,8 @@ <h3>Method Details</h3>
122122
&quot;etag&quot;: &quot;A String&quot;, # Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a volume backup from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform volume backup updates in order to avoid race conditions.
123123
&quot;format&quot;: &quot;A String&quot;, # Output only. The format used for the volume backup.
124124
&quot;name&quot;: &quot;A String&quot;, # Output only. The full name of the VolumeBackup resource. Format: `projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*`.
125+
&quot;satisfiesPzi&quot;: True or False, # Output only. [Output Only] Reserved for future use.
126+
&quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
125127
&quot;sourcePvc&quot;: { # A reference to a namespaced resource in Kubernetes. # Output only. A reference to the source Kubernetes PVC from which this VolumeBackup was created.
126128
&quot;name&quot;: &quot;A String&quot;, # Optional. The name of the Kubernetes resource.
127129
&quot;namespace&quot;: &quot;A String&quot;, # Optional. The Namespace of the Kubernetes resource.
@@ -211,6 +213,8 @@ <h3>Method Details</h3>
211213
&quot;etag&quot;: &quot;A String&quot;, # Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a volume backup from overwriting each other. It is strongly suggested that systems make use of the `etag` in the read-modify-write cycle to perform volume backup updates in order to avoid race conditions.
212214
&quot;format&quot;: &quot;A String&quot;, # Output only. The format used for the volume backup.
213215
&quot;name&quot;: &quot;A String&quot;, # Output only. The full name of the VolumeBackup resource. Format: `projects/*/locations/*/backupPlans/*/backups/*/volumeBackups/*`.
216+
&quot;satisfiesPzi&quot;: True or False, # Output only. [Output Only] Reserved for future use.
217+
&quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
214218
&quot;sourcePvc&quot;: { # A reference to a namespaced resource in Kubernetes. # Output only. A reference to the source Kubernetes PVC from which this VolumeBackup was created.
215219
&quot;name&quot;: &quot;A String&quot;, # Optional. The name of the Kubernetes resource.
216220
&quot;namespace&quot;: &quot;A String&quot;, # Optional. The Namespace of the Kubernetes resource.

‎googleapiclient/discovery_cache/documents/gkebackup.v1.json

+33-1
Original file line numberDiff line numberDiff line change
@@ -623,6 +623,11 @@
623623
"pattern": "^projects/[^/]+/locations/[^/]+/backupPlans/[^/]+$",
624624
"required": true,
625625
"type": "string"
626+
},
627+
"returnPartialSuccess": {
628+
"description": "Optional. If set to true, the response will return partial results when some regions are unreachable and the unreachable field will be populated.",
629+
"location": "query",
630+
"type": "boolean"
626631
}
627632
},
628633
"path": "v1/{+parent}/backups",
@@ -1713,7 +1718,7 @@
17131718
}
17141719
}
17151720
},
1716-
"revision": "20250226",
1721+
"revision": "20250305",
17171722
"rootUrl": "https://gkebackup.googleapis.com/",
17181723
"schemas": {
17191724
"AuditConfig": {
@@ -1876,6 +1881,16 @@
18761881
"readOnly": true,
18771882
"type": "string"
18781883
},
1884+
"satisfiesPzi": {
1885+
"description": "Output only. [Output Only] Reserved for future use.",
1886+
"readOnly": true,
1887+
"type": "boolean"
1888+
},
1889+
"satisfiesPzs": {
1890+
"description": "Output only. [Output Only] Reserved for future use.",
1891+
"readOnly": true,
1892+
"type": "boolean"
1893+
},
18791894
"selectedApplications": {
18801895
"$ref": "NamespacedNames",
18811896
"description": "Output only. If set, the list of ProtectedApplications whose resources were included in the Backup.",
@@ -2485,6 +2500,13 @@
24852500
"nextPageToken": {
24862501
"description": "A token which may be sent as page_token in a subsequent `ListBackups` call to retrieve the next page of results. If this field is omitted or empty, then there are no more results to return.",
24872502
"type": "string"
2503+
},
2504+
"unreachable": {
2505+
"description": "Locations that could not be reached.",
2506+
"items": {
2507+
"type": "string"
2508+
},
2509+
"type": "array"
24882510
}
24892511
},
24902512
"type": "object"
@@ -3402,6 +3424,16 @@
34023424
"readOnly": true,
34033425
"type": "string"
34043426
},
3427+
"satisfiesPzi": {
3428+
"description": "Output only. [Output Only] Reserved for future use.",
3429+
"readOnly": true,
3430+
"type": "boolean"
3431+
},
3432+
"satisfiesPzs": {
3433+
"description": "Output only. [Output Only] Reserved for future use.",
3434+
"readOnly": true,
3435+
"type": "boolean"
3436+
},
34053437
"sourcePvc": {
34063438
"$ref": "NamespacedName",
34073439
"description": "Output only. A reference to the source Kubernetes PVC from which this VolumeBackup was created.",

0 commit comments

Comments
 (0)
Please sign in to comment.