Debian Codegraph @

docs/dyn/compute_beta.regionDisks.html

raw
1 <html><body>
2 <style>
3
4 body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13 }
14
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51 }
52
53 .toc_element {
54 margin-top: 0.5em;
55 }
56
57 .firstline {
58 margin-left: 2 em;
59 }
60
61 .method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66 }
67
68 .details {
69 font-weight: bold;
70 font-size: 14px;
71 }
72
73 </style>
74
75 <h1><a href="compute_beta.html">Compute Engine API</a> . <a href="compute_beta.regionDisks.html">regionDisks</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#addResourcePolicies">addResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Adds existing resource policies to a regional disk. You can only add one</p>
80 <p class="toc_element">
81 <code><a href="#bulkInsert">bulkInsert(project, region, body=None, requestId=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Bulk create a set of disks.</p>
83 <p class="toc_element">
84 <code><a href="#close">close()</a></code></p>
85 <p class="firstline">Close httplib2 connections.</p>
86 <p class="toc_element">
87 <code><a href="#createSnapshot">createSnapshot(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Creates a snapshot of a specified persistent disk. For regular snapshot</p>
89 <p class="toc_element">
90 <code><a href="#delete">delete(project, region, disk, requestId=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Deletes the specified regional persistent disk. Deleting a regional disk</p>
92 <p class="toc_element">
93 <code><a href="#get">get(project, region, disk, x__xgafv=None)</a></code></p>
94 <p class="firstline">Returns a specified regional persistent disk.</p>
95 <p class="toc_element">
96 <code><a href="#getIamPolicy">getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Gets the access control policy for a resource. May be empty if no such</p>
98 <p class="toc_element">
99 <code><a href="#insert">insert(project, region, body=None, requestId=None, sourceImage=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Creates a persistent regional disk in the specified project using the data</p>
101 <p class="toc_element">
102 <code><a href="#list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
103 <p class="firstline">Retrieves the list of persistent disks contained within</p>
104 <p class="toc_element">
105 <code><a href="#list_next">list_next()</a></code></p>
106 <p class="firstline">Retrieves the next page of results.</p>
107 <p class="toc_element">
108 <code><a href="#removeResourcePolicies">removeResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
109 <p class="firstline">Removes resource policies from a regional disk.</p>
110 <p class="toc_element">
111 <code><a href="#resize">resize(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
112 <p class="firstline">Resizes the specified regional persistent disk.</p>
113 <p class="toc_element">
114 <code><a href="#setIamPolicy">setIamPolicy(project, region, resource, body=None, x__xgafv=None)</a></code></p>
115 <p class="firstline">Sets the access control policy on the specified resource.</p>
116 <p class="toc_element">
117 <code><a href="#setLabels">setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)</a></code></p>
118 <p class="firstline">Sets the labels on the target regional disk.</p>
119 <p class="toc_element">
120 <code><a href="#startAsyncReplication">startAsyncReplication(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
121 <p class="firstline">Starts asynchronous replication.</p>
122 <p class="toc_element">
123 <code><a href="#stopAsyncReplication">stopAsyncReplication(project, region, disk, requestId=None, x__xgafv=None)</a></code></p>
124 <p class="firstline">Stops asynchronous replication.</p>
125 <p class="toc_element">
126 <code><a href="#stopGroupAsyncReplication">stopGroupAsyncReplication(project, region, body=None, requestId=None, x__xgafv=None)</a></code></p>
127 <p class="firstline">Stops asynchronous replication for a consistency group of disks.</p>
128 <p class="toc_element">
129 <code><a href="#testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</a></code></p>
130 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
131 <p class="toc_element">
132 <code><a href="#update">update(project, region, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)</a></code></p>
133 <p class="firstline">Update the specified disk with the data included in the request. Update is</p>
134 <p class="toc_element">
135 <code><a href="#updateKmsKey">updateKmsKey(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
136 <p class="firstline">Rotates the customer-managed</p>
137 <h3>Method Details</h3>
138 <div class="method">
139 <code class="details" id="addResourcePolicies">addResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
140 <pre>Adds existing resource policies to a regional disk. You can only add one
141 policy which will be applied to this disk for scheduling snapshot
142 creation.
143
144 Args:
145 project: string, Project ID for this request. (required)
146 region: string, The name of the region for this request. (required)
147 disk: string, The disk name for this request. (required)
148 body: object, The request body.
149 The object takes the form of:
150
151 {
152 &quot;resourcePolicies&quot;: [ # Resource policies to be added to this disk.
153 &quot;A String&quot;,
154 ],
155 }
156
157 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
158 that if you must retry your request, the server will know to ignore the
159 request if it has already been completed.
160
161 For example, consider a situation where you make an initial request and
162 the request times out. If you make the request again with the same
163 request ID, the server can check if original operation with the same
164 request ID was received, and if so, will ignore the second request. This
165 prevents clients from accidentally creating duplicate commitments.
166
167 The request ID must be
168 a valid UUID with the exception that zero UUID is not supported
169 (00000000-0000-0000-0000-000000000000).
170 x__xgafv: string, V1 error format.
171 Allowed values
172 1 - v1 error format
173 2 - v2 error format
174
175 Returns:
176 An object of the form:
177
178 { # Represents an Operation resource.
179 #
180 # Google Compute Engine has three Operation resources:
181 #
182 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
183 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
184 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
185 #
186 # You can use an operation resource to manage asynchronous API requests.
187 # For more information, readHandling
188 # API responses.
189 #
190 # Operations can be global, regional or zonal.
191 #
192 # - For global operations, use the `globalOperations`
193 # resource.
194 # - For regional operations, use the
195 # `regionOperations` resource.
196 # - For zonal operations, use
197 # the `zoneOperations` resource.
198 #
199 #
200 #
201 # For more information, read
202 # Global, Regional, and Zonal Resources.
203 #
204 # Note that completed Operation resources have a limited
205 # retention period.
206 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
207 # Not present otherwise.
208 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
209 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
210 # set when the operation is created.
211 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
212 # text format.
213 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
214 # this field will be populated.
215 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
216 # operation.
217 {
218 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
219 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
220 # details. There is a set of defined message types to use for providing
221 # details.The syntax depends on the error code. For example,
222 # QuotaExceededInfo will have details when the error code is
223 # QUOTA_EXCEEDED.
224 {
225 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
226 #
227 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
228 # is not enabled:
229 #
230 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
231 # &quot;domain&quot;: &quot;googleapis.com&quot;
232 # &quot;metadata&quot;: {
233 # &quot;resource&quot;: &quot;projects/123&quot;,
234 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
235 # }
236 # }
237 #
238 # This response indicates that the pubsub.googleapis.com API is not enabled.
239 #
240 # Example of an error that is returned when attempting to create a Spanner
241 # instance in a region that is out of stock:
242 #
243 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
244 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
245 # &quot;metadata&quot;: {
246 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
247 # }
248 # }
249 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
250 # is typically the registered service name of the tool or product that
251 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
252 # generated by some common infrastructure, the error domain must be a
253 # globally unique value that identifies the infrastructure. For Google API
254 # infrastructure, the error domain is &quot;googleapis.com&quot;.
255 &quot;metadatas&quot;: { # Additional structured details about this error.
256 #
257 # Keys must match a regular expression of `a-z+` but should
258 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
259 # length. When identifying the current value of an exceeded limit, the units
260 # should be contained in the key, not the value. For example, rather than
261 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
262 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
263 # instances that can be created in a single (batch) request.
264 &quot;a_key&quot;: &quot;A String&quot;,
265 },
266 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
267 # proximate cause of the error. Error reasons are unique within a particular
268 # domain of errors. This should be at most 63 characters and match a
269 # regular expression of `A-Z+[A-Z0-9]`, which represents
270 # UPPER_SNAKE_CASE.
271 },
272 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
273 #
274 # For example, if a quota check failed with an error indicating the calling
275 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
276 # directly to the right place in the developer console to flip the bit.
277 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
278 { # Describes a URL link.
279 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
280 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
281 },
282 ],
283 },
284 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
285 # which can be attached to an RPC error.
286 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
287 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
288 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
289 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
290 },
291 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
292 &quot;dimensions&quot;: { # The map holding related quota dimensions.
293 &quot;a_key&quot;: &quot;A String&quot;,
294 },
295 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
296 # type or metric.
297 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
298 # or metric.
299 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
300 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
301 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
302 },
303 },
304 ],
305 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
306 # This property is optional.
307 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
308 },
309 ],
310 },
311 &quot;getVersionOperationMetadata&quot;: {
312 &quot;inlineSbomInfo&quot;: {
313 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
314 # appropriate identifiers.
315 &quot;a_key&quot;: &quot;A String&quot;,
316 },
317 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
318 # identifiers.
319 &quot;a_key&quot;: &quot;A String&quot;,
320 },
321 },
322 },
323 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
324 # message that was returned, such as `NOT FOUND`.
325 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
326 # status code that was returned. For example, a `404` means the
327 # resource was not found.
328 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
329 # defined by the server.
330 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
331 # This value is inRFC3339
332 # text format.
333 &quot;instancesBulkInsertOperationMetadata&quot;: {
334 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
335 # Example key: zones/us-central1-a
336 &quot;a_key&quot;: {
337 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
338 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
339 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
340 # error.
341 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
342 # if the flow is rolling forward or rolling back.
343 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
344 },
345 },
346 },
347 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
348 # Operation resources.
349 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
350 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
351 # group of operations results from a `bulkInsert` API request.
352 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
353 # `update`, or `delete`, and so on.
354 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
355 # There is no requirement that this be linear or support any granularity of
356 # operations. This should not be used to guess when the operation will be
357 # complete. This number should monotonically increase as the operation
358 # progresses.
359 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
360 # applicable when performing regional operations.
361 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
362 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
363 # this field will contain information on all underlying zonal actions and
364 # their state.
365 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
366 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
367 # Example key: zones/us-central1-a
368 &quot;a_key&quot;: {
369 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
370 # populated.
371 # different programming environments, including REST APIs and RPC APIs. It is
372 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
373 # three pieces of data: error code, error message, and error details.
374 #
375 # You can find out more about this error model and how to work with it in the
376 # [API Design Guide](https://cloud.google.com/apis/design/errors).
377 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
378 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
379 # message types for APIs to use.
380 {
381 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
382 },
383 ],
384 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
385 # user-facing error message should be localized and sent in the
386 # google.rpc.Status.details field, or localized by the client.
387 },
388 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
389 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
390 },
391 },
392 },
393 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
394 # This value is inRFC3339
395 # text format.
396 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
397 # following:
398 # `PENDING`, `RUNNING`, or `DONE`.
399 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
400 # operation.
401 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
402 # of the target resource.
403 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
404 # operations related to creating a snapshot, this points to the disk
405 # that the snapshot was created from.
406 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
407 # `[email protected]` or
408 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
409 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
410 # operation, this field will be populated.
411 {
412 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
413 # Engine returns NO_RESULTS_ON_PAGE if there
414 # are no results in the response.
415 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
416 # value format. For example:
417 #
418 # &quot;data&quot;: [
419 # {
420 # &quot;key&quot;: &quot;scope&quot;,
421 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
422 # }
423 {
424 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
425 # returned. For example, for warnings where there are no results in a list
426 # request for a particular zone, this key might be scope and
427 # the key value might be the zone name. Other examples might be a key
428 # indicating a deprecated resource and a suggested replacement, or a
429 # warning about invalid network settings (for example, if an instance
430 # attempts to perform IP forwarding but is not enabled for IP forwarding).
431 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
432 },
433 ],
434 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
435 },
436 ],
437 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
438 # applicable when performing per-zone operations.
439 }</pre>
440 </div>
441
442 <div class="method">
443 <code class="details" id="bulkInsert">bulkInsert(project, region, body=None, requestId=None, x__xgafv=None)</code>
444 <pre>Bulk create a set of disks.
445
446 Args:
447 project: string, Project ID for this request. (required)
448 region: string, The name of the region for this request. (required)
449 body: object, The request body.
450 The object takes the form of:
451
452 { # A transient resource used in compute.disks.bulkInsert and
453 # compute.regionDisks.bulkInsert. It is only used to process
454 # requests and is not persisted.
455 &quot;instantSnapshotGroupParameters&quot;: { # The parameters for the instant snapshot group.
456 &quot;sourceInstantSnapshotGroup&quot;: &quot;A String&quot;, # The source instant snapshot group used to create disks. You can provide
457 # this as a partial or full URL to the resource. For example, the following
458 # are valid values:
459 #
460 #
461 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup
462 # - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup
463 # - zones/zone/instantSnapshotGroups/instantSnapshotGroup
464 },
465 &quot;snapshotGroupParameters&quot;: { # The parameters for the snapshot group. The usage of snapshot group feature
466 # is restricted.
467 &quot;replicaZones&quot;: [ # URLs of the zones where disks should be replicated to. Only applicable
468 # for regional resources.
469 &quot;A String&quot;,
470 ],
471 &quot;sourceSnapshotGroup&quot;: &quot;A String&quot;, # The source snapshot group used to create disks. You can provide this as a
472 # partial or full URL to the resource. For example, the following are valid
473 # values:
474 #
475 #
476 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshotGroups/snapshotGroup
477 # - projects/project/global/snapshotGroups/snapshotGroup
478 # - global/snapshotGroups/snapshotGroup
479 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
480 # disks. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
481 # types.
482 },
483 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # The URL of the DiskConsistencyGroupPolicy for the group of disks to clone.
484 # This may be a full or partial URL, such as:
485 #
486 #
487 # -
488 # https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
489 #
490 # -
491 # projects/project/regions/region/resourcePolicies/resourcePolicy
492 #
493 # -
494 # regions/region/resourcePolicies/resourcePolicy
495 }
496
497 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
498 that if you must retry your request, the server will know to ignore the
499 request if it has already been completed.
500
501 For example, consider a situation where you make an initial request and
502 the request times out. If you make the request again with the same
503 request ID, the server can check if original operation with the same
504 request ID was received, and if so, will ignore the second request. This
505 prevents clients from accidentally creating duplicate commitments.
506
507 The request ID must be
508 a valid UUID with the exception that zero UUID is not supported
509 (00000000-0000-0000-0000-000000000000).
510 x__xgafv: string, V1 error format.
511 Allowed values
512 1 - v1 error format
513 2 - v2 error format
514
515 Returns:
516 An object of the form:
517
518 { # Represents an Operation resource.
519 #
520 # Google Compute Engine has three Operation resources:
521 #
522 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
523 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
524 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
525 #
526 # You can use an operation resource to manage asynchronous API requests.
527 # For more information, readHandling
528 # API responses.
529 #
530 # Operations can be global, regional or zonal.
531 #
532 # - For global operations, use the `globalOperations`
533 # resource.
534 # - For regional operations, use the
535 # `regionOperations` resource.
536 # - For zonal operations, use
537 # the `zoneOperations` resource.
538 #
539 #
540 #
541 # For more information, read
542 # Global, Regional, and Zonal Resources.
543 #
544 # Note that completed Operation resources have a limited
545 # retention period.
546 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
547 # Not present otherwise.
548 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
549 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
550 # set when the operation is created.
551 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
552 # text format.
553 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
554 # this field will be populated.
555 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
556 # operation.
557 {
558 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
559 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
560 # details. There is a set of defined message types to use for providing
561 # details.The syntax depends on the error code. For example,
562 # QuotaExceededInfo will have details when the error code is
563 # QUOTA_EXCEEDED.
564 {
565 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
566 #
567 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
568 # is not enabled:
569 #
570 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
571 # &quot;domain&quot;: &quot;googleapis.com&quot;
572 # &quot;metadata&quot;: {
573 # &quot;resource&quot;: &quot;projects/123&quot;,
574 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
575 # }
576 # }
577 #
578 # This response indicates that the pubsub.googleapis.com API is not enabled.
579 #
580 # Example of an error that is returned when attempting to create a Spanner
581 # instance in a region that is out of stock:
582 #
583 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
584 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
585 # &quot;metadata&quot;: {
586 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
587 # }
588 # }
589 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
590 # is typically the registered service name of the tool or product that
591 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
592 # generated by some common infrastructure, the error domain must be a
593 # globally unique value that identifies the infrastructure. For Google API
594 # infrastructure, the error domain is &quot;googleapis.com&quot;.
595 &quot;metadatas&quot;: { # Additional structured details about this error.
596 #
597 # Keys must match a regular expression of `a-z+` but should
598 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
599 # length. When identifying the current value of an exceeded limit, the units
600 # should be contained in the key, not the value. For example, rather than
601 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
602 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
603 # instances that can be created in a single (batch) request.
604 &quot;a_key&quot;: &quot;A String&quot;,
605 },
606 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
607 # proximate cause of the error. Error reasons are unique within a particular
608 # domain of errors. This should be at most 63 characters and match a
609 # regular expression of `A-Z+[A-Z0-9]`, which represents
610 # UPPER_SNAKE_CASE.
611 },
612 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
613 #
614 # For example, if a quota check failed with an error indicating the calling
615 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
616 # directly to the right place in the developer console to flip the bit.
617 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
618 { # Describes a URL link.
619 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
620 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
621 },
622 ],
623 },
624 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
625 # which can be attached to an RPC error.
626 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
627 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
628 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
629 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
630 },
631 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
632 &quot;dimensions&quot;: { # The map holding related quota dimensions.
633 &quot;a_key&quot;: &quot;A String&quot;,
634 },
635 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
636 # type or metric.
637 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
638 # or metric.
639 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
640 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
641 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
642 },
643 },
644 ],
645 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
646 # This property is optional.
647 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
648 },
649 ],
650 },
651 &quot;getVersionOperationMetadata&quot;: {
652 &quot;inlineSbomInfo&quot;: {
653 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
654 # appropriate identifiers.
655 &quot;a_key&quot;: &quot;A String&quot;,
656 },
657 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
658 # identifiers.
659 &quot;a_key&quot;: &quot;A String&quot;,
660 },
661 },
662 },
663 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
664 # message that was returned, such as `NOT FOUND`.
665 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
666 # status code that was returned. For example, a `404` means the
667 # resource was not found.
668 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
669 # defined by the server.
670 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
671 # This value is inRFC3339
672 # text format.
673 &quot;instancesBulkInsertOperationMetadata&quot;: {
674 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
675 # Example key: zones/us-central1-a
676 &quot;a_key&quot;: {
677 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
678 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
679 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
680 # error.
681 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
682 # if the flow is rolling forward or rolling back.
683 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
684 },
685 },
686 },
687 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
688 # Operation resources.
689 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
690 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
691 # group of operations results from a `bulkInsert` API request.
692 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
693 # `update`, or `delete`, and so on.
694 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
695 # There is no requirement that this be linear or support any granularity of
696 # operations. This should not be used to guess when the operation will be
697 # complete. This number should monotonically increase as the operation
698 # progresses.
699 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
700 # applicable when performing regional operations.
701 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
702 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
703 # this field will contain information on all underlying zonal actions and
704 # their state.
705 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
706 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
707 # Example key: zones/us-central1-a
708 &quot;a_key&quot;: {
709 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
710 # populated.
711 # different programming environments, including REST APIs and RPC APIs. It is
712 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
713 # three pieces of data: error code, error message, and error details.
714 #
715 # You can find out more about this error model and how to work with it in the
716 # [API Design Guide](https://cloud.google.com/apis/design/errors).
717 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
718 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
719 # message types for APIs to use.
720 {
721 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
722 },
723 ],
724 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
725 # user-facing error message should be localized and sent in the
726 # google.rpc.Status.details field, or localized by the client.
727 },
728 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
729 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
730 },
731 },
732 },
733 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
734 # This value is inRFC3339
735 # text format.
736 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
737 # following:
738 # `PENDING`, `RUNNING`, or `DONE`.
739 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
740 # operation.
741 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
742 # of the target resource.
743 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
744 # operations related to creating a snapshot, this points to the disk
745 # that the snapshot was created from.
746 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
747 # `[email protected]` or
748 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
749 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
750 # operation, this field will be populated.
751 {
752 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
753 # Engine returns NO_RESULTS_ON_PAGE if there
754 # are no results in the response.
755 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
756 # value format. For example:
757 #
758 # &quot;data&quot;: [
759 # {
760 # &quot;key&quot;: &quot;scope&quot;,
761 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
762 # }
763 {
764 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
765 # returned. For example, for warnings where there are no results in a list
766 # request for a particular zone, this key might be scope and
767 # the key value might be the zone name. Other examples might be a key
768 # indicating a deprecated resource and a suggested replacement, or a
769 # warning about invalid network settings (for example, if an instance
770 # attempts to perform IP forwarding but is not enabled for IP forwarding).
771 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
772 },
773 ],
774 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
775 },
776 ],
777 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
778 # applicable when performing per-zone operations.
779 }</pre>
780 </div>
781
782 <div class="method">
783 <code class="details" id="close">close()</code>
784 <pre>Close httplib2 connections.</pre>
785 </div>
786
787 <div class="method">
788 <code class="details" id="createSnapshot">createSnapshot(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
789 <pre>Creates a snapshot of a specified persistent disk. For regular snapshot
790 creation, consider using snapshots.insert
791 instead, as that method supports more features, such as creating snapshots
792 in a project different from the source disk project.
793
794 Args:
795 project: string, Project ID for this request. (required)
796 region: string, Name of the region for this request. (required)
797 disk: string, Name of the regional persistent disk to snapshot. (required)
798 body: object, The request body.
799 The object takes the form of:
800
801 { # Represents a Persistent Disk Snapshot resource.
802 #
803 # You can use snapshots to back up data on a regular interval. For more
804 # information, read Creating
805 # persistent disk snapshots.
806 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the snapshot. Valid values are
807 # ARM64 or X86_64.
808 &quot;autoCreated&quot;: True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
809 # applying resource policy on the target disk.
810 &quot;chainName&quot;: &quot;A String&quot;, # Creates the new snapshot in the snapshot chain labeled with the
811 # specified name. The chain name must be 1-63 characters long and comply
812 # with RFC1035. This is an uncommon option only for advanced service
813 # owners who needs to create separate snapshot chains, for example,
814 # for chargeback tracking. When you describe your snapshot resource, this
815 # field is visible only if it has a non-empty value.
816 &quot;creationSizeBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Size in bytes of the snapshot at creation time.
817 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
818 # text format.
819 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
820 # create the resource.
821 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Output only. [Output Only] Size of the source disk, specified in GB.
822 &quot;downloadBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
823 &quot;enableConfidentialCompute&quot;: True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
824 # [Output Only]: This field is not set by user, but from source disk.
825 &quot;guestFlush&quot;: True or False, # [Input Only] Whether to attempt an application consistent snapshot by
826 # informing the OS to prepare for the snapshot process.
827 &quot;guestOsFeatures&quot;: [ # Output only. [Output Only] A list of features to enable on the guest operating system.
828 # Applicable only for bootable images. Read
829 # Enabling guest operating system features to see a list of available
830 # options.
831 { # Guest OS features.
832 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
833 # separate values. Set to one or more of the following values:
834 #
835 # - VIRTIO_SCSI_MULTIQUEUE
836 # - WINDOWS
837 # - MULTI_IP_SUBNET
838 # - UEFI_COMPATIBLE
839 # - GVNIC
840 # - SEV_CAPABLE
841 # - SUSPEND_RESUME_COMPATIBLE
842 # - SEV_LIVE_MIGRATABLE_V2
843 # - SEV_SNP_CAPABLE
844 # - TDX_CAPABLE
845 # - IDPF
846 # - SNP_SVSM_CAPABLE
847 # - CCA_CAPABLE
848 #
849 #
850 # For more information, see
851 # Enabling guest operating system features.
852 },
853 ],
854 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
855 # defined by the server.
856 &quot;kind&quot;: &quot;compute#snapshot&quot;, # Output only. [Output Only] Type of the resource. Always compute#snapshot
857 # for Snapshot resources.
858 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this snapshot, which is
859 # essentially a hash of the labels set used for optimistic locking. The
860 # fingerprint is initially generated by Compute Engine and changes after
861 # every request to modify or update labels. You must always provide an
862 # up-to-date fingerprint hash in order to update or change labels,
863 # otherwise the request will fail with error412 conditionNotMet.
864 #
865 # To see the latest fingerprint, make a get() request to
866 # retrieve a snapshot.
867 &quot;labels&quot;: { # Labels to apply to this snapshot. These can be later modified by
868 # the setLabels method.
869 # Label values may be empty.
870 &quot;a_key&quot;: &quot;A String&quot;,
871 },
872 &quot;licenseCodes&quot;: [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
873 # to this snapshot.
874 &quot;A String&quot;,
875 ],
876 &quot;licenses&quot;: [ # Output only. [Output Only] A list of public visible licenses that apply to this
877 # snapshot. This can be because the original image had licenses attached
878 # (such as a Windows image).
879 &quot;A String&quot;,
880 ],
881 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the snapshot close to other
882 # resources.
883 # This field is for use by internal tools that use the public API.
884 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
885 # The name must be 1-63 characters long, and comply withRFC1035.
886 # Specifically, the name must be 1-63 characters long and match the regular
887 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
888 # character must be a lowercase letter, and all following characters must be
889 # a dash, lowercase letter, or digit, except the last character, which cannot
890 # be a dash.
891 &quot;params&quot;: { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted
892 # as part of resource payload.
893 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have
894 # the same definition as resource
895 # manager tags. Keys and values can be either in numeric format,
896 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
897 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
898 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
899 # PATCH) when empty.
900 &quot;a_key&quot;: &quot;A String&quot;,
901 },
902 },
903 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
904 # for regional snapshots.
905 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
906 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
907 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for the resource.
908 &quot;snapshotEncryptionKey&quot;: { # Encrypts the snapshot using acustomer-supplied
909 # encryption key.
910 #
911 # After you encrypt a snapshot using a customer-supplied key, you must
912 # provide the same key if you use the snapshot later. For example, you must
913 # provide the encryption key when you create a disk from the encrypted
914 # snapshot in a future request.
915 #
916 # Customer-supplied encryption keys do not protect access to metadata
917 # of the snapshot.
918 #
919 # If you do not provide an encryption key when creating the snapshot, then
920 # the snapshot will be encrypted using an automatically generated key and you
921 # do not need to provide a key to use the snapshot later.
922 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
923 # For example:
924 #
925 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
926 # key_region/cryptoKeys/key
927 #
928 # The fully-qualifed key name may be returned for resource GET requests. For
929 # example:
930 #
931 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
932 # key_region/cryptoKeys/key
933 # /cryptoKeyVersions/1
934 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
935 # key. If absent, the Compute Engine default service account is used.
936 # For example:
937 #
938 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
939 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
940 # encryption key, encoded in RFC
941 # 4648 base64 to either encrypt or decrypt this resource. You can
942 # provide either the rawKey or thersaEncryptedKey.
943 # For example:
944 #
945 # &quot;rawKey&quot;:
946 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
947 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
948 # customer-supplied encryption key to either encrypt or decrypt this
949 # resource. You can provide either the rawKey or thersaEncryptedKey.
950 # For example:
951 #
952 # &quot;rsaEncryptedKey&quot;:
953 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
954 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
955 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
956 #
957 # The key must meet the following requirements before you can provide it to
958 # Compute Engine:
959 #
960 # 1. The key is wrapped using a RSA public key certificate provided by
961 # Google.
962 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
963 # encoding.
964 #
965 # Gets the RSA public key certificate provided by Google at:
966 #
967 #
968 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
969 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
970 # 4648 base64 encoded SHA-256 hash of the customer-supplied
971 # encryption key that protects this resource.
972 },
973 &quot;snapshotGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot group that this snapshot
974 # belongs to. The usage of snapshot group feature is restricted.
975 &quot;snapshotGroupName&quot;: &quot;A String&quot;, # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
976 # of snapshot group feature is restricted.
977 &quot;snapshotType&quot;: &quot;A String&quot;, # Indicates the type of the snapshot.
978 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this snapshot.
979 &quot;sourceDiskEncryptionKey&quot;: { # The customer-supplied
980 # encryption key of the source disk. Required if the source disk is
981 # protected by a customer-supplied encryption key.
982 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
983 # For example:
984 #
985 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
986 # key_region/cryptoKeys/key
987 #
988 # The fully-qualifed key name may be returned for resource GET requests. For
989 # example:
990 #
991 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
992 # key_region/cryptoKeys/key
993 # /cryptoKeyVersions/1
994 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
995 # key. If absent, the Compute Engine default service account is used.
996 # For example:
997 #
998 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
999 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1000 # encryption key, encoded in RFC
1001 # 4648 base64 to either encrypt or decrypt this resource. You can
1002 # provide either the rawKey or thersaEncryptedKey.
1003 # For example:
1004 #
1005 # &quot;rawKey&quot;:
1006 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1007 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1008 # customer-supplied encryption key to either encrypt or decrypt this
1009 # resource. You can provide either the rawKey or thersaEncryptedKey.
1010 # For example:
1011 #
1012 # &quot;rsaEncryptedKey&quot;:
1013 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1014 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1015 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1016 #
1017 # The key must meet the following requirements before you can provide it to
1018 # Compute Engine:
1019 #
1020 # 1. The key is wrapped using a RSA public key certificate provided by
1021 # Google.
1022 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1023 # encoding.
1024 #
1025 # Gets the RSA public key certificate provided by Google at:
1026 #
1027 #
1028 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1029 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1030 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1031 # encryption key that protects this resource.
1032 },
1033 &quot;sourceDiskForRecoveryCheckpoint&quot;: &quot;A String&quot;, # The source disk whose recovery checkpoint will be used to create this
1034 # snapshot.
1035 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
1036 # value may be used to determine whether the snapshot was taken from the
1037 # current or a previous instance of a given disk name.
1038 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this snapshot. You can provide
1039 # this as a partial or full URL to the resource. For example, the following
1040 # are valid values:
1041 #
1042 #
1043 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
1044 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
1045 # - zones/zone/instantSnapshots/instantSnapshot
1046 &quot;sourceInstantSnapshotEncryptionKey&quot;: { # Customer provided encryption key when creating Snapshot from Instant
1047 # Snapshot.
1048 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1049 # For example:
1050 #
1051 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1052 # key_region/cryptoKeys/key
1053 #
1054 # The fully-qualifed key name may be returned for resource GET requests. For
1055 # example:
1056 #
1057 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1058 # key_region/cryptoKeys/key
1059 # /cryptoKeyVersions/1
1060 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1061 # key. If absent, the Compute Engine default service account is used.
1062 # For example:
1063 #
1064 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1065 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1066 # encryption key, encoded in RFC
1067 # 4648 base64 to either encrypt or decrypt this resource. You can
1068 # provide either the rawKey or thersaEncryptedKey.
1069 # For example:
1070 #
1071 # &quot;rawKey&quot;:
1072 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1073 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1074 # customer-supplied encryption key to either encrypt or decrypt this
1075 # resource. You can provide either the rawKey or thersaEncryptedKey.
1076 # For example:
1077 #
1078 # &quot;rsaEncryptedKey&quot;:
1079 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1080 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1081 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1082 #
1083 # The key must meet the following requirements before you can provide it to
1084 # Compute Engine:
1085 #
1086 # 1. The key is wrapped using a RSA public key certificate provided by
1087 # Google.
1088 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1089 # encoding.
1090 #
1091 # Gets the RSA public key certificate provided by Google at:
1092 #
1093 #
1094 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1095 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1096 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1097 # encryption key that protects this resource.
1098 },
1099 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
1100 # snapshot. This value identifies the exact instant snapshot that was used to
1101 # create this snapshot. For example, if you created the snapshot from an
1102 # instant snapshot that was later deleted and recreated under the same name,
1103 # the source instant snapshot ID would identify the exact instant snapshot
1104 # that was used.
1105 &quot;sourceSnapshotSchedulePolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the resource policy which created this
1106 # scheduled snapshot.
1107 &quot;sourceSnapshotSchedulePolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the resource policy which created this
1108 # scheduled snapshot.
1109 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
1110 &quot;storageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
1111 # share storage, this number is expected to change with snapshot
1112 # creation/deletion.
1113 &quot;storageBytesStatus&quot;: &quot;A String&quot;, # Output only. [Deprecated] Instead, check the storageBytes field. After
1114 # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
1115 # [Output Only] An indicator whether storageBytes is in a
1116 # stable state or it is being adjusted as a result of shared storage
1117 # reallocation. This status can either be unset, meaning the snapshot is
1118 # being created, or UP_TO_DATE, meaning the size of the snapshot
1119 # is up-to-date.
1120 &quot;storageLocations&quot;: [ # Cloud Storage bucket storage location of the snapshot (regional or
1121 # multi-regional).
1122 &quot;A String&quot;,
1123 ],
1124 }
1125
1126 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1127 that if you must retry your request, the server will know to ignore the
1128 request if it has already been completed.
1129
1130 For example, consider a situation where you make an initial request and
1131 the request times out. If you make the request again with the same
1132 request ID, the server can check if original operation with the same
1133 request ID was received, and if so, will ignore the second request. This
1134 prevents clients from accidentally creating duplicate commitments.
1135
1136 The request ID must be
1137 a valid UUID with the exception that zero UUID is not supported
1138 (00000000-0000-0000-0000-000000000000).
1139 x__xgafv: string, V1 error format.
1140 Allowed values
1141 1 - v1 error format
1142 2 - v2 error format
1143
1144 Returns:
1145 An object of the form:
1146
1147 { # Represents an Operation resource.
1148 #
1149 # Google Compute Engine has three Operation resources:
1150 #
1151 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
1152 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
1153 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
1154 #
1155 # You can use an operation resource to manage asynchronous API requests.
1156 # For more information, readHandling
1157 # API responses.
1158 #
1159 # Operations can be global, regional or zonal.
1160 #
1161 # - For global operations, use the `globalOperations`
1162 # resource.
1163 # - For regional operations, use the
1164 # `regionOperations` resource.
1165 # - For zonal operations, use
1166 # the `zoneOperations` resource.
1167 #
1168 #
1169 #
1170 # For more information, read
1171 # Global, Regional, and Zonal Resources.
1172 #
1173 # Note that completed Operation resources have a limited
1174 # retention period.
1175 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1176 # Not present otherwise.
1177 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1178 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1179 # set when the operation is created.
1180 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1181 # text format.
1182 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1183 # this field will be populated.
1184 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1185 # operation.
1186 {
1187 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1188 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1189 # details. There is a set of defined message types to use for providing
1190 # details.The syntax depends on the error code. For example,
1191 # QuotaExceededInfo will have details when the error code is
1192 # QUOTA_EXCEEDED.
1193 {
1194 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1195 #
1196 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1197 # is not enabled:
1198 #
1199 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1200 # &quot;domain&quot;: &quot;googleapis.com&quot;
1201 # &quot;metadata&quot;: {
1202 # &quot;resource&quot;: &quot;projects/123&quot;,
1203 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1204 # }
1205 # }
1206 #
1207 # This response indicates that the pubsub.googleapis.com API is not enabled.
1208 #
1209 # Example of an error that is returned when attempting to create a Spanner
1210 # instance in a region that is out of stock:
1211 #
1212 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1213 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1214 # &quot;metadata&quot;: {
1215 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1216 # }
1217 # }
1218 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1219 # is typically the registered service name of the tool or product that
1220 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1221 # generated by some common infrastructure, the error domain must be a
1222 # globally unique value that identifies the infrastructure. For Google API
1223 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1224 &quot;metadatas&quot;: { # Additional structured details about this error.
1225 #
1226 # Keys must match a regular expression of `a-z+` but should
1227 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1228 # length. When identifying the current value of an exceeded limit, the units
1229 # should be contained in the key, not the value. For example, rather than
1230 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1231 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1232 # instances that can be created in a single (batch) request.
1233 &quot;a_key&quot;: &quot;A String&quot;,
1234 },
1235 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1236 # proximate cause of the error. Error reasons are unique within a particular
1237 # domain of errors. This should be at most 63 characters and match a
1238 # regular expression of `A-Z+[A-Z0-9]`, which represents
1239 # UPPER_SNAKE_CASE.
1240 },
1241 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1242 #
1243 # For example, if a quota check failed with an error indicating the calling
1244 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1245 # directly to the right place in the developer console to flip the bit.
1246 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1247 { # Describes a URL link.
1248 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1249 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1250 },
1251 ],
1252 },
1253 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1254 # which can be attached to an RPC error.
1255 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1256 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1257 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1258 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1259 },
1260 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1261 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1262 &quot;a_key&quot;: &quot;A String&quot;,
1263 },
1264 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1265 # type or metric.
1266 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1267 # or metric.
1268 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1269 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1270 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1271 },
1272 },
1273 ],
1274 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1275 # This property is optional.
1276 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1277 },
1278 ],
1279 },
1280 &quot;getVersionOperationMetadata&quot;: {
1281 &quot;inlineSbomInfo&quot;: {
1282 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1283 # appropriate identifiers.
1284 &quot;a_key&quot;: &quot;A String&quot;,
1285 },
1286 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1287 # identifiers.
1288 &quot;a_key&quot;: &quot;A String&quot;,
1289 },
1290 },
1291 },
1292 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1293 # message that was returned, such as `NOT FOUND`.
1294 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1295 # status code that was returned. For example, a `404` means the
1296 # resource was not found.
1297 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1298 # defined by the server.
1299 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1300 # This value is inRFC3339
1301 # text format.
1302 &quot;instancesBulkInsertOperationMetadata&quot;: {
1303 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1304 # Example key: zones/us-central1-a
1305 &quot;a_key&quot;: {
1306 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1307 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1308 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1309 # error.
1310 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1311 # if the flow is rolling forward or rolling back.
1312 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1313 },
1314 },
1315 },
1316 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1317 # Operation resources.
1318 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1319 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1320 # group of operations results from a `bulkInsert` API request.
1321 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1322 # `update`, or `delete`, and so on.
1323 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1324 # There is no requirement that this be linear or support any granularity of
1325 # operations. This should not be used to guess when the operation will be
1326 # complete. This number should monotonically increase as the operation
1327 # progresses.
1328 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1329 # applicable when performing regional operations.
1330 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1331 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1332 # this field will contain information on all underlying zonal actions and
1333 # their state.
1334 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1335 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1336 # Example key: zones/us-central1-a
1337 &quot;a_key&quot;: {
1338 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
1339 # populated.
1340 # different programming environments, including REST APIs and RPC APIs. It is
1341 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1342 # three pieces of data: error code, error message, and error details.
1343 #
1344 # You can find out more about this error model and how to work with it in the
1345 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1346 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1347 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1348 # message types for APIs to use.
1349 {
1350 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1351 },
1352 ],
1353 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1354 # user-facing error message should be localized and sent in the
1355 # google.rpc.Status.details field, or localized by the client.
1356 },
1357 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1358 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1359 },
1360 },
1361 },
1362 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1363 # This value is inRFC3339
1364 # text format.
1365 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1366 # following:
1367 # `PENDING`, `RUNNING`, or `DONE`.
1368 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1369 # operation.
1370 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1371 # of the target resource.
1372 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1373 # operations related to creating a snapshot, this points to the disk
1374 # that the snapshot was created from.
1375 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1376 # `[email protected]` or
1377 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1378 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1379 # operation, this field will be populated.
1380 {
1381 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1382 # Engine returns NO_RESULTS_ON_PAGE if there
1383 # are no results in the response.
1384 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1385 # value format. For example:
1386 #
1387 # &quot;data&quot;: [
1388 # {
1389 # &quot;key&quot;: &quot;scope&quot;,
1390 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1391 # }
1392 {
1393 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1394 # returned. For example, for warnings where there are no results in a list
1395 # request for a particular zone, this key might be scope and
1396 # the key value might be the zone name. Other examples might be a key
1397 # indicating a deprecated resource and a suggested replacement, or a
1398 # warning about invalid network settings (for example, if an instance
1399 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1400 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1401 },
1402 ],
1403 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1404 },
1405 ],
1406 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1407 # applicable when performing per-zone operations.
1408 }</pre>
1409 </div>
1410
1411 <div class="method">
1412 <code class="details" id="delete">delete(project, region, disk, requestId=None, x__xgafv=None)</code>
1413 <pre>Deletes the specified regional persistent disk. Deleting a regional disk
1414 removes all the replicas of its data permanently and is irreversible.
1415 However, deleting a disk does not delete anysnapshots
1416 previously made from the disk. You must separatelydelete
1417 snapshots.
1418
1419 Args:
1420 project: string, Project ID for this request. (required)
1421 region: string, Name of the region for this request. (required)
1422 disk: string, Name of the regional persistent disk to delete. (required)
1423 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1424 that if you must retry your request, the server will know to ignore the
1425 request if it has already been completed.
1426
1427 For example, consider a situation where you make an initial request and
1428 the request times out. If you make the request again with the same
1429 request ID, the server can check if original operation with the same
1430 request ID was received, and if so, will ignore the second request. This
1431 prevents clients from accidentally creating duplicate commitments.
1432
1433 The request ID must be
1434 a valid UUID with the exception that zero UUID is not supported
1435 (00000000-0000-0000-0000-000000000000).
1436 x__xgafv: string, V1 error format.
1437 Allowed values
1438 1 - v1 error format
1439 2 - v2 error format
1440
1441 Returns:
1442 An object of the form:
1443
1444 { # Represents an Operation resource.
1445 #
1446 # Google Compute Engine has three Operation resources:
1447 #
1448 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
1449 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
1450 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
1451 #
1452 # You can use an operation resource to manage asynchronous API requests.
1453 # For more information, readHandling
1454 # API responses.
1455 #
1456 # Operations can be global, regional or zonal.
1457 #
1458 # - For global operations, use the `globalOperations`
1459 # resource.
1460 # - For regional operations, use the
1461 # `regionOperations` resource.
1462 # - For zonal operations, use
1463 # the `zoneOperations` resource.
1464 #
1465 #
1466 #
1467 # For more information, read
1468 # Global, Regional, and Zonal Resources.
1469 #
1470 # Note that completed Operation resources have a limited
1471 # retention period.
1472 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1473 # Not present otherwise.
1474 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1475 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1476 # set when the operation is created.
1477 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1478 # text format.
1479 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1480 # this field will be populated.
1481 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1482 # operation.
1483 {
1484 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1485 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1486 # details. There is a set of defined message types to use for providing
1487 # details.The syntax depends on the error code. For example,
1488 # QuotaExceededInfo will have details when the error code is
1489 # QUOTA_EXCEEDED.
1490 {
1491 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1492 #
1493 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1494 # is not enabled:
1495 #
1496 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1497 # &quot;domain&quot;: &quot;googleapis.com&quot;
1498 # &quot;metadata&quot;: {
1499 # &quot;resource&quot;: &quot;projects/123&quot;,
1500 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1501 # }
1502 # }
1503 #
1504 # This response indicates that the pubsub.googleapis.com API is not enabled.
1505 #
1506 # Example of an error that is returned when attempting to create a Spanner
1507 # instance in a region that is out of stock:
1508 #
1509 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1510 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1511 # &quot;metadata&quot;: {
1512 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1513 # }
1514 # }
1515 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1516 # is typically the registered service name of the tool or product that
1517 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1518 # generated by some common infrastructure, the error domain must be a
1519 # globally unique value that identifies the infrastructure. For Google API
1520 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1521 &quot;metadatas&quot;: { # Additional structured details about this error.
1522 #
1523 # Keys must match a regular expression of `a-z+` but should
1524 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1525 # length. When identifying the current value of an exceeded limit, the units
1526 # should be contained in the key, not the value. For example, rather than
1527 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1528 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1529 # instances that can be created in a single (batch) request.
1530 &quot;a_key&quot;: &quot;A String&quot;,
1531 },
1532 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1533 # proximate cause of the error. Error reasons are unique within a particular
1534 # domain of errors. This should be at most 63 characters and match a
1535 # regular expression of `A-Z+[A-Z0-9]`, which represents
1536 # UPPER_SNAKE_CASE.
1537 },
1538 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1539 #
1540 # For example, if a quota check failed with an error indicating the calling
1541 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1542 # directly to the right place in the developer console to flip the bit.
1543 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1544 { # Describes a URL link.
1545 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1546 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1547 },
1548 ],
1549 },
1550 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1551 # which can be attached to an RPC error.
1552 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1553 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1554 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1555 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1556 },
1557 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1558 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1559 &quot;a_key&quot;: &quot;A String&quot;,
1560 },
1561 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1562 # type or metric.
1563 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1564 # or metric.
1565 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1566 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1567 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1568 },
1569 },
1570 ],
1571 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1572 # This property is optional.
1573 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1574 },
1575 ],
1576 },
1577 &quot;getVersionOperationMetadata&quot;: {
1578 &quot;inlineSbomInfo&quot;: {
1579 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1580 # appropriate identifiers.
1581 &quot;a_key&quot;: &quot;A String&quot;,
1582 },
1583 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1584 # identifiers.
1585 &quot;a_key&quot;: &quot;A String&quot;,
1586 },
1587 },
1588 },
1589 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1590 # message that was returned, such as `NOT FOUND`.
1591 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1592 # status code that was returned. For example, a `404` means the
1593 # resource was not found.
1594 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1595 # defined by the server.
1596 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1597 # This value is inRFC3339
1598 # text format.
1599 &quot;instancesBulkInsertOperationMetadata&quot;: {
1600 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1601 # Example key: zones/us-central1-a
1602 &quot;a_key&quot;: {
1603 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1604 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1605 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1606 # error.
1607 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1608 # if the flow is rolling forward or rolling back.
1609 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1610 },
1611 },
1612 },
1613 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1614 # Operation resources.
1615 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1616 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1617 # group of operations results from a `bulkInsert` API request.
1618 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1619 # `update`, or `delete`, and so on.
1620 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1621 # There is no requirement that this be linear or support any granularity of
1622 # operations. This should not be used to guess when the operation will be
1623 # complete. This number should monotonically increase as the operation
1624 # progresses.
1625 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1626 # applicable when performing regional operations.
1627 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1628 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1629 # this field will contain information on all underlying zonal actions and
1630 # their state.
1631 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1632 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1633 # Example key: zones/us-central1-a
1634 &quot;a_key&quot;: {
1635 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
1636 # populated.
1637 # different programming environments, including REST APIs and RPC APIs. It is
1638 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1639 # three pieces of data: error code, error message, and error details.
1640 #
1641 # You can find out more about this error model and how to work with it in the
1642 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1643 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1644 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1645 # message types for APIs to use.
1646 {
1647 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1648 },
1649 ],
1650 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1651 # user-facing error message should be localized and sent in the
1652 # google.rpc.Status.details field, or localized by the client.
1653 },
1654 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1655 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1656 },
1657 },
1658 },
1659 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1660 # This value is inRFC3339
1661 # text format.
1662 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1663 # following:
1664 # `PENDING`, `RUNNING`, or `DONE`.
1665 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1666 # operation.
1667 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1668 # of the target resource.
1669 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1670 # operations related to creating a snapshot, this points to the disk
1671 # that the snapshot was created from.
1672 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1673 # `[email protected]` or
1674 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1675 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1676 # operation, this field will be populated.
1677 {
1678 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1679 # Engine returns NO_RESULTS_ON_PAGE if there
1680 # are no results in the response.
1681 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1682 # value format. For example:
1683 #
1684 # &quot;data&quot;: [
1685 # {
1686 # &quot;key&quot;: &quot;scope&quot;,
1687 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1688 # }
1689 {
1690 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1691 # returned. For example, for warnings where there are no results in a list
1692 # request for a particular zone, this key might be scope and
1693 # the key value might be the zone name. Other examples might be a key
1694 # indicating a deprecated resource and a suggested replacement, or a
1695 # warning about invalid network settings (for example, if an instance
1696 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1697 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1698 },
1699 ],
1700 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1701 },
1702 ],
1703 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1704 # applicable when performing per-zone operations.
1705 }</pre>
1706 </div>
1707
1708 <div class="method">
1709 <code class="details" id="get">get(project, region, disk, x__xgafv=None)</code>
1710 <pre>Returns a specified regional persistent disk.
1711
1712 Args:
1713 project: string, Project ID for this request. (required)
1714 region: string, Name of the region for this request. (required)
1715 disk: string, Name of the regional persistent disk to return. (required)
1716 x__xgafv: string, V1 error format.
1717 Allowed values
1718 1 - v1 error format
1719 2 - v2 error format
1720
1721 Returns:
1722 An object of the form:
1723
1724 { # Represents a Persistent Disk resource.
1725 #
1726 # Google Compute Engine has two Disk resources:
1727 #
1728 # * [Zonal](/compute/docs/reference/rest/beta/disks)
1729 # * [Regional](/compute/docs/reference/rest/beta/regionDisks)
1730 #
1731 # Persistent disks are required for running your VM instances.
1732 # Create both boot and non-boot (data) persistent disks. For more information,
1733 # read Persistent Disks. For more
1734 # storage options, read Storage options.
1735 #
1736 # The disks resource represents a zonal persistent disk.
1737 # For more information, readZonal persistent disks.
1738 #
1739 # The regionDisks resource represents a
1740 # regional persistent disk. For more information, read
1741 # Regional resources.
1742 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
1743 #
1744 #
1745 # - READ_WRITE_SINGLE: The default AccessMode, means the
1746 # disk can be attached to single instance in RW mode.
1747 # - READ_WRITE_MANY: The AccessMode means the disk can be
1748 # attached to multiple instances in RW mode.
1749 # - READ_ONLY_MANY: The AccessMode means the disk can be
1750 # attached to multiple instances in RO mode.
1751 #
1752 #
1753 # The AccessMode is only valid for Hyperdisk disk types.
1754 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
1755 # ARM64 or X86_64.
1756 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
1757 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
1758 # started on the disk as a member of a group.
1759 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
1760 # started on the disk as a member of a group.
1761 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
1762 # You can provide this as a partial or full URL to the resource.
1763 # For example, the following are valid values:
1764 #
1765 #
1766 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
1767 # - projects/project/zones/zone/disks/disk
1768 # - zones/zone/disks/disk
1769 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
1770 # to or from the current disk. This value identifies the exact disk that
1771 # was used to create this replication. For example, if you started
1772 # replicating the persistent disk from a disk that was later deleted and
1773 # recreated under the same name, the disk ID would identify the exact
1774 # version of the disk that was used.
1775 },
1776 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
1777 &quot;a_key&quot;: {
1778 &quot;asyncReplicationDisk&quot;: {
1779 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
1780 # started on the disk as a member of a group.
1781 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
1782 # started on the disk as a member of a group.
1783 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
1784 # You can provide this as a partial or full URL to the resource.
1785 # For example, the following are valid values:
1786 #
1787 #
1788 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
1789 # - projects/project/zones/zone/disks/disk
1790 # - zones/zone/disks/disk
1791 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
1792 # to or from the current disk. This value identifies the exact disk that
1793 # was used to create this replication. For example, if you started
1794 # replicating the persistent disk from a disk that was later deleted and
1795 # recreated under the same name, the disk ID would identify the exact
1796 # version of the disk that was used.
1797 },
1798 },
1799 },
1800 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
1801 # text format.
1802 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1803 # create the resource.
1804 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
1805 # customer-supplied encryption key or a
1806 # customer-managed encryption key.
1807 #
1808 # Encryption keys do not protect access to metadata of the disk.
1809 #
1810 # After you encrypt a disk with a customer-supplied key, you must provide the
1811 # same key if you use the disk later. For example, to create a disk snapshot,
1812 # to create a disk image, to create a machine image, or to attach the disk to
1813 # a virtual machine.
1814 #
1815 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
1816 # name once the disk is created. The disk is encrypted with this version of
1817 # the key. In the response, diskEncryptionKey.kmsKeyName appears
1818 # in the following format:
1819 #
1820 # &quot;diskEncryptionKey.kmsKeyName&quot;:
1821 # &quot;projects/kms_project_id/locations/region/keyRings/
1822 # key_region/cryptoKeys/key
1823 # /cryptoKeysVersions/version
1824 #
1825 # If you do not provide an encryption key when creating the disk, then the
1826 # disk is encrypted using an automatically generated key and you don&#x27;t need
1827 # to provide a key to use the disk later.
1828 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1829 # For example:
1830 #
1831 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1832 # key_region/cryptoKeys/key
1833 #
1834 # The fully-qualifed key name may be returned for resource GET requests. For
1835 # example:
1836 #
1837 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1838 # key_region/cryptoKeys/key
1839 # /cryptoKeyVersions/1
1840 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1841 # key. If absent, the Compute Engine default service account is used.
1842 # For example:
1843 #
1844 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1845 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1846 # encryption key, encoded in RFC
1847 # 4648 base64 to either encrypt or decrypt this resource. You can
1848 # provide either the rawKey or thersaEncryptedKey.
1849 # For example:
1850 #
1851 # &quot;rawKey&quot;:
1852 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1853 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1854 # customer-supplied encryption key to either encrypt or decrypt this
1855 # resource. You can provide either the rawKey or thersaEncryptedKey.
1856 # For example:
1857 #
1858 # &quot;rsaEncryptedKey&quot;:
1859 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1860 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1861 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1862 #
1863 # The key must meet the following requirements before you can provide it to
1864 # Compute Engine:
1865 #
1866 # 1. The key is wrapped using a RSA public key certificate provided by
1867 # Google.
1868 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1869 # encoding.
1870 #
1871 # Gets the RSA public key certificate provided by Google at:
1872 #
1873 #
1874 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1875 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1876 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1877 # encryption key that protects this resource.
1878 },
1879 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
1880 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
1881 # Windows specific VSS signature.
1882 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
1883 # only for bootable images. Read
1884 # Enabling guest operating system features to see a list of available
1885 # options.
1886 { # Guest OS features.
1887 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
1888 # separate values. Set to one or more of the following values:
1889 #
1890 # - VIRTIO_SCSI_MULTIQUEUE
1891 # - WINDOWS
1892 # - MULTI_IP_SUBNET
1893 # - UEFI_COMPATIBLE
1894 # - GVNIC
1895 # - SEV_CAPABLE
1896 # - SUSPEND_RESUME_COMPATIBLE
1897 # - SEV_LIVE_MIGRATABLE_V2
1898 # - SEV_SNP_CAPABLE
1899 # - TDX_CAPABLE
1900 # - IDPF
1901 # - SNP_SVSM_CAPABLE
1902 # - CCA_CAPABLE
1903 #
1904 #
1905 # For more information, see
1906 # Enabling guest operating system features.
1907 },
1908 ],
1909 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
1910 # defined by the server.
1911 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
1912 # which is either SCSI or NVME. The default isSCSI.
1913 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
1914 # disks.
1915 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
1916 # essentially a hash of the labels set used for optimistic locking. The
1917 # fingerprint is initially generated by Compute Engine and changes after
1918 # every request to modify or update labels. You must always provide an
1919 # up-to-date fingerprint hash in order to update or change labels,
1920 # otherwise the request will fail with error412 conditionNotMet.
1921 #
1922 # To see the latest fingerprint, make a get() request to
1923 # retrieve a disk.
1924 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
1925 # the setLabels method.
1926 &quot;a_key&quot;: &quot;A String&quot;,
1927 },
1928 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
1929 # text format.
1930 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
1931 # text format.
1932 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
1933 &quot;A String&quot;,
1934 ],
1935 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
1936 &quot;A String&quot;,
1937 ],
1938 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
1939 # This field is for use by internal tools that use the public API.
1940 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
1941 # source image. Attachment of a disk created from a locked source image will
1942 # cause the following operations to become irreversibly prohibited:
1943 #
1944 # - R/W or R/O disk attachment to any other instance
1945 # - Disk detachment. And the disk can only be deleted when the instance
1946 # is deleted
1947 # - Creation of images or snapshots
1948 # - Disk cloning
1949 #
1950 #
1951 #
1952 # Furthermore, the instance with at least one disk with locked flag set to
1953 # true will be prohibited from performing the operations below:
1954 #
1955 # - Further attachment of secondary disks.
1956 # - Detachment of any disks
1957 # - Create machine images
1958 # - Create instance template
1959 # - Delete the instance with --keep-disk parameter set to true for locked
1960 # disks
1961 # - Attach a locked disk with --auto-delete parameter set to false
1962 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
1963 # more than one instance.
1964 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1965 # The name must be 1-63 characters long, and comply withRFC1035.
1966 # Specifically, the name must be 1-63 characters long and match the regular
1967 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
1968 # which means the first character must be a lowercase letter, and all
1969 # following characters must be a dash, lowercase letter, or digit, except
1970 # the last character, which cannot be a dash.
1971 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
1972 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
1973 # as part of resource payload.
1974 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
1975 # have the same definition as resource
1976 # manager tags. Keys and values can be either in numeric format,
1977 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1978 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1979 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
1980 # PATCH) when empty.
1981 &quot;a_key&quot;: &quot;A String&quot;,
1982 },
1983 },
1984 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
1985 # If not present in a request, a default value is used.
1986 # The currently supported size is 4096, other sizes may be added in
1987 # the future.
1988 # If an unsupported value is requested, the error message will list
1989 # the supported values for the caller&#x27;s project.
1990 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
1991 # of I/O operations per second that the disk can handle. Values must be
1992 # between 10,000 and 120,000. For more details, see theExtreme persistent
1993 # disk documentation.
1994 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
1995 # number of throughput mb per second that the disk can handle. Values must be
1996 # greater than or equal to 1.
1997 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
1998 # regional resources.
1999 # You must specify this field as part of the HTTP request URL. It is
2000 # not settable as a field in the request body.
2001 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
2002 # for regional resources.
2003 &quot;A String&quot;,
2004 ],
2005 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
2006 &quot;A String&quot;,
2007 ],
2008 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
2009 &quot;asyncPrimaryDisk&quot;: {
2010 &quot;state&quot;: &quot;A String&quot;,
2011 },
2012 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
2013 &quot;a_key&quot;: {
2014 &quot;state&quot;: &quot;A String&quot;,
2015 },
2016 },
2017 },
2018 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
2019 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
2020 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
2021 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
2022 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
2023 # persistent disk.
2024 #
2025 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
2026 # source.
2027 # Acceptable values are greater than 0.
2028 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
2029 # that was created using a consistency group.
2030 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
2031 # that was created using a consistency group.
2032 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
2033 # partial or full URL to the resource. For example, the following are valid
2034 # values:
2035 #
2036 #
2037 # -
2038 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
2039 #
2040 # -
2041 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
2042 #
2043 # -
2044 # projects/project/zones/zone/disks/disk
2045 #
2046 # -
2047 # projects/project/regions/region/disks/disk
2048 #
2049 # -
2050 # zones/zone/disks/disk
2051 #
2052 # -
2053 # regions/region/disks/disk
2054 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
2055 # value identifies the exact disk that was used to create this persistent
2056 # disk. For example, if you created the persistent disk from a disk that
2057 # was later deleted and recreated under the same name, the source disk ID
2058 # would identify the exact version of the disk that was used.
2059 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
2060 # deleted, this field will not be set.
2061 #
2062 # To create a disk with one of the public operating system images, specify
2063 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
2064 #
2065 # projects/debian-cloud/global/images/family/debian-9
2066 #
2067 #
2068 # Alternatively, use a specific version of a public operating system image:
2069 #
2070 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
2071 #
2072 #
2073 # To create a disk with a custom image that you created, specify the
2074 # image name in the following format:
2075 #
2076 # global/images/my-custom-image
2077 #
2078 #
2079 # You can also specify a custom image by its image family, which returns
2080 # the latest version of the image in that family. Replace the image name
2081 # with family/family-name:
2082 #
2083 # global/images/family/my-image-family
2084 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
2085 # encryption key of the source image. Required if the source image is
2086 # protected by a customer-supplied encryption key.
2087 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2088 # For example:
2089 #
2090 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2091 # key_region/cryptoKeys/key
2092 #
2093 # The fully-qualifed key name may be returned for resource GET requests. For
2094 # example:
2095 #
2096 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2097 # key_region/cryptoKeys/key
2098 # /cryptoKeyVersions/1
2099 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2100 # key. If absent, the Compute Engine default service account is used.
2101 # For example:
2102 #
2103 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2104 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2105 # encryption key, encoded in RFC
2106 # 4648 base64 to either encrypt or decrypt this resource. You can
2107 # provide either the rawKey or thersaEncryptedKey.
2108 # For example:
2109 #
2110 # &quot;rawKey&quot;:
2111 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2112 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2113 # customer-supplied encryption key to either encrypt or decrypt this
2114 # resource. You can provide either the rawKey or thersaEncryptedKey.
2115 # For example:
2116 #
2117 # &quot;rsaEncryptedKey&quot;:
2118 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2119 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2120 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2121 #
2122 # The key must meet the following requirements before you can provide it to
2123 # Compute Engine:
2124 #
2125 # 1. The key is wrapped using a RSA public key certificate provided by
2126 # Google.
2127 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2128 # encoding.
2129 #
2130 # Gets the RSA public key certificate provided by Google at:
2131 #
2132 #
2133 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2134 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2135 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2136 # encryption key that protects this resource.
2137 },
2138 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
2139 # value identifies the exact image that was used to create this persistent
2140 # disk. For example, if you created the persistent disk from an image that
2141 # was later deleted and recreated under the same name, the source image ID
2142 # would identify the exact version of the image that was used.
2143 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
2144 # this as a partial or full URL to the resource. For example, the following
2145 # are valid values:
2146 #
2147 #
2148 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
2149 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
2150 # - zones/zone/instantSnapshots/instantSnapshot
2151 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
2152 # disk. This value identifies the exact instant snapshot that was used to
2153 # create this persistent disk. For example, if you created the persistent
2154 # disk from an instant snapshot that was later deleted and recreated under
2155 # the same name, the source instant snapshot ID would identify the exact
2156 # version of the instant snapshot that was used.
2157 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
2158 # partial or full URL to the resource. For example, the following are valid
2159 # values:
2160 #
2161 #
2162 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
2163 # - projects/project/global/machineImages/machineImage
2164 # - global/machineImages/machineImage
2165 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
2166 # source_machine_image must be specified.
2167 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
2168 # encryption key of the source machine image. Required if the source
2169 # machine image is protected by a customer-supplied encryption key.
2170 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2171 # For example:
2172 #
2173 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2174 # key_region/cryptoKeys/key
2175 #
2176 # The fully-qualifed key name may be returned for resource GET requests. For
2177 # example:
2178 #
2179 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2180 # key_region/cryptoKeys/key
2181 # /cryptoKeyVersions/1
2182 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2183 # key. If absent, the Compute Engine default service account is used.
2184 # For example:
2185 #
2186 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2187 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2188 # encryption key, encoded in RFC
2189 # 4648 base64 to either encrypt or decrypt this resource. You can
2190 # provide either the rawKey or thersaEncryptedKey.
2191 # For example:
2192 #
2193 # &quot;rawKey&quot;:
2194 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2195 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2196 # customer-supplied encryption key to either encrypt or decrypt this
2197 # resource. You can provide either the rawKey or thersaEncryptedKey.
2198 # For example:
2199 #
2200 # &quot;rsaEncryptedKey&quot;:
2201 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2202 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2203 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2204 #
2205 # The key must meet the following requirements before you can provide it to
2206 # Compute Engine:
2207 #
2208 # 1. The key is wrapped using a RSA public key certificate provided by
2209 # Google.
2210 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2211 # encoding.
2212 #
2213 # Gets the RSA public key certificate provided by Google at:
2214 #
2215 #
2216 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2217 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2218 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2219 # encryption key that protects this resource.
2220 },
2221 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
2222 # This value identifies the exact machine image that was used to create this
2223 # persistent disk. For example, if you created the persistent disk from a
2224 # machine image that was later deleted and recreated under the same name, the
2225 # source machine image ID would identify the exact version of the machine
2226 # image that was used.
2227 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
2228 # partial or full URL to the resource. For example, the following are valid
2229 # values:
2230 #
2231 #
2232 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
2233 # - projects/project/global/snapshots/snapshot
2234 # - global/snapshots/snapshot
2235 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
2236 # encryption key of the source snapshot. Required if the source snapshot
2237 # is protected by a customer-supplied encryption key.
2238 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2239 # For example:
2240 #
2241 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2242 # key_region/cryptoKeys/key
2243 #
2244 # The fully-qualifed key name may be returned for resource GET requests. For
2245 # example:
2246 #
2247 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2248 # key_region/cryptoKeys/key
2249 # /cryptoKeyVersions/1
2250 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2251 # key. If absent, the Compute Engine default service account is used.
2252 # For example:
2253 #
2254 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2255 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2256 # encryption key, encoded in RFC
2257 # 4648 base64 to either encrypt or decrypt this resource. You can
2258 # provide either the rawKey or thersaEncryptedKey.
2259 # For example:
2260 #
2261 # &quot;rawKey&quot;:
2262 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2263 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2264 # customer-supplied encryption key to either encrypt or decrypt this
2265 # resource. You can provide either the rawKey or thersaEncryptedKey.
2266 # For example:
2267 #
2268 # &quot;rsaEncryptedKey&quot;:
2269 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2270 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2271 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2272 #
2273 # The key must meet the following requirements before you can provide it to
2274 # Compute Engine:
2275 #
2276 # 1. The key is wrapped using a RSA public key certificate provided by
2277 # Google.
2278 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2279 # encoding.
2280 #
2281 # Gets the RSA public key certificate provided by Google at:
2282 #
2283 #
2284 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2285 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2286 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2287 # encryption key that protects this resource.
2288 },
2289 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
2290 # value identifies the exact snapshot that was used to create this persistent
2291 # disk. For example, if you created the persistent disk from a snapshot that
2292 # was later deleted and recreated under the same name, the source snapshot ID
2293 # would identify the exact version of the snapshot that was used.
2294 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
2295 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
2296 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
2297 # https://storage.googleapis.com/. This flag is not optimized for creating
2298 # multiple disks from a source storage object. To create many disks from a
2299 # source storage object, use gcloud compute images
2300 # import instead.
2301 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
2302 #
2303 #
2304 # - CREATING: Disk is provisioning.
2305 # - RESTORING: Source data is being copied into the
2306 # disk.
2307 # - FAILED: Disk creation failed.
2308 # - READY: Disk is ready for use.
2309 # - DELETING: Disk is deleting.
2310 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
2311 # this as a partial or full URL to the resource. For example, the following
2312 # are valid values:
2313 #
2314 #
2315 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
2316 # - projects/project/zones/zone/storagePools/storagePool
2317 # - zones/zone/storagePools/storagePool
2318 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
2319 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
2320 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
2321 # types.
2322 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
2323 # in form:projects/project/zones/zone/instances/instance
2324 &quot;A String&quot;,
2325 ],
2326 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
2327 # You must specify this field as part of the HTTP request URL. It is
2328 # not settable as a field in the request body.
2329 }</pre>
2330 </div>
2331
2332 <div class="method">
2333 <code class="details" id="getIamPolicy">getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</code>
2334 <pre>Gets the access control policy for a resource. May be empty if no such
2335 policy or resource exists.
2336
2337 Args:
2338 project: string, Project ID for this request. (required)
2339 region: string, The name of the region for this request. (required)
2340 resource: string, Name or id of the resource for this request. (required)
2341 optionsRequestedPolicyVersion: integer, Requested IAM Policy version.
2342 x__xgafv: string, V1 error format.
2343 Allowed values
2344 1 - v1 error format
2345 2 - v2 error format
2346
2347 Returns:
2348 An object of the form:
2349
2350 { # An Identity and Access Management (IAM) policy, which specifies access
2351 # controls for Google Cloud resources.
2352 #
2353 #
2354 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
2355 # `members`, or principals, to a single `role`. Principals can be user
2356 # accounts, service accounts, Google groups, and domains (such as G Suite). A
2357 # `role` is a named list of permissions; each `role` can be an IAM predefined
2358 # role or a user-created custom role.
2359 #
2360 # For some types of Google Cloud resources, a `binding` can also specify a
2361 # `condition`, which is a logical expression that allows access to a resource
2362 # only if the expression evaluates to `true`. A condition can add constraints
2363 # based on attributes of the request, the resource, or both. To learn which
2364 # resources support conditions in their IAM policies, see the
2365 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2366 #
2367 # **JSON example:**
2368 #
2369 # ```
2370 # {
2371 # &quot;bindings&quot;: [
2372 # {
2373 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
2374 # &quot;members&quot;: [
2375 # &quot;user:[email protected]&quot;,
2376 # &quot;group:[email protected]&quot;,
2377 # &quot;domain:google.com&quot;,
2378 # &quot;serviceAccount:[email protected]&quot;
2379 # ]
2380 # },
2381 # {
2382 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
2383 # &quot;members&quot;: [
2384 # &quot;user:[email protected]&quot;
2385 # ],
2386 # &quot;condition&quot;: {
2387 # &quot;title&quot;: &quot;expirable access&quot;,
2388 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
2389 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
2390 # }
2391 # }
2392 # ],
2393 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
2394 # &quot;version&quot;: 3
2395 # }
2396 # ```
2397 #
2398 # **YAML example:**
2399 #
2400 # ```
2401 # bindings:
2402 # - members:
2403 # - user:[email protected]
2404 # - group:[email protected]
2405 # - domain:google.com
2406 # - serviceAccount:[email protected]
2407 # role: roles/resourcemanager.organizationAdmin
2408 # - members:
2409 # - user:[email protected]
2410 # role: roles/resourcemanager.organizationViewer
2411 # condition:
2412 # title: expirable access
2413 # description: Does not grant access after Sep 2020
2414 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
2415 # etag: BwWWja0YfJA=
2416 # version: 3
2417 # ```
2418 #
2419 # For a description of IAM and its features, see the
2420 # [IAM documentation](https://cloud.google.com/iam/docs/).
2421 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
2422 { # Specifies the audit configuration for a service.
2423 # The configuration determines which permission types are logged, and what
2424 # identities, if any, are exempted from logging.
2425 # An AuditConfig must have one or more AuditLogConfigs.
2426 #
2427 # If there are AuditConfigs for both `allServices` and a specific service,
2428 # the union of the two AuditConfigs is used for that service: the log_types
2429 # specified in each AuditConfig are enabled, and the exempted_members in each
2430 # AuditLogConfig are exempted.
2431 #
2432 # Example Policy with multiple AuditConfigs:
2433 #
2434 # {
2435 # &quot;audit_configs&quot;: [
2436 # {
2437 # &quot;service&quot;: &quot;allServices&quot;,
2438 # &quot;audit_log_configs&quot;: [
2439 # {
2440 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
2441 # &quot;exempted_members&quot;: [
2442 # &quot;user:[email protected]&quot;
2443 # ]
2444 # },
2445 # {
2446 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
2447 # },
2448 # {
2449 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
2450 # }
2451 # ]
2452 # },
2453 # {
2454 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
2455 # &quot;audit_log_configs&quot;: [
2456 # {
2457 # &quot;log_type&quot;: &quot;DATA_READ&quot;
2458 # },
2459 # {
2460 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
2461 # &quot;exempted_members&quot;: [
2462 # &quot;user:[email protected]&quot;
2463 # ]
2464 # }
2465 # ]
2466 # }
2467 # ]
2468 # }
2469 #
2470 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
2471 # logging. It also exempts `[email protected]` from DATA_READ logging, and
2472 # `[email protected]` from DATA_WRITE logging.
2473 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
2474 { # Provides the configuration for logging a type of permissions.
2475 # Example:
2476 #
2477 # {
2478 # &quot;audit_log_configs&quot;: [
2479 # {
2480 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
2481 # &quot;exempted_members&quot;: [
2482 # &quot;user:[email protected]&quot;
2483 # ]
2484 # },
2485 # {
2486 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
2487 # }
2488 # ]
2489 # }
2490 #
2491 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
2492 # [email protected] from DATA_READ logging.
2493 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
2494 # permission.
2495 # Follows the same format of Binding.members.
2496 &quot;A String&quot;,
2497 ],
2498 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
2499 },
2500 ],
2501 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
2502 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
2503 # `allServices` is a special value that covers all services.
2504 },
2505 ],
2506 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
2507 # may specify a `condition` that determines how and when the `bindings` are
2508 # applied. Each of the `bindings` must contain at least one principal.
2509 #
2510 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
2511 # of these principals can be Google groups. Each occurrence of a principal
2512 # counts towards these limits. For example, if the `bindings` grant 50
2513 # different roles to `user:[email protected]`, and not to any other
2514 # principal, then you can add another 1,450 principals to the `bindings` in
2515 # the `Policy`.
2516 { # Associates `members`, or principals, with a `role`.
2517 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
2518 #
2519 # If the condition evaluates to `true`, then this binding applies to the
2520 # current request.
2521 #
2522 # If the condition evaluates to `false`, then this binding does not apply to
2523 # the current request. However, a different role binding might grant the same
2524 # role to one or more of the principals in this binding.
2525 #
2526 # To learn which resources support conditions in their IAM policies, see the
2527 # [IAM
2528 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2529 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
2530 # are documented at https://github.com/google/cel-spec.
2531 #
2532 # Example (Comparison):
2533 #
2534 # title: &quot;Summary size limit&quot;
2535 # description: &quot;Determines if a summary is less than 100 chars&quot;
2536 # expression: &quot;document.summary.size() &lt; 100&quot;
2537 #
2538 # Example (Equality):
2539 #
2540 # title: &quot;Requestor is owner&quot;
2541 # description: &quot;Determines if requestor is the document owner&quot;
2542 # expression: &quot;document.owner == request.auth.claims.email&quot;
2543 #
2544 # Example (Logic):
2545 #
2546 # title: &quot;Public documents&quot;
2547 # description: &quot;Determine whether the document should be publicly visible&quot;
2548 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
2549 #
2550 # Example (Data Manipulation):
2551 #
2552 # title: &quot;Notification string&quot;
2553 # description: &quot;Create a notification string with a timestamp.&quot;
2554 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
2555 #
2556 # The exact variables and functions that may be referenced within an expression
2557 # are determined by the service that evaluates it. See the service
2558 # documentation for additional information.
2559 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
2560 # describes the expression, e.g. when hovered over it in a UI.
2561 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
2562 # syntax.
2563 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
2564 # reporting, e.g. a file name and a position in the file.
2565 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
2566 # its purpose. This can be used e.g. in UIs which allow to enter the
2567 # expression.
2568 },
2569 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
2570 # `members` can have the following values:
2571 #
2572 # * `allUsers`: A special identifier that represents anyone who is
2573 # on the internet; with or without a Google account.
2574 #
2575 # * `allAuthenticatedUsers`: A special identifier that represents anyone
2576 # who is authenticated with a Google account or a service account.
2577 # Does not include identities that come from external identity providers
2578 # (IdPs) through identity federation.
2579 #
2580 # * `user:{emailid}`: An email address that represents a specific Google
2581 # account. For example, `[email protected]` .
2582 #
2583 #
2584 # * `serviceAccount:{emailid}`: An email address that represents a Google
2585 # service account. For example,
2586 # `[email protected]`.
2587 #
2588 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
2589 # identifier for a
2590 # [Kubernetes service
2591 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
2592 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
2593 #
2594 # * `group:{emailid}`: An email address that represents a Google group.
2595 # For example, `[email protected]`.
2596 #
2597 #
2598 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
2599 # users of that domain. For example, `google.com` or `example.com`.
2600 #
2601 #
2602 #
2603 #
2604 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
2605 # A single identity in a workforce identity pool.
2606 #
2607 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
2608 # All workforce identities in a group.
2609 #
2610 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
2611 # All workforce identities with a specific attribute value.
2612 #
2613 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
2614 # All identities in a workforce identity pool.
2615 #
2616 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
2617 # A single identity in a workload identity pool.
2618 #
2619 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
2620 # A workload identity pool group.
2621 #
2622 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
2623 # All identities in a workload identity pool with a certain attribute.
2624 #
2625 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
2626 # All identities in a workload identity pool.
2627 #
2628 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
2629 # identifier) representing a user that has been recently deleted. For
2630 # example, `[email protected]?uid=123456789012345678901`. If the user is
2631 # recovered, this value reverts to `user:{emailid}` and the recovered user
2632 # retains the role in the binding.
2633 #
2634 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
2635 # unique identifier) representing a service account that has been recently
2636 # deleted. For example,
2637 # `[email protected]?uid=123456789012345678901`.
2638 # If the service account is undeleted, this value reverts to
2639 # `serviceAccount:{emailid}` and the undeleted service account retains the
2640 # role in the binding.
2641 #
2642 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
2643 # identifier) representing a Google group that has been recently
2644 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
2645 # the group is recovered, this value reverts to `group:{emailid}` and the
2646 # recovered group retains the role in the binding.
2647 #
2648 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
2649 # Deleted single identity in a workforce identity pool. For example,
2650 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
2651 &quot;A String&quot;,
2652 ],
2653 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
2654 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
2655 #
2656 # For an overview of the IAM roles and permissions, see the
2657 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
2658 # a list of the available pre-defined roles, see
2659 # [here](https://cloud.google.com/iam/docs/understanding-roles).
2660 },
2661 ],
2662 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
2663 # prevent simultaneous updates of a policy from overwriting each other.
2664 # It is strongly suggested that systems make use of the `etag` in the
2665 # read-modify-write cycle to perform policy updates in order to avoid race
2666 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
2667 # systems are expected to put that etag in the request to `setIamPolicy` to
2668 # ensure that their change will be applied to the same version of the policy.
2669 #
2670 # **Important:** If you use IAM Conditions, you must include the `etag` field
2671 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
2672 # you to overwrite a version `3` policy with a version `1` policy, and all of
2673 # the conditions in the version `3` policy are lost.
2674 &quot;version&quot;: 42, # Specifies the format of the policy.
2675 #
2676 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
2677 # are rejected.
2678 #
2679 # Any operation that affects conditional role bindings must specify version
2680 # `3`. This requirement applies to the following operations:
2681 #
2682 # * Getting a policy that includes a conditional role binding
2683 # * Adding a conditional role binding to a policy
2684 # * Changing a conditional role binding in a policy
2685 # * Removing any role binding, with or without a condition, from a policy
2686 # that includes conditions
2687 #
2688 # **Important:** If you use IAM Conditions, you must include the `etag` field
2689 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
2690 # you to overwrite a version `3` policy with a version `1` policy, and all of
2691 # the conditions in the version `3` policy are lost.
2692 #
2693 # If a policy does not include any conditions, operations on that policy may
2694 # specify any valid version or leave the field unset.
2695 #
2696 # To learn which resources support conditions in their IAM policies, see the
2697 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2698 }</pre>
2699 </div>
2700
2701 <div class="method">
2702 <code class="details" id="insert">insert(project, region, body=None, requestId=None, sourceImage=None, x__xgafv=None)</code>
2703 <pre>Creates a persistent regional disk in the specified project using the data
2704 included in the request.
2705
2706 Args:
2707 project: string, Project ID for this request. (required)
2708 region: string, Name of the region for this request. (required)
2709 body: object, The request body.
2710 The object takes the form of:
2711
2712 { # Represents a Persistent Disk resource.
2713 #
2714 # Google Compute Engine has two Disk resources:
2715 #
2716 # * [Zonal](/compute/docs/reference/rest/beta/disks)
2717 # * [Regional](/compute/docs/reference/rest/beta/regionDisks)
2718 #
2719 # Persistent disks are required for running your VM instances.
2720 # Create both boot and non-boot (data) persistent disks. For more information,
2721 # read Persistent Disks. For more
2722 # storage options, read Storage options.
2723 #
2724 # The disks resource represents a zonal persistent disk.
2725 # For more information, readZonal persistent disks.
2726 #
2727 # The regionDisks resource represents a
2728 # regional persistent disk. For more information, read
2729 # Regional resources.
2730 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
2731 #
2732 #
2733 # - READ_WRITE_SINGLE: The default AccessMode, means the
2734 # disk can be attached to single instance in RW mode.
2735 # - READ_WRITE_MANY: The AccessMode means the disk can be
2736 # attached to multiple instances in RW mode.
2737 # - READ_ONLY_MANY: The AccessMode means the disk can be
2738 # attached to multiple instances in RO mode.
2739 #
2740 #
2741 # The AccessMode is only valid for Hyperdisk disk types.
2742 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
2743 # ARM64 or X86_64.
2744 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
2745 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
2746 # started on the disk as a member of a group.
2747 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
2748 # started on the disk as a member of a group.
2749 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
2750 # You can provide this as a partial or full URL to the resource.
2751 # For example, the following are valid values:
2752 #
2753 #
2754 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
2755 # - projects/project/zones/zone/disks/disk
2756 # - zones/zone/disks/disk
2757 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
2758 # to or from the current disk. This value identifies the exact disk that
2759 # was used to create this replication. For example, if you started
2760 # replicating the persistent disk from a disk that was later deleted and
2761 # recreated under the same name, the disk ID would identify the exact
2762 # version of the disk that was used.
2763 },
2764 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
2765 &quot;a_key&quot;: {
2766 &quot;asyncReplicationDisk&quot;: {
2767 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
2768 # started on the disk as a member of a group.
2769 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
2770 # started on the disk as a member of a group.
2771 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
2772 # You can provide this as a partial or full URL to the resource.
2773 # For example, the following are valid values:
2774 #
2775 #
2776 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
2777 # - projects/project/zones/zone/disks/disk
2778 # - zones/zone/disks/disk
2779 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
2780 # to or from the current disk. This value identifies the exact disk that
2781 # was used to create this replication. For example, if you started
2782 # replicating the persistent disk from a disk that was later deleted and
2783 # recreated under the same name, the disk ID would identify the exact
2784 # version of the disk that was used.
2785 },
2786 },
2787 },
2788 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
2789 # text format.
2790 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
2791 # create the resource.
2792 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
2793 # customer-supplied encryption key or a
2794 # customer-managed encryption key.
2795 #
2796 # Encryption keys do not protect access to metadata of the disk.
2797 #
2798 # After you encrypt a disk with a customer-supplied key, you must provide the
2799 # same key if you use the disk later. For example, to create a disk snapshot,
2800 # to create a disk image, to create a machine image, or to attach the disk to
2801 # a virtual machine.
2802 #
2803 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
2804 # name once the disk is created. The disk is encrypted with this version of
2805 # the key. In the response, diskEncryptionKey.kmsKeyName appears
2806 # in the following format:
2807 #
2808 # &quot;diskEncryptionKey.kmsKeyName&quot;:
2809 # &quot;projects/kms_project_id/locations/region/keyRings/
2810 # key_region/cryptoKeys/key
2811 # /cryptoKeysVersions/version
2812 #
2813 # If you do not provide an encryption key when creating the disk, then the
2814 # disk is encrypted using an automatically generated key and you don&#x27;t need
2815 # to provide a key to use the disk later.
2816 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2817 # For example:
2818 #
2819 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2820 # key_region/cryptoKeys/key
2821 #
2822 # The fully-qualifed key name may be returned for resource GET requests. For
2823 # example:
2824 #
2825 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2826 # key_region/cryptoKeys/key
2827 # /cryptoKeyVersions/1
2828 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2829 # key. If absent, the Compute Engine default service account is used.
2830 # For example:
2831 #
2832 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2833 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2834 # encryption key, encoded in RFC
2835 # 4648 base64 to either encrypt or decrypt this resource. You can
2836 # provide either the rawKey or thersaEncryptedKey.
2837 # For example:
2838 #
2839 # &quot;rawKey&quot;:
2840 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2841 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2842 # customer-supplied encryption key to either encrypt or decrypt this
2843 # resource. You can provide either the rawKey or thersaEncryptedKey.
2844 # For example:
2845 #
2846 # &quot;rsaEncryptedKey&quot;:
2847 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2848 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2849 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2850 #
2851 # The key must meet the following requirements before you can provide it to
2852 # Compute Engine:
2853 #
2854 # 1. The key is wrapped using a RSA public key certificate provided by
2855 # Google.
2856 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2857 # encoding.
2858 #
2859 # Gets the RSA public key certificate provided by Google at:
2860 #
2861 #
2862 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2863 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2864 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2865 # encryption key that protects this resource.
2866 },
2867 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
2868 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
2869 # Windows specific VSS signature.
2870 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2871 # only for bootable images. Read
2872 # Enabling guest operating system features to see a list of available
2873 # options.
2874 { # Guest OS features.
2875 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2876 # separate values. Set to one or more of the following values:
2877 #
2878 # - VIRTIO_SCSI_MULTIQUEUE
2879 # - WINDOWS
2880 # - MULTI_IP_SUBNET
2881 # - UEFI_COMPATIBLE
2882 # - GVNIC
2883 # - SEV_CAPABLE
2884 # - SUSPEND_RESUME_COMPATIBLE
2885 # - SEV_LIVE_MIGRATABLE_V2
2886 # - SEV_SNP_CAPABLE
2887 # - TDX_CAPABLE
2888 # - IDPF
2889 # - SNP_SVSM_CAPABLE
2890 # - CCA_CAPABLE
2891 #
2892 #
2893 # For more information, see
2894 # Enabling guest operating system features.
2895 },
2896 ],
2897 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
2898 # defined by the server.
2899 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
2900 # which is either SCSI or NVME. The default isSCSI.
2901 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
2902 # disks.
2903 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
2904 # essentially a hash of the labels set used for optimistic locking. The
2905 # fingerprint is initially generated by Compute Engine and changes after
2906 # every request to modify or update labels. You must always provide an
2907 # up-to-date fingerprint hash in order to update or change labels,
2908 # otherwise the request will fail with error412 conditionNotMet.
2909 #
2910 # To see the latest fingerprint, make a get() request to
2911 # retrieve a disk.
2912 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
2913 # the setLabels method.
2914 &quot;a_key&quot;: &quot;A String&quot;,
2915 },
2916 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
2917 # text format.
2918 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
2919 # text format.
2920 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
2921 &quot;A String&quot;,
2922 ],
2923 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
2924 &quot;A String&quot;,
2925 ],
2926 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
2927 # This field is for use by internal tools that use the public API.
2928 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
2929 # source image. Attachment of a disk created from a locked source image will
2930 # cause the following operations to become irreversibly prohibited:
2931 #
2932 # - R/W or R/O disk attachment to any other instance
2933 # - Disk detachment. And the disk can only be deleted when the instance
2934 # is deleted
2935 # - Creation of images or snapshots
2936 # - Disk cloning
2937 #
2938 #
2939 #
2940 # Furthermore, the instance with at least one disk with locked flag set to
2941 # true will be prohibited from performing the operations below:
2942 #
2943 # - Further attachment of secondary disks.
2944 # - Detachment of any disks
2945 # - Create machine images
2946 # - Create instance template
2947 # - Delete the instance with --keep-disk parameter set to true for locked
2948 # disks
2949 # - Attach a locked disk with --auto-delete parameter set to false
2950 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
2951 # more than one instance.
2952 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
2953 # The name must be 1-63 characters long, and comply withRFC1035.
2954 # Specifically, the name must be 1-63 characters long and match the regular
2955 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
2956 # which means the first character must be a lowercase letter, and all
2957 # following characters must be a dash, lowercase letter, or digit, except
2958 # the last character, which cannot be a dash.
2959 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
2960 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
2961 # as part of resource payload.
2962 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
2963 # have the same definition as resource
2964 # manager tags. Keys and values can be either in numeric format,
2965 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
2966 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
2967 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
2968 # PATCH) when empty.
2969 &quot;a_key&quot;: &quot;A String&quot;,
2970 },
2971 },
2972 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
2973 # If not present in a request, a default value is used.
2974 # The currently supported size is 4096, other sizes may be added in
2975 # the future.
2976 # If an unsupported value is requested, the error message will list
2977 # the supported values for the caller&#x27;s project.
2978 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
2979 # of I/O operations per second that the disk can handle. Values must be
2980 # between 10,000 and 120,000. For more details, see theExtreme persistent
2981 # disk documentation.
2982 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
2983 # number of throughput mb per second that the disk can handle. Values must be
2984 # greater than or equal to 1.
2985 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
2986 # regional resources.
2987 # You must specify this field as part of the HTTP request URL. It is
2988 # not settable as a field in the request body.
2989 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
2990 # for regional resources.
2991 &quot;A String&quot;,
2992 ],
2993 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
2994 &quot;A String&quot;,
2995 ],
2996 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
2997 &quot;asyncPrimaryDisk&quot;: {
2998 &quot;state&quot;: &quot;A String&quot;,
2999 },
3000 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
3001 &quot;a_key&quot;: {
3002 &quot;state&quot;: &quot;A String&quot;,
3003 },
3004 },
3005 },
3006 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
3007 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
3008 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
3009 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
3010 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
3011 # persistent disk.
3012 #
3013 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
3014 # source.
3015 # Acceptable values are greater than 0.
3016 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
3017 # that was created using a consistency group.
3018 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
3019 # that was created using a consistency group.
3020 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
3021 # partial or full URL to the resource. For example, the following are valid
3022 # values:
3023 #
3024 #
3025 # -
3026 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3027 #
3028 # -
3029 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
3030 #
3031 # -
3032 # projects/project/zones/zone/disks/disk
3033 #
3034 # -
3035 # projects/project/regions/region/disks/disk
3036 #
3037 # -
3038 # zones/zone/disks/disk
3039 #
3040 # -
3041 # regions/region/disks/disk
3042 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
3043 # value identifies the exact disk that was used to create this persistent
3044 # disk. For example, if you created the persistent disk from a disk that
3045 # was later deleted and recreated under the same name, the source disk ID
3046 # would identify the exact version of the disk that was used.
3047 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
3048 # deleted, this field will not be set.
3049 #
3050 # To create a disk with one of the public operating system images, specify
3051 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
3052 #
3053 # projects/debian-cloud/global/images/family/debian-9
3054 #
3055 #
3056 # Alternatively, use a specific version of a public operating system image:
3057 #
3058 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
3059 #
3060 #
3061 # To create a disk with a custom image that you created, specify the
3062 # image name in the following format:
3063 #
3064 # global/images/my-custom-image
3065 #
3066 #
3067 # You can also specify a custom image by its image family, which returns
3068 # the latest version of the image in that family. Replace the image name
3069 # with family/family-name:
3070 #
3071 # global/images/family/my-image-family
3072 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
3073 # encryption key of the source image. Required if the source image is
3074 # protected by a customer-supplied encryption key.
3075 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3076 # For example:
3077 #
3078 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3079 # key_region/cryptoKeys/key
3080 #
3081 # The fully-qualifed key name may be returned for resource GET requests. For
3082 # example:
3083 #
3084 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3085 # key_region/cryptoKeys/key
3086 # /cryptoKeyVersions/1
3087 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3088 # key. If absent, the Compute Engine default service account is used.
3089 # For example:
3090 #
3091 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3092 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3093 # encryption key, encoded in RFC
3094 # 4648 base64 to either encrypt or decrypt this resource. You can
3095 # provide either the rawKey or thersaEncryptedKey.
3096 # For example:
3097 #
3098 # &quot;rawKey&quot;:
3099 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3100 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3101 # customer-supplied encryption key to either encrypt or decrypt this
3102 # resource. You can provide either the rawKey or thersaEncryptedKey.
3103 # For example:
3104 #
3105 # &quot;rsaEncryptedKey&quot;:
3106 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3107 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3108 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3109 #
3110 # The key must meet the following requirements before you can provide it to
3111 # Compute Engine:
3112 #
3113 # 1. The key is wrapped using a RSA public key certificate provided by
3114 # Google.
3115 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3116 # encoding.
3117 #
3118 # Gets the RSA public key certificate provided by Google at:
3119 #
3120 #
3121 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3122 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3123 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3124 # encryption key that protects this resource.
3125 },
3126 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
3127 # value identifies the exact image that was used to create this persistent
3128 # disk. For example, if you created the persistent disk from an image that
3129 # was later deleted and recreated under the same name, the source image ID
3130 # would identify the exact version of the image that was used.
3131 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
3132 # this as a partial or full URL to the resource. For example, the following
3133 # are valid values:
3134 #
3135 #
3136 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
3137 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
3138 # - zones/zone/instantSnapshots/instantSnapshot
3139 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
3140 # disk. This value identifies the exact instant snapshot that was used to
3141 # create this persistent disk. For example, if you created the persistent
3142 # disk from an instant snapshot that was later deleted and recreated under
3143 # the same name, the source instant snapshot ID would identify the exact
3144 # version of the instant snapshot that was used.
3145 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
3146 # partial or full URL to the resource. For example, the following are valid
3147 # values:
3148 #
3149 #
3150 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
3151 # - projects/project/global/machineImages/machineImage
3152 # - global/machineImages/machineImage
3153 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
3154 # source_machine_image must be specified.
3155 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
3156 # encryption key of the source machine image. Required if the source
3157 # machine image is protected by a customer-supplied encryption key.
3158 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3159 # For example:
3160 #
3161 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3162 # key_region/cryptoKeys/key
3163 #
3164 # The fully-qualifed key name may be returned for resource GET requests. For
3165 # example:
3166 #
3167 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3168 # key_region/cryptoKeys/key
3169 # /cryptoKeyVersions/1
3170 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3171 # key. If absent, the Compute Engine default service account is used.
3172 # For example:
3173 #
3174 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3175 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3176 # encryption key, encoded in RFC
3177 # 4648 base64 to either encrypt or decrypt this resource. You can
3178 # provide either the rawKey or thersaEncryptedKey.
3179 # For example:
3180 #
3181 # &quot;rawKey&quot;:
3182 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3183 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3184 # customer-supplied encryption key to either encrypt or decrypt this
3185 # resource. You can provide either the rawKey or thersaEncryptedKey.
3186 # For example:
3187 #
3188 # &quot;rsaEncryptedKey&quot;:
3189 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3190 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3191 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3192 #
3193 # The key must meet the following requirements before you can provide it to
3194 # Compute Engine:
3195 #
3196 # 1. The key is wrapped using a RSA public key certificate provided by
3197 # Google.
3198 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3199 # encoding.
3200 #
3201 # Gets the RSA public key certificate provided by Google at:
3202 #
3203 #
3204 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3205 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3206 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3207 # encryption key that protects this resource.
3208 },
3209 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
3210 # This value identifies the exact machine image that was used to create this
3211 # persistent disk. For example, if you created the persistent disk from a
3212 # machine image that was later deleted and recreated under the same name, the
3213 # source machine image ID would identify the exact version of the machine
3214 # image that was used.
3215 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
3216 # partial or full URL to the resource. For example, the following are valid
3217 # values:
3218 #
3219 #
3220 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
3221 # - projects/project/global/snapshots/snapshot
3222 # - global/snapshots/snapshot
3223 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3224 # encryption key of the source snapshot. Required if the source snapshot
3225 # is protected by a customer-supplied encryption key.
3226 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3227 # For example:
3228 #
3229 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3230 # key_region/cryptoKeys/key
3231 #
3232 # The fully-qualifed key name may be returned for resource GET requests. For
3233 # example:
3234 #
3235 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3236 # key_region/cryptoKeys/key
3237 # /cryptoKeyVersions/1
3238 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3239 # key. If absent, the Compute Engine default service account is used.
3240 # For example:
3241 #
3242 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3243 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3244 # encryption key, encoded in RFC
3245 # 4648 base64 to either encrypt or decrypt this resource. You can
3246 # provide either the rawKey or thersaEncryptedKey.
3247 # For example:
3248 #
3249 # &quot;rawKey&quot;:
3250 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3251 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3252 # customer-supplied encryption key to either encrypt or decrypt this
3253 # resource. You can provide either the rawKey or thersaEncryptedKey.
3254 # For example:
3255 #
3256 # &quot;rsaEncryptedKey&quot;:
3257 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3258 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3259 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3260 #
3261 # The key must meet the following requirements before you can provide it to
3262 # Compute Engine:
3263 #
3264 # 1. The key is wrapped using a RSA public key certificate provided by
3265 # Google.
3266 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3267 # encoding.
3268 #
3269 # Gets the RSA public key certificate provided by Google at:
3270 #
3271 #
3272 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3273 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3274 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3275 # encryption key that protects this resource.
3276 },
3277 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
3278 # value identifies the exact snapshot that was used to create this persistent
3279 # disk. For example, if you created the persistent disk from a snapshot that
3280 # was later deleted and recreated under the same name, the source snapshot ID
3281 # would identify the exact version of the snapshot that was used.
3282 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
3283 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
3284 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
3285 # https://storage.googleapis.com/. This flag is not optimized for creating
3286 # multiple disks from a source storage object. To create many disks from a
3287 # source storage object, use gcloud compute images
3288 # import instead.
3289 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
3290 #
3291 #
3292 # - CREATING: Disk is provisioning.
3293 # - RESTORING: Source data is being copied into the
3294 # disk.
3295 # - FAILED: Disk creation failed.
3296 # - READY: Disk is ready for use.
3297 # - DELETING: Disk is deleting.
3298 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3299 # this as a partial or full URL to the resource. For example, the following
3300 # are valid values:
3301 #
3302 #
3303 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3304 # - projects/project/zones/zone/storagePools/storagePool
3305 # - zones/zone/storagePools/storagePool
3306 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
3307 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
3308 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
3309 # types.
3310 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
3311 # in form:projects/project/zones/zone/instances/instance
3312 &quot;A String&quot;,
3313 ],
3314 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
3315 # You must specify this field as part of the HTTP request URL. It is
3316 # not settable as a field in the request body.
3317 }
3318
3319 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3320 that if you must retry your request, the server will know to ignore the
3321 request if it has already been completed.
3322
3323 For example, consider a situation where you make an initial request and
3324 the request times out. If you make the request again with the same
3325 request ID, the server can check if original operation with the same
3326 request ID was received, and if so, will ignore the second request. This
3327 prevents clients from accidentally creating duplicate commitments.
3328
3329 The request ID must be
3330 a valid UUID with the exception that zero UUID is not supported
3331 (00000000-0000-0000-0000-000000000000).
3332 sourceImage: string, Source image to restore onto a disk. This field is optional.
3333 x__xgafv: string, V1 error format.
3334 Allowed values
3335 1 - v1 error format
3336 2 - v2 error format
3337
3338 Returns:
3339 An object of the form:
3340
3341 { # Represents an Operation resource.
3342 #
3343 # Google Compute Engine has three Operation resources:
3344 #
3345 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
3346 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
3347 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
3348 #
3349 # You can use an operation resource to manage asynchronous API requests.
3350 # For more information, readHandling
3351 # API responses.
3352 #
3353 # Operations can be global, regional or zonal.
3354 #
3355 # - For global operations, use the `globalOperations`
3356 # resource.
3357 # - For regional operations, use the
3358 # `regionOperations` resource.
3359 # - For zonal operations, use
3360 # the `zoneOperations` resource.
3361 #
3362 #
3363 #
3364 # For more information, read
3365 # Global, Regional, and Zonal Resources.
3366 #
3367 # Note that completed Operation resources have a limited
3368 # retention period.
3369 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3370 # Not present otherwise.
3371 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3372 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3373 # set when the operation is created.
3374 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3375 # text format.
3376 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3377 # this field will be populated.
3378 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3379 # operation.
3380 {
3381 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3382 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3383 # details. There is a set of defined message types to use for providing
3384 # details.The syntax depends on the error code. For example,
3385 # QuotaExceededInfo will have details when the error code is
3386 # QUOTA_EXCEEDED.
3387 {
3388 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3389 #
3390 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3391 # is not enabled:
3392 #
3393 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3394 # &quot;domain&quot;: &quot;googleapis.com&quot;
3395 # &quot;metadata&quot;: {
3396 # &quot;resource&quot;: &quot;projects/123&quot;,
3397 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3398 # }
3399 # }
3400 #
3401 # This response indicates that the pubsub.googleapis.com API is not enabled.
3402 #
3403 # Example of an error that is returned when attempting to create a Spanner
3404 # instance in a region that is out of stock:
3405 #
3406 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3407 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3408 # &quot;metadata&quot;: {
3409 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3410 # }
3411 # }
3412 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3413 # is typically the registered service name of the tool or product that
3414 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3415 # generated by some common infrastructure, the error domain must be a
3416 # globally unique value that identifies the infrastructure. For Google API
3417 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3418 &quot;metadatas&quot;: { # Additional structured details about this error.
3419 #
3420 # Keys must match a regular expression of `a-z+` but should
3421 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3422 # length. When identifying the current value of an exceeded limit, the units
3423 # should be contained in the key, not the value. For example, rather than
3424 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3425 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3426 # instances that can be created in a single (batch) request.
3427 &quot;a_key&quot;: &quot;A String&quot;,
3428 },
3429 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3430 # proximate cause of the error. Error reasons are unique within a particular
3431 # domain of errors. This should be at most 63 characters and match a
3432 # regular expression of `A-Z+[A-Z0-9]`, which represents
3433 # UPPER_SNAKE_CASE.
3434 },
3435 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3436 #
3437 # For example, if a quota check failed with an error indicating the calling
3438 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3439 # directly to the right place in the developer console to flip the bit.
3440 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3441 { # Describes a URL link.
3442 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3443 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3444 },
3445 ],
3446 },
3447 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3448 # which can be attached to an RPC error.
3449 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3450 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3451 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3452 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3453 },
3454 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3455 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3456 &quot;a_key&quot;: &quot;A String&quot;,
3457 },
3458 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3459 # type or metric.
3460 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3461 # or metric.
3462 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3463 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3464 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3465 },
3466 },
3467 ],
3468 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3469 # This property is optional.
3470 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3471 },
3472 ],
3473 },
3474 &quot;getVersionOperationMetadata&quot;: {
3475 &quot;inlineSbomInfo&quot;: {
3476 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3477 # appropriate identifiers.
3478 &quot;a_key&quot;: &quot;A String&quot;,
3479 },
3480 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3481 # identifiers.
3482 &quot;a_key&quot;: &quot;A String&quot;,
3483 },
3484 },
3485 },
3486 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3487 # message that was returned, such as `NOT FOUND`.
3488 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3489 # status code that was returned. For example, a `404` means the
3490 # resource was not found.
3491 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3492 # defined by the server.
3493 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3494 # This value is inRFC3339
3495 # text format.
3496 &quot;instancesBulkInsertOperationMetadata&quot;: {
3497 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3498 # Example key: zones/us-central1-a
3499 &quot;a_key&quot;: {
3500 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3501 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3502 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3503 # error.
3504 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3505 # if the flow is rolling forward or rolling back.
3506 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3507 },
3508 },
3509 },
3510 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3511 # Operation resources.
3512 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3513 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3514 # group of operations results from a `bulkInsert` API request.
3515 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3516 # `update`, or `delete`, and so on.
3517 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3518 # There is no requirement that this be linear or support any granularity of
3519 # operations. This should not be used to guess when the operation will be
3520 # complete. This number should monotonically increase as the operation
3521 # progresses.
3522 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3523 # applicable when performing regional operations.
3524 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3525 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3526 # this field will contain information on all underlying zonal actions and
3527 # their state.
3528 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3529 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3530 # Example key: zones/us-central1-a
3531 &quot;a_key&quot;: {
3532 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
3533 # populated.
3534 # different programming environments, including REST APIs and RPC APIs. It is
3535 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3536 # three pieces of data: error code, error message, and error details.
3537 #
3538 # You can find out more about this error model and how to work with it in the
3539 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3540 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3541 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3542 # message types for APIs to use.
3543 {
3544 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3545 },
3546 ],
3547 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3548 # user-facing error message should be localized and sent in the
3549 # google.rpc.Status.details field, or localized by the client.
3550 },
3551 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3552 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3553 },
3554 },
3555 },
3556 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3557 # This value is inRFC3339
3558 # text format.
3559 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3560 # following:
3561 # `PENDING`, `RUNNING`, or `DONE`.
3562 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3563 # operation.
3564 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3565 # of the target resource.
3566 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3567 # operations related to creating a snapshot, this points to the disk
3568 # that the snapshot was created from.
3569 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3570 # `[email protected]` or
3571 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3572 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3573 # operation, this field will be populated.
3574 {
3575 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3576 # Engine returns NO_RESULTS_ON_PAGE if there
3577 # are no results in the response.
3578 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3579 # value format. For example:
3580 #
3581 # &quot;data&quot;: [
3582 # {
3583 # &quot;key&quot;: &quot;scope&quot;,
3584 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3585 # }
3586 {
3587 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3588 # returned. For example, for warnings where there are no results in a list
3589 # request for a particular zone, this key might be scope and
3590 # the key value might be the zone name. Other examples might be a key
3591 # indicating a deprecated resource and a suggested replacement, or a
3592 # warning about invalid network settings (for example, if an instance
3593 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3594 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3595 },
3596 ],
3597 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3598 },
3599 ],
3600 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3601 # applicable when performing per-zone operations.
3602 }</pre>
3603 </div>
3604
3605 <div class="method">
3606 <code class="details" id="list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
3607 <pre>Retrieves the list of persistent disks contained within
3608 the specified region.
3609
3610 Args:
3611 project: string, Project ID for this request. (required)
3612 region: string, Name of the region for this request. (required)
3613 filter: string, A filter expression that filters resources listed in the response. Most
3614 Compute resources support two types of filter expressions:
3615 expressions that support regular expressions and expressions that follow
3616 API improvement proposal AIP-160.
3617 These two types of filter expressions cannot be mixed in one request.
3618
3619 If you want to use AIP-160, your expression must specify the field name, an
3620 operator, and the value that you want to use for filtering. The value
3621 must be a string, a number, or a boolean. The operator
3622 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
3623
3624 For example, if you are filtering Compute Engine instances, you can
3625 exclude instances named `example-instance` by specifying
3626 `name != example-instance`.
3627
3628 The `:*` comparison can be used to test whether a key has been defined.
3629 For example, to find all objects with `owner` label use:
3630 ```
3631 labels.owner:*
3632 ```
3633
3634 You can also filter nested fields. For example, you could specify
3635 `scheduling.automaticRestart = false` to include instances only
3636 if they are not scheduled for automatic restarts. You can use filtering
3637 on nested fields to filter based onresource labels.
3638
3639 To filter on multiple expressions, provide each separate expression within
3640 parentheses. For example:
3641 ```
3642 (scheduling.automaticRestart = true)
3643 (cpuPlatform = &quot;Intel Skylake&quot;)
3644 ```
3645 By default, each expression is an `AND` expression. However, you
3646 can include `AND` and `OR` expressions explicitly.
3647 For example:
3648 ```
3649 (cpuPlatform = &quot;Intel Skylake&quot;) OR
3650 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
3651 (scheduling.automaticRestart = true)
3652 ```
3653
3654 If you want to use a regular expression, use the `eq` (equal) or `ne`
3655 (not equal) operator against a single un-parenthesized expression with or
3656 without quotes or against multiple parenthesized expressions. Examples:
3657
3658 `fieldname eq unquoted literal`
3659 `fieldname eq &#x27;single quoted literal&#x27;`
3660 `fieldname eq &quot;double quoted literal&quot;`
3661 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
3662
3663 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
3664 The literal value must match the entire field.
3665
3666 For example, to filter for instances that do not end with name &quot;instance&quot;,
3667 you would use `name ne .*instance`.
3668
3669 You cannot combine constraints on multiple fields using regular
3670 expressions.
3671 maxResults: integer, The maximum number of results per page that should be returned.
3672 If the number of available results is larger than `maxResults`,
3673 Compute Engine returns a `nextPageToken` that can be used to get
3674 the next page of results in subsequent list requests. Acceptable values are
3675 `0` to `500`, inclusive. (Default: `500`)
3676 orderBy: string, Sorts list results by a certain order. By default, results
3677 are returned in alphanumerical order based on the resource name.
3678
3679 You can also sort results in descending order based on the creation
3680 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
3681 results based on the `creationTimestamp` field in
3682 reverse chronological order (newest result first). Use this to sort
3683 resources like operations so that the newest operation is returned first.
3684
3685 Currently, only sorting by `name` or
3686 `creationTimestamp desc` is supported.
3687 pageToken: string, Specifies a page token to use. Set `pageToken` to the
3688 `nextPageToken` returned by a previous list request to get
3689 the next page of results.
3690 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
3691 of failure. The default value is false.
3692
3693 For example, when partial success behavior is enabled, aggregatedList for a
3694 single zone scope either returns all resources in the zone or no resources,
3695 with an error code.
3696 x__xgafv: string, V1 error format.
3697 Allowed values
3698 1 - v1 error format
3699 2 - v2 error format
3700
3701 Returns:
3702 An object of the form:
3703
3704 { # A list of Disk resources.
3705 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
3706 &quot;items&quot;: [ # A list of Disk resources.
3707 { # Represents a Persistent Disk resource.
3708 #
3709 # Google Compute Engine has two Disk resources:
3710 #
3711 # * [Zonal](/compute/docs/reference/rest/beta/disks)
3712 # * [Regional](/compute/docs/reference/rest/beta/regionDisks)
3713 #
3714 # Persistent disks are required for running your VM instances.
3715 # Create both boot and non-boot (data) persistent disks. For more information,
3716 # read Persistent Disks. For more
3717 # storage options, read Storage options.
3718 #
3719 # The disks resource represents a zonal persistent disk.
3720 # For more information, readZonal persistent disks.
3721 #
3722 # The regionDisks resource represents a
3723 # regional persistent disk. For more information, read
3724 # Regional resources.
3725 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
3726 #
3727 #
3728 # - READ_WRITE_SINGLE: The default AccessMode, means the
3729 # disk can be attached to single instance in RW mode.
3730 # - READ_WRITE_MANY: The AccessMode means the disk can be
3731 # attached to multiple instances in RW mode.
3732 # - READ_ONLY_MANY: The AccessMode means the disk can be
3733 # attached to multiple instances in RO mode.
3734 #
3735 #
3736 # The AccessMode is only valid for Hyperdisk disk types.
3737 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
3738 # ARM64 or X86_64.
3739 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
3740 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
3741 # started on the disk as a member of a group.
3742 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
3743 # started on the disk as a member of a group.
3744 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
3745 # You can provide this as a partial or full URL to the resource.
3746 # For example, the following are valid values:
3747 #
3748 #
3749 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3750 # - projects/project/zones/zone/disks/disk
3751 # - zones/zone/disks/disk
3752 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
3753 # to or from the current disk. This value identifies the exact disk that
3754 # was used to create this replication. For example, if you started
3755 # replicating the persistent disk from a disk that was later deleted and
3756 # recreated under the same name, the disk ID would identify the exact
3757 # version of the disk that was used.
3758 },
3759 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
3760 &quot;a_key&quot;: {
3761 &quot;asyncReplicationDisk&quot;: {
3762 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
3763 # started on the disk as a member of a group.
3764 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
3765 # started on the disk as a member of a group.
3766 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
3767 # You can provide this as a partial or full URL to the resource.
3768 # For example, the following are valid values:
3769 #
3770 #
3771 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3772 # - projects/project/zones/zone/disks/disk
3773 # - zones/zone/disks/disk
3774 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
3775 # to or from the current disk. This value identifies the exact disk that
3776 # was used to create this replication. For example, if you started
3777 # replicating the persistent disk from a disk that was later deleted and
3778 # recreated under the same name, the disk ID would identify the exact
3779 # version of the disk that was used.
3780 },
3781 },
3782 },
3783 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
3784 # text format.
3785 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
3786 # create the resource.
3787 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
3788 # customer-supplied encryption key or a
3789 # customer-managed encryption key.
3790 #
3791 # Encryption keys do not protect access to metadata of the disk.
3792 #
3793 # After you encrypt a disk with a customer-supplied key, you must provide the
3794 # same key if you use the disk later. For example, to create a disk snapshot,
3795 # to create a disk image, to create a machine image, or to attach the disk to
3796 # a virtual machine.
3797 #
3798 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
3799 # name once the disk is created. The disk is encrypted with this version of
3800 # the key. In the response, diskEncryptionKey.kmsKeyName appears
3801 # in the following format:
3802 #
3803 # &quot;diskEncryptionKey.kmsKeyName&quot;:
3804 # &quot;projects/kms_project_id/locations/region/keyRings/
3805 # key_region/cryptoKeys/key
3806 # /cryptoKeysVersions/version
3807 #
3808 # If you do not provide an encryption key when creating the disk, then the
3809 # disk is encrypted using an automatically generated key and you don&#x27;t need
3810 # to provide a key to use the disk later.
3811 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3812 # For example:
3813 #
3814 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3815 # key_region/cryptoKeys/key
3816 #
3817 # The fully-qualifed key name may be returned for resource GET requests. For
3818 # example:
3819 #
3820 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3821 # key_region/cryptoKeys/key
3822 # /cryptoKeyVersions/1
3823 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3824 # key. If absent, the Compute Engine default service account is used.
3825 # For example:
3826 #
3827 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3828 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3829 # encryption key, encoded in RFC
3830 # 4648 base64 to either encrypt or decrypt this resource. You can
3831 # provide either the rawKey or thersaEncryptedKey.
3832 # For example:
3833 #
3834 # &quot;rawKey&quot;:
3835 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3836 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3837 # customer-supplied encryption key to either encrypt or decrypt this
3838 # resource. You can provide either the rawKey or thersaEncryptedKey.
3839 # For example:
3840 #
3841 # &quot;rsaEncryptedKey&quot;:
3842 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3843 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3844 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3845 #
3846 # The key must meet the following requirements before you can provide it to
3847 # Compute Engine:
3848 #
3849 # 1. The key is wrapped using a RSA public key certificate provided by
3850 # Google.
3851 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3852 # encoding.
3853 #
3854 # Gets the RSA public key certificate provided by Google at:
3855 #
3856 #
3857 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3858 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3859 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3860 # encryption key that protects this resource.
3861 },
3862 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
3863 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
3864 # Windows specific VSS signature.
3865 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
3866 # only for bootable images. Read
3867 # Enabling guest operating system features to see a list of available
3868 # options.
3869 { # Guest OS features.
3870 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
3871 # separate values. Set to one or more of the following values:
3872 #
3873 # - VIRTIO_SCSI_MULTIQUEUE
3874 # - WINDOWS
3875 # - MULTI_IP_SUBNET
3876 # - UEFI_COMPATIBLE
3877 # - GVNIC
3878 # - SEV_CAPABLE
3879 # - SUSPEND_RESUME_COMPATIBLE
3880 # - SEV_LIVE_MIGRATABLE_V2
3881 # - SEV_SNP_CAPABLE
3882 # - TDX_CAPABLE
3883 # - IDPF
3884 # - SNP_SVSM_CAPABLE
3885 # - CCA_CAPABLE
3886 #
3887 #
3888 # For more information, see
3889 # Enabling guest operating system features.
3890 },
3891 ],
3892 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
3893 # defined by the server.
3894 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
3895 # which is either SCSI or NVME. The default isSCSI.
3896 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
3897 # disks.
3898 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
3899 # essentially a hash of the labels set used for optimistic locking. The
3900 # fingerprint is initially generated by Compute Engine and changes after
3901 # every request to modify or update labels. You must always provide an
3902 # up-to-date fingerprint hash in order to update or change labels,
3903 # otherwise the request will fail with error412 conditionNotMet.
3904 #
3905 # To see the latest fingerprint, make a get() request to
3906 # retrieve a disk.
3907 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
3908 # the setLabels method.
3909 &quot;a_key&quot;: &quot;A String&quot;,
3910 },
3911 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
3912 # text format.
3913 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
3914 # text format.
3915 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
3916 &quot;A String&quot;,
3917 ],
3918 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
3919 &quot;A String&quot;,
3920 ],
3921 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
3922 # This field is for use by internal tools that use the public API.
3923 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
3924 # source image. Attachment of a disk created from a locked source image will
3925 # cause the following operations to become irreversibly prohibited:
3926 #
3927 # - R/W or R/O disk attachment to any other instance
3928 # - Disk detachment. And the disk can only be deleted when the instance
3929 # is deleted
3930 # - Creation of images or snapshots
3931 # - Disk cloning
3932 #
3933 #
3934 #
3935 # Furthermore, the instance with at least one disk with locked flag set to
3936 # true will be prohibited from performing the operations below:
3937 #
3938 # - Further attachment of secondary disks.
3939 # - Detachment of any disks
3940 # - Create machine images
3941 # - Create instance template
3942 # - Delete the instance with --keep-disk parameter set to true for locked
3943 # disks
3944 # - Attach a locked disk with --auto-delete parameter set to false
3945 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
3946 # more than one instance.
3947 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
3948 # The name must be 1-63 characters long, and comply withRFC1035.
3949 # Specifically, the name must be 1-63 characters long and match the regular
3950 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
3951 # which means the first character must be a lowercase letter, and all
3952 # following characters must be a dash, lowercase letter, or digit, except
3953 # the last character, which cannot be a dash.
3954 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
3955 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
3956 # as part of resource payload.
3957 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
3958 # have the same definition as resource
3959 # manager tags. Keys and values can be either in numeric format,
3960 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3961 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3962 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
3963 # PATCH) when empty.
3964 &quot;a_key&quot;: &quot;A String&quot;,
3965 },
3966 },
3967 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
3968 # If not present in a request, a default value is used.
3969 # The currently supported size is 4096, other sizes may be added in
3970 # the future.
3971 # If an unsupported value is requested, the error message will list
3972 # the supported values for the caller&#x27;s project.
3973 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
3974 # of I/O operations per second that the disk can handle. Values must be
3975 # between 10,000 and 120,000. For more details, see theExtreme persistent
3976 # disk documentation.
3977 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
3978 # number of throughput mb per second that the disk can handle. Values must be
3979 # greater than or equal to 1.
3980 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
3981 # regional resources.
3982 # You must specify this field as part of the HTTP request URL. It is
3983 # not settable as a field in the request body.
3984 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
3985 # for regional resources.
3986 &quot;A String&quot;,
3987 ],
3988 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
3989 &quot;A String&quot;,
3990 ],
3991 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
3992 &quot;asyncPrimaryDisk&quot;: {
3993 &quot;state&quot;: &quot;A String&quot;,
3994 },
3995 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
3996 &quot;a_key&quot;: {
3997 &quot;state&quot;: &quot;A String&quot;,
3998 },
3999 },
4000 },
4001 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
4002 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
4003 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
4004 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
4005 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
4006 # persistent disk.
4007 #
4008 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
4009 # source.
4010 # Acceptable values are greater than 0.
4011 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
4012 # that was created using a consistency group.
4013 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
4014 # that was created using a consistency group.
4015 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
4016 # partial or full URL to the resource. For example, the following are valid
4017 # values:
4018 #
4019 #
4020 # -
4021 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
4022 #
4023 # -
4024 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
4025 #
4026 # -
4027 # projects/project/zones/zone/disks/disk
4028 #
4029 # -
4030 # projects/project/regions/region/disks/disk
4031 #
4032 # -
4033 # zones/zone/disks/disk
4034 #
4035 # -
4036 # regions/region/disks/disk
4037 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
4038 # value identifies the exact disk that was used to create this persistent
4039 # disk. For example, if you created the persistent disk from a disk that
4040 # was later deleted and recreated under the same name, the source disk ID
4041 # would identify the exact version of the disk that was used.
4042 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
4043 # deleted, this field will not be set.
4044 #
4045 # To create a disk with one of the public operating system images, specify
4046 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
4047 #
4048 # projects/debian-cloud/global/images/family/debian-9
4049 #
4050 #
4051 # Alternatively, use a specific version of a public operating system image:
4052 #
4053 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
4054 #
4055 #
4056 # To create a disk with a custom image that you created, specify the
4057 # image name in the following format:
4058 #
4059 # global/images/my-custom-image
4060 #
4061 #
4062 # You can also specify a custom image by its image family, which returns
4063 # the latest version of the image in that family. Replace the image name
4064 # with family/family-name:
4065 #
4066 # global/images/family/my-image-family
4067 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
4068 # encryption key of the source image. Required if the source image is
4069 # protected by a customer-supplied encryption key.
4070 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4071 # For example:
4072 #
4073 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4074 # key_region/cryptoKeys/key
4075 #
4076 # The fully-qualifed key name may be returned for resource GET requests. For
4077 # example:
4078 #
4079 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4080 # key_region/cryptoKeys/key
4081 # /cryptoKeyVersions/1
4082 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4083 # key. If absent, the Compute Engine default service account is used.
4084 # For example:
4085 #
4086 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4087 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4088 # encryption key, encoded in RFC
4089 # 4648 base64 to either encrypt or decrypt this resource. You can
4090 # provide either the rawKey or thersaEncryptedKey.
4091 # For example:
4092 #
4093 # &quot;rawKey&quot;:
4094 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4095 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4096 # customer-supplied encryption key to either encrypt or decrypt this
4097 # resource. You can provide either the rawKey or thersaEncryptedKey.
4098 # For example:
4099 #
4100 # &quot;rsaEncryptedKey&quot;:
4101 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4102 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4103 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4104 #
4105 # The key must meet the following requirements before you can provide it to
4106 # Compute Engine:
4107 #
4108 # 1. The key is wrapped using a RSA public key certificate provided by
4109 # Google.
4110 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4111 # encoding.
4112 #
4113 # Gets the RSA public key certificate provided by Google at:
4114 #
4115 #
4116 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4117 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4118 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4119 # encryption key that protects this resource.
4120 },
4121 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
4122 # value identifies the exact image that was used to create this persistent
4123 # disk. For example, if you created the persistent disk from an image that
4124 # was later deleted and recreated under the same name, the source image ID
4125 # would identify the exact version of the image that was used.
4126 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
4127 # this as a partial or full URL to the resource. For example, the following
4128 # are valid values:
4129 #
4130 #
4131 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
4132 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
4133 # - zones/zone/instantSnapshots/instantSnapshot
4134 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
4135 # disk. This value identifies the exact instant snapshot that was used to
4136 # create this persistent disk. For example, if you created the persistent
4137 # disk from an instant snapshot that was later deleted and recreated under
4138 # the same name, the source instant snapshot ID would identify the exact
4139 # version of the instant snapshot that was used.
4140 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
4141 # partial or full URL to the resource. For example, the following are valid
4142 # values:
4143 #
4144 #
4145 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
4146 # - projects/project/global/machineImages/machineImage
4147 # - global/machineImages/machineImage
4148 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
4149 # source_machine_image must be specified.
4150 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
4151 # encryption key of the source machine image. Required if the source
4152 # machine image is protected by a customer-supplied encryption key.
4153 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4154 # For example:
4155 #
4156 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4157 # key_region/cryptoKeys/key
4158 #
4159 # The fully-qualifed key name may be returned for resource GET requests. For
4160 # example:
4161 #
4162 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4163 # key_region/cryptoKeys/key
4164 # /cryptoKeyVersions/1
4165 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4166 # key. If absent, the Compute Engine default service account is used.
4167 # For example:
4168 #
4169 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4170 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4171 # encryption key, encoded in RFC
4172 # 4648 base64 to either encrypt or decrypt this resource. You can
4173 # provide either the rawKey or thersaEncryptedKey.
4174 # For example:
4175 #
4176 # &quot;rawKey&quot;:
4177 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4178 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4179 # customer-supplied encryption key to either encrypt or decrypt this
4180 # resource. You can provide either the rawKey or thersaEncryptedKey.
4181 # For example:
4182 #
4183 # &quot;rsaEncryptedKey&quot;:
4184 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4185 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4186 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4187 #
4188 # The key must meet the following requirements before you can provide it to
4189 # Compute Engine:
4190 #
4191 # 1. The key is wrapped using a RSA public key certificate provided by
4192 # Google.
4193 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4194 # encoding.
4195 #
4196 # Gets the RSA public key certificate provided by Google at:
4197 #
4198 #
4199 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4200 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4201 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4202 # encryption key that protects this resource.
4203 },
4204 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
4205 # This value identifies the exact machine image that was used to create this
4206 # persistent disk. For example, if you created the persistent disk from a
4207 # machine image that was later deleted and recreated under the same name, the
4208 # source machine image ID would identify the exact version of the machine
4209 # image that was used.
4210 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
4211 # partial or full URL to the resource. For example, the following are valid
4212 # values:
4213 #
4214 #
4215 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
4216 # - projects/project/global/snapshots/snapshot
4217 # - global/snapshots/snapshot
4218 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
4219 # encryption key of the source snapshot. Required if the source snapshot
4220 # is protected by a customer-supplied encryption key.
4221 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4222 # For example:
4223 #
4224 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4225 # key_region/cryptoKeys/key
4226 #
4227 # The fully-qualifed key name may be returned for resource GET requests. For
4228 # example:
4229 #
4230 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4231 # key_region/cryptoKeys/key
4232 # /cryptoKeyVersions/1
4233 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4234 # key. If absent, the Compute Engine default service account is used.
4235 # For example:
4236 #
4237 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4238 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4239 # encryption key, encoded in RFC
4240 # 4648 base64 to either encrypt or decrypt this resource. You can
4241 # provide either the rawKey or thersaEncryptedKey.
4242 # For example:
4243 #
4244 # &quot;rawKey&quot;:
4245 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4246 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4247 # customer-supplied encryption key to either encrypt or decrypt this
4248 # resource. You can provide either the rawKey or thersaEncryptedKey.
4249 # For example:
4250 #
4251 # &quot;rsaEncryptedKey&quot;:
4252 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4253 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4254 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4255 #
4256 # The key must meet the following requirements before you can provide it to
4257 # Compute Engine:
4258 #
4259 # 1. The key is wrapped using a RSA public key certificate provided by
4260 # Google.
4261 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4262 # encoding.
4263 #
4264 # Gets the RSA public key certificate provided by Google at:
4265 #
4266 #
4267 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4268 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4269 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4270 # encryption key that protects this resource.
4271 },
4272 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
4273 # value identifies the exact snapshot that was used to create this persistent
4274 # disk. For example, if you created the persistent disk from a snapshot that
4275 # was later deleted and recreated under the same name, the source snapshot ID
4276 # would identify the exact version of the snapshot that was used.
4277 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
4278 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
4279 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
4280 # https://storage.googleapis.com/. This flag is not optimized for creating
4281 # multiple disks from a source storage object. To create many disks from a
4282 # source storage object, use gcloud compute images
4283 # import instead.
4284 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
4285 #
4286 #
4287 # - CREATING: Disk is provisioning.
4288 # - RESTORING: Source data is being copied into the
4289 # disk.
4290 # - FAILED: Disk creation failed.
4291 # - READY: Disk is ready for use.
4292 # - DELETING: Disk is deleting.
4293 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
4294 # this as a partial or full URL to the resource. For example, the following
4295 # are valid values:
4296 #
4297 #
4298 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
4299 # - projects/project/zones/zone/storagePools/storagePool
4300 # - zones/zone/storagePools/storagePool
4301 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
4302 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
4303 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
4304 # types.
4305 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
4306 # in form:projects/project/zones/zone/instances/instance
4307 &quot;A String&quot;,
4308 ],
4309 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
4310 # You must specify this field as part of the HTTP request URL. It is
4311 # not settable as a field in the request body.
4312 },
4313 ],
4314 &quot;kind&quot;: &quot;compute#diskList&quot;, # Output only. [Output Only] Type of resource. Always compute#diskList for
4315 # lists of disks.
4316 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
4317 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
4318 # the query parameter pageToken in the next list request.
4319 # Subsequent list requests will have their own nextPageToken to
4320 # continue paging through the results.
4321 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
4322 &quot;warning&quot;: { # [Output Only] Informational warning message.
4323 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4324 # Engine returns NO_RESULTS_ON_PAGE if there
4325 # are no results in the response.
4326 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4327 # value format. For example:
4328 #
4329 # &quot;data&quot;: [
4330 # {
4331 # &quot;key&quot;: &quot;scope&quot;,
4332 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4333 # }
4334 {
4335 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4336 # returned. For example, for warnings where there are no results in a list
4337 # request for a particular zone, this key might be scope and
4338 # the key value might be the zone name. Other examples might be a key
4339 # indicating a deprecated resource and a suggested replacement, or a
4340 # warning about invalid network settings (for example, if an instance
4341 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4342 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4343 },
4344 ],
4345 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4346 },
4347 }</pre>
4348 </div>
4349
4350 <div class="method">
4351 <code class="details" id="list_next">list_next()</code>
4352 <pre>Retrieves the next page of results.
4353
4354 Args:
4355 previous_request: The request for the previous page. (required)
4356 previous_response: The response from the request for the previous page. (required)
4357
4358 Returns:
4359 A request object that you can call &#x27;execute()&#x27; on to request the next
4360 page. Returns None if there are no more items in the collection.
4361 </pre>
4362 </div>
4363
4364 <div class="method">
4365 <code class="details" id="removeResourcePolicies">removeResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
4366 <pre>Removes resource policies from a regional disk.
4367
4368 Args:
4369 project: string, Project ID for this request. (required)
4370 region: string, The name of the region for this request. (required)
4371 disk: string, The disk name for this request. (required)
4372 body: object, The request body.
4373 The object takes the form of:
4374
4375 {
4376 &quot;resourcePolicies&quot;: [ # Resource policies to be removed from this disk.
4377 &quot;A String&quot;,
4378 ],
4379 }
4380
4381 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
4382 that if you must retry your request, the server will know to ignore the
4383 request if it has already been completed.
4384
4385 For example, consider a situation where you make an initial request and
4386 the request times out. If you make the request again with the same
4387 request ID, the server can check if original operation with the same
4388 request ID was received, and if so, will ignore the second request. This
4389 prevents clients from accidentally creating duplicate commitments.
4390
4391 The request ID must be
4392 a valid UUID with the exception that zero UUID is not supported
4393 (00000000-0000-0000-0000-000000000000).
4394 x__xgafv: string, V1 error format.
4395 Allowed values
4396 1 - v1 error format
4397 2 - v2 error format
4398
4399 Returns:
4400 An object of the form:
4401
4402 { # Represents an Operation resource.
4403 #
4404 # Google Compute Engine has three Operation resources:
4405 #
4406 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
4407 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
4408 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
4409 #
4410 # You can use an operation resource to manage asynchronous API requests.
4411 # For more information, readHandling
4412 # API responses.
4413 #
4414 # Operations can be global, regional or zonal.
4415 #
4416 # - For global operations, use the `globalOperations`
4417 # resource.
4418 # - For regional operations, use the
4419 # `regionOperations` resource.
4420 # - For zonal operations, use
4421 # the `zoneOperations` resource.
4422 #
4423 #
4424 #
4425 # For more information, read
4426 # Global, Regional, and Zonal Resources.
4427 #
4428 # Note that completed Operation resources have a limited
4429 # retention period.
4430 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4431 # Not present otherwise.
4432 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4433 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4434 # set when the operation is created.
4435 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4436 # text format.
4437 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4438 # this field will be populated.
4439 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4440 # operation.
4441 {
4442 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4443 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4444 # details. There is a set of defined message types to use for providing
4445 # details.The syntax depends on the error code. For example,
4446 # QuotaExceededInfo will have details when the error code is
4447 # QUOTA_EXCEEDED.
4448 {
4449 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4450 #
4451 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4452 # is not enabled:
4453 #
4454 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4455 # &quot;domain&quot;: &quot;googleapis.com&quot;
4456 # &quot;metadata&quot;: {
4457 # &quot;resource&quot;: &quot;projects/123&quot;,
4458 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4459 # }
4460 # }
4461 #
4462 # This response indicates that the pubsub.googleapis.com API is not enabled.
4463 #
4464 # Example of an error that is returned when attempting to create a Spanner
4465 # instance in a region that is out of stock:
4466 #
4467 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4468 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4469 # &quot;metadata&quot;: {
4470 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4471 # }
4472 # }
4473 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4474 # is typically the registered service name of the tool or product that
4475 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4476 # generated by some common infrastructure, the error domain must be a
4477 # globally unique value that identifies the infrastructure. For Google API
4478 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4479 &quot;metadatas&quot;: { # Additional structured details about this error.
4480 #
4481 # Keys must match a regular expression of `a-z+` but should
4482 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4483 # length. When identifying the current value of an exceeded limit, the units
4484 # should be contained in the key, not the value. For example, rather than
4485 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4486 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4487 # instances that can be created in a single (batch) request.
4488 &quot;a_key&quot;: &quot;A String&quot;,
4489 },
4490 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4491 # proximate cause of the error. Error reasons are unique within a particular
4492 # domain of errors. This should be at most 63 characters and match a
4493 # regular expression of `A-Z+[A-Z0-9]`, which represents
4494 # UPPER_SNAKE_CASE.
4495 },
4496 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4497 #
4498 # For example, if a quota check failed with an error indicating the calling
4499 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4500 # directly to the right place in the developer console to flip the bit.
4501 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4502 { # Describes a URL link.
4503 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4504 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4505 },
4506 ],
4507 },
4508 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4509 # which can be attached to an RPC error.
4510 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4511 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4512 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4513 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4514 },
4515 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4516 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4517 &quot;a_key&quot;: &quot;A String&quot;,
4518 },
4519 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4520 # type or metric.
4521 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4522 # or metric.
4523 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4524 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4525 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4526 },
4527 },
4528 ],
4529 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4530 # This property is optional.
4531 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4532 },
4533 ],
4534 },
4535 &quot;getVersionOperationMetadata&quot;: {
4536 &quot;inlineSbomInfo&quot;: {
4537 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4538 # appropriate identifiers.
4539 &quot;a_key&quot;: &quot;A String&quot;,
4540 },
4541 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4542 # identifiers.
4543 &quot;a_key&quot;: &quot;A String&quot;,
4544 },
4545 },
4546 },
4547 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4548 # message that was returned, such as `NOT FOUND`.
4549 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4550 # status code that was returned. For example, a `404` means the
4551 # resource was not found.
4552 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4553 # defined by the server.
4554 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4555 # This value is inRFC3339
4556 # text format.
4557 &quot;instancesBulkInsertOperationMetadata&quot;: {
4558 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4559 # Example key: zones/us-central1-a
4560 &quot;a_key&quot;: {
4561 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4562 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4563 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4564 # error.
4565 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4566 # if the flow is rolling forward or rolling back.
4567 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4568 },
4569 },
4570 },
4571 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4572 # Operation resources.
4573 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4574 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4575 # group of operations results from a `bulkInsert` API request.
4576 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4577 # `update`, or `delete`, and so on.
4578 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4579 # There is no requirement that this be linear or support any granularity of
4580 # operations. This should not be used to guess when the operation will be
4581 # complete. This number should monotonically increase as the operation
4582 # progresses.
4583 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4584 # applicable when performing regional operations.
4585 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4586 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4587 # this field will contain information on all underlying zonal actions and
4588 # their state.
4589 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4590 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4591 # Example key: zones/us-central1-a
4592 &quot;a_key&quot;: {
4593 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
4594 # populated.
4595 # different programming environments, including REST APIs and RPC APIs. It is
4596 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4597 # three pieces of data: error code, error message, and error details.
4598 #
4599 # You can find out more about this error model and how to work with it in the
4600 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4601 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4602 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4603 # message types for APIs to use.
4604 {
4605 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4606 },
4607 ],
4608 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4609 # user-facing error message should be localized and sent in the
4610 # google.rpc.Status.details field, or localized by the client.
4611 },
4612 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4613 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4614 },
4615 },
4616 },
4617 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4618 # This value is inRFC3339
4619 # text format.
4620 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4621 # following:
4622 # `PENDING`, `RUNNING`, or `DONE`.
4623 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4624 # operation.
4625 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4626 # of the target resource.
4627 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4628 # operations related to creating a snapshot, this points to the disk
4629 # that the snapshot was created from.
4630 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4631 # `[email protected]` or
4632 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4633 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4634 # operation, this field will be populated.
4635 {
4636 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4637 # Engine returns NO_RESULTS_ON_PAGE if there
4638 # are no results in the response.
4639 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4640 # value format. For example:
4641 #
4642 # &quot;data&quot;: [
4643 # {
4644 # &quot;key&quot;: &quot;scope&quot;,
4645 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4646 # }
4647 {
4648 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4649 # returned. For example, for warnings where there are no results in a list
4650 # request for a particular zone, this key might be scope and
4651 # the key value might be the zone name. Other examples might be a key
4652 # indicating a deprecated resource and a suggested replacement, or a
4653 # warning about invalid network settings (for example, if an instance
4654 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4655 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4656 },
4657 ],
4658 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4659 },
4660 ],
4661 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4662 # applicable when performing per-zone operations.
4663 }</pre>
4664 </div>
4665
4666 <div class="method">
4667 <code class="details" id="resize">resize(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
4668 <pre>Resizes the specified regional persistent disk.
4669
4670 Args:
4671 project: string, The project ID for this request. (required)
4672 region: string, Name of the region for this request. (required)
4673 disk: string, Name of the regional persistent disk. (required)
4674 body: object, The request body.
4675 The object takes the form of:
4676
4677 {
4678 &quot;sizeGb&quot;: &quot;A String&quot;, # The new size of the regional persistent disk, which is specified in GB.
4679 }
4680
4681 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
4682 that if you must retry your request, the server will know to ignore the
4683 request if it has already been completed.
4684
4685 For example, consider a situation where you make an initial request and
4686 the request times out. If you make the request again with the same
4687 request ID, the server can check if original operation with the same
4688 request ID was received, and if so, will ignore the second request. This
4689 prevents clients from accidentally creating duplicate commitments.
4690
4691 The request ID must be
4692 a valid UUID with the exception that zero UUID is not supported
4693 (00000000-0000-0000-0000-000000000000).
4694 x__xgafv: string, V1 error format.
4695 Allowed values
4696 1 - v1 error format
4697 2 - v2 error format
4698
4699 Returns:
4700 An object of the form:
4701
4702 { # Represents an Operation resource.
4703 #
4704 # Google Compute Engine has three Operation resources:
4705 #
4706 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
4707 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
4708 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
4709 #
4710 # You can use an operation resource to manage asynchronous API requests.
4711 # For more information, readHandling
4712 # API responses.
4713 #
4714 # Operations can be global, regional or zonal.
4715 #
4716 # - For global operations, use the `globalOperations`
4717 # resource.
4718 # - For regional operations, use the
4719 # `regionOperations` resource.
4720 # - For zonal operations, use
4721 # the `zoneOperations` resource.
4722 #
4723 #
4724 #
4725 # For more information, read
4726 # Global, Regional, and Zonal Resources.
4727 #
4728 # Note that completed Operation resources have a limited
4729 # retention period.
4730 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4731 # Not present otherwise.
4732 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4733 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4734 # set when the operation is created.
4735 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4736 # text format.
4737 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4738 # this field will be populated.
4739 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4740 # operation.
4741 {
4742 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4743 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4744 # details. There is a set of defined message types to use for providing
4745 # details.The syntax depends on the error code. For example,
4746 # QuotaExceededInfo will have details when the error code is
4747 # QUOTA_EXCEEDED.
4748 {
4749 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4750 #
4751 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4752 # is not enabled:
4753 #
4754 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4755 # &quot;domain&quot;: &quot;googleapis.com&quot;
4756 # &quot;metadata&quot;: {
4757 # &quot;resource&quot;: &quot;projects/123&quot;,
4758 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4759 # }
4760 # }
4761 #
4762 # This response indicates that the pubsub.googleapis.com API is not enabled.
4763 #
4764 # Example of an error that is returned when attempting to create a Spanner
4765 # instance in a region that is out of stock:
4766 #
4767 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4768 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4769 # &quot;metadata&quot;: {
4770 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4771 # }
4772 # }
4773 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4774 # is typically the registered service name of the tool or product that
4775 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4776 # generated by some common infrastructure, the error domain must be a
4777 # globally unique value that identifies the infrastructure. For Google API
4778 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4779 &quot;metadatas&quot;: { # Additional structured details about this error.
4780 #
4781 # Keys must match a regular expression of `a-z+` but should
4782 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4783 # length. When identifying the current value of an exceeded limit, the units
4784 # should be contained in the key, not the value. For example, rather than
4785 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4786 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4787 # instances that can be created in a single (batch) request.
4788 &quot;a_key&quot;: &quot;A String&quot;,
4789 },
4790 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4791 # proximate cause of the error. Error reasons are unique within a particular
4792 # domain of errors. This should be at most 63 characters and match a
4793 # regular expression of `A-Z+[A-Z0-9]`, which represents
4794 # UPPER_SNAKE_CASE.
4795 },
4796 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4797 #
4798 # For example, if a quota check failed with an error indicating the calling
4799 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4800 # directly to the right place in the developer console to flip the bit.
4801 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4802 { # Describes a URL link.
4803 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4804 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4805 },
4806 ],
4807 },
4808 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4809 # which can be attached to an RPC error.
4810 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4811 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4812 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4813 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4814 },
4815 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4816 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4817 &quot;a_key&quot;: &quot;A String&quot;,
4818 },
4819 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4820 # type or metric.
4821 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4822 # or metric.
4823 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4824 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4825 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4826 },
4827 },
4828 ],
4829 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4830 # This property is optional.
4831 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4832 },
4833 ],
4834 },
4835 &quot;getVersionOperationMetadata&quot;: {
4836 &quot;inlineSbomInfo&quot;: {
4837 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4838 # appropriate identifiers.
4839 &quot;a_key&quot;: &quot;A String&quot;,
4840 },
4841 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4842 # identifiers.
4843 &quot;a_key&quot;: &quot;A String&quot;,
4844 },
4845 },
4846 },
4847 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4848 # message that was returned, such as `NOT FOUND`.
4849 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4850 # status code that was returned. For example, a `404` means the
4851 # resource was not found.
4852 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4853 # defined by the server.
4854 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4855 # This value is inRFC3339
4856 # text format.
4857 &quot;instancesBulkInsertOperationMetadata&quot;: {
4858 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4859 # Example key: zones/us-central1-a
4860 &quot;a_key&quot;: {
4861 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4862 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4863 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4864 # error.
4865 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4866 # if the flow is rolling forward or rolling back.
4867 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4868 },
4869 },
4870 },
4871 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4872 # Operation resources.
4873 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4874 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4875 # group of operations results from a `bulkInsert` API request.
4876 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4877 # `update`, or `delete`, and so on.
4878 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4879 # There is no requirement that this be linear or support any granularity of
4880 # operations. This should not be used to guess when the operation will be
4881 # complete. This number should monotonically increase as the operation
4882 # progresses.
4883 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4884 # applicable when performing regional operations.
4885 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4886 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4887 # this field will contain information on all underlying zonal actions and
4888 # their state.
4889 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4890 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4891 # Example key: zones/us-central1-a
4892 &quot;a_key&quot;: {
4893 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
4894 # populated.
4895 # different programming environments, including REST APIs and RPC APIs. It is
4896 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4897 # three pieces of data: error code, error message, and error details.
4898 #
4899 # You can find out more about this error model and how to work with it in the
4900 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4901 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4902 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4903 # message types for APIs to use.
4904 {
4905 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4906 },
4907 ],
4908 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4909 # user-facing error message should be localized and sent in the
4910 # google.rpc.Status.details field, or localized by the client.
4911 },
4912 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4913 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4914 },
4915 },
4916 },
4917 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4918 # This value is inRFC3339
4919 # text format.
4920 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4921 # following:
4922 # `PENDING`, `RUNNING`, or `DONE`.
4923 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4924 # operation.
4925 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4926 # of the target resource.
4927 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4928 # operations related to creating a snapshot, this points to the disk
4929 # that the snapshot was created from.
4930 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4931 # `[email protected]` or
4932 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4933 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4934 # operation, this field will be populated.
4935 {
4936 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4937 # Engine returns NO_RESULTS_ON_PAGE if there
4938 # are no results in the response.
4939 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4940 # value format. For example:
4941 #
4942 # &quot;data&quot;: [
4943 # {
4944 # &quot;key&quot;: &quot;scope&quot;,
4945 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4946 # }
4947 {
4948 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4949 # returned. For example, for warnings where there are no results in a list
4950 # request for a particular zone, this key might be scope and
4951 # the key value might be the zone name. Other examples might be a key
4952 # indicating a deprecated resource and a suggested replacement, or a
4953 # warning about invalid network settings (for example, if an instance
4954 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4955 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4956 },
4957 ],
4958 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4959 },
4960 ],
4961 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4962 # applicable when performing per-zone operations.
4963 }</pre>
4964 </div>
4965
4966 <div class="method">
4967 <code class="details" id="setIamPolicy">setIamPolicy(project, region, resource, body=None, x__xgafv=None)</code>
4968 <pre>Sets the access control policy on the specified resource.
4969 Replaces any existing policy.
4970
4971 Args:
4972 project: string, Project ID for this request. (required)
4973 region: string, The name of the region for this request. (required)
4974 resource: string, Name or id of the resource for this request. (required)
4975 body: object, The request body.
4976 The object takes the form of:
4977
4978 {
4979 &quot;bindings&quot;: [ # Flatten Policy to create a backwacd compatible wire-format.
4980 # Deprecated. Use &#x27;policy&#x27; to specify bindings.
4981 { # Associates `members`, or principals, with a `role`.
4982 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
4983 #
4984 # If the condition evaluates to `true`, then this binding applies to the
4985 # current request.
4986 #
4987 # If the condition evaluates to `false`, then this binding does not apply to
4988 # the current request. However, a different role binding might grant the same
4989 # role to one or more of the principals in this binding.
4990 #
4991 # To learn which resources support conditions in their IAM policies, see the
4992 # [IAM
4993 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
4994 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
4995 # are documented at https://github.com/google/cel-spec.
4996 #
4997 # Example (Comparison):
4998 #
4999 # title: &quot;Summary size limit&quot;
5000 # description: &quot;Determines if a summary is less than 100 chars&quot;
5001 # expression: &quot;document.summary.size() &lt; 100&quot;
5002 #
5003 # Example (Equality):
5004 #
5005 # title: &quot;Requestor is owner&quot;
5006 # description: &quot;Determines if requestor is the document owner&quot;
5007 # expression: &quot;document.owner == request.auth.claims.email&quot;
5008 #
5009 # Example (Logic):
5010 #
5011 # title: &quot;Public documents&quot;
5012 # description: &quot;Determine whether the document should be publicly visible&quot;
5013 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
5014 #
5015 # Example (Data Manipulation):
5016 #
5017 # title: &quot;Notification string&quot;
5018 # description: &quot;Create a notification string with a timestamp.&quot;
5019 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
5020 #
5021 # The exact variables and functions that may be referenced within an expression
5022 # are determined by the service that evaluates it. See the service
5023 # documentation for additional information.
5024 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
5025 # describes the expression, e.g. when hovered over it in a UI.
5026 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
5027 # syntax.
5028 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
5029 # reporting, e.g. a file name and a position in the file.
5030 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
5031 # its purpose. This can be used e.g. in UIs which allow to enter the
5032 # expression.
5033 },
5034 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
5035 # `members` can have the following values:
5036 #
5037 # * `allUsers`: A special identifier that represents anyone who is
5038 # on the internet; with or without a Google account.
5039 #
5040 # * `allAuthenticatedUsers`: A special identifier that represents anyone
5041 # who is authenticated with a Google account or a service account.
5042 # Does not include identities that come from external identity providers
5043 # (IdPs) through identity federation.
5044 #
5045 # * `user:{emailid}`: An email address that represents a specific Google
5046 # account. For example, `[email protected]` .
5047 #
5048 #
5049 # * `serviceAccount:{emailid}`: An email address that represents a Google
5050 # service account. For example,
5051 # `[email protected]`.
5052 #
5053 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
5054 # identifier for a
5055 # [Kubernetes service
5056 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
5057 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
5058 #
5059 # * `group:{emailid}`: An email address that represents a Google group.
5060 # For example, `[email protected]`.
5061 #
5062 #
5063 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
5064 # users of that domain. For example, `google.com` or `example.com`.
5065 #
5066 #
5067 #
5068 #
5069 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5070 # A single identity in a workforce identity pool.
5071 #
5072 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
5073 # All workforce identities in a group.
5074 #
5075 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5076 # All workforce identities with a specific attribute value.
5077 #
5078 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
5079 # All identities in a workforce identity pool.
5080 #
5081 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
5082 # A single identity in a workload identity pool.
5083 #
5084 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
5085 # A workload identity pool group.
5086 #
5087 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5088 # All identities in a workload identity pool with a certain attribute.
5089 #
5090 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
5091 # All identities in a workload identity pool.
5092 #
5093 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
5094 # identifier) representing a user that has been recently deleted. For
5095 # example, `[email protected]?uid=123456789012345678901`. If the user is
5096 # recovered, this value reverts to `user:{emailid}` and the recovered user
5097 # retains the role in the binding.
5098 #
5099 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
5100 # unique identifier) representing a service account that has been recently
5101 # deleted. For example,
5102 # `[email protected]?uid=123456789012345678901`.
5103 # If the service account is undeleted, this value reverts to
5104 # `serviceAccount:{emailid}` and the undeleted service account retains the
5105 # role in the binding.
5106 #
5107 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
5108 # identifier) representing a Google group that has been recently
5109 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
5110 # the group is recovered, this value reverts to `group:{emailid}` and the
5111 # recovered group retains the role in the binding.
5112 #
5113 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5114 # Deleted single identity in a workforce identity pool. For example,
5115 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
5116 &quot;A String&quot;,
5117 ],
5118 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
5119 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
5120 #
5121 # For an overview of the IAM roles and permissions, see the
5122 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
5123 # a list of the available pre-defined roles, see
5124 # [here](https://cloud.google.com/iam/docs/understanding-roles).
5125 },
5126 ],
5127 &quot;etag&quot;: &quot;A String&quot;, # Flatten Policy to create a backward compatible wire-format.
5128 # Deprecated. Use &#x27;policy&#x27; to specify the etag.
5129 &quot;policy&quot;: { # An Identity and Access Management (IAM) policy, which specifies access # REQUIRED: The complete policy to be applied to the &#x27;resource&#x27;. The size of
5130 # the policy is limited to a few 10s of KB. An empty policy is in general a
5131 # valid policy but certain services (like Projects) might reject them.
5132 # controls for Google Cloud resources.
5133 #
5134 #
5135 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
5136 # `members`, or principals, to a single `role`. Principals can be user
5137 # accounts, service accounts, Google groups, and domains (such as G Suite). A
5138 # `role` is a named list of permissions; each `role` can be an IAM predefined
5139 # role or a user-created custom role.
5140 #
5141 # For some types of Google Cloud resources, a `binding` can also specify a
5142 # `condition`, which is a logical expression that allows access to a resource
5143 # only if the expression evaluates to `true`. A condition can add constraints
5144 # based on attributes of the request, the resource, or both. To learn which
5145 # resources support conditions in their IAM policies, see the
5146 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5147 #
5148 # **JSON example:**
5149 #
5150 # ```
5151 # {
5152 # &quot;bindings&quot;: [
5153 # {
5154 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
5155 # &quot;members&quot;: [
5156 # &quot;user:[email protected]&quot;,
5157 # &quot;group:[email protected]&quot;,
5158 # &quot;domain:google.com&quot;,
5159 # &quot;serviceAccount:[email protected]&quot;
5160 # ]
5161 # },
5162 # {
5163 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
5164 # &quot;members&quot;: [
5165 # &quot;user:[email protected]&quot;
5166 # ],
5167 # &quot;condition&quot;: {
5168 # &quot;title&quot;: &quot;expirable access&quot;,
5169 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
5170 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
5171 # }
5172 # }
5173 # ],
5174 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
5175 # &quot;version&quot;: 3
5176 # }
5177 # ```
5178 #
5179 # **YAML example:**
5180 #
5181 # ```
5182 # bindings:
5183 # - members:
5184 # - user:[email protected]
5185 # - group:[email protected]
5186 # - domain:google.com
5187 # - serviceAccount:[email protected]
5188 # role: roles/resourcemanager.organizationAdmin
5189 # - members:
5190 # - user:[email protected]
5191 # role: roles/resourcemanager.organizationViewer
5192 # condition:
5193 # title: expirable access
5194 # description: Does not grant access after Sep 2020
5195 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
5196 # etag: BwWWja0YfJA=
5197 # version: 3
5198 # ```
5199 #
5200 # For a description of IAM and its features, see the
5201 # [IAM documentation](https://cloud.google.com/iam/docs/).
5202 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
5203 { # Specifies the audit configuration for a service.
5204 # The configuration determines which permission types are logged, and what
5205 # identities, if any, are exempted from logging.
5206 # An AuditConfig must have one or more AuditLogConfigs.
5207 #
5208 # If there are AuditConfigs for both `allServices` and a specific service,
5209 # the union of the two AuditConfigs is used for that service: the log_types
5210 # specified in each AuditConfig are enabled, and the exempted_members in each
5211 # AuditLogConfig are exempted.
5212 #
5213 # Example Policy with multiple AuditConfigs:
5214 #
5215 # {
5216 # &quot;audit_configs&quot;: [
5217 # {
5218 # &quot;service&quot;: &quot;allServices&quot;,
5219 # &quot;audit_log_configs&quot;: [
5220 # {
5221 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5222 # &quot;exempted_members&quot;: [
5223 # &quot;user:[email protected]&quot;
5224 # ]
5225 # },
5226 # {
5227 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5228 # },
5229 # {
5230 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
5231 # }
5232 # ]
5233 # },
5234 # {
5235 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
5236 # &quot;audit_log_configs&quot;: [
5237 # {
5238 # &quot;log_type&quot;: &quot;DATA_READ&quot;
5239 # },
5240 # {
5241 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
5242 # &quot;exempted_members&quot;: [
5243 # &quot;user:[email protected]&quot;
5244 # ]
5245 # }
5246 # ]
5247 # }
5248 # ]
5249 # }
5250 #
5251 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
5252 # logging. It also exempts `[email protected]` from DATA_READ logging, and
5253 # `[email protected]` from DATA_WRITE logging.
5254 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
5255 { # Provides the configuration for logging a type of permissions.
5256 # Example:
5257 #
5258 # {
5259 # &quot;audit_log_configs&quot;: [
5260 # {
5261 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5262 # &quot;exempted_members&quot;: [
5263 # &quot;user:[email protected]&quot;
5264 # ]
5265 # },
5266 # {
5267 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5268 # }
5269 # ]
5270 # }
5271 #
5272 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
5273 # [email protected] from DATA_READ logging.
5274 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
5275 # permission.
5276 # Follows the same format of Binding.members.
5277 &quot;A String&quot;,
5278 ],
5279 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
5280 },
5281 ],
5282 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
5283 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
5284 # `allServices` is a special value that covers all services.
5285 },
5286 ],
5287 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
5288 # may specify a `condition` that determines how and when the `bindings` are
5289 # applied. Each of the `bindings` must contain at least one principal.
5290 #
5291 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
5292 # of these principals can be Google groups. Each occurrence of a principal
5293 # counts towards these limits. For example, if the `bindings` grant 50
5294 # different roles to `user:[email protected]`, and not to any other
5295 # principal, then you can add another 1,450 principals to the `bindings` in
5296 # the `Policy`.
5297 { # Associates `members`, or principals, with a `role`.
5298 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
5299 #
5300 # If the condition evaluates to `true`, then this binding applies to the
5301 # current request.
5302 #
5303 # If the condition evaluates to `false`, then this binding does not apply to
5304 # the current request. However, a different role binding might grant the same
5305 # role to one or more of the principals in this binding.
5306 #
5307 # To learn which resources support conditions in their IAM policies, see the
5308 # [IAM
5309 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5310 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
5311 # are documented at https://github.com/google/cel-spec.
5312 #
5313 # Example (Comparison):
5314 #
5315 # title: &quot;Summary size limit&quot;
5316 # description: &quot;Determines if a summary is less than 100 chars&quot;
5317 # expression: &quot;document.summary.size() &lt; 100&quot;
5318 #
5319 # Example (Equality):
5320 #
5321 # title: &quot;Requestor is owner&quot;
5322 # description: &quot;Determines if requestor is the document owner&quot;
5323 # expression: &quot;document.owner == request.auth.claims.email&quot;
5324 #
5325 # Example (Logic):
5326 #
5327 # title: &quot;Public documents&quot;
5328 # description: &quot;Determine whether the document should be publicly visible&quot;
5329 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
5330 #
5331 # Example (Data Manipulation):
5332 #
5333 # title: &quot;Notification string&quot;
5334 # description: &quot;Create a notification string with a timestamp.&quot;
5335 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
5336 #
5337 # The exact variables and functions that may be referenced within an expression
5338 # are determined by the service that evaluates it. See the service
5339 # documentation for additional information.
5340 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
5341 # describes the expression, e.g. when hovered over it in a UI.
5342 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
5343 # syntax.
5344 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
5345 # reporting, e.g. a file name and a position in the file.
5346 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
5347 # its purpose. This can be used e.g. in UIs which allow to enter the
5348 # expression.
5349 },
5350 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
5351 # `members` can have the following values:
5352 #
5353 # * `allUsers`: A special identifier that represents anyone who is
5354 # on the internet; with or without a Google account.
5355 #
5356 # * `allAuthenticatedUsers`: A special identifier that represents anyone
5357 # who is authenticated with a Google account or a service account.
5358 # Does not include identities that come from external identity providers
5359 # (IdPs) through identity federation.
5360 #
5361 # * `user:{emailid}`: An email address that represents a specific Google
5362 # account. For example, `[email protected]` .
5363 #
5364 #
5365 # * `serviceAccount:{emailid}`: An email address that represents a Google
5366 # service account. For example,
5367 # `[email protected]`.
5368 #
5369 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
5370 # identifier for a
5371 # [Kubernetes service
5372 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
5373 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
5374 #
5375 # * `group:{emailid}`: An email address that represents a Google group.
5376 # For example, `[email protected]`.
5377 #
5378 #
5379 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
5380 # users of that domain. For example, `google.com` or `example.com`.
5381 #
5382 #
5383 #
5384 #
5385 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5386 # A single identity in a workforce identity pool.
5387 #
5388 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
5389 # All workforce identities in a group.
5390 #
5391 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5392 # All workforce identities with a specific attribute value.
5393 #
5394 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
5395 # All identities in a workforce identity pool.
5396 #
5397 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
5398 # A single identity in a workload identity pool.
5399 #
5400 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
5401 # A workload identity pool group.
5402 #
5403 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5404 # All identities in a workload identity pool with a certain attribute.
5405 #
5406 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
5407 # All identities in a workload identity pool.
5408 #
5409 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
5410 # identifier) representing a user that has been recently deleted. For
5411 # example, `[email protected]?uid=123456789012345678901`. If the user is
5412 # recovered, this value reverts to `user:{emailid}` and the recovered user
5413 # retains the role in the binding.
5414 #
5415 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
5416 # unique identifier) representing a service account that has been recently
5417 # deleted. For example,
5418 # `[email protected]?uid=123456789012345678901`.
5419 # If the service account is undeleted, this value reverts to
5420 # `serviceAccount:{emailid}` and the undeleted service account retains the
5421 # role in the binding.
5422 #
5423 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
5424 # identifier) representing a Google group that has been recently
5425 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
5426 # the group is recovered, this value reverts to `group:{emailid}` and the
5427 # recovered group retains the role in the binding.
5428 #
5429 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5430 # Deleted single identity in a workforce identity pool. For example,
5431 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
5432 &quot;A String&quot;,
5433 ],
5434 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
5435 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
5436 #
5437 # For an overview of the IAM roles and permissions, see the
5438 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
5439 # a list of the available pre-defined roles, see
5440 # [here](https://cloud.google.com/iam/docs/understanding-roles).
5441 },
5442 ],
5443 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
5444 # prevent simultaneous updates of a policy from overwriting each other.
5445 # It is strongly suggested that systems make use of the `etag` in the
5446 # read-modify-write cycle to perform policy updates in order to avoid race
5447 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
5448 # systems are expected to put that etag in the request to `setIamPolicy` to
5449 # ensure that their change will be applied to the same version of the policy.
5450 #
5451 # **Important:** If you use IAM Conditions, you must include the `etag` field
5452 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5453 # you to overwrite a version `3` policy with a version `1` policy, and all of
5454 # the conditions in the version `3` policy are lost.
5455 &quot;version&quot;: 42, # Specifies the format of the policy.
5456 #
5457 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
5458 # are rejected.
5459 #
5460 # Any operation that affects conditional role bindings must specify version
5461 # `3`. This requirement applies to the following operations:
5462 #
5463 # * Getting a policy that includes a conditional role binding
5464 # * Adding a conditional role binding to a policy
5465 # * Changing a conditional role binding in a policy
5466 # * Removing any role binding, with or without a condition, from a policy
5467 # that includes conditions
5468 #
5469 # **Important:** If you use IAM Conditions, you must include the `etag` field
5470 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5471 # you to overwrite a version `3` policy with a version `1` policy, and all of
5472 # the conditions in the version `3` policy are lost.
5473 #
5474 # If a policy does not include any conditions, operations on that policy may
5475 # specify any valid version or leave the field unset.
5476 #
5477 # To learn which resources support conditions in their IAM policies, see the
5478 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5479 },
5480 }
5481
5482 x__xgafv: string, V1 error format.
5483 Allowed values
5484 1 - v1 error format
5485 2 - v2 error format
5486
5487 Returns:
5488 An object of the form:
5489
5490 { # An Identity and Access Management (IAM) policy, which specifies access
5491 # controls for Google Cloud resources.
5492 #
5493 #
5494 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
5495 # `members`, or principals, to a single `role`. Principals can be user
5496 # accounts, service accounts, Google groups, and domains (such as G Suite). A
5497 # `role` is a named list of permissions; each `role` can be an IAM predefined
5498 # role or a user-created custom role.
5499 #
5500 # For some types of Google Cloud resources, a `binding` can also specify a
5501 # `condition`, which is a logical expression that allows access to a resource
5502 # only if the expression evaluates to `true`. A condition can add constraints
5503 # based on attributes of the request, the resource, or both. To learn which
5504 # resources support conditions in their IAM policies, see the
5505 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5506 #
5507 # **JSON example:**
5508 #
5509 # ```
5510 # {
5511 # &quot;bindings&quot;: [
5512 # {
5513 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
5514 # &quot;members&quot;: [
5515 # &quot;user:[email protected]&quot;,
5516 # &quot;group:[email protected]&quot;,
5517 # &quot;domain:google.com&quot;,
5518 # &quot;serviceAccount:[email protected]&quot;
5519 # ]
5520 # },
5521 # {
5522 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
5523 # &quot;members&quot;: [
5524 # &quot;user:[email protected]&quot;
5525 # ],
5526 # &quot;condition&quot;: {
5527 # &quot;title&quot;: &quot;expirable access&quot;,
5528 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
5529 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
5530 # }
5531 # }
5532 # ],
5533 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
5534 # &quot;version&quot;: 3
5535 # }
5536 # ```
5537 #
5538 # **YAML example:**
5539 #
5540 # ```
5541 # bindings:
5542 # - members:
5543 # - user:[email protected]
5544 # - group:[email protected]
5545 # - domain:google.com
5546 # - serviceAccount:[email protected]
5547 # role: roles/resourcemanager.organizationAdmin
5548 # - members:
5549 # - user:[email protected]
5550 # role: roles/resourcemanager.organizationViewer
5551 # condition:
5552 # title: expirable access
5553 # description: Does not grant access after Sep 2020
5554 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
5555 # etag: BwWWja0YfJA=
5556 # version: 3
5557 # ```
5558 #
5559 # For a description of IAM and its features, see the
5560 # [IAM documentation](https://cloud.google.com/iam/docs/).
5561 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
5562 { # Specifies the audit configuration for a service.
5563 # The configuration determines which permission types are logged, and what
5564 # identities, if any, are exempted from logging.
5565 # An AuditConfig must have one or more AuditLogConfigs.
5566 #
5567 # If there are AuditConfigs for both `allServices` and a specific service,
5568 # the union of the two AuditConfigs is used for that service: the log_types
5569 # specified in each AuditConfig are enabled, and the exempted_members in each
5570 # AuditLogConfig are exempted.
5571 #
5572 # Example Policy with multiple AuditConfigs:
5573 #
5574 # {
5575 # &quot;audit_configs&quot;: [
5576 # {
5577 # &quot;service&quot;: &quot;allServices&quot;,
5578 # &quot;audit_log_configs&quot;: [
5579 # {
5580 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5581 # &quot;exempted_members&quot;: [
5582 # &quot;user:[email protected]&quot;
5583 # ]
5584 # },
5585 # {
5586 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5587 # },
5588 # {
5589 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
5590 # }
5591 # ]
5592 # },
5593 # {
5594 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
5595 # &quot;audit_log_configs&quot;: [
5596 # {
5597 # &quot;log_type&quot;: &quot;DATA_READ&quot;
5598 # },
5599 # {
5600 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
5601 # &quot;exempted_members&quot;: [
5602 # &quot;user:[email protected]&quot;
5603 # ]
5604 # }
5605 # ]
5606 # }
5607 # ]
5608 # }
5609 #
5610 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
5611 # logging. It also exempts `[email protected]` from DATA_READ logging, and
5612 # `[email protected]` from DATA_WRITE logging.
5613 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
5614 { # Provides the configuration for logging a type of permissions.
5615 # Example:
5616 #
5617 # {
5618 # &quot;audit_log_configs&quot;: [
5619 # {
5620 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5621 # &quot;exempted_members&quot;: [
5622 # &quot;user:[email protected]&quot;
5623 # ]
5624 # },
5625 # {
5626 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5627 # }
5628 # ]
5629 # }
5630 #
5631 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
5632 # [email protected] from DATA_READ logging.
5633 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
5634 # permission.
5635 # Follows the same format of Binding.members.
5636 &quot;A String&quot;,
5637 ],
5638 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
5639 },
5640 ],
5641 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
5642 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
5643 # `allServices` is a special value that covers all services.
5644 },
5645 ],
5646 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
5647 # may specify a `condition` that determines how and when the `bindings` are
5648 # applied. Each of the `bindings` must contain at least one principal.
5649 #
5650 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
5651 # of these principals can be Google groups. Each occurrence of a principal
5652 # counts towards these limits. For example, if the `bindings` grant 50
5653 # different roles to `user:[email protected]`, and not to any other
5654 # principal, then you can add another 1,450 principals to the `bindings` in
5655 # the `Policy`.
5656 { # Associates `members`, or principals, with a `role`.
5657 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
5658 #
5659 # If the condition evaluates to `true`, then this binding applies to the
5660 # current request.
5661 #
5662 # If the condition evaluates to `false`, then this binding does not apply to
5663 # the current request. However, a different role binding might grant the same
5664 # role to one or more of the principals in this binding.
5665 #
5666 # To learn which resources support conditions in their IAM policies, see the
5667 # [IAM
5668 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5669 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
5670 # are documented at https://github.com/google/cel-spec.
5671 #
5672 # Example (Comparison):
5673 #
5674 # title: &quot;Summary size limit&quot;
5675 # description: &quot;Determines if a summary is less than 100 chars&quot;
5676 # expression: &quot;document.summary.size() &lt; 100&quot;
5677 #
5678 # Example (Equality):
5679 #
5680 # title: &quot;Requestor is owner&quot;
5681 # description: &quot;Determines if requestor is the document owner&quot;
5682 # expression: &quot;document.owner == request.auth.claims.email&quot;
5683 #
5684 # Example (Logic):
5685 #
5686 # title: &quot;Public documents&quot;
5687 # description: &quot;Determine whether the document should be publicly visible&quot;
5688 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
5689 #
5690 # Example (Data Manipulation):
5691 #
5692 # title: &quot;Notification string&quot;
5693 # description: &quot;Create a notification string with a timestamp.&quot;
5694 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
5695 #
5696 # The exact variables and functions that may be referenced within an expression
5697 # are determined by the service that evaluates it. See the service
5698 # documentation for additional information.
5699 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
5700 # describes the expression, e.g. when hovered over it in a UI.
5701 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
5702 # syntax.
5703 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
5704 # reporting, e.g. a file name and a position in the file.
5705 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
5706 # its purpose. This can be used e.g. in UIs which allow to enter the
5707 # expression.
5708 },
5709 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
5710 # `members` can have the following values:
5711 #
5712 # * `allUsers`: A special identifier that represents anyone who is
5713 # on the internet; with or without a Google account.
5714 #
5715 # * `allAuthenticatedUsers`: A special identifier that represents anyone
5716 # who is authenticated with a Google account or a service account.
5717 # Does not include identities that come from external identity providers
5718 # (IdPs) through identity federation.
5719 #
5720 # * `user:{emailid}`: An email address that represents a specific Google
5721 # account. For example, `[email protected]` .
5722 #
5723 #
5724 # * `serviceAccount:{emailid}`: An email address that represents a Google
5725 # service account. For example,
5726 # `[email protected]`.
5727 #
5728 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
5729 # identifier for a
5730 # [Kubernetes service
5731 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
5732 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
5733 #
5734 # * `group:{emailid}`: An email address that represents a Google group.
5735 # For example, `[email protected]`.
5736 #
5737 #
5738 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
5739 # users of that domain. For example, `google.com` or `example.com`.
5740 #
5741 #
5742 #
5743 #
5744 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5745 # A single identity in a workforce identity pool.
5746 #
5747 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
5748 # All workforce identities in a group.
5749 #
5750 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5751 # All workforce identities with a specific attribute value.
5752 #
5753 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
5754 # All identities in a workforce identity pool.
5755 #
5756 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
5757 # A single identity in a workload identity pool.
5758 #
5759 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
5760 # A workload identity pool group.
5761 #
5762 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5763 # All identities in a workload identity pool with a certain attribute.
5764 #
5765 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
5766 # All identities in a workload identity pool.
5767 #
5768 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
5769 # identifier) representing a user that has been recently deleted. For
5770 # example, `[email protected]?uid=123456789012345678901`. If the user is
5771 # recovered, this value reverts to `user:{emailid}` and the recovered user
5772 # retains the role in the binding.
5773 #
5774 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
5775 # unique identifier) representing a service account that has been recently
5776 # deleted. For example,
5777 # `[email protected]?uid=123456789012345678901`.
5778 # If the service account is undeleted, this value reverts to
5779 # `serviceAccount:{emailid}` and the undeleted service account retains the
5780 # role in the binding.
5781 #
5782 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
5783 # identifier) representing a Google group that has been recently
5784 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
5785 # the group is recovered, this value reverts to `group:{emailid}` and the
5786 # recovered group retains the role in the binding.
5787 #
5788 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5789 # Deleted single identity in a workforce identity pool. For example,
5790 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
5791 &quot;A String&quot;,
5792 ],
5793 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
5794 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
5795 #
5796 # For an overview of the IAM roles and permissions, see the
5797 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
5798 # a list of the available pre-defined roles, see
5799 # [here](https://cloud.google.com/iam/docs/understanding-roles).
5800 },
5801 ],
5802 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
5803 # prevent simultaneous updates of a policy from overwriting each other.
5804 # It is strongly suggested that systems make use of the `etag` in the
5805 # read-modify-write cycle to perform policy updates in order to avoid race
5806 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
5807 # systems are expected to put that etag in the request to `setIamPolicy` to
5808 # ensure that their change will be applied to the same version of the policy.
5809 #
5810 # **Important:** If you use IAM Conditions, you must include the `etag` field
5811 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5812 # you to overwrite a version `3` policy with a version `1` policy, and all of
5813 # the conditions in the version `3` policy are lost.
5814 &quot;version&quot;: 42, # Specifies the format of the policy.
5815 #
5816 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
5817 # are rejected.
5818 #
5819 # Any operation that affects conditional role bindings must specify version
5820 # `3`. This requirement applies to the following operations:
5821 #
5822 # * Getting a policy that includes a conditional role binding
5823 # * Adding a conditional role binding to a policy
5824 # * Changing a conditional role binding in a policy
5825 # * Removing any role binding, with or without a condition, from a policy
5826 # that includes conditions
5827 #
5828 # **Important:** If you use IAM Conditions, you must include the `etag` field
5829 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5830 # you to overwrite a version `3` policy with a version `1` policy, and all of
5831 # the conditions in the version `3` policy are lost.
5832 #
5833 # If a policy does not include any conditions, operations on that policy may
5834 # specify any valid version or leave the field unset.
5835 #
5836 # To learn which resources support conditions in their IAM policies, see the
5837 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5838 }</pre>
5839 </div>
5840
5841 <div class="method">
5842 <code class="details" id="setLabels">setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)</code>
5843 <pre>Sets the labels on the target regional disk.
5844
5845 Args:
5846 project: string, Project ID for this request. (required)
5847 region: string, The region for this request. (required)
5848 resource: string, Name or id of the resource for this request. (required)
5849 body: object, The request body.
5850 The object takes the form of:
5851
5852 {
5853 &quot;labelFingerprint&quot;: &quot;A String&quot;, # The fingerprint of the previous set of labels for this resource,
5854 # used to detect conflicts. The fingerprint is initially generated by Compute
5855 # Engine and changes after every request to modify or update labels. You must
5856 # always provide an up-to-date fingerprint hash in order to update or change
5857 # labels. Make a get() request to the resource to get the latest
5858 # fingerprint.
5859 &quot;labels&quot;: { # The labels to set for this resource.
5860 &quot;a_key&quot;: &quot;A String&quot;,
5861 },
5862 }
5863
5864 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
5865 that if you must retry your request, the server will know to ignore the
5866 request if it has already been completed.
5867
5868 For example, consider a situation where you make an initial request and
5869 the request times out. If you make the request again with the same
5870 request ID, the server can check if original operation with the same
5871 request ID was received, and if so, will ignore the second request. This
5872 prevents clients from accidentally creating duplicate commitments.
5873
5874 The request ID must be
5875 a valid UUID with the exception that zero UUID is not supported
5876 (00000000-0000-0000-0000-000000000000).
5877 x__xgafv: string, V1 error format.
5878 Allowed values
5879 1 - v1 error format
5880 2 - v2 error format
5881
5882 Returns:
5883 An object of the form:
5884
5885 { # Represents an Operation resource.
5886 #
5887 # Google Compute Engine has three Operation resources:
5888 #
5889 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
5890 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
5891 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
5892 #
5893 # You can use an operation resource to manage asynchronous API requests.
5894 # For more information, readHandling
5895 # API responses.
5896 #
5897 # Operations can be global, regional or zonal.
5898 #
5899 # - For global operations, use the `globalOperations`
5900 # resource.
5901 # - For regional operations, use the
5902 # `regionOperations` resource.
5903 # - For zonal operations, use
5904 # the `zoneOperations` resource.
5905 #
5906 #
5907 #
5908 # For more information, read
5909 # Global, Regional, and Zonal Resources.
5910 #
5911 # Note that completed Operation resources have a limited
5912 # retention period.
5913 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
5914 # Not present otherwise.
5915 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
5916 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
5917 # set when the operation is created.
5918 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
5919 # text format.
5920 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
5921 # this field will be populated.
5922 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
5923 # operation.
5924 {
5925 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
5926 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
5927 # details. There is a set of defined message types to use for providing
5928 # details.The syntax depends on the error code. For example,
5929 # QuotaExceededInfo will have details when the error code is
5930 # QUOTA_EXCEEDED.
5931 {
5932 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
5933 #
5934 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
5935 # is not enabled:
5936 #
5937 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
5938 # &quot;domain&quot;: &quot;googleapis.com&quot;
5939 # &quot;metadata&quot;: {
5940 # &quot;resource&quot;: &quot;projects/123&quot;,
5941 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
5942 # }
5943 # }
5944 #
5945 # This response indicates that the pubsub.googleapis.com API is not enabled.
5946 #
5947 # Example of an error that is returned when attempting to create a Spanner
5948 # instance in a region that is out of stock:
5949 #
5950 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
5951 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
5952 # &quot;metadata&quot;: {
5953 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
5954 # }
5955 # }
5956 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
5957 # is typically the registered service name of the tool or product that
5958 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
5959 # generated by some common infrastructure, the error domain must be a
5960 # globally unique value that identifies the infrastructure. For Google API
5961 # infrastructure, the error domain is &quot;googleapis.com&quot;.
5962 &quot;metadatas&quot;: { # Additional structured details about this error.
5963 #
5964 # Keys must match a regular expression of `a-z+` but should
5965 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
5966 # length. When identifying the current value of an exceeded limit, the units
5967 # should be contained in the key, not the value. For example, rather than
5968 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
5969 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
5970 # instances that can be created in a single (batch) request.
5971 &quot;a_key&quot;: &quot;A String&quot;,
5972 },
5973 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
5974 # proximate cause of the error. Error reasons are unique within a particular
5975 # domain of errors. This should be at most 63 characters and match a
5976 # regular expression of `A-Z+[A-Z0-9]`, which represents
5977 # UPPER_SNAKE_CASE.
5978 },
5979 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
5980 #
5981 # For example, if a quota check failed with an error indicating the calling
5982 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
5983 # directly to the right place in the developer console to flip the bit.
5984 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
5985 { # Describes a URL link.
5986 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
5987 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
5988 },
5989 ],
5990 },
5991 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
5992 # which can be attached to an RPC error.
5993 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
5994 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
5995 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
5996 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
5997 },
5998 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
5999 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6000 &quot;a_key&quot;: &quot;A String&quot;,
6001 },
6002 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6003 # type or metric.
6004 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6005 # or metric.
6006 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6007 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6008 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6009 },
6010 },
6011 ],
6012 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6013 # This property is optional.
6014 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6015 },
6016 ],
6017 },
6018 &quot;getVersionOperationMetadata&quot;: {
6019 &quot;inlineSbomInfo&quot;: {
6020 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6021 # appropriate identifiers.
6022 &quot;a_key&quot;: &quot;A String&quot;,
6023 },
6024 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6025 # identifiers.
6026 &quot;a_key&quot;: &quot;A String&quot;,
6027 },
6028 },
6029 },
6030 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6031 # message that was returned, such as `NOT FOUND`.
6032 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6033 # status code that was returned. For example, a `404` means the
6034 # resource was not found.
6035 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6036 # defined by the server.
6037 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6038 # This value is inRFC3339
6039 # text format.
6040 &quot;instancesBulkInsertOperationMetadata&quot;: {
6041 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6042 # Example key: zones/us-central1-a
6043 &quot;a_key&quot;: {
6044 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6045 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6046 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6047 # error.
6048 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6049 # if the flow is rolling forward or rolling back.
6050 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6051 },
6052 },
6053 },
6054 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6055 # Operation resources.
6056 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6057 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6058 # group of operations results from a `bulkInsert` API request.
6059 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6060 # `update`, or `delete`, and so on.
6061 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6062 # There is no requirement that this be linear or support any granularity of
6063 # operations. This should not be used to guess when the operation will be
6064 # complete. This number should monotonically increase as the operation
6065 # progresses.
6066 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6067 # applicable when performing regional operations.
6068 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6069 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6070 # this field will contain information on all underlying zonal actions and
6071 # their state.
6072 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6073 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6074 # Example key: zones/us-central1-a
6075 &quot;a_key&quot;: {
6076 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
6077 # populated.
6078 # different programming environments, including REST APIs and RPC APIs. It is
6079 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6080 # three pieces of data: error code, error message, and error details.
6081 #
6082 # You can find out more about this error model and how to work with it in the
6083 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6084 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6085 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6086 # message types for APIs to use.
6087 {
6088 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6089 },
6090 ],
6091 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6092 # user-facing error message should be localized and sent in the
6093 # google.rpc.Status.details field, or localized by the client.
6094 },
6095 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6096 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6097 },
6098 },
6099 },
6100 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6101 # This value is inRFC3339
6102 # text format.
6103 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6104 # following:
6105 # `PENDING`, `RUNNING`, or `DONE`.
6106 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6107 # operation.
6108 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6109 # of the target resource.
6110 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6111 # operations related to creating a snapshot, this points to the disk
6112 # that the snapshot was created from.
6113 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6114 # `[email protected]` or
6115 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6116 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6117 # operation, this field will be populated.
6118 {
6119 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6120 # Engine returns NO_RESULTS_ON_PAGE if there
6121 # are no results in the response.
6122 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6123 # value format. For example:
6124 #
6125 # &quot;data&quot;: [
6126 # {
6127 # &quot;key&quot;: &quot;scope&quot;,
6128 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6129 # }
6130 {
6131 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6132 # returned. For example, for warnings where there are no results in a list
6133 # request for a particular zone, this key might be scope and
6134 # the key value might be the zone name. Other examples might be a key
6135 # indicating a deprecated resource and a suggested replacement, or a
6136 # warning about invalid network settings (for example, if an instance
6137 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6138 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6139 },
6140 ],
6141 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6142 },
6143 ],
6144 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6145 # applicable when performing per-zone operations.
6146 }</pre>
6147 </div>
6148
6149 <div class="method">
6150 <code class="details" id="startAsyncReplication">startAsyncReplication(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
6151 <pre>Starts asynchronous replication.
6152 Must be invoked on the primary disk.
6153
6154 Args:
6155 project: string, Project ID for this request. (required)
6156 region: string, The name of the region for this request. (required)
6157 disk: string, The name of the persistent disk. (required)
6158 body: object, The request body.
6159 The object takes the form of:
6160
6161 {
6162 &quot;asyncSecondaryDisk&quot;: &quot;A String&quot;, # The secondary disk to start asynchronous replication to.
6163 # You can provide this as a partial or full URL to the resource. For example,
6164 # the following are valid values:
6165 #
6166 #
6167 # -
6168 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
6169 #
6170 # -
6171 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
6172 #
6173 # -
6174 # projects/project/zones/zone/disks/disk
6175 #
6176 # -
6177 # projects/project/regions/region/disks/disk
6178 #
6179 # -
6180 # zones/zone/disks/disk
6181 #
6182 # -
6183 # regions/region/disks/disk
6184 }
6185
6186 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6187 that if you must retry your request, the server will know to ignore the
6188 request if it has already been completed.
6189
6190 For example, consider a situation where you make an initial request and
6191 the request times out. If you make the request again with the same
6192 request ID, the server can check if original operation with the same
6193 request ID was received, and if so, will ignore the second request. This
6194 prevents clients from accidentally creating duplicate commitments.
6195
6196 The request ID must be
6197 a valid UUID with the exception that zero UUID is not supported
6198 (00000000-0000-0000-0000-000000000000).
6199 x__xgafv: string, V1 error format.
6200 Allowed values
6201 1 - v1 error format
6202 2 - v2 error format
6203
6204 Returns:
6205 An object of the form:
6206
6207 { # Represents an Operation resource.
6208 #
6209 # Google Compute Engine has three Operation resources:
6210 #
6211 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
6212 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
6213 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
6214 #
6215 # You can use an operation resource to manage asynchronous API requests.
6216 # For more information, readHandling
6217 # API responses.
6218 #
6219 # Operations can be global, regional or zonal.
6220 #
6221 # - For global operations, use the `globalOperations`
6222 # resource.
6223 # - For regional operations, use the
6224 # `regionOperations` resource.
6225 # - For zonal operations, use
6226 # the `zoneOperations` resource.
6227 #
6228 #
6229 #
6230 # For more information, read
6231 # Global, Regional, and Zonal Resources.
6232 #
6233 # Note that completed Operation resources have a limited
6234 # retention period.
6235 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6236 # Not present otherwise.
6237 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6238 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6239 # set when the operation is created.
6240 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6241 # text format.
6242 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6243 # this field will be populated.
6244 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6245 # operation.
6246 {
6247 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6248 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6249 # details. There is a set of defined message types to use for providing
6250 # details.The syntax depends on the error code. For example,
6251 # QuotaExceededInfo will have details when the error code is
6252 # QUOTA_EXCEEDED.
6253 {
6254 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6255 #
6256 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6257 # is not enabled:
6258 #
6259 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6260 # &quot;domain&quot;: &quot;googleapis.com&quot;
6261 # &quot;metadata&quot;: {
6262 # &quot;resource&quot;: &quot;projects/123&quot;,
6263 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6264 # }
6265 # }
6266 #
6267 # This response indicates that the pubsub.googleapis.com API is not enabled.
6268 #
6269 # Example of an error that is returned when attempting to create a Spanner
6270 # instance in a region that is out of stock:
6271 #
6272 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6273 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6274 # &quot;metadata&quot;: {
6275 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6276 # }
6277 # }
6278 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6279 # is typically the registered service name of the tool or product that
6280 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6281 # generated by some common infrastructure, the error domain must be a
6282 # globally unique value that identifies the infrastructure. For Google API
6283 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6284 &quot;metadatas&quot;: { # Additional structured details about this error.
6285 #
6286 # Keys must match a regular expression of `a-z+` but should
6287 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6288 # length. When identifying the current value of an exceeded limit, the units
6289 # should be contained in the key, not the value. For example, rather than
6290 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6291 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6292 # instances that can be created in a single (batch) request.
6293 &quot;a_key&quot;: &quot;A String&quot;,
6294 },
6295 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6296 # proximate cause of the error. Error reasons are unique within a particular
6297 # domain of errors. This should be at most 63 characters and match a
6298 # regular expression of `A-Z+[A-Z0-9]`, which represents
6299 # UPPER_SNAKE_CASE.
6300 },
6301 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6302 #
6303 # For example, if a quota check failed with an error indicating the calling
6304 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6305 # directly to the right place in the developer console to flip the bit.
6306 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6307 { # Describes a URL link.
6308 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6309 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6310 },
6311 ],
6312 },
6313 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6314 # which can be attached to an RPC error.
6315 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6316 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6317 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6318 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6319 },
6320 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6321 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6322 &quot;a_key&quot;: &quot;A String&quot;,
6323 },
6324 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6325 # type or metric.
6326 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6327 # or metric.
6328 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6329 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6330 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6331 },
6332 },
6333 ],
6334 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6335 # This property is optional.
6336 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6337 },
6338 ],
6339 },
6340 &quot;getVersionOperationMetadata&quot;: {
6341 &quot;inlineSbomInfo&quot;: {
6342 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6343 # appropriate identifiers.
6344 &quot;a_key&quot;: &quot;A String&quot;,
6345 },
6346 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6347 # identifiers.
6348 &quot;a_key&quot;: &quot;A String&quot;,
6349 },
6350 },
6351 },
6352 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6353 # message that was returned, such as `NOT FOUND`.
6354 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6355 # status code that was returned. For example, a `404` means the
6356 # resource was not found.
6357 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6358 # defined by the server.
6359 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6360 # This value is inRFC3339
6361 # text format.
6362 &quot;instancesBulkInsertOperationMetadata&quot;: {
6363 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6364 # Example key: zones/us-central1-a
6365 &quot;a_key&quot;: {
6366 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6367 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6368 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6369 # error.
6370 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6371 # if the flow is rolling forward or rolling back.
6372 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6373 },
6374 },
6375 },
6376 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6377 # Operation resources.
6378 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6379 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6380 # group of operations results from a `bulkInsert` API request.
6381 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6382 # `update`, or `delete`, and so on.
6383 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6384 # There is no requirement that this be linear or support any granularity of
6385 # operations. This should not be used to guess when the operation will be
6386 # complete. This number should monotonically increase as the operation
6387 # progresses.
6388 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6389 # applicable when performing regional operations.
6390 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6391 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6392 # this field will contain information on all underlying zonal actions and
6393 # their state.
6394 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6395 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6396 # Example key: zones/us-central1-a
6397 &quot;a_key&quot;: {
6398 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
6399 # populated.
6400 # different programming environments, including REST APIs and RPC APIs. It is
6401 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6402 # three pieces of data: error code, error message, and error details.
6403 #
6404 # You can find out more about this error model and how to work with it in the
6405 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6406 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6407 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6408 # message types for APIs to use.
6409 {
6410 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6411 },
6412 ],
6413 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6414 # user-facing error message should be localized and sent in the
6415 # google.rpc.Status.details field, or localized by the client.
6416 },
6417 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6418 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6419 },
6420 },
6421 },
6422 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6423 # This value is inRFC3339
6424 # text format.
6425 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6426 # following:
6427 # `PENDING`, `RUNNING`, or `DONE`.
6428 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6429 # operation.
6430 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6431 # of the target resource.
6432 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6433 # operations related to creating a snapshot, this points to the disk
6434 # that the snapshot was created from.
6435 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6436 # `[email protected]` or
6437 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6438 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6439 # operation, this field will be populated.
6440 {
6441 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6442 # Engine returns NO_RESULTS_ON_PAGE if there
6443 # are no results in the response.
6444 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6445 # value format. For example:
6446 #
6447 # &quot;data&quot;: [
6448 # {
6449 # &quot;key&quot;: &quot;scope&quot;,
6450 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6451 # }
6452 {
6453 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6454 # returned. For example, for warnings where there are no results in a list
6455 # request for a particular zone, this key might be scope and
6456 # the key value might be the zone name. Other examples might be a key
6457 # indicating a deprecated resource and a suggested replacement, or a
6458 # warning about invalid network settings (for example, if an instance
6459 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6460 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6461 },
6462 ],
6463 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6464 },
6465 ],
6466 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6467 # applicable when performing per-zone operations.
6468 }</pre>
6469 </div>
6470
6471 <div class="method">
6472 <code class="details" id="stopAsyncReplication">stopAsyncReplication(project, region, disk, requestId=None, x__xgafv=None)</code>
6473 <pre>Stops asynchronous replication.
6474 Can be invoked either on the primary or on the secondary disk.
6475
6476 Args:
6477 project: string, Project ID for this request. (required)
6478 region: string, The name of the region for this request. (required)
6479 disk: string, The name of the persistent disk. (required)
6480 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6481 that if you must retry your request, the server will know to ignore the
6482 request if it has already been completed.
6483
6484 For example, consider a situation where you make an initial request and
6485 the request times out. If you make the request again with the same
6486 request ID, the server can check if original operation with the same
6487 request ID was received, and if so, will ignore the second request. This
6488 prevents clients from accidentally creating duplicate commitments.
6489
6490 The request ID must be
6491 a valid UUID with the exception that zero UUID is not supported
6492 (00000000-0000-0000-0000-000000000000).
6493 x__xgafv: string, V1 error format.
6494 Allowed values
6495 1 - v1 error format
6496 2 - v2 error format
6497
6498 Returns:
6499 An object of the form:
6500
6501 { # Represents an Operation resource.
6502 #
6503 # Google Compute Engine has three Operation resources:
6504 #
6505 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
6506 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
6507 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
6508 #
6509 # You can use an operation resource to manage asynchronous API requests.
6510 # For more information, readHandling
6511 # API responses.
6512 #
6513 # Operations can be global, regional or zonal.
6514 #
6515 # - For global operations, use the `globalOperations`
6516 # resource.
6517 # - For regional operations, use the
6518 # `regionOperations` resource.
6519 # - For zonal operations, use
6520 # the `zoneOperations` resource.
6521 #
6522 #
6523 #
6524 # For more information, read
6525 # Global, Regional, and Zonal Resources.
6526 #
6527 # Note that completed Operation resources have a limited
6528 # retention period.
6529 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6530 # Not present otherwise.
6531 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6532 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6533 # set when the operation is created.
6534 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6535 # text format.
6536 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6537 # this field will be populated.
6538 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6539 # operation.
6540 {
6541 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6542 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6543 # details. There is a set of defined message types to use for providing
6544 # details.The syntax depends on the error code. For example,
6545 # QuotaExceededInfo will have details when the error code is
6546 # QUOTA_EXCEEDED.
6547 {
6548 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6549 #
6550 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6551 # is not enabled:
6552 #
6553 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6554 # &quot;domain&quot;: &quot;googleapis.com&quot;
6555 # &quot;metadata&quot;: {
6556 # &quot;resource&quot;: &quot;projects/123&quot;,
6557 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6558 # }
6559 # }
6560 #
6561 # This response indicates that the pubsub.googleapis.com API is not enabled.
6562 #
6563 # Example of an error that is returned when attempting to create a Spanner
6564 # instance in a region that is out of stock:
6565 #
6566 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6567 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6568 # &quot;metadata&quot;: {
6569 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6570 # }
6571 # }
6572 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6573 # is typically the registered service name of the tool or product that
6574 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6575 # generated by some common infrastructure, the error domain must be a
6576 # globally unique value that identifies the infrastructure. For Google API
6577 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6578 &quot;metadatas&quot;: { # Additional structured details about this error.
6579 #
6580 # Keys must match a regular expression of `a-z+` but should
6581 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6582 # length. When identifying the current value of an exceeded limit, the units
6583 # should be contained in the key, not the value. For example, rather than
6584 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6585 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6586 # instances that can be created in a single (batch) request.
6587 &quot;a_key&quot;: &quot;A String&quot;,
6588 },
6589 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6590 # proximate cause of the error. Error reasons are unique within a particular
6591 # domain of errors. This should be at most 63 characters and match a
6592 # regular expression of `A-Z+[A-Z0-9]`, which represents
6593 # UPPER_SNAKE_CASE.
6594 },
6595 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6596 #
6597 # For example, if a quota check failed with an error indicating the calling
6598 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6599 # directly to the right place in the developer console to flip the bit.
6600 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6601 { # Describes a URL link.
6602 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6603 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6604 },
6605 ],
6606 },
6607 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6608 # which can be attached to an RPC error.
6609 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6610 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6611 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6612 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6613 },
6614 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6615 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6616 &quot;a_key&quot;: &quot;A String&quot;,
6617 },
6618 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6619 # type or metric.
6620 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6621 # or metric.
6622 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6623 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6624 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6625 },
6626 },
6627 ],
6628 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6629 # This property is optional.
6630 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6631 },
6632 ],
6633 },
6634 &quot;getVersionOperationMetadata&quot;: {
6635 &quot;inlineSbomInfo&quot;: {
6636 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6637 # appropriate identifiers.
6638 &quot;a_key&quot;: &quot;A String&quot;,
6639 },
6640 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6641 # identifiers.
6642 &quot;a_key&quot;: &quot;A String&quot;,
6643 },
6644 },
6645 },
6646 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6647 # message that was returned, such as `NOT FOUND`.
6648 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6649 # status code that was returned. For example, a `404` means the
6650 # resource was not found.
6651 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6652 # defined by the server.
6653 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6654 # This value is inRFC3339
6655 # text format.
6656 &quot;instancesBulkInsertOperationMetadata&quot;: {
6657 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6658 # Example key: zones/us-central1-a
6659 &quot;a_key&quot;: {
6660 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6661 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6662 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6663 # error.
6664 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6665 # if the flow is rolling forward or rolling back.
6666 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6667 },
6668 },
6669 },
6670 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6671 # Operation resources.
6672 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6673 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6674 # group of operations results from a `bulkInsert` API request.
6675 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6676 # `update`, or `delete`, and so on.
6677 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6678 # There is no requirement that this be linear or support any granularity of
6679 # operations. This should not be used to guess when the operation will be
6680 # complete. This number should monotonically increase as the operation
6681 # progresses.
6682 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6683 # applicable when performing regional operations.
6684 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6685 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6686 # this field will contain information on all underlying zonal actions and
6687 # their state.
6688 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6689 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6690 # Example key: zones/us-central1-a
6691 &quot;a_key&quot;: {
6692 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
6693 # populated.
6694 # different programming environments, including REST APIs and RPC APIs. It is
6695 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6696 # three pieces of data: error code, error message, and error details.
6697 #
6698 # You can find out more about this error model and how to work with it in the
6699 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6700 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6701 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6702 # message types for APIs to use.
6703 {
6704 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6705 },
6706 ],
6707 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6708 # user-facing error message should be localized and sent in the
6709 # google.rpc.Status.details field, or localized by the client.
6710 },
6711 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6712 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6713 },
6714 },
6715 },
6716 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6717 # This value is inRFC3339
6718 # text format.
6719 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6720 # following:
6721 # `PENDING`, `RUNNING`, or `DONE`.
6722 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6723 # operation.
6724 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6725 # of the target resource.
6726 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6727 # operations related to creating a snapshot, this points to the disk
6728 # that the snapshot was created from.
6729 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6730 # `[email protected]` or
6731 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6732 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6733 # operation, this field will be populated.
6734 {
6735 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6736 # Engine returns NO_RESULTS_ON_PAGE if there
6737 # are no results in the response.
6738 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6739 # value format. For example:
6740 #
6741 # &quot;data&quot;: [
6742 # {
6743 # &quot;key&quot;: &quot;scope&quot;,
6744 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6745 # }
6746 {
6747 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6748 # returned. For example, for warnings where there are no results in a list
6749 # request for a particular zone, this key might be scope and
6750 # the key value might be the zone name. Other examples might be a key
6751 # indicating a deprecated resource and a suggested replacement, or a
6752 # warning about invalid network settings (for example, if an instance
6753 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6754 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6755 },
6756 ],
6757 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6758 },
6759 ],
6760 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6761 # applicable when performing per-zone operations.
6762 }</pre>
6763 </div>
6764
6765 <div class="method">
6766 <code class="details" id="stopGroupAsyncReplication">stopGroupAsyncReplication(project, region, body=None, requestId=None, x__xgafv=None)</code>
6767 <pre>Stops asynchronous replication for a consistency group of disks.
6768 Can be invoked either in the primary or secondary scope.
6769
6770 Args:
6771 project: string, Project ID for this request. (required)
6772 region: string, The name of the region for this request. This must be the region of the
6773 primary or secondary disks in the consistency group. (required)
6774 body: object, The request body.
6775 The object takes the form of:
6776
6777 { # A transient resource used in compute.disks.stopGroupAsyncReplication and
6778 # compute.regionDisks.stopGroupAsyncReplication. It is only used to process
6779 # requests and is not persisted.
6780 &quot;resourcePolicy&quot;: &quot;A String&quot;, # The URL of the DiskConsistencyGroupPolicy for the group of disks to stop.
6781 # This may be a full or partial URL, such as:
6782 #
6783 #
6784 # -
6785 # https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
6786 #
6787 # -
6788 # projects/project/regions/region/resourcePolicies/resourcePolicy
6789 #
6790 # -
6791 # regions/region/resourcePolicies/resourcePolicy
6792 }
6793
6794 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6795 that if you must retry your request, the server will know to ignore the
6796 request if it has already been completed.
6797
6798 For example, consider a situation where you make an initial request and
6799 the request times out. If you make the request again with the same
6800 request ID, the server can check if original operation with the same
6801 request ID was received, and if so, will ignore the second request. This
6802 prevents clients from accidentally creating duplicate commitments.
6803
6804 The request ID must be
6805 a valid UUID with the exception that zero UUID is not supported
6806 (00000000-0000-0000-0000-000000000000).
6807 x__xgafv: string, V1 error format.
6808 Allowed values
6809 1 - v1 error format
6810 2 - v2 error format
6811
6812 Returns:
6813 An object of the form:
6814
6815 { # Represents an Operation resource.
6816 #
6817 # Google Compute Engine has three Operation resources:
6818 #
6819 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
6820 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
6821 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
6822 #
6823 # You can use an operation resource to manage asynchronous API requests.
6824 # For more information, readHandling
6825 # API responses.
6826 #
6827 # Operations can be global, regional or zonal.
6828 #
6829 # - For global operations, use the `globalOperations`
6830 # resource.
6831 # - For regional operations, use the
6832 # `regionOperations` resource.
6833 # - For zonal operations, use
6834 # the `zoneOperations` resource.
6835 #
6836 #
6837 #
6838 # For more information, read
6839 # Global, Regional, and Zonal Resources.
6840 #
6841 # Note that completed Operation resources have a limited
6842 # retention period.
6843 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6844 # Not present otherwise.
6845 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6846 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6847 # set when the operation is created.
6848 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6849 # text format.
6850 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6851 # this field will be populated.
6852 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6853 # operation.
6854 {
6855 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6856 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6857 # details. There is a set of defined message types to use for providing
6858 # details.The syntax depends on the error code. For example,
6859 # QuotaExceededInfo will have details when the error code is
6860 # QUOTA_EXCEEDED.
6861 {
6862 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6863 #
6864 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6865 # is not enabled:
6866 #
6867 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6868 # &quot;domain&quot;: &quot;googleapis.com&quot;
6869 # &quot;metadata&quot;: {
6870 # &quot;resource&quot;: &quot;projects/123&quot;,
6871 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6872 # }
6873 # }
6874 #
6875 # This response indicates that the pubsub.googleapis.com API is not enabled.
6876 #
6877 # Example of an error that is returned when attempting to create a Spanner
6878 # instance in a region that is out of stock:
6879 #
6880 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6881 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6882 # &quot;metadata&quot;: {
6883 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6884 # }
6885 # }
6886 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6887 # is typically the registered service name of the tool or product that
6888 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6889 # generated by some common infrastructure, the error domain must be a
6890 # globally unique value that identifies the infrastructure. For Google API
6891 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6892 &quot;metadatas&quot;: { # Additional structured details about this error.
6893 #
6894 # Keys must match a regular expression of `a-z+` but should
6895 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6896 # length. When identifying the current value of an exceeded limit, the units
6897 # should be contained in the key, not the value. For example, rather than
6898 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6899 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6900 # instances that can be created in a single (batch) request.
6901 &quot;a_key&quot;: &quot;A String&quot;,
6902 },
6903 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6904 # proximate cause of the error. Error reasons are unique within a particular
6905 # domain of errors. This should be at most 63 characters and match a
6906 # regular expression of `A-Z+[A-Z0-9]`, which represents
6907 # UPPER_SNAKE_CASE.
6908 },
6909 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6910 #
6911 # For example, if a quota check failed with an error indicating the calling
6912 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6913 # directly to the right place in the developer console to flip the bit.
6914 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6915 { # Describes a URL link.
6916 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6917 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6918 },
6919 ],
6920 },
6921 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6922 # which can be attached to an RPC error.
6923 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6924 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6925 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6926 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6927 },
6928 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6929 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6930 &quot;a_key&quot;: &quot;A String&quot;,
6931 },
6932 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6933 # type or metric.
6934 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6935 # or metric.
6936 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6937 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6938 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6939 },
6940 },
6941 ],
6942 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6943 # This property is optional.
6944 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6945 },
6946 ],
6947 },
6948 &quot;getVersionOperationMetadata&quot;: {
6949 &quot;inlineSbomInfo&quot;: {
6950 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6951 # appropriate identifiers.
6952 &quot;a_key&quot;: &quot;A String&quot;,
6953 },
6954 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6955 # identifiers.
6956 &quot;a_key&quot;: &quot;A String&quot;,
6957 },
6958 },
6959 },
6960 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6961 # message that was returned, such as `NOT FOUND`.
6962 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6963 # status code that was returned. For example, a `404` means the
6964 # resource was not found.
6965 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6966 # defined by the server.
6967 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6968 # This value is inRFC3339
6969 # text format.
6970 &quot;instancesBulkInsertOperationMetadata&quot;: {
6971 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6972 # Example key: zones/us-central1-a
6973 &quot;a_key&quot;: {
6974 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6975 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6976 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6977 # error.
6978 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6979 # if the flow is rolling forward or rolling back.
6980 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6981 },
6982 },
6983 },
6984 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6985 # Operation resources.
6986 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6987 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6988 # group of operations results from a `bulkInsert` API request.
6989 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6990 # `update`, or `delete`, and so on.
6991 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6992 # There is no requirement that this be linear or support any granularity of
6993 # operations. This should not be used to guess when the operation will be
6994 # complete. This number should monotonically increase as the operation
6995 # progresses.
6996 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6997 # applicable when performing regional operations.
6998 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6999 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
7000 # this field will contain information on all underlying zonal actions and
7001 # their state.
7002 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
7003 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
7004 # Example key: zones/us-central1-a
7005 &quot;a_key&quot;: {
7006 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
7007 # populated.
7008 # different programming environments, including REST APIs and RPC APIs. It is
7009 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
7010 # three pieces of data: error code, error message, and error details.
7011 #
7012 # You can find out more about this error model and how to work with it in the
7013 # [API Design Guide](https://cloud.google.com/apis/design/errors).
7014 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
7015 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
7016 # message types for APIs to use.
7017 {
7018 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
7019 },
7020 ],
7021 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
7022 # user-facing error message should be localized and sent in the
7023 # google.rpc.Status.details field, or localized by the client.
7024 },
7025 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
7026 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
7027 },
7028 },
7029 },
7030 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
7031 # This value is inRFC3339
7032 # text format.
7033 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
7034 # following:
7035 # `PENDING`, `RUNNING`, or `DONE`.
7036 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
7037 # operation.
7038 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
7039 # of the target resource.
7040 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
7041 # operations related to creating a snapshot, this points to the disk
7042 # that the snapshot was created from.
7043 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
7044 # `[email protected]` or
7045 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
7046 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
7047 # operation, this field will be populated.
7048 {
7049 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
7050 # Engine returns NO_RESULTS_ON_PAGE if there
7051 # are no results in the response.
7052 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
7053 # value format. For example:
7054 #
7055 # &quot;data&quot;: [
7056 # {
7057 # &quot;key&quot;: &quot;scope&quot;,
7058 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
7059 # }
7060 {
7061 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
7062 # returned. For example, for warnings where there are no results in a list
7063 # request for a particular zone, this key might be scope and
7064 # the key value might be the zone name. Other examples might be a key
7065 # indicating a deprecated resource and a suggested replacement, or a
7066 # warning about invalid network settings (for example, if an instance
7067 # attempts to perform IP forwarding but is not enabled for IP forwarding).
7068 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
7069 },
7070 ],
7071 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
7072 },
7073 ],
7074 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
7075 # applicable when performing per-zone operations.
7076 }</pre>
7077 </div>
7078
7079 <div class="method">
7080 <code class="details" id="testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</code>
7081 <pre>Returns permissions that a caller has on the specified resource.
7082
7083 Args:
7084 project: string, Project ID for this request. (required)
7085 region: string, The name of the region for this request. (required)
7086 resource: string, Name or id of the resource for this request. (required)
7087 body: object, The request body.
7088 The object takes the form of:
7089
7090 {
7091 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
7092 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
7093 &quot;A String&quot;,
7094 ],
7095 }
7096
7097 x__xgafv: string, V1 error format.
7098 Allowed values
7099 1 - v1 error format
7100 2 - v2 error format
7101
7102 Returns:
7103 An object of the form:
7104
7105 {
7106 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
7107 # allowed.
7108 &quot;A String&quot;,
7109 ],
7110 }</pre>
7111 </div>
7112
7113 <div class="method">
7114 <code class="details" id="update">update(project, region, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)</code>
7115 <pre>Update the specified disk with the data included in the request. Update is
7116 performed only on selected fields included as part of update-mask.
7117
7118 Args:
7119 project: string, Project ID for this request. (required)
7120 region: string, The name of the region for this request. (required)
7121 disk: string, The disk name for this request. (required)
7122 body: object, The request body.
7123 The object takes the form of:
7124
7125 { # Represents a Persistent Disk resource.
7126 #
7127 # Google Compute Engine has two Disk resources:
7128 #
7129 # * [Zonal](/compute/docs/reference/rest/beta/disks)
7130 # * [Regional](/compute/docs/reference/rest/beta/regionDisks)
7131 #
7132 # Persistent disks are required for running your VM instances.
7133 # Create both boot and non-boot (data) persistent disks. For more information,
7134 # read Persistent Disks. For more
7135 # storage options, read Storage options.
7136 #
7137 # The disks resource represents a zonal persistent disk.
7138 # For more information, readZonal persistent disks.
7139 #
7140 # The regionDisks resource represents a
7141 # regional persistent disk. For more information, read
7142 # Regional resources.
7143 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
7144 #
7145 #
7146 # - READ_WRITE_SINGLE: The default AccessMode, means the
7147 # disk can be attached to single instance in RW mode.
7148 # - READ_WRITE_MANY: The AccessMode means the disk can be
7149 # attached to multiple instances in RW mode.
7150 # - READ_ONLY_MANY: The AccessMode means the disk can be
7151 # attached to multiple instances in RO mode.
7152 #
7153 #
7154 # The AccessMode is only valid for Hyperdisk disk types.
7155 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
7156 # ARM64 or X86_64.
7157 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
7158 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
7159 # started on the disk as a member of a group.
7160 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
7161 # started on the disk as a member of a group.
7162 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
7163 # You can provide this as a partial or full URL to the resource.
7164 # For example, the following are valid values:
7165 #
7166 #
7167 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
7168 # - projects/project/zones/zone/disks/disk
7169 # - zones/zone/disks/disk
7170 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
7171 # to or from the current disk. This value identifies the exact disk that
7172 # was used to create this replication. For example, if you started
7173 # replicating the persistent disk from a disk that was later deleted and
7174 # recreated under the same name, the disk ID would identify the exact
7175 # version of the disk that was used.
7176 },
7177 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
7178 &quot;a_key&quot;: {
7179 &quot;asyncReplicationDisk&quot;: {
7180 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
7181 # started on the disk as a member of a group.
7182 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
7183 # started on the disk as a member of a group.
7184 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
7185 # You can provide this as a partial or full URL to the resource.
7186 # For example, the following are valid values:
7187 #
7188 #
7189 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
7190 # - projects/project/zones/zone/disks/disk
7191 # - zones/zone/disks/disk
7192 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
7193 # to or from the current disk. This value identifies the exact disk that
7194 # was used to create this replication. For example, if you started
7195 # replicating the persistent disk from a disk that was later deleted and
7196 # recreated under the same name, the disk ID would identify the exact
7197 # version of the disk that was used.
7198 },
7199 },
7200 },
7201 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
7202 # text format.
7203 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
7204 # create the resource.
7205 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
7206 # customer-supplied encryption key or a
7207 # customer-managed encryption key.
7208 #
7209 # Encryption keys do not protect access to metadata of the disk.
7210 #
7211 # After you encrypt a disk with a customer-supplied key, you must provide the
7212 # same key if you use the disk later. For example, to create a disk snapshot,
7213 # to create a disk image, to create a machine image, or to attach the disk to
7214 # a virtual machine.
7215 #
7216 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
7217 # name once the disk is created. The disk is encrypted with this version of
7218 # the key. In the response, diskEncryptionKey.kmsKeyName appears
7219 # in the following format:
7220 #
7221 # &quot;diskEncryptionKey.kmsKeyName&quot;:
7222 # &quot;projects/kms_project_id/locations/region/keyRings/
7223 # key_region/cryptoKeys/key
7224 # /cryptoKeysVersions/version
7225 #
7226 # If you do not provide an encryption key when creating the disk, then the
7227 # disk is encrypted using an automatically generated key and you don&#x27;t need
7228 # to provide a key to use the disk later.
7229 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7230 # For example:
7231 #
7232 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7233 # key_region/cryptoKeys/key
7234 #
7235 # The fully-qualifed key name may be returned for resource GET requests. For
7236 # example:
7237 #
7238 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7239 # key_region/cryptoKeys/key
7240 # /cryptoKeyVersions/1
7241 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7242 # key. If absent, the Compute Engine default service account is used.
7243 # For example:
7244 #
7245 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7246 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7247 # encryption key, encoded in RFC
7248 # 4648 base64 to either encrypt or decrypt this resource. You can
7249 # provide either the rawKey or thersaEncryptedKey.
7250 # For example:
7251 #
7252 # &quot;rawKey&quot;:
7253 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7254 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7255 # customer-supplied encryption key to either encrypt or decrypt this
7256 # resource. You can provide either the rawKey or thersaEncryptedKey.
7257 # For example:
7258 #
7259 # &quot;rsaEncryptedKey&quot;:
7260 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7261 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7262 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7263 #
7264 # The key must meet the following requirements before you can provide it to
7265 # Compute Engine:
7266 #
7267 # 1. The key is wrapped using a RSA public key certificate provided by
7268 # Google.
7269 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7270 # encoding.
7271 #
7272 # Gets the RSA public key certificate provided by Google at:
7273 #
7274 #
7275 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7276 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7277 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7278 # encryption key that protects this resource.
7279 },
7280 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
7281 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
7282 # Windows specific VSS signature.
7283 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7284 # only for bootable images. Read
7285 # Enabling guest operating system features to see a list of available
7286 # options.
7287 { # Guest OS features.
7288 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7289 # separate values. Set to one or more of the following values:
7290 #
7291 # - VIRTIO_SCSI_MULTIQUEUE
7292 # - WINDOWS
7293 # - MULTI_IP_SUBNET
7294 # - UEFI_COMPATIBLE
7295 # - GVNIC
7296 # - SEV_CAPABLE
7297 # - SUSPEND_RESUME_COMPATIBLE
7298 # - SEV_LIVE_MIGRATABLE_V2
7299 # - SEV_SNP_CAPABLE
7300 # - TDX_CAPABLE
7301 # - IDPF
7302 # - SNP_SVSM_CAPABLE
7303 # - CCA_CAPABLE
7304 #
7305 #
7306 # For more information, see
7307 # Enabling guest operating system features.
7308 },
7309 ],
7310 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
7311 # defined by the server.
7312 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
7313 # which is either SCSI or NVME. The default isSCSI.
7314 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
7315 # disks.
7316 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
7317 # essentially a hash of the labels set used for optimistic locking. The
7318 # fingerprint is initially generated by Compute Engine and changes after
7319 # every request to modify or update labels. You must always provide an
7320 # up-to-date fingerprint hash in order to update or change labels,
7321 # otherwise the request will fail with error412 conditionNotMet.
7322 #
7323 # To see the latest fingerprint, make a get() request to
7324 # retrieve a disk.
7325 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
7326 # the setLabels method.
7327 &quot;a_key&quot;: &quot;A String&quot;,
7328 },
7329 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
7330 # text format.
7331 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
7332 # text format.
7333 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
7334 &quot;A String&quot;,
7335 ],
7336 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
7337 &quot;A String&quot;,
7338 ],
7339 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
7340 # This field is for use by internal tools that use the public API.
7341 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
7342 # source image. Attachment of a disk created from a locked source image will
7343 # cause the following operations to become irreversibly prohibited:
7344 #
7345 # - R/W or R/O disk attachment to any other instance
7346 # - Disk detachment. And the disk can only be deleted when the instance
7347 # is deleted
7348 # - Creation of images or snapshots
7349 # - Disk cloning
7350 #
7351 #
7352 #
7353 # Furthermore, the instance with at least one disk with locked flag set to
7354 # true will be prohibited from performing the operations below:
7355 #
7356 # - Further attachment of secondary disks.
7357 # - Detachment of any disks
7358 # - Create machine images
7359 # - Create instance template
7360 # - Delete the instance with --keep-disk parameter set to true for locked
7361 # disks
7362 # - Attach a locked disk with --auto-delete parameter set to false
7363 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
7364 # more than one instance.
7365 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
7366 # The name must be 1-63 characters long, and comply withRFC1035.
7367 # Specifically, the name must be 1-63 characters long and match the regular
7368 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
7369 # which means the first character must be a lowercase letter, and all
7370 # following characters must be a dash, lowercase letter, or digit, except
7371 # the last character, which cannot be a dash.
7372 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
7373 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
7374 # as part of resource payload.
7375 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
7376 # have the same definition as resource
7377 # manager tags. Keys and values can be either in numeric format,
7378 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
7379 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
7380 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
7381 # PATCH) when empty.
7382 &quot;a_key&quot;: &quot;A String&quot;,
7383 },
7384 },
7385 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
7386 # If not present in a request, a default value is used.
7387 # The currently supported size is 4096, other sizes may be added in
7388 # the future.
7389 # If an unsupported value is requested, the error message will list
7390 # the supported values for the caller&#x27;s project.
7391 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
7392 # of I/O operations per second that the disk can handle. Values must be
7393 # between 10,000 and 120,000. For more details, see theExtreme persistent
7394 # disk documentation.
7395 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
7396 # number of throughput mb per second that the disk can handle. Values must be
7397 # greater than or equal to 1.
7398 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
7399 # regional resources.
7400 # You must specify this field as part of the HTTP request URL. It is
7401 # not settable as a field in the request body.
7402 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
7403 # for regional resources.
7404 &quot;A String&quot;,
7405 ],
7406 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
7407 &quot;A String&quot;,
7408 ],
7409 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
7410 &quot;asyncPrimaryDisk&quot;: {
7411 &quot;state&quot;: &quot;A String&quot;,
7412 },
7413 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
7414 &quot;a_key&quot;: {
7415 &quot;state&quot;: &quot;A String&quot;,
7416 },
7417 },
7418 },
7419 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
7420 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
7421 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
7422 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
7423 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
7424 # persistent disk.
7425 #
7426 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
7427 # source.
7428 # Acceptable values are greater than 0.
7429 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
7430 # that was created using a consistency group.
7431 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
7432 # that was created using a consistency group.
7433 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
7434 # partial or full URL to the resource. For example, the following are valid
7435 # values:
7436 #
7437 #
7438 # -
7439 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
7440 #
7441 # -
7442 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
7443 #
7444 # -
7445 # projects/project/zones/zone/disks/disk
7446 #
7447 # -
7448 # projects/project/regions/region/disks/disk
7449 #
7450 # -
7451 # zones/zone/disks/disk
7452 #
7453 # -
7454 # regions/region/disks/disk
7455 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
7456 # value identifies the exact disk that was used to create this persistent
7457 # disk. For example, if you created the persistent disk from a disk that
7458 # was later deleted and recreated under the same name, the source disk ID
7459 # would identify the exact version of the disk that was used.
7460 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
7461 # deleted, this field will not be set.
7462 #
7463 # To create a disk with one of the public operating system images, specify
7464 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
7465 #
7466 # projects/debian-cloud/global/images/family/debian-9
7467 #
7468 #
7469 # Alternatively, use a specific version of a public operating system image:
7470 #
7471 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
7472 #
7473 #
7474 # To create a disk with a custom image that you created, specify the
7475 # image name in the following format:
7476 #
7477 # global/images/my-custom-image
7478 #
7479 #
7480 # You can also specify a custom image by its image family, which returns
7481 # the latest version of the image in that family. Replace the image name
7482 # with family/family-name:
7483 #
7484 # global/images/family/my-image-family
7485 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
7486 # encryption key of the source image. Required if the source image is
7487 # protected by a customer-supplied encryption key.
7488 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7489 # For example:
7490 #
7491 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7492 # key_region/cryptoKeys/key
7493 #
7494 # The fully-qualifed key name may be returned for resource GET requests. For
7495 # example:
7496 #
7497 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7498 # key_region/cryptoKeys/key
7499 # /cryptoKeyVersions/1
7500 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7501 # key. If absent, the Compute Engine default service account is used.
7502 # For example:
7503 #
7504 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7505 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7506 # encryption key, encoded in RFC
7507 # 4648 base64 to either encrypt or decrypt this resource. You can
7508 # provide either the rawKey or thersaEncryptedKey.
7509 # For example:
7510 #
7511 # &quot;rawKey&quot;:
7512 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7513 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7514 # customer-supplied encryption key to either encrypt or decrypt this
7515 # resource. You can provide either the rawKey or thersaEncryptedKey.
7516 # For example:
7517 #
7518 # &quot;rsaEncryptedKey&quot;:
7519 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7520 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7521 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7522 #
7523 # The key must meet the following requirements before you can provide it to
7524 # Compute Engine:
7525 #
7526 # 1. The key is wrapped using a RSA public key certificate provided by
7527 # Google.
7528 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7529 # encoding.
7530 #
7531 # Gets the RSA public key certificate provided by Google at:
7532 #
7533 #
7534 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7535 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7536 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7537 # encryption key that protects this resource.
7538 },
7539 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
7540 # value identifies the exact image that was used to create this persistent
7541 # disk. For example, if you created the persistent disk from an image that
7542 # was later deleted and recreated under the same name, the source image ID
7543 # would identify the exact version of the image that was used.
7544 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
7545 # this as a partial or full URL to the resource. For example, the following
7546 # are valid values:
7547 #
7548 #
7549 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
7550 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
7551 # - zones/zone/instantSnapshots/instantSnapshot
7552 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
7553 # disk. This value identifies the exact instant snapshot that was used to
7554 # create this persistent disk. For example, if you created the persistent
7555 # disk from an instant snapshot that was later deleted and recreated under
7556 # the same name, the source instant snapshot ID would identify the exact
7557 # version of the instant snapshot that was used.
7558 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
7559 # partial or full URL to the resource. For example, the following are valid
7560 # values:
7561 #
7562 #
7563 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
7564 # - projects/project/global/machineImages/machineImage
7565 # - global/machineImages/machineImage
7566 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
7567 # source_machine_image must be specified.
7568 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
7569 # encryption key of the source machine image. Required if the source
7570 # machine image is protected by a customer-supplied encryption key.
7571 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7572 # For example:
7573 #
7574 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7575 # key_region/cryptoKeys/key
7576 #
7577 # The fully-qualifed key name may be returned for resource GET requests. For
7578 # example:
7579 #
7580 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7581 # key_region/cryptoKeys/key
7582 # /cryptoKeyVersions/1
7583 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7584 # key. If absent, the Compute Engine default service account is used.
7585 # For example:
7586 #
7587 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7588 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7589 # encryption key, encoded in RFC
7590 # 4648 base64 to either encrypt or decrypt this resource. You can
7591 # provide either the rawKey or thersaEncryptedKey.
7592 # For example:
7593 #
7594 # &quot;rawKey&quot;:
7595 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7596 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7597 # customer-supplied encryption key to either encrypt or decrypt this
7598 # resource. You can provide either the rawKey or thersaEncryptedKey.
7599 # For example:
7600 #
7601 # &quot;rsaEncryptedKey&quot;:
7602 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7603 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7604 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7605 #
7606 # The key must meet the following requirements before you can provide it to
7607 # Compute Engine:
7608 #
7609 # 1. The key is wrapped using a RSA public key certificate provided by
7610 # Google.
7611 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7612 # encoding.
7613 #
7614 # Gets the RSA public key certificate provided by Google at:
7615 #
7616 #
7617 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7618 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7619 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7620 # encryption key that protects this resource.
7621 },
7622 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
7623 # This value identifies the exact machine image that was used to create this
7624 # persistent disk. For example, if you created the persistent disk from a
7625 # machine image that was later deleted and recreated under the same name, the
7626 # source machine image ID would identify the exact version of the machine
7627 # image that was used.
7628 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
7629 # partial or full URL to the resource. For example, the following are valid
7630 # values:
7631 #
7632 #
7633 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
7634 # - projects/project/global/snapshots/snapshot
7635 # - global/snapshots/snapshot
7636 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
7637 # encryption key of the source snapshot. Required if the source snapshot
7638 # is protected by a customer-supplied encryption key.
7639 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7640 # For example:
7641 #
7642 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7643 # key_region/cryptoKeys/key
7644 #
7645 # The fully-qualifed key name may be returned for resource GET requests. For
7646 # example:
7647 #
7648 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7649 # key_region/cryptoKeys/key
7650 # /cryptoKeyVersions/1
7651 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7652 # key. If absent, the Compute Engine default service account is used.
7653 # For example:
7654 #
7655 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7656 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7657 # encryption key, encoded in RFC
7658 # 4648 base64 to either encrypt or decrypt this resource. You can
7659 # provide either the rawKey or thersaEncryptedKey.
7660 # For example:
7661 #
7662 # &quot;rawKey&quot;:
7663 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7664 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7665 # customer-supplied encryption key to either encrypt or decrypt this
7666 # resource. You can provide either the rawKey or thersaEncryptedKey.
7667 # For example:
7668 #
7669 # &quot;rsaEncryptedKey&quot;:
7670 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7671 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7672 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7673 #
7674 # The key must meet the following requirements before you can provide it to
7675 # Compute Engine:
7676 #
7677 # 1. The key is wrapped using a RSA public key certificate provided by
7678 # Google.
7679 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7680 # encoding.
7681 #
7682 # Gets the RSA public key certificate provided by Google at:
7683 #
7684 #
7685 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7686 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7687 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7688 # encryption key that protects this resource.
7689 },
7690 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
7691 # value identifies the exact snapshot that was used to create this persistent
7692 # disk. For example, if you created the persistent disk from a snapshot that
7693 # was later deleted and recreated under the same name, the source snapshot ID
7694 # would identify the exact version of the snapshot that was used.
7695 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
7696 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
7697 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
7698 # https://storage.googleapis.com/. This flag is not optimized for creating
7699 # multiple disks from a source storage object. To create many disks from a
7700 # source storage object, use gcloud compute images
7701 # import instead.
7702 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
7703 #
7704 #
7705 # - CREATING: Disk is provisioning.
7706 # - RESTORING: Source data is being copied into the
7707 # disk.
7708 # - FAILED: Disk creation failed.
7709 # - READY: Disk is ready for use.
7710 # - DELETING: Disk is deleting.
7711 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7712 # this as a partial or full URL to the resource. For example, the following
7713 # are valid values:
7714 #
7715 #
7716 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7717 # - projects/project/zones/zone/storagePools/storagePool
7718 # - zones/zone/storagePools/storagePool
7719 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
7720 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
7721 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
7722 # types.
7723 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
7724 # in form:projects/project/zones/zone/instances/instance
7725 &quot;A String&quot;,
7726 ],
7727 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
7728 # You must specify this field as part of the HTTP request URL. It is
7729 # not settable as a field in the request body.
7730 }
7731
7732 paths: string, A parameter (repeated)
7733 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
7734 that if you must retry your request, the server will know to ignore the
7735 request if it has already been completed.
7736
7737 For example, consider a situation where you make an initial request and
7738 the request times out. If you make the request again with the same
7739 request ID, the server can check if original operation with the same
7740 request ID was received, and if so, will ignore the second request. This
7741 prevents clients from accidentally creating duplicate commitments.
7742
7743 The request ID must be
7744 a valid UUID with the exception that zero UUID is not supported
7745 (00000000-0000-0000-0000-000000000000).
7746 updateMask: string, update_mask indicates fields to be updated as part of this request.
7747 x__xgafv: string, V1 error format.
7748 Allowed values
7749 1 - v1 error format
7750 2 - v2 error format
7751
7752 Returns:
7753 An object of the form:
7754
7755 { # Represents an Operation resource.
7756 #
7757 # Google Compute Engine has three Operation resources:
7758 #
7759 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
7760 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
7761 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
7762 #
7763 # You can use an operation resource to manage asynchronous API requests.
7764 # For more information, readHandling
7765 # API responses.
7766 #
7767 # Operations can be global, regional or zonal.
7768 #
7769 # - For global operations, use the `globalOperations`
7770 # resource.
7771 # - For regional operations, use the
7772 # `regionOperations` resource.
7773 # - For zonal operations, use
7774 # the `zoneOperations` resource.
7775 #
7776 #
7777 #
7778 # For more information, read
7779 # Global, Regional, and Zonal Resources.
7780 #
7781 # Note that completed Operation resources have a limited
7782 # retention period.
7783 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
7784 # Not present otherwise.
7785 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
7786 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
7787 # set when the operation is created.
7788 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
7789 # text format.
7790 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
7791 # this field will be populated.
7792 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7793 # operation.
7794 {
7795 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7796 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7797 # details. There is a set of defined message types to use for providing
7798 # details.The syntax depends on the error code. For example,
7799 # QuotaExceededInfo will have details when the error code is
7800 # QUOTA_EXCEEDED.
7801 {
7802 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7803 #
7804 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7805 # is not enabled:
7806 #
7807 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7808 # &quot;domain&quot;: &quot;googleapis.com&quot;
7809 # &quot;metadata&quot;: {
7810 # &quot;resource&quot;: &quot;projects/123&quot;,
7811 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7812 # }
7813 # }
7814 #
7815 # This response indicates that the pubsub.googleapis.com API is not enabled.
7816 #
7817 # Example of an error that is returned when attempting to create a Spanner
7818 # instance in a region that is out of stock:
7819 #
7820 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7821 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7822 # &quot;metadata&quot;: {
7823 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7824 # }
7825 # }
7826 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7827 # is typically the registered service name of the tool or product that
7828 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7829 # generated by some common infrastructure, the error domain must be a
7830 # globally unique value that identifies the infrastructure. For Google API
7831 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7832 &quot;metadatas&quot;: { # Additional structured details about this error.
7833 #
7834 # Keys must match a regular expression of `a-z+` but should
7835 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7836 # length. When identifying the current value of an exceeded limit, the units
7837 # should be contained in the key, not the value. For example, rather than
7838 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7839 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7840 # instances that can be created in a single (batch) request.
7841 &quot;a_key&quot;: &quot;A String&quot;,
7842 },
7843 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7844 # proximate cause of the error. Error reasons are unique within a particular
7845 # domain of errors. This should be at most 63 characters and match a
7846 # regular expression of `A-Z+[A-Z0-9]`, which represents
7847 # UPPER_SNAKE_CASE.
7848 },
7849 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7850 #
7851 # For example, if a quota check failed with an error indicating the calling
7852 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7853 # directly to the right place in the developer console to flip the bit.
7854 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7855 { # Describes a URL link.
7856 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7857 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7858 },
7859 ],
7860 },
7861 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7862 # which can be attached to an RPC error.
7863 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7864 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7865 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7866 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7867 },
7868 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7869 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7870 &quot;a_key&quot;: &quot;A String&quot;,
7871 },
7872 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7873 # type or metric.
7874 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7875 # or metric.
7876 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7877 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7878 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7879 },
7880 },
7881 ],
7882 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7883 # This property is optional.
7884 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7885 },
7886 ],
7887 },
7888 &quot;getVersionOperationMetadata&quot;: {
7889 &quot;inlineSbomInfo&quot;: {
7890 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
7891 # appropriate identifiers.
7892 &quot;a_key&quot;: &quot;A String&quot;,
7893 },
7894 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
7895 # identifiers.
7896 &quot;a_key&quot;: &quot;A String&quot;,
7897 },
7898 },
7899 },
7900 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
7901 # message that was returned, such as `NOT FOUND`.
7902 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
7903 # status code that was returned. For example, a `404` means the
7904 # resource was not found.
7905 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
7906 # defined by the server.
7907 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
7908 # This value is inRFC3339
7909 # text format.
7910 &quot;instancesBulkInsertOperationMetadata&quot;: {
7911 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
7912 # Example key: zones/us-central1-a
7913 &quot;a_key&quot;: {
7914 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
7915 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
7916 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
7917 # error.
7918 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
7919 # if the flow is rolling forward or rolling back.
7920 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
7921 },
7922 },
7923 },
7924 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
7925 # Operation resources.
7926 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
7927 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
7928 # group of operations results from a `bulkInsert` API request.
7929 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
7930 # `update`, or `delete`, and so on.
7931 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
7932 # There is no requirement that this be linear or support any granularity of
7933 # operations. This should not be used to guess when the operation will be
7934 # complete. This number should monotonically increase as the operation
7935 # progresses.
7936 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
7937 # applicable when performing regional operations.
7938 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7939 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
7940 # this field will contain information on all underlying zonal actions and
7941 # their state.
7942 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
7943 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
7944 # Example key: zones/us-central1-a
7945 &quot;a_key&quot;: {
7946 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
7947 # populated.
7948 # different programming environments, including REST APIs and RPC APIs. It is
7949 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
7950 # three pieces of data: error code, error message, and error details.
7951 #
7952 # You can find out more about this error model and how to work with it in the
7953 # [API Design Guide](https://cloud.google.com/apis/design/errors).
7954 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
7955 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
7956 # message types for APIs to use.
7957 {
7958 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
7959 },
7960 ],
7961 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
7962 # user-facing error message should be localized and sent in the
7963 # google.rpc.Status.details field, or localized by the client.
7964 },
7965 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
7966 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
7967 },
7968 },
7969 },
7970 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
7971 # This value is inRFC3339
7972 # text format.
7973 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
7974 # following:
7975 # `PENDING`, `RUNNING`, or `DONE`.
7976 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
7977 # operation.
7978 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
7979 # of the target resource.
7980 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
7981 # operations related to creating a snapshot, this points to the disk
7982 # that the snapshot was created from.
7983 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
7984 # `[email protected]` or
7985 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
7986 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
7987 # operation, this field will be populated.
7988 {
7989 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
7990 # Engine returns NO_RESULTS_ON_PAGE if there
7991 # are no results in the response.
7992 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
7993 # value format. For example:
7994 #
7995 # &quot;data&quot;: [
7996 # {
7997 # &quot;key&quot;: &quot;scope&quot;,
7998 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
7999 # }
8000 {
8001 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8002 # returned. For example, for warnings where there are no results in a list
8003 # request for a particular zone, this key might be scope and
8004 # the key value might be the zone name. Other examples might be a key
8005 # indicating a deprecated resource and a suggested replacement, or a
8006 # warning about invalid network settings (for example, if an instance
8007 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8008 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8009 },
8010 ],
8011 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8012 },
8013 ],
8014 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8015 # applicable when performing per-zone operations.
8016 }</pre>
8017 </div>
8018
8019 <div class="method">
8020 <code class="details" id="updateKmsKey">updateKmsKey(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
8021 <pre>Rotates the customer-managed
8022 encryption key to the latest version for the specified persistent disk.
8023
8024 Args:
8025 project: string, Project ID for this request. (required)
8026 region: string, The name of the region for this request. (required)
8027 disk: string, Name of the Disk resource, should conform to RFC1035. (required)
8028 body: object, The request body.
8029 The object takes the form of:
8030
8031 {
8032 &quot;kmsKeyName&quot;: &quot;A String&quot;, # Optional. The new KMS key to replace the current one on the disk. If empty, the disk
8033 # will be re-encrypted using the primary version of the disk&#x27;s current KMS
8034 # key.
8035 #
8036 # The KMS key can be provided in the following formats:
8037 #
8038 #
8039 # - projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key
8040 #
8041 #
8042 # Where project is the project ID or
8043 # project number.
8044 }
8045
8046 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
8047 that if you must retry your request, the server will know to ignore the
8048 request if it has already been completed.
8049
8050 For example, consider a situation where you make an initial request and
8051 the request times out. If you make the request again with the same
8052 request ID, the server can check if original operation with the same
8053 request ID was received, and if so, will ignore the second request. This
8054 prevents clients from accidentally creating duplicate commitments.
8055
8056 The request ID must be
8057 a valid UUID with the exception that zero UUID is not supported
8058 (00000000-0000-0000-0000-000000000000).
8059 x__xgafv: string, V1 error format.
8060 Allowed values
8061 1 - v1 error format
8062 2 - v2 error format
8063
8064 Returns:
8065 An object of the form:
8066
8067 { # Represents an Operation resource.
8068 #
8069 # Google Compute Engine has three Operation resources:
8070 #
8071 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
8072 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
8073 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
8074 #
8075 # You can use an operation resource to manage asynchronous API requests.
8076 # For more information, readHandling
8077 # API responses.
8078 #
8079 # Operations can be global, regional or zonal.
8080 #
8081 # - For global operations, use the `globalOperations`
8082 # resource.
8083 # - For regional operations, use the
8084 # `regionOperations` resource.
8085 # - For zonal operations, use
8086 # the `zoneOperations` resource.
8087 #
8088 #
8089 #
8090 # For more information, read
8091 # Global, Regional, and Zonal Resources.
8092 #
8093 # Note that completed Operation resources have a limited
8094 # retention period.
8095 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
8096 # Not present otherwise.
8097 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
8098 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
8099 # set when the operation is created.
8100 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
8101 # text format.
8102 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
8103 # this field will be populated.
8104 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8105 # operation.
8106 {
8107 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8108 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8109 # details. There is a set of defined message types to use for providing
8110 # details.The syntax depends on the error code. For example,
8111 # QuotaExceededInfo will have details when the error code is
8112 # QUOTA_EXCEEDED.
8113 {
8114 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8115 #
8116 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8117 # is not enabled:
8118 #
8119 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8120 # &quot;domain&quot;: &quot;googleapis.com&quot;
8121 # &quot;metadata&quot;: {
8122 # &quot;resource&quot;: &quot;projects/123&quot;,
8123 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8124 # }
8125 # }
8126 #
8127 # This response indicates that the pubsub.googleapis.com API is not enabled.
8128 #
8129 # Example of an error that is returned when attempting to create a Spanner
8130 # instance in a region that is out of stock:
8131 #
8132 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8133 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8134 # &quot;metadata&quot;: {
8135 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8136 # }
8137 # }
8138 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8139 # is typically the registered service name of the tool or product that
8140 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8141 # generated by some common infrastructure, the error domain must be a
8142 # globally unique value that identifies the infrastructure. For Google API
8143 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8144 &quot;metadatas&quot;: { # Additional structured details about this error.
8145 #
8146 # Keys must match a regular expression of `a-z+` but should
8147 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8148 # length. When identifying the current value of an exceeded limit, the units
8149 # should be contained in the key, not the value. For example, rather than
8150 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8151 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8152 # instances that can be created in a single (batch) request.
8153 &quot;a_key&quot;: &quot;A String&quot;,
8154 },
8155 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8156 # proximate cause of the error. Error reasons are unique within a particular
8157 # domain of errors. This should be at most 63 characters and match a
8158 # regular expression of `A-Z+[A-Z0-9]`, which represents
8159 # UPPER_SNAKE_CASE.
8160 },
8161 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8162 #
8163 # For example, if a quota check failed with an error indicating the calling
8164 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8165 # directly to the right place in the developer console to flip the bit.
8166 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8167 { # Describes a URL link.
8168 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8169 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8170 },
8171 ],
8172 },
8173 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8174 # which can be attached to an RPC error.
8175 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8176 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8177 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8178 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8179 },
8180 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8181 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8182 &quot;a_key&quot;: &quot;A String&quot;,
8183 },
8184 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8185 # type or metric.
8186 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8187 # or metric.
8188 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8189 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8190 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8191 },
8192 },
8193 ],
8194 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8195 # This property is optional.
8196 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8197 },
8198 ],
8199 },
8200 &quot;getVersionOperationMetadata&quot;: {
8201 &quot;inlineSbomInfo&quot;: {
8202 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
8203 # appropriate identifiers.
8204 &quot;a_key&quot;: &quot;A String&quot;,
8205 },
8206 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8207 # identifiers.
8208 &quot;a_key&quot;: &quot;A String&quot;,
8209 },
8210 },
8211 },
8212 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8213 # message that was returned, such as `NOT FOUND`.
8214 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8215 # status code that was returned. For example, a `404` means the
8216 # resource was not found.
8217 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8218 # defined by the server.
8219 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8220 # This value is inRFC3339
8221 # text format.
8222 &quot;instancesBulkInsertOperationMetadata&quot;: {
8223 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8224 # Example key: zones/us-central1-a
8225 &quot;a_key&quot;: {
8226 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8227 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8228 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8229 # error.
8230 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8231 # if the flow is rolling forward or rolling back.
8232 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8233 },
8234 },
8235 },
8236 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8237 # Operation resources.
8238 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8239 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8240 # group of operations results from a `bulkInsert` API request.
8241 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8242 # `update`, or `delete`, and so on.
8243 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8244 # There is no requirement that this be linear or support any granularity of
8245 # operations. This should not be used to guess when the operation will be
8246 # complete. This number should monotonically increase as the operation
8247 # progresses.
8248 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8249 # applicable when performing regional operations.
8250 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8251 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8252 # this field will contain information on all underlying zonal actions and
8253 # their state.
8254 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8255 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8256 # Example key: zones/us-central1-a
8257 &quot;a_key&quot;: {
8258 &quot;error&quot;: { # The `Status` type defines a logical error model that is suitable for # [Output Only] If state is `ABANDONED` or `FAILED`, this field is
8259 # populated.
8260 # different programming environments, including REST APIs and RPC APIs. It is
8261 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8262 # three pieces of data: error code, error message, and error details.
8263 #
8264 # You can find out more about this error model and how to work with it in the
8265 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8266 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8267 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8268 # message types for APIs to use.
8269 {
8270 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8271 },
8272 ],
8273 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8274 # user-facing error message should be localized and sent in the
8275 # google.rpc.Status.details field, or localized by the client.
8276 },
8277 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8278 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8279 },
8280 },
8281 },
8282 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8283 # This value is inRFC3339
8284 # text format.
8285 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8286 # following:
8287 # `PENDING`, `RUNNING`, or `DONE`.
8288 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8289 # operation.
8290 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8291 # of the target resource.
8292 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8293 # operations related to creating a snapshot, this points to the disk
8294 # that the snapshot was created from.
8295 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8296 # `[email protected]` or
8297 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8298 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8299 # operation, this field will be populated.
8300 {
8301 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8302 # Engine returns NO_RESULTS_ON_PAGE if there
8303 # are no results in the response.
8304 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8305 # value format. For example:
8306 #
8307 # &quot;data&quot;: [
8308 # {
8309 # &quot;key&quot;: &quot;scope&quot;,
8310 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8311 # }
8312 {
8313 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8314 # returned. For example, for warnings where there are no results in a list
8315 # request for a particular zone, this key might be scope and
8316 # the key value might be the zone name. Other examples might be a key
8317 # indicating a deprecated resource and a suggested replacement, or a
8318 # warning about invalid network settings (for example, if an instance
8319 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8320 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8321 },
8322 ],
8323 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8324 },
8325 ],
8326 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8327 # applicable when performing per-zone operations.
8328 }</pre>
8329 </div>
8330
8331 </body></html>