Debian Codegraph @

docs/dyn/compute_alpha.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_alpha.html">Compute Engine API</a> . <a href="compute_alpha.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, guestFlush=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="#getAsyncReplicationStatus">getAsyncReplicationStatus(project, region, disk, x__xgafv=None)</a></code></p>
97 <p class="firstline">Gets the status of current async replication for a given device.</p>
98 <p class="toc_element">
99 <code><a href="#getIamPolicy">getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Gets the access control policy for a resource. May be empty if no such</p>
101 <p class="toc_element">
102 <code><a href="#insert">insert(project, region, body=None, requestId=None, sourceImage=None, x__xgafv=None)</a></code></p>
103 <p class="firstline">Creates a persistent regional disk in the specified project using the data</p>
104 <p class="toc_element">
105 <code><a href="#list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
106 <p class="firstline">Retrieves the list of persistent disks contained within</p>
107 <p class="toc_element">
108 <code><a href="#list_next">list_next()</a></code></p>
109 <p class="firstline">Retrieves the next page of results.</p>
110 <p class="toc_element">
111 <code><a href="#removeResourcePolicies">removeResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
112 <p class="firstline">Removes resource policies from a regional disk.</p>
113 <p class="toc_element">
114 <code><a href="#resize">resize(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
115 <p class="firstline">Resizes the specified regional persistent disk.</p>
116 <p class="toc_element">
117 <code><a href="#setIamPolicy">setIamPolicy(project, region, resource, body=None, x__xgafv=None)</a></code></p>
118 <p class="firstline">Sets the access control policy on the specified resource.</p>
119 <p class="toc_element">
120 <code><a href="#setLabels">setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)</a></code></p>
121 <p class="firstline">Sets the labels on the target regional disk.</p>
122 <p class="toc_element">
123 <code><a href="#startAsyncReplication">startAsyncReplication(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
124 <p class="firstline">Starts asynchronous replication.</p>
125 <p class="toc_element">
126 <code><a href="#stopAsyncReplication">stopAsyncReplication(project, region, disk, requestId=None, x__xgafv=None)</a></code></p>
127 <p class="firstline">Stops asynchronous replication.</p>
128 <p class="toc_element">
129 <code><a href="#stopGroupAsyncReplication">stopGroupAsyncReplication(project, region, body=None, requestId=None, x__xgafv=None)</a></code></p>
130 <p class="firstline">Stops asynchronous replication for a consistency group of disks.</p>
131 <p class="toc_element">
132 <code><a href="#testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</a></code></p>
133 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
134 <p class="toc_element">
135 <code><a href="#update">update(project, region, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)</a></code></p>
136 <p class="firstline">Update the specified disk with the data included in the request. Update is</p>
137 <p class="toc_element">
138 <code><a href="#updateKmsKey">updateKmsKey(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
139 <p class="firstline">Rotates the customer-managed</p>
140 <p class="toc_element">
141 <code><a href="#waitForReplicationCatchUp">waitForReplicationCatchUp(project, region, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
142 <p class="firstline">Wait for replication to catch up on the secondary disk.</p>
143 <h3>Method Details</h3>
144 <div class="method">
145 <code class="details" id="addResourcePolicies">addResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
146 <pre>Adds existing resource policies to a regional disk. You can only add one
147 policy which will be applied to this disk for scheduling snapshot
148 creation.
149
150 Args:
151 project: string, Project ID for this request. (required)
152 region: string, The name of the region for this request. (required)
153 disk: string, The disk name for this request. (required)
154 body: object, The request body.
155 The object takes the form of:
156
157 {
158 &quot;resourcePolicies&quot;: [ # Resource policies to be added to this disk.
159 &quot;A String&quot;,
160 ],
161 }
162
163 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
164 that if you must retry your request, the server will know to ignore the
165 request if it has already been completed.
166
167 For example, consider a situation where you make an initial request and
168 the request times out. If you make the request again with the same
169 request ID, the server can check if original operation with the same
170 request ID was received, and if so, will ignore the second request. This
171 prevents clients from accidentally creating duplicate commitments.
172
173 The request ID must be
174 a valid UUID with the exception that zero UUID is not supported
175 (00000000-0000-0000-0000-000000000000).
176 x__xgafv: string, V1 error format.
177 Allowed values
178 1 - v1 error format
179 2 - v2 error format
180
181 Returns:
182 An object of the form:
183
184 { # Represents an Operation resource.
185 #
186 # Google Compute Engine has three Operation resources:
187 #
188 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
189 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
190 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
191 #
192 # You can use an operation resource to manage asynchronous API requests.
193 # For more information, readHandling
194 # API responses.
195 #
196 # Operations can be global, regional or zonal.
197 #
198 # - For global operations, use the `globalOperations`
199 # resource.
200 # - For regional operations, use the
201 # `regionOperations` resource.
202 # - For zonal operations, use
203 # the `zoneOperations` resource.
204 #
205 #
206 #
207 # For more information, read
208 # Global, Regional, and Zonal Resources.
209 #
210 # Note that completed Operation resources have a limited
211 # retention period.
212 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
213 # Not present otherwise.
214 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
215 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
216 # set when the operation is created.
217 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
218 # text format.
219 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
220 # this field will be populated.
221 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
222 # operation.
223 {
224 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
225 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
226 # details. There is a set of defined message types to use for providing
227 # details.The syntax depends on the error code. For example,
228 # QuotaExceededInfo will have details when the error code is
229 # QUOTA_EXCEEDED.
230 {
231 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
232 #
233 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
234 # is not enabled:
235 #
236 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
237 # &quot;domain&quot;: &quot;googleapis.com&quot;
238 # &quot;metadata&quot;: {
239 # &quot;resource&quot;: &quot;projects/123&quot;,
240 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
241 # }
242 # }
243 #
244 # This response indicates that the pubsub.googleapis.com API is not enabled.
245 #
246 # Example of an error that is returned when attempting to create a Spanner
247 # instance in a region that is out of stock:
248 #
249 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
250 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
251 # &quot;metadata&quot;: {
252 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
253 # }
254 # }
255 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
256 # is typically the registered service name of the tool or product that
257 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
258 # generated by some common infrastructure, the error domain must be a
259 # globally unique value that identifies the infrastructure. For Google API
260 # infrastructure, the error domain is &quot;googleapis.com&quot;.
261 &quot;metadatas&quot;: { # Additional structured details about this error.
262 #
263 # Keys must match a regular expression of `a-z+` but should
264 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
265 # length. When identifying the current value of an exceeded limit, the units
266 # should be contained in the key, not the value. For example, rather than
267 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
268 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
269 # instances that can be created in a single (batch) request.
270 &quot;a_key&quot;: &quot;A String&quot;,
271 },
272 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
273 # proximate cause of the error. Error reasons are unique within a particular
274 # domain of errors. This should be at most 63 characters and match a
275 # regular expression of `A-Z+[A-Z0-9]`, which represents
276 # UPPER_SNAKE_CASE.
277 },
278 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
279 #
280 # For example, if a quota check failed with an error indicating the calling
281 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
282 # directly to the right place in the developer console to flip the bit.
283 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
284 { # Describes a URL link.
285 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
286 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
287 },
288 ],
289 },
290 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
291 # which can be attached to an RPC error.
292 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
293 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
294 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
295 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
296 },
297 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
298 &quot;dimensions&quot;: { # The map holding related quota dimensions.
299 &quot;a_key&quot;: &quot;A String&quot;,
300 },
301 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
302 # type or metric.
303 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
304 # or metric.
305 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
306 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
307 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
308 },
309 },
310 ],
311 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
312 # This property is optional.
313 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
314 },
315 ],
316 },
317 &quot;getVersionOperationMetadata&quot;: {
318 &quot;inlineSbomInfo&quot;: {
319 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
320 # appropriate identifiers.
321 &quot;a_key&quot;: &quot;A String&quot;,
322 },
323 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
324 # identifiers.
325 &quot;a_key&quot;: &quot;A String&quot;,
326 },
327 },
328 },
329 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
330 # message that was returned, such as `NOT FOUND`.
331 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
332 # status code that was returned. For example, a `404` means the
333 # resource was not found.
334 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
335 # defined by the server.
336 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
337 # This value is inRFC3339
338 # text format.
339 &quot;instancesBulkInsertOperationMetadata&quot;: {
340 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
341 # Example key: zones/us-central1-a
342 &quot;a_key&quot;: {
343 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
344 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
345 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
346 # error.
347 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
348 # if the flow is rolling forward or rolling back.
349 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
350 },
351 },
352 },
353 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
354 # Operation resources.
355 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
356 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
357 # group of operations results from a `bulkInsert` API request.
358 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
359 # `update`, or `delete`, and so on.
360 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
361 # There is no requirement that this be linear or support any granularity of
362 # operations. This should not be used to guess when the operation will be
363 # complete. This number should monotonically increase as the operation
364 # progresses.
365 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
366 # applicable when performing regional operations.
367 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
368 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
369 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
370 # this field will contain information on all underlying zonal actions and
371 # their state.
372 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
373 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
374 # Example key: zones/us-central1-a
375 &quot;a_key&quot;: {
376 &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
377 # populated.
378 # different programming environments, including REST APIs and RPC APIs. It is
379 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
380 # three pieces of data: error code, error message, and error details.
381 #
382 # You can find out more about this error model and how to work with it in the
383 # [API Design Guide](https://cloud.google.com/apis/design/errors).
384 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
385 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
386 # message types for APIs to use.
387 {
388 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
389 },
390 ],
391 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
392 # user-facing error message should be localized and sent in the
393 # google.rpc.Status.details field, or localized by the client.
394 },
395 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
396 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
397 },
398 },
399 },
400 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
401 # This value is inRFC3339
402 # text format.
403 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
404 # following:
405 # `PENDING`, `RUNNING`, or `DONE`.
406 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
407 # operation.
408 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
409 # of the target resource.
410 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
411 # operations related to creating a snapshot, this points to the disk
412 # that the snapshot was created from.
413 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
414 # `[email protected]` or
415 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
416 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
417 # operation, this field will be populated.
418 {
419 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
420 # Engine returns NO_RESULTS_ON_PAGE if there
421 # are no results in the response.
422 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
423 # value format. For example:
424 #
425 # &quot;data&quot;: [
426 # {
427 # &quot;key&quot;: &quot;scope&quot;,
428 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
429 # }
430 {
431 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
432 # returned. For example, for warnings where there are no results in a list
433 # request for a particular zone, this key might be scope and
434 # the key value might be the zone name. Other examples might be a key
435 # indicating a deprecated resource and a suggested replacement, or a
436 # warning about invalid network settings (for example, if an instance
437 # attempts to perform IP forwarding but is not enabled for IP forwarding).
438 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
439 },
440 ],
441 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
442 },
443 ],
444 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
445 # applicable when performing per-zone operations.
446 }</pre>
447 </div>
448
449 <div class="method">
450 <code class="details" id="bulkInsert">bulkInsert(project, region, body=None, requestId=None, x__xgafv=None)</code>
451 <pre>Bulk create a set of disks.
452
453 Args:
454 project: string, Project ID for this request. (required)
455 region: string, The name of the region for this request. (required)
456 body: object, The request body.
457 The object takes the form of:
458
459 { # A transient resource used in compute.disks.bulkInsert and
460 # compute.regionDisks.bulkInsert. It is only used to process
461 # requests and is not persisted.
462 &quot;instantSnapshotGroupParameters&quot;: { # The parameters for the instant snapshot group.
463 &quot;sourceInstantSnapshotGroup&quot;: &quot;A String&quot;, # The source instant snapshot group used to create disks. You can provide
464 # this as a partial or full URL to the resource. For example, the following
465 # are valid values:
466 #
467 #
468 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup
469 # - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup
470 # - zones/zone/instantSnapshotGroups/instantSnapshotGroup
471 },
472 &quot;snapshotGroupParameters&quot;: { # The parameters for the snapshot group. The usage of snapshot group feature
473 # is restricted.
474 &quot;replicaZones&quot;: [ # URLs of the zones where disks should be replicated to. Only applicable
475 # for regional resources.
476 &quot;A String&quot;,
477 ],
478 &quot;sourceSnapshotGroup&quot;: &quot;A String&quot;, # The source snapshot group used to create disks. You can provide this as a
479 # partial or full URL to the resource. For example, the following are valid
480 # values:
481 #
482 #
483 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshotGroups/snapshotGroup
484 # - projects/project/global/snapshotGroups/snapshotGroup
485 # - global/snapshotGroups/snapshotGroup
486 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
487 # disks. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
488 # types.
489 },
490 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # The URL of the DiskConsistencyGroupPolicy for the group of disks to clone.
491 # This may be a full or partial URL, such as:
492 #
493 #
494 # -
495 # https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
496 #
497 # -
498 # projects/project/regions/region/resourcePolicies/resourcePolicy
499 #
500 # -
501 # regions/region/resourcePolicies/resourcePolicy
502 }
503
504 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
505 that if you must retry your request, the server will know to ignore the
506 request if it has already been completed.
507
508 For example, consider a situation where you make an initial request and
509 the request times out. If you make the request again with the same
510 request ID, the server can check if original operation with the same
511 request ID was received, and if so, will ignore the second request. This
512 prevents clients from accidentally creating duplicate commitments.
513
514 The request ID must be
515 a valid UUID with the exception that zero UUID is not supported
516 (00000000-0000-0000-0000-000000000000).
517 x__xgafv: string, V1 error format.
518 Allowed values
519 1 - v1 error format
520 2 - v2 error format
521
522 Returns:
523 An object of the form:
524
525 { # Represents an Operation resource.
526 #
527 # Google Compute Engine has three Operation resources:
528 #
529 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
530 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
531 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
532 #
533 # You can use an operation resource to manage asynchronous API requests.
534 # For more information, readHandling
535 # API responses.
536 #
537 # Operations can be global, regional or zonal.
538 #
539 # - For global operations, use the `globalOperations`
540 # resource.
541 # - For regional operations, use the
542 # `regionOperations` resource.
543 # - For zonal operations, use
544 # the `zoneOperations` resource.
545 #
546 #
547 #
548 # For more information, read
549 # Global, Regional, and Zonal Resources.
550 #
551 # Note that completed Operation resources have a limited
552 # retention period.
553 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
554 # Not present otherwise.
555 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
556 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
557 # set when the operation is created.
558 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
559 # text format.
560 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
561 # this field will be populated.
562 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
563 # operation.
564 {
565 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
566 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
567 # details. There is a set of defined message types to use for providing
568 # details.The syntax depends on the error code. For example,
569 # QuotaExceededInfo will have details when the error code is
570 # QUOTA_EXCEEDED.
571 {
572 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
573 #
574 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
575 # is not enabled:
576 #
577 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
578 # &quot;domain&quot;: &quot;googleapis.com&quot;
579 # &quot;metadata&quot;: {
580 # &quot;resource&quot;: &quot;projects/123&quot;,
581 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
582 # }
583 # }
584 #
585 # This response indicates that the pubsub.googleapis.com API is not enabled.
586 #
587 # Example of an error that is returned when attempting to create a Spanner
588 # instance in a region that is out of stock:
589 #
590 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
591 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
592 # &quot;metadata&quot;: {
593 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
594 # }
595 # }
596 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
597 # is typically the registered service name of the tool or product that
598 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
599 # generated by some common infrastructure, the error domain must be a
600 # globally unique value that identifies the infrastructure. For Google API
601 # infrastructure, the error domain is &quot;googleapis.com&quot;.
602 &quot;metadatas&quot;: { # Additional structured details about this error.
603 #
604 # Keys must match a regular expression of `a-z+` but should
605 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
606 # length. When identifying the current value of an exceeded limit, the units
607 # should be contained in the key, not the value. For example, rather than
608 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
609 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
610 # instances that can be created in a single (batch) request.
611 &quot;a_key&quot;: &quot;A String&quot;,
612 },
613 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
614 # proximate cause of the error. Error reasons are unique within a particular
615 # domain of errors. This should be at most 63 characters and match a
616 # regular expression of `A-Z+[A-Z0-9]`, which represents
617 # UPPER_SNAKE_CASE.
618 },
619 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
620 #
621 # For example, if a quota check failed with an error indicating the calling
622 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
623 # directly to the right place in the developer console to flip the bit.
624 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
625 { # Describes a URL link.
626 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
627 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
628 },
629 ],
630 },
631 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
632 # which can be attached to an RPC error.
633 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
634 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
635 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
636 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
637 },
638 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
639 &quot;dimensions&quot;: { # The map holding related quota dimensions.
640 &quot;a_key&quot;: &quot;A String&quot;,
641 },
642 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
643 # type or metric.
644 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
645 # or metric.
646 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
647 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
648 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
649 },
650 },
651 ],
652 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
653 # This property is optional.
654 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
655 },
656 ],
657 },
658 &quot;getVersionOperationMetadata&quot;: {
659 &quot;inlineSbomInfo&quot;: {
660 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
661 # appropriate identifiers.
662 &quot;a_key&quot;: &quot;A String&quot;,
663 },
664 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
665 # identifiers.
666 &quot;a_key&quot;: &quot;A String&quot;,
667 },
668 },
669 },
670 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
671 # message that was returned, such as `NOT FOUND`.
672 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
673 # status code that was returned. For example, a `404` means the
674 # resource was not found.
675 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
676 # defined by the server.
677 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
678 # This value is inRFC3339
679 # text format.
680 &quot;instancesBulkInsertOperationMetadata&quot;: {
681 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
682 # Example key: zones/us-central1-a
683 &quot;a_key&quot;: {
684 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
685 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
686 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
687 # error.
688 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
689 # if the flow is rolling forward or rolling back.
690 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
691 },
692 },
693 },
694 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
695 # Operation resources.
696 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
697 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
698 # group of operations results from a `bulkInsert` API request.
699 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
700 # `update`, or `delete`, and so on.
701 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
702 # There is no requirement that this be linear or support any granularity of
703 # operations. This should not be used to guess when the operation will be
704 # complete. This number should monotonically increase as the operation
705 # progresses.
706 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
707 # applicable when performing regional operations.
708 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
709 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
710 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
711 # this field will contain information on all underlying zonal actions and
712 # their state.
713 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
714 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
715 # Example key: zones/us-central1-a
716 &quot;a_key&quot;: {
717 &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
718 # populated.
719 # different programming environments, including REST APIs and RPC APIs. It is
720 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
721 # three pieces of data: error code, error message, and error details.
722 #
723 # You can find out more about this error model and how to work with it in the
724 # [API Design Guide](https://cloud.google.com/apis/design/errors).
725 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
726 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
727 # message types for APIs to use.
728 {
729 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
730 },
731 ],
732 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
733 # user-facing error message should be localized and sent in the
734 # google.rpc.Status.details field, or localized by the client.
735 },
736 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
737 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
738 },
739 },
740 },
741 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
742 # This value is inRFC3339
743 # text format.
744 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
745 # following:
746 # `PENDING`, `RUNNING`, or `DONE`.
747 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
748 # operation.
749 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
750 # of the target resource.
751 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
752 # operations related to creating a snapshot, this points to the disk
753 # that the snapshot was created from.
754 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
755 # `[email protected]` or
756 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
757 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
758 # operation, this field will be populated.
759 {
760 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
761 # Engine returns NO_RESULTS_ON_PAGE if there
762 # are no results in the response.
763 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
764 # value format. For example:
765 #
766 # &quot;data&quot;: [
767 # {
768 # &quot;key&quot;: &quot;scope&quot;,
769 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
770 # }
771 {
772 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
773 # returned. For example, for warnings where there are no results in a list
774 # request for a particular zone, this key might be scope and
775 # the key value might be the zone name. Other examples might be a key
776 # indicating a deprecated resource and a suggested replacement, or a
777 # warning about invalid network settings (for example, if an instance
778 # attempts to perform IP forwarding but is not enabled for IP forwarding).
779 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
780 },
781 ],
782 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
783 },
784 ],
785 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
786 # applicable when performing per-zone operations.
787 }</pre>
788 </div>
789
790 <div class="method">
791 <code class="details" id="close">close()</code>
792 <pre>Close httplib2 connections.</pre>
793 </div>
794
795 <div class="method">
796 <code class="details" id="createSnapshot">createSnapshot(project, region, disk, body=None, guestFlush=None, requestId=None, x__xgafv=None)</code>
797 <pre>Creates a snapshot of a specified persistent disk. For regular snapshot
798 creation, consider using snapshots.insert
799 instead, as that method supports more features, such as creating snapshots
800 in a project different from the source disk project.
801
802 Args:
803 project: string, Project ID for this request. (required)
804 region: string, Name of the region for this request. (required)
805 disk: string, Name of the regional persistent disk to snapshot. (required)
806 body: object, The request body.
807 The object takes the form of:
808
809 { # Represents a Persistent Disk Snapshot resource.
810 #
811 # You can use snapshots to back up data on a regular interval. For more
812 # information, read Creating
813 # persistent disk snapshots.
814 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the snapshot. Valid values are
815 # ARM64 or X86_64.
816 &quot;autoCreated&quot;: True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
817 # applying resource policy on the target disk.
818 &quot;chainName&quot;: &quot;A String&quot;, # Creates the new snapshot in the snapshot chain labeled with the
819 # specified name. The chain name must be 1-63 characters long and comply
820 # with RFC1035. This is an uncommon option only for advanced service
821 # owners who needs to create separate snapshot chains, for example,
822 # for chargeback tracking. When you describe your snapshot resource, this
823 # field is visible only if it has a non-empty value.
824 &quot;creationSizeBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Size in bytes of the snapshot at creation time.
825 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
826 # text format.
827 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
828 # create the resource.
829 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Output only. [Output Only] Size of the source disk, specified in GB.
830 &quot;downloadBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
831 &quot;enableConfidentialCompute&quot;: True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
832 # [Output Only]: This field is not set by user, but from source disk.
833 &quot;guestFlush&quot;: True or False, # [Input Only] Whether to attempt an application consistent snapshot by
834 # informing the OS to prepare for the snapshot process.
835 &quot;guestOsFeatures&quot;: [ # Output only. [Output Only] A list of features to enable on the guest operating system.
836 # Applicable only for bootable images. Read
837 # Enabling guest operating system features to see a list of available
838 # options.
839 { # Guest OS features.
840 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
841 # separate values. Set to one or more of the following values:
842 #
843 # - VIRTIO_SCSI_MULTIQUEUE
844 # - WINDOWS
845 # - MULTI_IP_SUBNET
846 # - UEFI_COMPATIBLE
847 # - GVNIC
848 # - SEV_CAPABLE
849 # - SUSPEND_RESUME_COMPATIBLE
850 # - SEV_LIVE_MIGRATABLE_V2
851 # - SEV_SNP_CAPABLE
852 # - TDX_CAPABLE
853 # - IDPF
854 # - SNP_SVSM_CAPABLE
855 # - CCA_CAPABLE
856 #
857 #
858 # For more information, see
859 # Enabling guest operating system features.
860 },
861 ],
862 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
863 # defined by the server.
864 &quot;kind&quot;: &quot;compute#snapshot&quot;, # Output only. [Output Only] Type of the resource. Always compute#snapshot
865 # for Snapshot resources.
866 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this snapshot, which is
867 # essentially a hash of the labels set used for optimistic locking. The
868 # fingerprint is initially generated by Compute Engine and changes after
869 # every request to modify or update labels. You must always provide an
870 # up-to-date fingerprint hash in order to update or change labels,
871 # otherwise the request will fail with error412 conditionNotMet.
872 #
873 # To see the latest fingerprint, make a get() request to
874 # retrieve a snapshot.
875 &quot;labels&quot;: { # Labels to apply to this snapshot. These can be later modified by
876 # the setLabels method.
877 # Label values may be empty.
878 &quot;a_key&quot;: &quot;A String&quot;,
879 },
880 &quot;licenseCodes&quot;: [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
881 # to this snapshot.
882 &quot;A String&quot;,
883 ],
884 &quot;licenses&quot;: [ # Output only. [Output Only] A list of public visible licenses that apply to this
885 # snapshot. This can be because the original image had licenses attached
886 # (such as a Windows image).
887 &quot;A String&quot;,
888 ],
889 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the snapshot close to other
890 # resources.
891 # This field is for use by internal tools that use the public API.
892 &quot;maxRetentionDays&quot;: 42, # Number of days the snapshot should be retained before being deleted
893 # automatically.
894 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
895 # The name must be 1-63 characters long, and comply withRFC1035.
896 # Specifically, the name must be 1-63 characters long and match the regular
897 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
898 # character must be a lowercase letter, and all following characters must be
899 # a dash, lowercase letter, or digit, except the last character, which cannot
900 # be a dash.
901 &quot;params&quot;: { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted
902 # as part of resource payload.
903 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have
904 # the same definition as resource
905 # manager tags. Keys and values can be either in numeric format,
906 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
907 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
908 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
909 # PATCH) when empty.
910 &quot;a_key&quot;: &quot;A String&quot;,
911 },
912 },
913 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
914 # for regional snapshots.
915 &quot;resourceStatus&quot;: { # Output only. [Output only] ResourceStatus of the Snapshot resource
916 &quot;scheduledDeletionTime&quot;: &quot;A String&quot;, # Output only. [Output only] Scheduled deletion time of the snapshot. The snapshot will
917 # be deleted by the at any point within one hour after the deletion time.
918 },
919 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
920 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
921 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for the resource.
922 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
923 &quot;snapshotEncryptionKey&quot;: { # Encrypts the snapshot using acustomer-supplied
924 # encryption key.
925 #
926 # After you encrypt a snapshot using a customer-supplied key, you must
927 # provide the same key if you use the snapshot later. For example, you must
928 # provide the encryption key when you create a disk from the encrypted
929 # snapshot in a future request.
930 #
931 # Customer-supplied encryption keys do not protect access to metadata
932 # of the snapshot.
933 #
934 # If you do not provide an encryption key when creating the snapshot, then
935 # the snapshot will be encrypted using an automatically generated key and you
936 # do not need to provide a key to use the snapshot later.
937 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
938 # For example:
939 #
940 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
941 # key_region/cryptoKeys/key
942 #
943 # The fully-qualifed key name may be returned for resource GET requests. For
944 # example:
945 #
946 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
947 # key_region/cryptoKeys/key
948 # /cryptoKeyVersions/1
949 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
950 # key. If absent, the Compute Engine default service account is used.
951 # For example:
952 #
953 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
954 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
955 # encryption key, encoded in RFC
956 # 4648 base64 to either encrypt or decrypt this resource. You can
957 # provide either the rawKey or thersaEncryptedKey.
958 # For example:
959 #
960 # &quot;rawKey&quot;:
961 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
962 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
963 # customer-supplied encryption key to either encrypt or decrypt this
964 # resource. You can provide either the rawKey or thersaEncryptedKey.
965 # For example:
966 #
967 # &quot;rsaEncryptedKey&quot;:
968 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
969 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
970 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
971 #
972 # The key must meet the following requirements before you can provide it to
973 # Compute Engine:
974 #
975 # 1. The key is wrapped using a RSA public key certificate provided by
976 # Google.
977 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
978 # encoding.
979 #
980 # Gets the RSA public key certificate provided by Google at:
981 #
982 #
983 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
984 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
985 # 4648 base64 encoded SHA-256 hash of the customer-supplied
986 # encryption key that protects this resource.
987 },
988 &quot;snapshotGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot group that this snapshot
989 # belongs to. The usage of snapshot group feature is restricted.
990 &quot;snapshotGroupName&quot;: &quot;A String&quot;, # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
991 # of snapshot group feature is restricted.
992 &quot;snapshotType&quot;: &quot;A String&quot;, # Indicates the type of the snapshot.
993 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this snapshot.
994 &quot;sourceDiskEncryptionKey&quot;: { # The customer-supplied
995 # encryption key of the source disk. Required if the source disk is
996 # protected by a customer-supplied encryption key.
997 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
998 # For example:
999 #
1000 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1001 # key_region/cryptoKeys/key
1002 #
1003 # The fully-qualifed key name may be returned for resource GET requests. For
1004 # example:
1005 #
1006 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1007 # key_region/cryptoKeys/key
1008 # /cryptoKeyVersions/1
1009 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1010 # key. If absent, the Compute Engine default service account is used.
1011 # For example:
1012 #
1013 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1014 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1015 # encryption key, encoded in RFC
1016 # 4648 base64 to either encrypt or decrypt this resource. You can
1017 # provide either the rawKey or thersaEncryptedKey.
1018 # For example:
1019 #
1020 # &quot;rawKey&quot;:
1021 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1022 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1023 # customer-supplied encryption key to either encrypt or decrypt this
1024 # resource. You can provide either the rawKey or thersaEncryptedKey.
1025 # For example:
1026 #
1027 # &quot;rsaEncryptedKey&quot;:
1028 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1029 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1030 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1031 #
1032 # The key must meet the following requirements before you can provide it to
1033 # Compute Engine:
1034 #
1035 # 1. The key is wrapped using a RSA public key certificate provided by
1036 # Google.
1037 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1038 # encoding.
1039 #
1040 # Gets the RSA public key certificate provided by Google at:
1041 #
1042 #
1043 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1044 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1045 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1046 # encryption key that protects this resource.
1047 },
1048 &quot;sourceDiskForRecoveryCheckpoint&quot;: &quot;A String&quot;, # The source disk whose recovery checkpoint will be used to create this
1049 # snapshot.
1050 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
1051 # value may be used to determine whether the snapshot was taken from the
1052 # current or a previous instance of a given disk name.
1053 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this snapshot. You can provide
1054 # this as a partial or full URL to the resource. For example, the following
1055 # are valid values:
1056 #
1057 #
1058 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
1059 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
1060 # - zones/zone/instantSnapshots/instantSnapshot
1061 &quot;sourceInstantSnapshotEncryptionKey&quot;: { # Customer provided encryption key when creating Snapshot from Instant
1062 # Snapshot.
1063 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1064 # For example:
1065 #
1066 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1067 # key_region/cryptoKeys/key
1068 #
1069 # The fully-qualifed key name may be returned for resource GET requests. For
1070 # example:
1071 #
1072 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1073 # key_region/cryptoKeys/key
1074 # /cryptoKeyVersions/1
1075 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1076 # key. If absent, the Compute Engine default service account is used.
1077 # For example:
1078 #
1079 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1080 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1081 # encryption key, encoded in RFC
1082 # 4648 base64 to either encrypt or decrypt this resource. You can
1083 # provide either the rawKey or thersaEncryptedKey.
1084 # For example:
1085 #
1086 # &quot;rawKey&quot;:
1087 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1088 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1089 # customer-supplied encryption key to either encrypt or decrypt this
1090 # resource. You can provide either the rawKey or thersaEncryptedKey.
1091 # For example:
1092 #
1093 # &quot;rsaEncryptedKey&quot;:
1094 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1095 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1096 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1097 #
1098 # The key must meet the following requirements before you can provide it to
1099 # Compute Engine:
1100 #
1101 # 1. The key is wrapped using a RSA public key certificate provided by
1102 # Google.
1103 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1104 # encoding.
1105 #
1106 # Gets the RSA public key certificate provided by Google at:
1107 #
1108 #
1109 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1110 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1111 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1112 # encryption key that protects this resource.
1113 },
1114 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
1115 # snapshot. This value identifies the exact instant snapshot that was used to
1116 # create this snapshot. For example, if you created the snapshot from an
1117 # instant snapshot that was later deleted and recreated under the same name,
1118 # the source instant snapshot ID would identify the exact instant snapshot
1119 # that was used.
1120 &quot;sourceSnapshotSchedulePolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the resource policy which created this
1121 # scheduled snapshot.
1122 &quot;sourceSnapshotSchedulePolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the resource policy which created this
1123 # scheduled snapshot.
1124 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
1125 &quot;storageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
1126 # share storage, this number is expected to change with snapshot
1127 # creation/deletion.
1128 &quot;storageBytesStatus&quot;: &quot;A String&quot;, # Output only. [Deprecated] Instead, check the storageBytes field. After
1129 # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
1130 # [Output Only] An indicator whether storageBytes is in a
1131 # stable state or it is being adjusted as a result of shared storage
1132 # reallocation. This status can either be unset, meaning the snapshot is
1133 # being created, or UP_TO_DATE, meaning the size of the snapshot
1134 # is up-to-date.
1135 &quot;storageLocations&quot;: [ # Cloud Storage bucket storage location of the snapshot (regional or
1136 # multi-regional).
1137 &quot;A String&quot;,
1138 ],
1139 }
1140
1141 guestFlush: boolean, [Input Only] Specifies to create an application consistent snapshot by
1142 informing the OS to prepare for the snapshot process.
1143 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1144 that if you must retry your request, the server will know to ignore the
1145 request if it has already been completed.
1146
1147 For example, consider a situation where you make an initial request and
1148 the request times out. If you make the request again with the same
1149 request ID, the server can check if original operation with the same
1150 request ID was received, and if so, will ignore the second request. This
1151 prevents clients from accidentally creating duplicate commitments.
1152
1153 The request ID must be
1154 a valid UUID with the exception that zero UUID is not supported
1155 (00000000-0000-0000-0000-000000000000).
1156 x__xgafv: string, V1 error format.
1157 Allowed values
1158 1 - v1 error format
1159 2 - v2 error format
1160
1161 Returns:
1162 An object of the form:
1163
1164 { # Represents an Operation resource.
1165 #
1166 # Google Compute Engine has three Operation resources:
1167 #
1168 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1169 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1170 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1171 #
1172 # You can use an operation resource to manage asynchronous API requests.
1173 # For more information, readHandling
1174 # API responses.
1175 #
1176 # Operations can be global, regional or zonal.
1177 #
1178 # - For global operations, use the `globalOperations`
1179 # resource.
1180 # - For regional operations, use the
1181 # `regionOperations` resource.
1182 # - For zonal operations, use
1183 # the `zoneOperations` resource.
1184 #
1185 #
1186 #
1187 # For more information, read
1188 # Global, Regional, and Zonal Resources.
1189 #
1190 # Note that completed Operation resources have a limited
1191 # retention period.
1192 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1193 # Not present otherwise.
1194 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1195 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1196 # set when the operation is created.
1197 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1198 # text format.
1199 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1200 # this field will be populated.
1201 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1202 # operation.
1203 {
1204 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1205 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1206 # details. There is a set of defined message types to use for providing
1207 # details.The syntax depends on the error code. For example,
1208 # QuotaExceededInfo will have details when the error code is
1209 # QUOTA_EXCEEDED.
1210 {
1211 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1212 #
1213 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1214 # is not enabled:
1215 #
1216 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1217 # &quot;domain&quot;: &quot;googleapis.com&quot;
1218 # &quot;metadata&quot;: {
1219 # &quot;resource&quot;: &quot;projects/123&quot;,
1220 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1221 # }
1222 # }
1223 #
1224 # This response indicates that the pubsub.googleapis.com API is not enabled.
1225 #
1226 # Example of an error that is returned when attempting to create a Spanner
1227 # instance in a region that is out of stock:
1228 #
1229 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1230 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1231 # &quot;metadata&quot;: {
1232 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1233 # }
1234 # }
1235 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1236 # is typically the registered service name of the tool or product that
1237 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1238 # generated by some common infrastructure, the error domain must be a
1239 # globally unique value that identifies the infrastructure. For Google API
1240 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1241 &quot;metadatas&quot;: { # Additional structured details about this error.
1242 #
1243 # Keys must match a regular expression of `a-z+` but should
1244 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1245 # length. When identifying the current value of an exceeded limit, the units
1246 # should be contained in the key, not the value. For example, rather than
1247 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1248 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1249 # instances that can be created in a single (batch) request.
1250 &quot;a_key&quot;: &quot;A String&quot;,
1251 },
1252 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1253 # proximate cause of the error. Error reasons are unique within a particular
1254 # domain of errors. This should be at most 63 characters and match a
1255 # regular expression of `A-Z+[A-Z0-9]`, which represents
1256 # UPPER_SNAKE_CASE.
1257 },
1258 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1259 #
1260 # For example, if a quota check failed with an error indicating the calling
1261 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1262 # directly to the right place in the developer console to flip the bit.
1263 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1264 { # Describes a URL link.
1265 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1266 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1267 },
1268 ],
1269 },
1270 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1271 # which can be attached to an RPC error.
1272 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1273 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1274 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1275 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1276 },
1277 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1278 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1279 &quot;a_key&quot;: &quot;A String&quot;,
1280 },
1281 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1282 # type or metric.
1283 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1284 # or metric.
1285 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1286 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1287 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1288 },
1289 },
1290 ],
1291 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1292 # This property is optional.
1293 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1294 },
1295 ],
1296 },
1297 &quot;getVersionOperationMetadata&quot;: {
1298 &quot;inlineSbomInfo&quot;: {
1299 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1300 # appropriate identifiers.
1301 &quot;a_key&quot;: &quot;A String&quot;,
1302 },
1303 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1304 # identifiers.
1305 &quot;a_key&quot;: &quot;A String&quot;,
1306 },
1307 },
1308 },
1309 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1310 # message that was returned, such as `NOT FOUND`.
1311 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1312 # status code that was returned. For example, a `404` means the
1313 # resource was not found.
1314 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1315 # defined by the server.
1316 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1317 # This value is inRFC3339
1318 # text format.
1319 &quot;instancesBulkInsertOperationMetadata&quot;: {
1320 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1321 # Example key: zones/us-central1-a
1322 &quot;a_key&quot;: {
1323 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1324 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1325 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1326 # error.
1327 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1328 # if the flow is rolling forward or rolling back.
1329 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1330 },
1331 },
1332 },
1333 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1334 # Operation resources.
1335 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1336 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1337 # group of operations results from a `bulkInsert` API request.
1338 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1339 # `update`, or `delete`, and so on.
1340 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1341 # There is no requirement that this be linear or support any granularity of
1342 # operations. This should not be used to guess when the operation will be
1343 # complete. This number should monotonically increase as the operation
1344 # progresses.
1345 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1346 # applicable when performing regional operations.
1347 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1348 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1349 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1350 # this field will contain information on all underlying zonal actions and
1351 # their state.
1352 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1353 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1354 # Example key: zones/us-central1-a
1355 &quot;a_key&quot;: {
1356 &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
1357 # populated.
1358 # different programming environments, including REST APIs and RPC APIs. It is
1359 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1360 # three pieces of data: error code, error message, and error details.
1361 #
1362 # You can find out more about this error model and how to work with it in the
1363 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1364 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1365 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1366 # message types for APIs to use.
1367 {
1368 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1369 },
1370 ],
1371 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1372 # user-facing error message should be localized and sent in the
1373 # google.rpc.Status.details field, or localized by the client.
1374 },
1375 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1376 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1377 },
1378 },
1379 },
1380 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1381 # This value is inRFC3339
1382 # text format.
1383 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1384 # following:
1385 # `PENDING`, `RUNNING`, or `DONE`.
1386 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1387 # operation.
1388 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1389 # of the target resource.
1390 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1391 # operations related to creating a snapshot, this points to the disk
1392 # that the snapshot was created from.
1393 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1394 # `[email protected]` or
1395 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1396 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1397 # operation, this field will be populated.
1398 {
1399 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1400 # Engine returns NO_RESULTS_ON_PAGE if there
1401 # are no results in the response.
1402 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1403 # value format. For example:
1404 #
1405 # &quot;data&quot;: [
1406 # {
1407 # &quot;key&quot;: &quot;scope&quot;,
1408 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1409 # }
1410 {
1411 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1412 # returned. For example, for warnings where there are no results in a list
1413 # request for a particular zone, this key might be scope and
1414 # the key value might be the zone name. Other examples might be a key
1415 # indicating a deprecated resource and a suggested replacement, or a
1416 # warning about invalid network settings (for example, if an instance
1417 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1418 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1419 },
1420 ],
1421 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1422 },
1423 ],
1424 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1425 # applicable when performing per-zone operations.
1426 }</pre>
1427 </div>
1428
1429 <div class="method">
1430 <code class="details" id="delete">delete(project, region, disk, requestId=None, x__xgafv=None)</code>
1431 <pre>Deletes the specified regional persistent disk. Deleting a regional disk
1432 removes all the replicas of its data permanently and is irreversible.
1433 However, deleting a disk does not delete anysnapshots
1434 previously made from the disk. You must separatelydelete
1435 snapshots.
1436
1437 Args:
1438 project: string, Project ID for this request. (required)
1439 region: string, Name of the region for this request. (required)
1440 disk: string, Name of the regional persistent disk to delete. (required)
1441 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1442 that if you must retry your request, the server will know to ignore the
1443 request if it has already been completed.
1444
1445 For example, consider a situation where you make an initial request and
1446 the request times out. If you make the request again with the same
1447 request ID, the server can check if original operation with the same
1448 request ID was received, and if so, will ignore the second request. This
1449 prevents clients from accidentally creating duplicate commitments.
1450
1451 The request ID must be
1452 a valid UUID with the exception that zero UUID is not supported
1453 (00000000-0000-0000-0000-000000000000).
1454 x__xgafv: string, V1 error format.
1455 Allowed values
1456 1 - v1 error format
1457 2 - v2 error format
1458
1459 Returns:
1460 An object of the form:
1461
1462 { # Represents an Operation resource.
1463 #
1464 # Google Compute Engine has three Operation resources:
1465 #
1466 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1467 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1468 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1469 #
1470 # You can use an operation resource to manage asynchronous API requests.
1471 # For more information, readHandling
1472 # API responses.
1473 #
1474 # Operations can be global, regional or zonal.
1475 #
1476 # - For global operations, use the `globalOperations`
1477 # resource.
1478 # - For regional operations, use the
1479 # `regionOperations` resource.
1480 # - For zonal operations, use
1481 # the `zoneOperations` resource.
1482 #
1483 #
1484 #
1485 # For more information, read
1486 # Global, Regional, and Zonal Resources.
1487 #
1488 # Note that completed Operation resources have a limited
1489 # retention period.
1490 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1491 # Not present otherwise.
1492 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1493 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1494 # set when the operation is created.
1495 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1496 # text format.
1497 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1498 # this field will be populated.
1499 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1500 # operation.
1501 {
1502 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1503 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1504 # details. There is a set of defined message types to use for providing
1505 # details.The syntax depends on the error code. For example,
1506 # QuotaExceededInfo will have details when the error code is
1507 # QUOTA_EXCEEDED.
1508 {
1509 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1510 #
1511 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1512 # is not enabled:
1513 #
1514 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1515 # &quot;domain&quot;: &quot;googleapis.com&quot;
1516 # &quot;metadata&quot;: {
1517 # &quot;resource&quot;: &quot;projects/123&quot;,
1518 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1519 # }
1520 # }
1521 #
1522 # This response indicates that the pubsub.googleapis.com API is not enabled.
1523 #
1524 # Example of an error that is returned when attempting to create a Spanner
1525 # instance in a region that is out of stock:
1526 #
1527 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1528 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1529 # &quot;metadata&quot;: {
1530 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1531 # }
1532 # }
1533 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1534 # is typically the registered service name of the tool or product that
1535 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1536 # generated by some common infrastructure, the error domain must be a
1537 # globally unique value that identifies the infrastructure. For Google API
1538 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1539 &quot;metadatas&quot;: { # Additional structured details about this error.
1540 #
1541 # Keys must match a regular expression of `a-z+` but should
1542 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1543 # length. When identifying the current value of an exceeded limit, the units
1544 # should be contained in the key, not the value. For example, rather than
1545 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1546 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1547 # instances that can be created in a single (batch) request.
1548 &quot;a_key&quot;: &quot;A String&quot;,
1549 },
1550 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1551 # proximate cause of the error. Error reasons are unique within a particular
1552 # domain of errors. This should be at most 63 characters and match a
1553 # regular expression of `A-Z+[A-Z0-9]`, which represents
1554 # UPPER_SNAKE_CASE.
1555 },
1556 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1557 #
1558 # For example, if a quota check failed with an error indicating the calling
1559 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1560 # directly to the right place in the developer console to flip the bit.
1561 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1562 { # Describes a URL link.
1563 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1564 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1565 },
1566 ],
1567 },
1568 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1569 # which can be attached to an RPC error.
1570 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1571 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1572 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1573 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1574 },
1575 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1576 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1577 &quot;a_key&quot;: &quot;A String&quot;,
1578 },
1579 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1580 # type or metric.
1581 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1582 # or metric.
1583 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1584 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1585 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1586 },
1587 },
1588 ],
1589 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1590 # This property is optional.
1591 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1592 },
1593 ],
1594 },
1595 &quot;getVersionOperationMetadata&quot;: {
1596 &quot;inlineSbomInfo&quot;: {
1597 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1598 # appropriate identifiers.
1599 &quot;a_key&quot;: &quot;A String&quot;,
1600 },
1601 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1602 # identifiers.
1603 &quot;a_key&quot;: &quot;A String&quot;,
1604 },
1605 },
1606 },
1607 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1608 # message that was returned, such as `NOT FOUND`.
1609 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1610 # status code that was returned. For example, a `404` means the
1611 # resource was not found.
1612 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1613 # defined by the server.
1614 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1615 # This value is inRFC3339
1616 # text format.
1617 &quot;instancesBulkInsertOperationMetadata&quot;: {
1618 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1619 # Example key: zones/us-central1-a
1620 &quot;a_key&quot;: {
1621 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1622 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1623 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1624 # error.
1625 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1626 # if the flow is rolling forward or rolling back.
1627 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1628 },
1629 },
1630 },
1631 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1632 # Operation resources.
1633 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1634 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1635 # group of operations results from a `bulkInsert` API request.
1636 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1637 # `update`, or `delete`, and so on.
1638 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1639 # There is no requirement that this be linear or support any granularity of
1640 # operations. This should not be used to guess when the operation will be
1641 # complete. This number should monotonically increase as the operation
1642 # progresses.
1643 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1644 # applicable when performing regional operations.
1645 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1646 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1647 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1648 # this field will contain information on all underlying zonal actions and
1649 # their state.
1650 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1651 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1652 # Example key: zones/us-central1-a
1653 &quot;a_key&quot;: {
1654 &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
1655 # populated.
1656 # different programming environments, including REST APIs and RPC APIs. It is
1657 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1658 # three pieces of data: error code, error message, and error details.
1659 #
1660 # You can find out more about this error model and how to work with it in the
1661 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1662 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1663 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1664 # message types for APIs to use.
1665 {
1666 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1667 },
1668 ],
1669 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1670 # user-facing error message should be localized and sent in the
1671 # google.rpc.Status.details field, or localized by the client.
1672 },
1673 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1674 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1675 },
1676 },
1677 },
1678 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1679 # This value is inRFC3339
1680 # text format.
1681 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1682 # following:
1683 # `PENDING`, `RUNNING`, or `DONE`.
1684 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1685 # operation.
1686 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1687 # of the target resource.
1688 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1689 # operations related to creating a snapshot, this points to the disk
1690 # that the snapshot was created from.
1691 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1692 # `[email protected]` or
1693 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1694 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1695 # operation, this field will be populated.
1696 {
1697 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1698 # Engine returns NO_RESULTS_ON_PAGE if there
1699 # are no results in the response.
1700 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1701 # value format. For example:
1702 #
1703 # &quot;data&quot;: [
1704 # {
1705 # &quot;key&quot;: &quot;scope&quot;,
1706 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1707 # }
1708 {
1709 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1710 # returned. For example, for warnings where there are no results in a list
1711 # request for a particular zone, this key might be scope and
1712 # the key value might be the zone name. Other examples might be a key
1713 # indicating a deprecated resource and a suggested replacement, or a
1714 # warning about invalid network settings (for example, if an instance
1715 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1716 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1717 },
1718 ],
1719 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1720 },
1721 ],
1722 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1723 # applicable when performing per-zone operations.
1724 }</pre>
1725 </div>
1726
1727 <div class="method">
1728 <code class="details" id="get">get(project, region, disk, x__xgafv=None)</code>
1729 <pre>Returns a specified regional persistent disk.
1730
1731 Args:
1732 project: string, Project ID for this request. (required)
1733 region: string, Name of the region for this request. (required)
1734 disk: string, Name of the regional persistent disk to return. (required)
1735 x__xgafv: string, V1 error format.
1736 Allowed values
1737 1 - v1 error format
1738 2 - v2 error format
1739
1740 Returns:
1741 An object of the form:
1742
1743 { # Represents a Persistent Disk resource.
1744 #
1745 # Google Compute Engine has two Disk resources:
1746 #
1747 # * [Zonal](/compute/docs/reference/rest/alpha/disks)
1748 # * [Regional](/compute/docs/reference/rest/alpha/regionDisks)
1749 #
1750 # Persistent disks are required for running your VM instances.
1751 # Create both boot and non-boot (data) persistent disks. For more information,
1752 # read Persistent Disks. For more
1753 # storage options, read Storage options.
1754 #
1755 # The disks resource represents a zonal persistent disk.
1756 # For more information, readZonal persistent disks.
1757 #
1758 # The regionDisks resource represents a
1759 # regional persistent disk. For more information, read
1760 # Regional resources.
1761 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
1762 #
1763 #
1764 # - READ_WRITE_SINGLE: The default AccessMode, means the
1765 # disk can be attached to single instance in RW mode.
1766 # - READ_WRITE_MANY: The AccessMode means the disk can be
1767 # attached to multiple instances in RW mode.
1768 # - READ_ONLY_MANY: The AccessMode means the disk can be
1769 # attached to multiple instances in RO mode.
1770 #
1771 #
1772 # The AccessMode is only valid for Hyperdisk disk types.
1773 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
1774 # ARM64 or X86_64.
1775 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
1776 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
1777 # started on the disk as a member of a group.
1778 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
1779 # started on the disk as a member of a group.
1780 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
1781 # You can provide this as a partial or full URL to the resource.
1782 # For example, the following are valid values:
1783 #
1784 #
1785 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
1786 # - projects/project/zones/zone/disks/disk
1787 # - zones/zone/disks/disk
1788 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
1789 # to or from the current disk. This value identifies the exact disk that
1790 # was used to create this replication. For example, if you started
1791 # replicating the persistent disk from a disk that was later deleted and
1792 # recreated under the same name, the disk ID would identify the exact
1793 # version of the disk that was used.
1794 },
1795 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
1796 &quot;a_key&quot;: {
1797 &quot;asyncReplicationDisk&quot;: {
1798 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
1799 # started on the disk as a member of a group.
1800 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
1801 # started on the disk as a member of a group.
1802 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
1803 # You can provide this as a partial or full URL to the resource.
1804 # For example, the following are valid values:
1805 #
1806 #
1807 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
1808 # - projects/project/zones/zone/disks/disk
1809 # - zones/zone/disks/disk
1810 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
1811 # to or from the current disk. This value identifies the exact disk that
1812 # was used to create this replication. For example, if you started
1813 # replicating the persistent disk from a disk that was later deleted and
1814 # recreated under the same name, the disk ID would identify the exact
1815 # version of the disk that was used.
1816 },
1817 },
1818 },
1819 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
1820 # text format.
1821 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1822 # create the resource.
1823 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
1824 # customer-supplied encryption key or a
1825 # customer-managed encryption key.
1826 #
1827 # Encryption keys do not protect access to metadata of the disk.
1828 #
1829 # After you encrypt a disk with a customer-supplied key, you must provide the
1830 # same key if you use the disk later. For example, to create a disk snapshot,
1831 # to create a disk image, to create a machine image, or to attach the disk to
1832 # a virtual machine.
1833 #
1834 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
1835 # name once the disk is created. The disk is encrypted with this version of
1836 # the key. In the response, diskEncryptionKey.kmsKeyName appears
1837 # in the following format:
1838 #
1839 # &quot;diskEncryptionKey.kmsKeyName&quot;:
1840 # &quot;projects/kms_project_id/locations/region/keyRings/
1841 # key_region/cryptoKeys/key
1842 # /cryptoKeysVersions/version
1843 #
1844 # If you do not provide an encryption key when creating the disk, then the
1845 # disk is encrypted using an automatically generated key and you don&#x27;t need
1846 # to provide a key to use the disk later.
1847 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1848 # For example:
1849 #
1850 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1851 # key_region/cryptoKeys/key
1852 #
1853 # The fully-qualifed key name may be returned for resource GET requests. For
1854 # example:
1855 #
1856 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1857 # key_region/cryptoKeys/key
1858 # /cryptoKeyVersions/1
1859 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1860 # key. If absent, the Compute Engine default service account is used.
1861 # For example:
1862 #
1863 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1864 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1865 # encryption key, encoded in RFC
1866 # 4648 base64 to either encrypt or decrypt this resource. You can
1867 # provide either the rawKey or thersaEncryptedKey.
1868 # For example:
1869 #
1870 # &quot;rawKey&quot;:
1871 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1872 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1873 # customer-supplied encryption key to either encrypt or decrypt this
1874 # resource. You can provide either the rawKey or thersaEncryptedKey.
1875 # For example:
1876 #
1877 # &quot;rsaEncryptedKey&quot;:
1878 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1879 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1880 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1881 #
1882 # The key must meet the following requirements before you can provide it to
1883 # Compute Engine:
1884 #
1885 # 1. The key is wrapped using a RSA public key certificate provided by
1886 # Google.
1887 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1888 # encoding.
1889 #
1890 # Gets the RSA public key certificate provided by Google at:
1891 #
1892 #
1893 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1894 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1895 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1896 # encryption key that protects this resource.
1897 },
1898 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
1899 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
1900 # Windows specific VSS signature.
1901 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
1902 # only for bootable images. Read
1903 # Enabling guest operating system features to see a list of available
1904 # options.
1905 { # Guest OS features.
1906 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
1907 # separate values. Set to one or more of the following values:
1908 #
1909 # - VIRTIO_SCSI_MULTIQUEUE
1910 # - WINDOWS
1911 # - MULTI_IP_SUBNET
1912 # - UEFI_COMPATIBLE
1913 # - GVNIC
1914 # - SEV_CAPABLE
1915 # - SUSPEND_RESUME_COMPATIBLE
1916 # - SEV_LIVE_MIGRATABLE_V2
1917 # - SEV_SNP_CAPABLE
1918 # - TDX_CAPABLE
1919 # - IDPF
1920 # - SNP_SVSM_CAPABLE
1921 # - CCA_CAPABLE
1922 #
1923 #
1924 # For more information, see
1925 # Enabling guest operating system features.
1926 },
1927 ],
1928 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
1929 # defined by the server.
1930 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
1931 # which is either SCSI or NVME. The default isSCSI.
1932 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
1933 # disks.
1934 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
1935 # essentially a hash of the labels set used for optimistic locking. The
1936 # fingerprint is initially generated by Compute Engine and changes after
1937 # every request to modify or update labels. You must always provide an
1938 # up-to-date fingerprint hash in order to update or change labels,
1939 # otherwise the request will fail with error412 conditionNotMet.
1940 #
1941 # To see the latest fingerprint, make a get() request to
1942 # retrieve a disk.
1943 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
1944 # the setLabels method.
1945 &quot;a_key&quot;: &quot;A String&quot;,
1946 },
1947 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
1948 # text format.
1949 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
1950 # text format.
1951 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
1952 &quot;A String&quot;,
1953 ],
1954 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
1955 &quot;A String&quot;,
1956 ],
1957 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
1958 # This field is for use by internal tools that use the public API.
1959 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
1960 # source image. Attachment of a disk created from a locked source image will
1961 # cause the following operations to become irreversibly prohibited:
1962 #
1963 # - R/W or R/O disk attachment to any other instance
1964 # - Disk detachment. And the disk can only be deleted when the instance
1965 # is deleted
1966 # - Creation of images or snapshots
1967 # - Disk cloning
1968 #
1969 #
1970 #
1971 # Furthermore, the instance with at least one disk with locked flag set to
1972 # true will be prohibited from performing the operations below:
1973 #
1974 # - Further attachment of secondary disks.
1975 # - Detachment of any disks
1976 # - Create machine images
1977 # - Create instance template
1978 # - Delete the instance with --keep-disk parameter set to true for locked
1979 # disks
1980 # - Attach a locked disk with --auto-delete parameter set to false
1981 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
1982 # more than one instance.
1983 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1984 # The name must be 1-63 characters long, and comply withRFC1035.
1985 # Specifically, the name must be 1-63 characters long and match the regular
1986 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
1987 # which means the first character must be a lowercase letter, and all
1988 # following characters must be a dash, lowercase letter, or digit, except
1989 # the last character, which cannot be a dash.
1990 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
1991 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
1992 # as part of resource payload.
1993 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
1994 # have the same definition as resource
1995 # manager tags. Keys and values can be either in numeric format,
1996 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1997 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1998 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
1999 # PATCH) when empty.
2000 &quot;a_key&quot;: &quot;A String&quot;,
2001 },
2002 },
2003 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
2004 # If not present in a request, a default value is used.
2005 # The currently supported size is 4096, other sizes may be added in
2006 # the future.
2007 # If an unsupported value is requested, the error message will list
2008 # the supported values for the caller&#x27;s project.
2009 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
2010 # of I/O operations per second that the disk can handle. Values must be
2011 # between 10,000 and 120,000. For more details, see theExtreme persistent
2012 # disk documentation.
2013 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
2014 # number of throughput mb per second that the disk can handle. Values must be
2015 # greater than or equal to 1.
2016 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
2017 # regional resources.
2018 # You must specify this field as part of the HTTP request URL. It is
2019 # not settable as a field in the request body.
2020 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
2021 # for regional resources.
2022 &quot;A String&quot;,
2023 ],
2024 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
2025 &quot;A String&quot;,
2026 ],
2027 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
2028 &quot;asyncPrimaryDisk&quot;: {
2029 &quot;state&quot;: &quot;A String&quot;,
2030 },
2031 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
2032 &quot;a_key&quot;: {
2033 &quot;state&quot;: &quot;A String&quot;,
2034 },
2035 },
2036 &quot;usedBytes&quot;: &quot;A String&quot;, # [Output Only] Space used by data stored in the disk (in bytes). Note that
2037 # this field is set only when the disk is in a storage pool.
2038 },
2039 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
2040 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
2041 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
2042 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
2043 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
2044 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
2045 # persistent disk.
2046 #
2047 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
2048 # source.
2049 # Acceptable values are greater than 0.
2050 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
2051 # that was created using a consistency group.
2052 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
2053 # that was created using a consistency group.
2054 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
2055 # partial or full URL to the resource. For example, the following are valid
2056 # values:
2057 #
2058 #
2059 # -
2060 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
2061 #
2062 # -
2063 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
2064 #
2065 # -
2066 # projects/project/zones/zone/disks/disk
2067 #
2068 # -
2069 # projects/project/regions/region/disks/disk
2070 #
2071 # -
2072 # zones/zone/disks/disk
2073 #
2074 # -
2075 # regions/region/disks/disk
2076 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
2077 # value identifies the exact disk that was used to create this persistent
2078 # disk. For example, if you created the persistent disk from a disk that
2079 # was later deleted and recreated under the same name, the source disk ID
2080 # would identify the exact version of the disk that was used.
2081 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
2082 # deleted, this field will not be set.
2083 #
2084 # To create a disk with one of the public operating system images, specify
2085 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
2086 #
2087 # projects/debian-cloud/global/images/family/debian-9
2088 #
2089 #
2090 # Alternatively, use a specific version of a public operating system image:
2091 #
2092 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
2093 #
2094 #
2095 # To create a disk with a custom image that you created, specify the
2096 # image name in the following format:
2097 #
2098 # global/images/my-custom-image
2099 #
2100 #
2101 # You can also specify a custom image by its image family, which returns
2102 # the latest version of the image in that family. Replace the image name
2103 # with family/family-name:
2104 #
2105 # global/images/family/my-image-family
2106 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
2107 # encryption key of the source image. Required if the source image is
2108 # protected by a customer-supplied encryption key.
2109 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2110 # For example:
2111 #
2112 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2113 # key_region/cryptoKeys/key
2114 #
2115 # The fully-qualifed key name may be returned for resource GET requests. For
2116 # example:
2117 #
2118 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2119 # key_region/cryptoKeys/key
2120 # /cryptoKeyVersions/1
2121 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2122 # key. If absent, the Compute Engine default service account is used.
2123 # For example:
2124 #
2125 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2126 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2127 # encryption key, encoded in RFC
2128 # 4648 base64 to either encrypt or decrypt this resource. You can
2129 # provide either the rawKey or thersaEncryptedKey.
2130 # For example:
2131 #
2132 # &quot;rawKey&quot;:
2133 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2134 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2135 # customer-supplied encryption key to either encrypt or decrypt this
2136 # resource. You can provide either the rawKey or thersaEncryptedKey.
2137 # For example:
2138 #
2139 # &quot;rsaEncryptedKey&quot;:
2140 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2141 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2142 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2143 #
2144 # The key must meet the following requirements before you can provide it to
2145 # Compute Engine:
2146 #
2147 # 1. The key is wrapped using a RSA public key certificate provided by
2148 # Google.
2149 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2150 # encoding.
2151 #
2152 # Gets the RSA public key certificate provided by Google at:
2153 #
2154 #
2155 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2156 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2157 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2158 # encryption key that protects this resource.
2159 },
2160 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
2161 # value identifies the exact image that was used to create this persistent
2162 # disk. For example, if you created the persistent disk from an image that
2163 # was later deleted and recreated under the same name, the source image ID
2164 # would identify the exact version of the image that was used.
2165 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
2166 # this as a partial or full URL to the resource. For example, the following
2167 # are valid values:
2168 #
2169 #
2170 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
2171 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
2172 # - zones/zone/instantSnapshots/instantSnapshot
2173 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
2174 # disk. This value identifies the exact instant snapshot that was used to
2175 # create this persistent disk. For example, if you created the persistent
2176 # disk from an instant snapshot that was later deleted and recreated under
2177 # the same name, the source instant snapshot ID would identify the exact
2178 # version of the instant snapshot that was used.
2179 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
2180 # partial or full URL to the resource. For example, the following are valid
2181 # values:
2182 #
2183 #
2184 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
2185 # - projects/project/global/machineImages/machineImage
2186 # - global/machineImages/machineImage
2187 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
2188 # source_machine_image must be specified.
2189 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
2190 # encryption key of the source machine image. Required if the source
2191 # machine image is protected by a customer-supplied encryption key.
2192 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2193 # For example:
2194 #
2195 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2196 # key_region/cryptoKeys/key
2197 #
2198 # The fully-qualifed key name may be returned for resource GET requests. For
2199 # example:
2200 #
2201 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2202 # key_region/cryptoKeys/key
2203 # /cryptoKeyVersions/1
2204 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2205 # key. If absent, the Compute Engine default service account is used.
2206 # For example:
2207 #
2208 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2209 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2210 # encryption key, encoded in RFC
2211 # 4648 base64 to either encrypt or decrypt this resource. You can
2212 # provide either the rawKey or thersaEncryptedKey.
2213 # For example:
2214 #
2215 # &quot;rawKey&quot;:
2216 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2217 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2218 # customer-supplied encryption key to either encrypt or decrypt this
2219 # resource. You can provide either the rawKey or thersaEncryptedKey.
2220 # For example:
2221 #
2222 # &quot;rsaEncryptedKey&quot;:
2223 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2224 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2225 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2226 #
2227 # The key must meet the following requirements before you can provide it to
2228 # Compute Engine:
2229 #
2230 # 1. The key is wrapped using a RSA public key certificate provided by
2231 # Google.
2232 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2233 # encoding.
2234 #
2235 # Gets the RSA public key certificate provided by Google at:
2236 #
2237 #
2238 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2239 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2240 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2241 # encryption key that protects this resource.
2242 },
2243 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
2244 # This value identifies the exact machine image that was used to create this
2245 # persistent disk. For example, if you created the persistent disk from a
2246 # machine image that was later deleted and recreated under the same name, the
2247 # source machine image ID would identify the exact version of the machine
2248 # image that was used.
2249 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
2250 # partial or full URL to the resource. For example, the following are valid
2251 # values:
2252 #
2253 #
2254 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
2255 # - projects/project/global/snapshots/snapshot
2256 # - global/snapshots/snapshot
2257 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
2258 # encryption key of the source snapshot. Required if the source snapshot
2259 # is protected by a customer-supplied encryption key.
2260 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2261 # For example:
2262 #
2263 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2264 # key_region/cryptoKeys/key
2265 #
2266 # The fully-qualifed key name may be returned for resource GET requests. For
2267 # example:
2268 #
2269 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2270 # key_region/cryptoKeys/key
2271 # /cryptoKeyVersions/1
2272 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2273 # key. If absent, the Compute Engine default service account is used.
2274 # For example:
2275 #
2276 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2277 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2278 # encryption key, encoded in RFC
2279 # 4648 base64 to either encrypt or decrypt this resource. You can
2280 # provide either the rawKey or thersaEncryptedKey.
2281 # For example:
2282 #
2283 # &quot;rawKey&quot;:
2284 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2285 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2286 # customer-supplied encryption key to either encrypt or decrypt this
2287 # resource. You can provide either the rawKey or thersaEncryptedKey.
2288 # For example:
2289 #
2290 # &quot;rsaEncryptedKey&quot;:
2291 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2292 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2293 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2294 #
2295 # The key must meet the following requirements before you can provide it to
2296 # Compute Engine:
2297 #
2298 # 1. The key is wrapped using a RSA public key certificate provided by
2299 # Google.
2300 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2301 # encoding.
2302 #
2303 # Gets the RSA public key certificate provided by Google at:
2304 #
2305 #
2306 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2307 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2308 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2309 # encryption key that protects this resource.
2310 },
2311 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
2312 # value identifies the exact snapshot that was used to create this persistent
2313 # disk. For example, if you created the persistent disk from a snapshot that
2314 # was later deleted and recreated under the same name, the source snapshot ID
2315 # would identify the exact version of the snapshot that was used.
2316 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
2317 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
2318 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
2319 # https://storage.googleapis.com/. This flag is not optimized for creating
2320 # multiple disks from a source storage object. To create many disks from a
2321 # source storage object, use gcloud compute images
2322 # import instead.
2323 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
2324 #
2325 #
2326 # - CREATING: Disk is provisioning.
2327 # - RESTORING: Source data is being copied into the
2328 # disk.
2329 # - FAILED: Disk creation failed.
2330 # - READY: Disk is ready for use.
2331 # - DELETING: Disk is deleting.
2332 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
2333 # this as a partial or full URL to the resource. For example, the following
2334 # are valid values:
2335 #
2336 #
2337 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
2338 # - projects/project/zones/zone/storagePools/storagePool
2339 # - zones/zone/storagePools/storagePool
2340 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
2341 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
2342 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
2343 # types.
2344 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
2345 # in form:projects/project/zones/zone/instances/instance
2346 &quot;A String&quot;,
2347 ],
2348 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
2349 # You must specify this field as part of the HTTP request URL. It is
2350 # not settable as a field in the request body.
2351 }</pre>
2352 </div>
2353
2354 <div class="method">
2355 <code class="details" id="getAsyncReplicationStatus">getAsyncReplicationStatus(project, region, disk, x__xgafv=None)</code>
2356 <pre>Gets the status of current async replication for a given device.
2357
2358 Args:
2359 project: string, Project ID for this request. (required)
2360 region: string, The name of the zone for this request. (required)
2361 disk: string, Name of the Disk resource whose Async replication details are requested.
2362 Name should conform to RFC1035 or be an unsigned long integer. (required)
2363 x__xgafv: string, V1 error format.
2364 Allowed values
2365 1 - v1 error format
2366 2 - v2 error format
2367
2368 Returns:
2369 An object of the form:
2370
2371 {
2372 &quot;asyncReplicationStatus&quot;: {
2373 &quot;diskPairReplicationState&quot;: {
2374 &quot;dataReplicationState&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
2375 #
2376 #
2377 # - ASYNC_REPLICATION_STATE_INITIALIZING: The device is
2378 # doing the initial replication after starting the
2379 # replication.
2380 #
2381 # - ASYNC_REPLICATION_STATE_REPLICATING_HEALTHY: The
2382 # primary disk is healthily replicating to the secondary device i.e.
2383 # last_replication_time is within RPO.
2384 #
2385 # - ASYNC_REPLICATION_STATE_REPLICATING_BEHIND_HIGH_CHURN:
2386 # The replication is lagging above the SLO limit due to the disk&#x27;s change
2387 # rate being above the supported limit.
2388 #
2389 # - ASYNC_REPLICATION_STATE_REPLICATING_BEHIND_SYSTEM_LAGGING:
2390 # The replication is lagging, and the RPO is not being met due to some
2391 # internal issue.
2392 #
2393 # - ASYNC_REPLICATION_STATE_REPLICATION_STUCK: The
2394 # replication is completely stuck due to some internal error.
2395 #
2396 # - ASYNC_REPLICATION_STATE_STOPPING: The replication
2397 # is under the process of being stopped. This is a transient state.
2398 #
2399 # - ASYNC_REPLICATION_STATE_STOPPED: The replication
2400 # between the disk-pairs have stopped.
2401 #
2402 # - ASYNC_REPLICATION_STATE_REPLICATING_BEHIND_CG_HIGH_CHURN:
2403 # The replication is lagging above the SLO limit for the disk in the
2404 # consistency group due to disk&#x27;s change rate being above the supported
2405 # limit.
2406 &quot;replicationDiskPair&quot;: {
2407 &quot;primaryDisk&quot;: &quot;A String&quot;, # Output only. URL of the primary disk.
2408 &quot;secondaryDisk&quot;: &quot;A String&quot;, # Output only. URL of the secondary disk.
2409 },
2410 },
2411 &quot;lastReplicationDetails&quot;: {
2412 &quot;lastReplicationTime&quot;: &quot;A String&quot;, # Output only. The last sync time of the device pair.
2413 &quot;secondsSinceLastReplication&quot;: &quot;A String&quot;, # Output only. Replication lag in seconds. This will only be populated if device is in
2414 # replicating state. Note that the value is calculated sometime during
2415 # request processing and at the instant the client receives the response,
2416 # the current replication_lag may have changed.
2417 },
2418 },
2419 &quot;etag&quot;: &quot;A String&quot;, # end_interface: MixerGetResponseWithEtagBuilder
2420 }</pre>
2421 </div>
2422
2423 <div class="method">
2424 <code class="details" id="getIamPolicy">getIamPolicy(project, region, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</code>
2425 <pre>Gets the access control policy for a resource. May be empty if no such
2426 policy or resource exists.
2427
2428 Args:
2429 project: string, Project ID for this request. (required)
2430 region: string, The name of the region for this request. (required)
2431 resource: string, Name or id of the resource for this request. (required)
2432 optionsRequestedPolicyVersion: integer, Requested IAM Policy version.
2433 x__xgafv: string, V1 error format.
2434 Allowed values
2435 1 - v1 error format
2436 2 - v2 error format
2437
2438 Returns:
2439 An object of the form:
2440
2441 { # An Identity and Access Management (IAM) policy, which specifies access
2442 # controls for Google Cloud resources.
2443 #
2444 #
2445 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
2446 # `members`, or principals, to a single `role`. Principals can be user
2447 # accounts, service accounts, Google groups, and domains (such as G Suite). A
2448 # `role` is a named list of permissions; each `role` can be an IAM predefined
2449 # role or a user-created custom role.
2450 #
2451 # For some types of Google Cloud resources, a `binding` can also specify a
2452 # `condition`, which is a logical expression that allows access to a resource
2453 # only if the expression evaluates to `true`. A condition can add constraints
2454 # based on attributes of the request, the resource, or both. To learn which
2455 # resources support conditions in their IAM policies, see the
2456 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2457 #
2458 # **JSON example:**
2459 #
2460 # ```
2461 # {
2462 # &quot;bindings&quot;: [
2463 # {
2464 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
2465 # &quot;members&quot;: [
2466 # &quot;user:[email protected]&quot;,
2467 # &quot;group:[email protected]&quot;,
2468 # &quot;domain:google.com&quot;,
2469 # &quot;serviceAccount:[email protected]&quot;
2470 # ]
2471 # },
2472 # {
2473 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
2474 # &quot;members&quot;: [
2475 # &quot;user:[email protected]&quot;
2476 # ],
2477 # &quot;condition&quot;: {
2478 # &quot;title&quot;: &quot;expirable access&quot;,
2479 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
2480 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
2481 # }
2482 # }
2483 # ],
2484 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
2485 # &quot;version&quot;: 3
2486 # }
2487 # ```
2488 #
2489 # **YAML example:**
2490 #
2491 # ```
2492 # bindings:
2493 # - members:
2494 # - user:[email protected]
2495 # - group:[email protected]
2496 # - domain:google.com
2497 # - serviceAccount:[email protected]
2498 # role: roles/resourcemanager.organizationAdmin
2499 # - members:
2500 # - user:[email protected]
2501 # role: roles/resourcemanager.organizationViewer
2502 # condition:
2503 # title: expirable access
2504 # description: Does not grant access after Sep 2020
2505 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
2506 # etag: BwWWja0YfJA=
2507 # version: 3
2508 # ```
2509 #
2510 # For a description of IAM and its features, see the
2511 # [IAM documentation](https://cloud.google.com/iam/docs/).
2512 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
2513 { # Specifies the audit configuration for a service.
2514 # The configuration determines which permission types are logged, and what
2515 # identities, if any, are exempted from logging.
2516 # An AuditConfig must have one or more AuditLogConfigs.
2517 #
2518 # If there are AuditConfigs for both `allServices` and a specific service,
2519 # the union of the two AuditConfigs is used for that service: the log_types
2520 # specified in each AuditConfig are enabled, and the exempted_members in each
2521 # AuditLogConfig are exempted.
2522 #
2523 # Example Policy with multiple AuditConfigs:
2524 #
2525 # {
2526 # &quot;audit_configs&quot;: [
2527 # {
2528 # &quot;service&quot;: &quot;allServices&quot;,
2529 # &quot;audit_log_configs&quot;: [
2530 # {
2531 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
2532 # &quot;exempted_members&quot;: [
2533 # &quot;user:[email protected]&quot;
2534 # ]
2535 # },
2536 # {
2537 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
2538 # },
2539 # {
2540 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
2541 # }
2542 # ]
2543 # },
2544 # {
2545 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
2546 # &quot;audit_log_configs&quot;: [
2547 # {
2548 # &quot;log_type&quot;: &quot;DATA_READ&quot;
2549 # },
2550 # {
2551 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
2552 # &quot;exempted_members&quot;: [
2553 # &quot;user:[email protected]&quot;
2554 # ]
2555 # }
2556 # ]
2557 # }
2558 # ]
2559 # }
2560 #
2561 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
2562 # logging. It also exempts `[email protected]` from DATA_READ logging, and
2563 # `[email protected]` from DATA_WRITE logging.
2564 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
2565 { # Provides the configuration for logging a type of permissions.
2566 # Example:
2567 #
2568 # {
2569 # &quot;audit_log_configs&quot;: [
2570 # {
2571 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
2572 # &quot;exempted_members&quot;: [
2573 # &quot;user:[email protected]&quot;
2574 # ]
2575 # },
2576 # {
2577 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
2578 # }
2579 # ]
2580 # }
2581 #
2582 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
2583 # [email protected] from DATA_READ logging.
2584 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
2585 # permission.
2586 # Follows the same format of Binding.members.
2587 &quot;A String&quot;,
2588 ],
2589 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
2590 },
2591 ],
2592 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
2593 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
2594 # `allServices` is a special value that covers all services.
2595 },
2596 ],
2597 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
2598 # may specify a `condition` that determines how and when the `bindings` are
2599 # applied. Each of the `bindings` must contain at least one principal.
2600 #
2601 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
2602 # of these principals can be Google groups. Each occurrence of a principal
2603 # counts towards these limits. For example, if the `bindings` grant 50
2604 # different roles to `user:[email protected]`, and not to any other
2605 # principal, then you can add another 1,450 principals to the `bindings` in
2606 # the `Policy`.
2607 { # Associates `members`, or principals, with a `role`.
2608 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
2609 #
2610 # If the condition evaluates to `true`, then this binding applies to the
2611 # current request.
2612 #
2613 # If the condition evaluates to `false`, then this binding does not apply to
2614 # the current request. However, a different role binding might grant the same
2615 # role to one or more of the principals in this binding.
2616 #
2617 # To learn which resources support conditions in their IAM policies, see the
2618 # [IAM
2619 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2620 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
2621 # are documented at https://github.com/google/cel-spec.
2622 #
2623 # Example (Comparison):
2624 #
2625 # title: &quot;Summary size limit&quot;
2626 # description: &quot;Determines if a summary is less than 100 chars&quot;
2627 # expression: &quot;document.summary.size() &lt; 100&quot;
2628 #
2629 # Example (Equality):
2630 #
2631 # title: &quot;Requestor is owner&quot;
2632 # description: &quot;Determines if requestor is the document owner&quot;
2633 # expression: &quot;document.owner == request.auth.claims.email&quot;
2634 #
2635 # Example (Logic):
2636 #
2637 # title: &quot;Public documents&quot;
2638 # description: &quot;Determine whether the document should be publicly visible&quot;
2639 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
2640 #
2641 # Example (Data Manipulation):
2642 #
2643 # title: &quot;Notification string&quot;
2644 # description: &quot;Create a notification string with a timestamp.&quot;
2645 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
2646 #
2647 # The exact variables and functions that may be referenced within an expression
2648 # are determined by the service that evaluates it. See the service
2649 # documentation for additional information.
2650 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
2651 # describes the expression, e.g. when hovered over it in a UI.
2652 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
2653 # syntax.
2654 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
2655 # reporting, e.g. a file name and a position in the file.
2656 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
2657 # its purpose. This can be used e.g. in UIs which allow to enter the
2658 # expression.
2659 },
2660 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
2661 # `members` can have the following values:
2662 #
2663 # * `allUsers`: A special identifier that represents anyone who is
2664 # on the internet; with or without a Google account.
2665 #
2666 # * `allAuthenticatedUsers`: A special identifier that represents anyone
2667 # who is authenticated with a Google account or a service account.
2668 # Does not include identities that come from external identity providers
2669 # (IdPs) through identity federation.
2670 #
2671 # * `user:{emailid}`: An email address that represents a specific Google
2672 # account. For example, `[email protected]` .
2673 #
2674 #
2675 # * `serviceAccount:{emailid}`: An email address that represents a Google
2676 # service account. For example,
2677 # `[email protected]`.
2678 #
2679 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
2680 # identifier for a
2681 # [Kubernetes service
2682 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
2683 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
2684 #
2685 # * `group:{emailid}`: An email address that represents a Google group.
2686 # For example, `[email protected]`.
2687 #
2688 #
2689 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
2690 # users of that domain. For example, `google.com` or `example.com`.
2691 #
2692 #
2693 #
2694 #
2695 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
2696 # A single identity in a workforce identity pool.
2697 #
2698 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
2699 # All workforce identities in a group.
2700 #
2701 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
2702 # All workforce identities with a specific attribute value.
2703 #
2704 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
2705 # All identities in a workforce identity pool.
2706 #
2707 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
2708 # A single identity in a workload identity pool.
2709 #
2710 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
2711 # A workload identity pool group.
2712 #
2713 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
2714 # All identities in a workload identity pool with a certain attribute.
2715 #
2716 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
2717 # All identities in a workload identity pool.
2718 #
2719 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
2720 # identifier) representing a user that has been recently deleted. For
2721 # example, `[email protected]?uid=123456789012345678901`. If the user is
2722 # recovered, this value reverts to `user:{emailid}` and the recovered user
2723 # retains the role in the binding.
2724 #
2725 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
2726 # unique identifier) representing a service account that has been recently
2727 # deleted. For example,
2728 # `[email protected]?uid=123456789012345678901`.
2729 # If the service account is undeleted, this value reverts to
2730 # `serviceAccount:{emailid}` and the undeleted service account retains the
2731 # role in the binding.
2732 #
2733 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
2734 # identifier) representing a Google group that has been recently
2735 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
2736 # the group is recovered, this value reverts to `group:{emailid}` and the
2737 # recovered group retains the role in the binding.
2738 #
2739 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
2740 # Deleted single identity in a workforce identity pool. For example,
2741 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
2742 &quot;A String&quot;,
2743 ],
2744 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
2745 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
2746 #
2747 # For an overview of the IAM roles and permissions, see the
2748 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
2749 # a list of the available pre-defined roles, see
2750 # [here](https://cloud.google.com/iam/docs/understanding-roles).
2751 },
2752 ],
2753 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
2754 # prevent simultaneous updates of a policy from overwriting each other.
2755 # It is strongly suggested that systems make use of the `etag` in the
2756 # read-modify-write cycle to perform policy updates in order to avoid race
2757 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
2758 # systems are expected to put that etag in the request to `setIamPolicy` to
2759 # ensure that their change will be applied to the same version of the policy.
2760 #
2761 # **Important:** If you use IAM Conditions, you must include the `etag` field
2762 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
2763 # you to overwrite a version `3` policy with a version `1` policy, and all of
2764 # the conditions in the version `3` policy are lost.
2765 &quot;version&quot;: 42, # Specifies the format of the policy.
2766 #
2767 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
2768 # are rejected.
2769 #
2770 # Any operation that affects conditional role bindings must specify version
2771 # `3`. This requirement applies to the following operations:
2772 #
2773 # * Getting a policy that includes a conditional role binding
2774 # * Adding a conditional role binding to a policy
2775 # * Changing a conditional role binding in a policy
2776 # * Removing any role binding, with or without a condition, from a policy
2777 # that includes conditions
2778 #
2779 # **Important:** If you use IAM Conditions, you must include the `etag` field
2780 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
2781 # you to overwrite a version `3` policy with a version `1` policy, and all of
2782 # the conditions in the version `3` policy are lost.
2783 #
2784 # If a policy does not include any conditions, operations on that policy may
2785 # specify any valid version or leave the field unset.
2786 #
2787 # To learn which resources support conditions in their IAM policies, see the
2788 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2789 }</pre>
2790 </div>
2791
2792 <div class="method">
2793 <code class="details" id="insert">insert(project, region, body=None, requestId=None, sourceImage=None, x__xgafv=None)</code>
2794 <pre>Creates a persistent regional disk in the specified project using the data
2795 included in the request.
2796
2797 Args:
2798 project: string, Project ID for this request. (required)
2799 region: string, Name of the region for this request. (required)
2800 body: object, The request body.
2801 The object takes the form of:
2802
2803 { # Represents a Persistent Disk resource.
2804 #
2805 # Google Compute Engine has two Disk resources:
2806 #
2807 # * [Zonal](/compute/docs/reference/rest/alpha/disks)
2808 # * [Regional](/compute/docs/reference/rest/alpha/regionDisks)
2809 #
2810 # Persistent disks are required for running your VM instances.
2811 # Create both boot and non-boot (data) persistent disks. For more information,
2812 # read Persistent Disks. For more
2813 # storage options, read Storage options.
2814 #
2815 # The disks resource represents a zonal persistent disk.
2816 # For more information, readZonal persistent disks.
2817 #
2818 # The regionDisks resource represents a
2819 # regional persistent disk. For more information, read
2820 # Regional resources.
2821 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
2822 #
2823 #
2824 # - READ_WRITE_SINGLE: The default AccessMode, means the
2825 # disk can be attached to single instance in RW mode.
2826 # - READ_WRITE_MANY: The AccessMode means the disk can be
2827 # attached to multiple instances in RW mode.
2828 # - READ_ONLY_MANY: The AccessMode means the disk can be
2829 # attached to multiple instances in RO mode.
2830 #
2831 #
2832 # The AccessMode is only valid for Hyperdisk disk types.
2833 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
2834 # ARM64 or X86_64.
2835 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
2836 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
2837 # started on the disk as a member of a group.
2838 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
2839 # started on the disk as a member of a group.
2840 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
2841 # You can provide this as a partial or full URL to the resource.
2842 # For example, the following are valid values:
2843 #
2844 #
2845 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
2846 # - projects/project/zones/zone/disks/disk
2847 # - zones/zone/disks/disk
2848 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
2849 # to or from the current disk. This value identifies the exact disk that
2850 # was used to create this replication. For example, if you started
2851 # replicating the persistent disk from a disk that was later deleted and
2852 # recreated under the same name, the disk ID would identify the exact
2853 # version of the disk that was used.
2854 },
2855 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
2856 &quot;a_key&quot;: {
2857 &quot;asyncReplicationDisk&quot;: {
2858 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
2859 # started on the disk as a member of a group.
2860 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
2861 # started on the disk as a member of a group.
2862 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
2863 # You can provide this as a partial or full URL to the resource.
2864 # For example, the following are valid values:
2865 #
2866 #
2867 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
2868 # - projects/project/zones/zone/disks/disk
2869 # - zones/zone/disks/disk
2870 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
2871 # to or from the current disk. This value identifies the exact disk that
2872 # was used to create this replication. For example, if you started
2873 # replicating the persistent disk from a disk that was later deleted and
2874 # recreated under the same name, the disk ID would identify the exact
2875 # version of the disk that was used.
2876 },
2877 },
2878 },
2879 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
2880 # text format.
2881 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
2882 # create the resource.
2883 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
2884 # customer-supplied encryption key or a
2885 # customer-managed encryption key.
2886 #
2887 # Encryption keys do not protect access to metadata of the disk.
2888 #
2889 # After you encrypt a disk with a customer-supplied key, you must provide the
2890 # same key if you use the disk later. For example, to create a disk snapshot,
2891 # to create a disk image, to create a machine image, or to attach the disk to
2892 # a virtual machine.
2893 #
2894 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
2895 # name once the disk is created. The disk is encrypted with this version of
2896 # the key. In the response, diskEncryptionKey.kmsKeyName appears
2897 # in the following format:
2898 #
2899 # &quot;diskEncryptionKey.kmsKeyName&quot;:
2900 # &quot;projects/kms_project_id/locations/region/keyRings/
2901 # key_region/cryptoKeys/key
2902 # /cryptoKeysVersions/version
2903 #
2904 # If you do not provide an encryption key when creating the disk, then the
2905 # disk is encrypted using an automatically generated key and you don&#x27;t need
2906 # to provide a key to use the disk later.
2907 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2908 # For example:
2909 #
2910 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2911 # key_region/cryptoKeys/key
2912 #
2913 # The fully-qualifed key name may be returned for resource GET requests. For
2914 # example:
2915 #
2916 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2917 # key_region/cryptoKeys/key
2918 # /cryptoKeyVersions/1
2919 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2920 # key. If absent, the Compute Engine default service account is used.
2921 # For example:
2922 #
2923 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2924 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2925 # encryption key, encoded in RFC
2926 # 4648 base64 to either encrypt or decrypt this resource. You can
2927 # provide either the rawKey or thersaEncryptedKey.
2928 # For example:
2929 #
2930 # &quot;rawKey&quot;:
2931 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2932 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2933 # customer-supplied encryption key to either encrypt or decrypt this
2934 # resource. You can provide either the rawKey or thersaEncryptedKey.
2935 # For example:
2936 #
2937 # &quot;rsaEncryptedKey&quot;:
2938 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2939 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2940 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2941 #
2942 # The key must meet the following requirements before you can provide it to
2943 # Compute Engine:
2944 #
2945 # 1. The key is wrapped using a RSA public key certificate provided by
2946 # Google.
2947 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2948 # encoding.
2949 #
2950 # Gets the RSA public key certificate provided by Google at:
2951 #
2952 #
2953 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2954 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2955 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2956 # encryption key that protects this resource.
2957 },
2958 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
2959 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
2960 # Windows specific VSS signature.
2961 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2962 # only for bootable images. Read
2963 # Enabling guest operating system features to see a list of available
2964 # options.
2965 { # Guest OS features.
2966 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2967 # separate values. Set to one or more of the following values:
2968 #
2969 # - VIRTIO_SCSI_MULTIQUEUE
2970 # - WINDOWS
2971 # - MULTI_IP_SUBNET
2972 # - UEFI_COMPATIBLE
2973 # - GVNIC
2974 # - SEV_CAPABLE
2975 # - SUSPEND_RESUME_COMPATIBLE
2976 # - SEV_LIVE_MIGRATABLE_V2
2977 # - SEV_SNP_CAPABLE
2978 # - TDX_CAPABLE
2979 # - IDPF
2980 # - SNP_SVSM_CAPABLE
2981 # - CCA_CAPABLE
2982 #
2983 #
2984 # For more information, see
2985 # Enabling guest operating system features.
2986 },
2987 ],
2988 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
2989 # defined by the server.
2990 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
2991 # which is either SCSI or NVME. The default isSCSI.
2992 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
2993 # disks.
2994 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
2995 # essentially a hash of the labels set used for optimistic locking. The
2996 # fingerprint is initially generated by Compute Engine and changes after
2997 # every request to modify or update labels. You must always provide an
2998 # up-to-date fingerprint hash in order to update or change labels,
2999 # otherwise the request will fail with error412 conditionNotMet.
3000 #
3001 # To see the latest fingerprint, make a get() request to
3002 # retrieve a disk.
3003 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
3004 # the setLabels method.
3005 &quot;a_key&quot;: &quot;A String&quot;,
3006 },
3007 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
3008 # text format.
3009 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
3010 # text format.
3011 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
3012 &quot;A String&quot;,
3013 ],
3014 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
3015 &quot;A String&quot;,
3016 ],
3017 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
3018 # This field is for use by internal tools that use the public API.
3019 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
3020 # source image. Attachment of a disk created from a locked source image will
3021 # cause the following operations to become irreversibly prohibited:
3022 #
3023 # - R/W or R/O disk attachment to any other instance
3024 # - Disk detachment. And the disk can only be deleted when the instance
3025 # is deleted
3026 # - Creation of images or snapshots
3027 # - Disk cloning
3028 #
3029 #
3030 #
3031 # Furthermore, the instance with at least one disk with locked flag set to
3032 # true will be prohibited from performing the operations below:
3033 #
3034 # - Further attachment of secondary disks.
3035 # - Detachment of any disks
3036 # - Create machine images
3037 # - Create instance template
3038 # - Delete the instance with --keep-disk parameter set to true for locked
3039 # disks
3040 # - Attach a locked disk with --auto-delete parameter set to false
3041 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
3042 # more than one instance.
3043 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
3044 # The name must be 1-63 characters long, and comply withRFC1035.
3045 # Specifically, the name must be 1-63 characters long and match the regular
3046 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
3047 # which means the first character must be a lowercase letter, and all
3048 # following characters must be a dash, lowercase letter, or digit, except
3049 # the last character, which cannot be a dash.
3050 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
3051 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
3052 # as part of resource payload.
3053 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
3054 # have the same definition as resource
3055 # manager tags. Keys and values can be either in numeric format,
3056 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3057 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3058 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
3059 # PATCH) when empty.
3060 &quot;a_key&quot;: &quot;A String&quot;,
3061 },
3062 },
3063 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
3064 # If not present in a request, a default value is used.
3065 # The currently supported size is 4096, other sizes may be added in
3066 # the future.
3067 # If an unsupported value is requested, the error message will list
3068 # the supported values for the caller&#x27;s project.
3069 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
3070 # of I/O operations per second that the disk can handle. Values must be
3071 # between 10,000 and 120,000. For more details, see theExtreme persistent
3072 # disk documentation.
3073 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
3074 # number of throughput mb per second that the disk can handle. Values must be
3075 # greater than or equal to 1.
3076 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
3077 # regional resources.
3078 # You must specify this field as part of the HTTP request URL. It is
3079 # not settable as a field in the request body.
3080 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
3081 # for regional resources.
3082 &quot;A String&quot;,
3083 ],
3084 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
3085 &quot;A String&quot;,
3086 ],
3087 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
3088 &quot;asyncPrimaryDisk&quot;: {
3089 &quot;state&quot;: &quot;A String&quot;,
3090 },
3091 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
3092 &quot;a_key&quot;: {
3093 &quot;state&quot;: &quot;A String&quot;,
3094 },
3095 },
3096 &quot;usedBytes&quot;: &quot;A String&quot;, # [Output Only] Space used by data stored in the disk (in bytes). Note that
3097 # this field is set only when the disk is in a storage pool.
3098 },
3099 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
3100 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
3101 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
3102 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
3103 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
3104 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
3105 # persistent disk.
3106 #
3107 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
3108 # source.
3109 # Acceptable values are greater than 0.
3110 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
3111 # that was created using a consistency group.
3112 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
3113 # that was created using a consistency group.
3114 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
3115 # partial or full URL to the resource. For example, the following are valid
3116 # values:
3117 #
3118 #
3119 # -
3120 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3121 #
3122 # -
3123 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
3124 #
3125 # -
3126 # projects/project/zones/zone/disks/disk
3127 #
3128 # -
3129 # projects/project/regions/region/disks/disk
3130 #
3131 # -
3132 # zones/zone/disks/disk
3133 #
3134 # -
3135 # regions/region/disks/disk
3136 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
3137 # value identifies the exact disk that was used to create this persistent
3138 # disk. For example, if you created the persistent disk from a disk that
3139 # was later deleted and recreated under the same name, the source disk ID
3140 # would identify the exact version of the disk that was used.
3141 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
3142 # deleted, this field will not be set.
3143 #
3144 # To create a disk with one of the public operating system images, specify
3145 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
3146 #
3147 # projects/debian-cloud/global/images/family/debian-9
3148 #
3149 #
3150 # Alternatively, use a specific version of a public operating system image:
3151 #
3152 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
3153 #
3154 #
3155 # To create a disk with a custom image that you created, specify the
3156 # image name in the following format:
3157 #
3158 # global/images/my-custom-image
3159 #
3160 #
3161 # You can also specify a custom image by its image family, which returns
3162 # the latest version of the image in that family. Replace the image name
3163 # with family/family-name:
3164 #
3165 # global/images/family/my-image-family
3166 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
3167 # encryption key of the source image. Required if the source image is
3168 # protected by a customer-supplied encryption key.
3169 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3170 # For example:
3171 #
3172 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3173 # key_region/cryptoKeys/key
3174 #
3175 # The fully-qualifed key name may be returned for resource GET requests. For
3176 # example:
3177 #
3178 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3179 # key_region/cryptoKeys/key
3180 # /cryptoKeyVersions/1
3181 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3182 # key. If absent, the Compute Engine default service account is used.
3183 # For example:
3184 #
3185 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3186 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3187 # encryption key, encoded in RFC
3188 # 4648 base64 to either encrypt or decrypt this resource. You can
3189 # provide either the rawKey or thersaEncryptedKey.
3190 # For example:
3191 #
3192 # &quot;rawKey&quot;:
3193 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3194 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3195 # customer-supplied encryption key to either encrypt or decrypt this
3196 # resource. You can provide either the rawKey or thersaEncryptedKey.
3197 # For example:
3198 #
3199 # &quot;rsaEncryptedKey&quot;:
3200 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3201 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3202 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3203 #
3204 # The key must meet the following requirements before you can provide it to
3205 # Compute Engine:
3206 #
3207 # 1. The key is wrapped using a RSA public key certificate provided by
3208 # Google.
3209 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3210 # encoding.
3211 #
3212 # Gets the RSA public key certificate provided by Google at:
3213 #
3214 #
3215 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3216 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3217 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3218 # encryption key that protects this resource.
3219 },
3220 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
3221 # value identifies the exact image that was used to create this persistent
3222 # disk. For example, if you created the persistent disk from an image that
3223 # was later deleted and recreated under the same name, the source image ID
3224 # would identify the exact version of the image that was used.
3225 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
3226 # this as a partial or full URL to the resource. For example, the following
3227 # are valid values:
3228 #
3229 #
3230 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
3231 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
3232 # - zones/zone/instantSnapshots/instantSnapshot
3233 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
3234 # disk. This value identifies the exact instant snapshot that was used to
3235 # create this persistent disk. For example, if you created the persistent
3236 # disk from an instant snapshot that was later deleted and recreated under
3237 # the same name, the source instant snapshot ID would identify the exact
3238 # version of the instant snapshot that was used.
3239 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
3240 # partial or full URL to the resource. For example, the following are valid
3241 # values:
3242 #
3243 #
3244 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
3245 # - projects/project/global/machineImages/machineImage
3246 # - global/machineImages/machineImage
3247 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
3248 # source_machine_image must be specified.
3249 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
3250 # encryption key of the source machine image. Required if the source
3251 # machine image is protected by a customer-supplied encryption key.
3252 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3253 # For example:
3254 #
3255 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3256 # key_region/cryptoKeys/key
3257 #
3258 # The fully-qualifed key name may be returned for resource GET requests. For
3259 # example:
3260 #
3261 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3262 # key_region/cryptoKeys/key
3263 # /cryptoKeyVersions/1
3264 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3265 # key. If absent, the Compute Engine default service account is used.
3266 # For example:
3267 #
3268 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3269 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3270 # encryption key, encoded in RFC
3271 # 4648 base64 to either encrypt or decrypt this resource. You can
3272 # provide either the rawKey or thersaEncryptedKey.
3273 # For example:
3274 #
3275 # &quot;rawKey&quot;:
3276 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3277 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3278 # customer-supplied encryption key to either encrypt or decrypt this
3279 # resource. You can provide either the rawKey or thersaEncryptedKey.
3280 # For example:
3281 #
3282 # &quot;rsaEncryptedKey&quot;:
3283 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3284 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3285 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3286 #
3287 # The key must meet the following requirements before you can provide it to
3288 # Compute Engine:
3289 #
3290 # 1. The key is wrapped using a RSA public key certificate provided by
3291 # Google.
3292 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3293 # encoding.
3294 #
3295 # Gets the RSA public key certificate provided by Google at:
3296 #
3297 #
3298 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3299 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3300 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3301 # encryption key that protects this resource.
3302 },
3303 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
3304 # This value identifies the exact machine image that was used to create this
3305 # persistent disk. For example, if you created the persistent disk from a
3306 # machine image that was later deleted and recreated under the same name, the
3307 # source machine image ID would identify the exact version of the machine
3308 # image that was used.
3309 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
3310 # partial or full URL to the resource. For example, the following are valid
3311 # values:
3312 #
3313 #
3314 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
3315 # - projects/project/global/snapshots/snapshot
3316 # - global/snapshots/snapshot
3317 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3318 # encryption key of the source snapshot. Required if the source snapshot
3319 # is protected by a customer-supplied encryption key.
3320 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3321 # For example:
3322 #
3323 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3324 # key_region/cryptoKeys/key
3325 #
3326 # The fully-qualifed key name may be returned for resource GET requests. For
3327 # example:
3328 #
3329 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3330 # key_region/cryptoKeys/key
3331 # /cryptoKeyVersions/1
3332 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3333 # key. If absent, the Compute Engine default service account is used.
3334 # For example:
3335 #
3336 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3337 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3338 # encryption key, encoded in RFC
3339 # 4648 base64 to either encrypt or decrypt this resource. You can
3340 # provide either the rawKey or thersaEncryptedKey.
3341 # For example:
3342 #
3343 # &quot;rawKey&quot;:
3344 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3345 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3346 # customer-supplied encryption key to either encrypt or decrypt this
3347 # resource. You can provide either the rawKey or thersaEncryptedKey.
3348 # For example:
3349 #
3350 # &quot;rsaEncryptedKey&quot;:
3351 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3352 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3353 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3354 #
3355 # The key must meet the following requirements before you can provide it to
3356 # Compute Engine:
3357 #
3358 # 1. The key is wrapped using a RSA public key certificate provided by
3359 # Google.
3360 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3361 # encoding.
3362 #
3363 # Gets the RSA public key certificate provided by Google at:
3364 #
3365 #
3366 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3367 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3368 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3369 # encryption key that protects this resource.
3370 },
3371 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
3372 # value identifies the exact snapshot that was used to create this persistent
3373 # disk. For example, if you created the persistent disk from a snapshot that
3374 # was later deleted and recreated under the same name, the source snapshot ID
3375 # would identify the exact version of the snapshot that was used.
3376 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
3377 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
3378 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
3379 # https://storage.googleapis.com/. This flag is not optimized for creating
3380 # multiple disks from a source storage object. To create many disks from a
3381 # source storage object, use gcloud compute images
3382 # import instead.
3383 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
3384 #
3385 #
3386 # - CREATING: Disk is provisioning.
3387 # - RESTORING: Source data is being copied into the
3388 # disk.
3389 # - FAILED: Disk creation failed.
3390 # - READY: Disk is ready for use.
3391 # - DELETING: Disk is deleting.
3392 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3393 # this as a partial or full URL to the resource. For example, the following
3394 # are valid values:
3395 #
3396 #
3397 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3398 # - projects/project/zones/zone/storagePools/storagePool
3399 # - zones/zone/storagePools/storagePool
3400 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
3401 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
3402 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
3403 # types.
3404 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
3405 # in form:projects/project/zones/zone/instances/instance
3406 &quot;A String&quot;,
3407 ],
3408 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
3409 # You must specify this field as part of the HTTP request URL. It is
3410 # not settable as a field in the request body.
3411 }
3412
3413 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3414 that if you must retry your request, the server will know to ignore the
3415 request if it has already been completed.
3416
3417 For example, consider a situation where you make an initial request and
3418 the request times out. If you make the request again with the same
3419 request ID, the server can check if original operation with the same
3420 request ID was received, and if so, will ignore the second request. This
3421 prevents clients from accidentally creating duplicate commitments.
3422
3423 The request ID must be
3424 a valid UUID with the exception that zero UUID is not supported
3425 (00000000-0000-0000-0000-000000000000).
3426 sourceImage: string, Source image to restore onto a disk. This field is optional.
3427 x__xgafv: string, V1 error format.
3428 Allowed values
3429 1 - v1 error format
3430 2 - v2 error format
3431
3432 Returns:
3433 An object of the form:
3434
3435 { # Represents an Operation resource.
3436 #
3437 # Google Compute Engine has three Operation resources:
3438 #
3439 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
3440 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
3441 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
3442 #
3443 # You can use an operation resource to manage asynchronous API requests.
3444 # For more information, readHandling
3445 # API responses.
3446 #
3447 # Operations can be global, regional or zonal.
3448 #
3449 # - For global operations, use the `globalOperations`
3450 # resource.
3451 # - For regional operations, use the
3452 # `regionOperations` resource.
3453 # - For zonal operations, use
3454 # the `zoneOperations` resource.
3455 #
3456 #
3457 #
3458 # For more information, read
3459 # Global, Regional, and Zonal Resources.
3460 #
3461 # Note that completed Operation resources have a limited
3462 # retention period.
3463 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3464 # Not present otherwise.
3465 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3466 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3467 # set when the operation is created.
3468 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3469 # text format.
3470 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3471 # this field will be populated.
3472 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3473 # operation.
3474 {
3475 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3476 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3477 # details. There is a set of defined message types to use for providing
3478 # details.The syntax depends on the error code. For example,
3479 # QuotaExceededInfo will have details when the error code is
3480 # QUOTA_EXCEEDED.
3481 {
3482 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3483 #
3484 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3485 # is not enabled:
3486 #
3487 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3488 # &quot;domain&quot;: &quot;googleapis.com&quot;
3489 # &quot;metadata&quot;: {
3490 # &quot;resource&quot;: &quot;projects/123&quot;,
3491 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3492 # }
3493 # }
3494 #
3495 # This response indicates that the pubsub.googleapis.com API is not enabled.
3496 #
3497 # Example of an error that is returned when attempting to create a Spanner
3498 # instance in a region that is out of stock:
3499 #
3500 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3501 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3502 # &quot;metadata&quot;: {
3503 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3504 # }
3505 # }
3506 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3507 # is typically the registered service name of the tool or product that
3508 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3509 # generated by some common infrastructure, the error domain must be a
3510 # globally unique value that identifies the infrastructure. For Google API
3511 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3512 &quot;metadatas&quot;: { # Additional structured details about this error.
3513 #
3514 # Keys must match a regular expression of `a-z+` but should
3515 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3516 # length. When identifying the current value of an exceeded limit, the units
3517 # should be contained in the key, not the value. For example, rather than
3518 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3519 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3520 # instances that can be created in a single (batch) request.
3521 &quot;a_key&quot;: &quot;A String&quot;,
3522 },
3523 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3524 # proximate cause of the error. Error reasons are unique within a particular
3525 # domain of errors. This should be at most 63 characters and match a
3526 # regular expression of `A-Z+[A-Z0-9]`, which represents
3527 # UPPER_SNAKE_CASE.
3528 },
3529 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3530 #
3531 # For example, if a quota check failed with an error indicating the calling
3532 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3533 # directly to the right place in the developer console to flip the bit.
3534 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3535 { # Describes a URL link.
3536 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3537 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3538 },
3539 ],
3540 },
3541 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3542 # which can be attached to an RPC error.
3543 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3544 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3545 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3546 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3547 },
3548 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3549 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3550 &quot;a_key&quot;: &quot;A String&quot;,
3551 },
3552 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3553 # type or metric.
3554 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3555 # or metric.
3556 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3557 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3558 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3559 },
3560 },
3561 ],
3562 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3563 # This property is optional.
3564 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3565 },
3566 ],
3567 },
3568 &quot;getVersionOperationMetadata&quot;: {
3569 &quot;inlineSbomInfo&quot;: {
3570 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3571 # appropriate identifiers.
3572 &quot;a_key&quot;: &quot;A String&quot;,
3573 },
3574 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3575 # identifiers.
3576 &quot;a_key&quot;: &quot;A String&quot;,
3577 },
3578 },
3579 },
3580 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3581 # message that was returned, such as `NOT FOUND`.
3582 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3583 # status code that was returned. For example, a `404` means the
3584 # resource was not found.
3585 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3586 # defined by the server.
3587 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3588 # This value is inRFC3339
3589 # text format.
3590 &quot;instancesBulkInsertOperationMetadata&quot;: {
3591 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3592 # Example key: zones/us-central1-a
3593 &quot;a_key&quot;: {
3594 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3595 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3596 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3597 # error.
3598 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3599 # if the flow is rolling forward or rolling back.
3600 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3601 },
3602 },
3603 },
3604 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3605 # Operation resources.
3606 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3607 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3608 # group of operations results from a `bulkInsert` API request.
3609 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3610 # `update`, or `delete`, and so on.
3611 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3612 # There is no requirement that this be linear or support any granularity of
3613 # operations. This should not be used to guess when the operation will be
3614 # complete. This number should monotonically increase as the operation
3615 # progresses.
3616 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3617 # applicable when performing regional operations.
3618 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3619 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
3620 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3621 # this field will contain information on all underlying zonal actions and
3622 # their state.
3623 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3624 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3625 # Example key: zones/us-central1-a
3626 &quot;a_key&quot;: {
3627 &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
3628 # populated.
3629 # different programming environments, including REST APIs and RPC APIs. It is
3630 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3631 # three pieces of data: error code, error message, and error details.
3632 #
3633 # You can find out more about this error model and how to work with it in the
3634 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3635 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3636 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3637 # message types for APIs to use.
3638 {
3639 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3640 },
3641 ],
3642 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3643 # user-facing error message should be localized and sent in the
3644 # google.rpc.Status.details field, or localized by the client.
3645 },
3646 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3647 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3648 },
3649 },
3650 },
3651 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3652 # This value is inRFC3339
3653 # text format.
3654 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3655 # following:
3656 # `PENDING`, `RUNNING`, or `DONE`.
3657 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3658 # operation.
3659 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3660 # of the target resource.
3661 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3662 # operations related to creating a snapshot, this points to the disk
3663 # that the snapshot was created from.
3664 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3665 # `[email protected]` or
3666 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3667 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3668 # operation, this field will be populated.
3669 {
3670 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3671 # Engine returns NO_RESULTS_ON_PAGE if there
3672 # are no results in the response.
3673 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3674 # value format. For example:
3675 #
3676 # &quot;data&quot;: [
3677 # {
3678 # &quot;key&quot;: &quot;scope&quot;,
3679 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3680 # }
3681 {
3682 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3683 # returned. For example, for warnings where there are no results in a list
3684 # request for a particular zone, this key might be scope and
3685 # the key value might be the zone name. Other examples might be a key
3686 # indicating a deprecated resource and a suggested replacement, or a
3687 # warning about invalid network settings (for example, if an instance
3688 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3689 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3690 },
3691 ],
3692 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3693 },
3694 ],
3695 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3696 # applicable when performing per-zone operations.
3697 }</pre>
3698 </div>
3699
3700 <div class="method">
3701 <code class="details" id="list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
3702 <pre>Retrieves the list of persistent disks contained within
3703 the specified region.
3704
3705 Args:
3706 project: string, Project ID for this request. (required)
3707 region: string, Name of the region for this request. (required)
3708 filter: string, A filter expression that filters resources listed in the response. Most
3709 Compute resources support two types of filter expressions:
3710 expressions that support regular expressions and expressions that follow
3711 API improvement proposal AIP-160.
3712 These two types of filter expressions cannot be mixed in one request.
3713
3714 If you want to use AIP-160, your expression must specify the field name, an
3715 operator, and the value that you want to use for filtering. The value
3716 must be a string, a number, or a boolean. The operator
3717 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
3718
3719 For example, if you are filtering Compute Engine instances, you can
3720 exclude instances named `example-instance` by specifying
3721 `name != example-instance`.
3722
3723 The `:*` comparison can be used to test whether a key has been defined.
3724 For example, to find all objects with `owner` label use:
3725 ```
3726 labels.owner:*
3727 ```
3728
3729 You can also filter nested fields. For example, you could specify
3730 `scheduling.automaticRestart = false` to include instances only
3731 if they are not scheduled for automatic restarts. You can use filtering
3732 on nested fields to filter based onresource labels.
3733
3734 To filter on multiple expressions, provide each separate expression within
3735 parentheses. For example:
3736 ```
3737 (scheduling.automaticRestart = true)
3738 (cpuPlatform = &quot;Intel Skylake&quot;)
3739 ```
3740 By default, each expression is an `AND` expression. However, you
3741 can include `AND` and `OR` expressions explicitly.
3742 For example:
3743 ```
3744 (cpuPlatform = &quot;Intel Skylake&quot;) OR
3745 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
3746 (scheduling.automaticRestart = true)
3747 ```
3748
3749 If you want to use a regular expression, use the `eq` (equal) or `ne`
3750 (not equal) operator against a single un-parenthesized expression with or
3751 without quotes or against multiple parenthesized expressions. Examples:
3752
3753 `fieldname eq unquoted literal`
3754 `fieldname eq &#x27;single quoted literal&#x27;`
3755 `fieldname eq &quot;double quoted literal&quot;`
3756 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
3757
3758 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
3759 The literal value must match the entire field.
3760
3761 For example, to filter for instances that do not end with name &quot;instance&quot;,
3762 you would use `name ne .*instance`.
3763
3764 You cannot combine constraints on multiple fields using regular
3765 expressions.
3766 maxResults: integer, The maximum number of results per page that should be returned.
3767 If the number of available results is larger than `maxResults`,
3768 Compute Engine returns a `nextPageToken` that can be used to get
3769 the next page of results in subsequent list requests. Acceptable values are
3770 `0` to `500`, inclusive. (Default: `500`)
3771 orderBy: string, Sorts list results by a certain order. By default, results
3772 are returned in alphanumerical order based on the resource name.
3773
3774 You can also sort results in descending order based on the creation
3775 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
3776 results based on the `creationTimestamp` field in
3777 reverse chronological order (newest result first). Use this to sort
3778 resources like operations so that the newest operation is returned first.
3779
3780 Currently, only sorting by `name` or
3781 `creationTimestamp desc` is supported.
3782 pageToken: string, Specifies a page token to use. Set `pageToken` to the
3783 `nextPageToken` returned by a previous list request to get
3784 the next page of results.
3785 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
3786 of failure. The default value is false.
3787
3788 For example, when partial success behavior is enabled, aggregatedList for a
3789 single zone scope either returns all resources in the zone or no resources,
3790 with an error code.
3791 x__xgafv: string, V1 error format.
3792 Allowed values
3793 1 - v1 error format
3794 2 - v2 error format
3795
3796 Returns:
3797 An object of the form:
3798
3799 { # A list of Disk resources.
3800 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
3801 &quot;items&quot;: [ # A list of Disk resources.
3802 { # Represents a Persistent Disk resource.
3803 #
3804 # Google Compute Engine has two Disk resources:
3805 #
3806 # * [Zonal](/compute/docs/reference/rest/alpha/disks)
3807 # * [Regional](/compute/docs/reference/rest/alpha/regionDisks)
3808 #
3809 # Persistent disks are required for running your VM instances.
3810 # Create both boot and non-boot (data) persistent disks. For more information,
3811 # read Persistent Disks. For more
3812 # storage options, read Storage options.
3813 #
3814 # The disks resource represents a zonal persistent disk.
3815 # For more information, readZonal persistent disks.
3816 #
3817 # The regionDisks resource represents a
3818 # regional persistent disk. For more information, read
3819 # Regional resources.
3820 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
3821 #
3822 #
3823 # - READ_WRITE_SINGLE: The default AccessMode, means the
3824 # disk can be attached to single instance in RW mode.
3825 # - READ_WRITE_MANY: The AccessMode means the disk can be
3826 # attached to multiple instances in RW mode.
3827 # - READ_ONLY_MANY: The AccessMode means the disk can be
3828 # attached to multiple instances in RO mode.
3829 #
3830 #
3831 # The AccessMode is only valid for Hyperdisk disk types.
3832 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
3833 # ARM64 or X86_64.
3834 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
3835 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
3836 # started on the disk as a member of a group.
3837 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
3838 # started on the disk as a member of a group.
3839 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
3840 # You can provide this as a partial or full URL to the resource.
3841 # For example, the following are valid values:
3842 #
3843 #
3844 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3845 # - projects/project/zones/zone/disks/disk
3846 # - zones/zone/disks/disk
3847 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
3848 # to or from the current disk. This value identifies the exact disk that
3849 # was used to create this replication. For example, if you started
3850 # replicating the persistent disk from a disk that was later deleted and
3851 # recreated under the same name, the disk ID would identify the exact
3852 # version of the disk that was used.
3853 },
3854 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
3855 &quot;a_key&quot;: {
3856 &quot;asyncReplicationDisk&quot;: {
3857 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
3858 # started on the disk as a member of a group.
3859 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
3860 # started on the disk as a member of a group.
3861 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
3862 # You can provide this as a partial or full URL to the resource.
3863 # For example, the following are valid values:
3864 #
3865 #
3866 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3867 # - projects/project/zones/zone/disks/disk
3868 # - zones/zone/disks/disk
3869 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
3870 # to or from the current disk. This value identifies the exact disk that
3871 # was used to create this replication. For example, if you started
3872 # replicating the persistent disk from a disk that was later deleted and
3873 # recreated under the same name, the disk ID would identify the exact
3874 # version of the disk that was used.
3875 },
3876 },
3877 },
3878 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
3879 # text format.
3880 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
3881 # create the resource.
3882 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
3883 # customer-supplied encryption key or a
3884 # customer-managed encryption key.
3885 #
3886 # Encryption keys do not protect access to metadata of the disk.
3887 #
3888 # After you encrypt a disk with a customer-supplied key, you must provide the
3889 # same key if you use the disk later. For example, to create a disk snapshot,
3890 # to create a disk image, to create a machine image, or to attach the disk to
3891 # a virtual machine.
3892 #
3893 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
3894 # name once the disk is created. The disk is encrypted with this version of
3895 # the key. In the response, diskEncryptionKey.kmsKeyName appears
3896 # in the following format:
3897 #
3898 # &quot;diskEncryptionKey.kmsKeyName&quot;:
3899 # &quot;projects/kms_project_id/locations/region/keyRings/
3900 # key_region/cryptoKeys/key
3901 # /cryptoKeysVersions/version
3902 #
3903 # If you do not provide an encryption key when creating the disk, then the
3904 # disk is encrypted using an automatically generated key and you don&#x27;t need
3905 # to provide a key to use the disk later.
3906 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3907 # For example:
3908 #
3909 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3910 # key_region/cryptoKeys/key
3911 #
3912 # The fully-qualifed key name may be returned for resource GET requests. For
3913 # example:
3914 #
3915 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3916 # key_region/cryptoKeys/key
3917 # /cryptoKeyVersions/1
3918 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3919 # key. If absent, the Compute Engine default service account is used.
3920 # For example:
3921 #
3922 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3923 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3924 # encryption key, encoded in RFC
3925 # 4648 base64 to either encrypt or decrypt this resource. You can
3926 # provide either the rawKey or thersaEncryptedKey.
3927 # For example:
3928 #
3929 # &quot;rawKey&quot;:
3930 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3931 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3932 # customer-supplied encryption key to either encrypt or decrypt this
3933 # resource. You can provide either the rawKey or thersaEncryptedKey.
3934 # For example:
3935 #
3936 # &quot;rsaEncryptedKey&quot;:
3937 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3938 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3939 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3940 #
3941 # The key must meet the following requirements before you can provide it to
3942 # Compute Engine:
3943 #
3944 # 1. The key is wrapped using a RSA public key certificate provided by
3945 # Google.
3946 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3947 # encoding.
3948 #
3949 # Gets the RSA public key certificate provided by Google at:
3950 #
3951 #
3952 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3953 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3954 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3955 # encryption key that protects this resource.
3956 },
3957 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
3958 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
3959 # Windows specific VSS signature.
3960 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
3961 # only for bootable images. Read
3962 # Enabling guest operating system features to see a list of available
3963 # options.
3964 { # Guest OS features.
3965 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
3966 # separate values. Set to one or more of the following values:
3967 #
3968 # - VIRTIO_SCSI_MULTIQUEUE
3969 # - WINDOWS
3970 # - MULTI_IP_SUBNET
3971 # - UEFI_COMPATIBLE
3972 # - GVNIC
3973 # - SEV_CAPABLE
3974 # - SUSPEND_RESUME_COMPATIBLE
3975 # - SEV_LIVE_MIGRATABLE_V2
3976 # - SEV_SNP_CAPABLE
3977 # - TDX_CAPABLE
3978 # - IDPF
3979 # - SNP_SVSM_CAPABLE
3980 # - CCA_CAPABLE
3981 #
3982 #
3983 # For more information, see
3984 # Enabling guest operating system features.
3985 },
3986 ],
3987 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
3988 # defined by the server.
3989 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
3990 # which is either SCSI or NVME. The default isSCSI.
3991 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
3992 # disks.
3993 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
3994 # essentially a hash of the labels set used for optimistic locking. The
3995 # fingerprint is initially generated by Compute Engine and changes after
3996 # every request to modify or update labels. You must always provide an
3997 # up-to-date fingerprint hash in order to update or change labels,
3998 # otherwise the request will fail with error412 conditionNotMet.
3999 #
4000 # To see the latest fingerprint, make a get() request to
4001 # retrieve a disk.
4002 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
4003 # the setLabels method.
4004 &quot;a_key&quot;: &quot;A String&quot;,
4005 },
4006 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
4007 # text format.
4008 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
4009 # text format.
4010 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
4011 &quot;A String&quot;,
4012 ],
4013 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
4014 &quot;A String&quot;,
4015 ],
4016 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
4017 # This field is for use by internal tools that use the public API.
4018 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
4019 # source image. Attachment of a disk created from a locked source image will
4020 # cause the following operations to become irreversibly prohibited:
4021 #
4022 # - R/W or R/O disk attachment to any other instance
4023 # - Disk detachment. And the disk can only be deleted when the instance
4024 # is deleted
4025 # - Creation of images or snapshots
4026 # - Disk cloning
4027 #
4028 #
4029 #
4030 # Furthermore, the instance with at least one disk with locked flag set to
4031 # true will be prohibited from performing the operations below:
4032 #
4033 # - Further attachment of secondary disks.
4034 # - Detachment of any disks
4035 # - Create machine images
4036 # - Create instance template
4037 # - Delete the instance with --keep-disk parameter set to true for locked
4038 # disks
4039 # - Attach a locked disk with --auto-delete parameter set to false
4040 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
4041 # more than one instance.
4042 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
4043 # The name must be 1-63 characters long, and comply withRFC1035.
4044 # Specifically, the name must be 1-63 characters long and match the regular
4045 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
4046 # which means the first character must be a lowercase letter, and all
4047 # following characters must be a dash, lowercase letter, or digit, except
4048 # the last character, which cannot be a dash.
4049 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
4050 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
4051 # as part of resource payload.
4052 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
4053 # have the same definition as resource
4054 # manager tags. Keys and values can be either in numeric format,
4055 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4056 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4057 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
4058 # PATCH) when empty.
4059 &quot;a_key&quot;: &quot;A String&quot;,
4060 },
4061 },
4062 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
4063 # If not present in a request, a default value is used.
4064 # The currently supported size is 4096, other sizes may be added in
4065 # the future.
4066 # If an unsupported value is requested, the error message will list
4067 # the supported values for the caller&#x27;s project.
4068 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
4069 # of I/O operations per second that the disk can handle. Values must be
4070 # between 10,000 and 120,000. For more details, see theExtreme persistent
4071 # disk documentation.
4072 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
4073 # number of throughput mb per second that the disk can handle. Values must be
4074 # greater than or equal to 1.
4075 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
4076 # regional resources.
4077 # You must specify this field as part of the HTTP request URL. It is
4078 # not settable as a field in the request body.
4079 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
4080 # for regional resources.
4081 &quot;A String&quot;,
4082 ],
4083 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
4084 &quot;A String&quot;,
4085 ],
4086 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
4087 &quot;asyncPrimaryDisk&quot;: {
4088 &quot;state&quot;: &quot;A String&quot;,
4089 },
4090 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
4091 &quot;a_key&quot;: {
4092 &quot;state&quot;: &quot;A String&quot;,
4093 },
4094 },
4095 &quot;usedBytes&quot;: &quot;A String&quot;, # [Output Only] Space used by data stored in the disk (in bytes). Note that
4096 # this field is set only when the disk is in a storage pool.
4097 },
4098 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
4099 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
4100 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
4101 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
4102 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
4103 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
4104 # persistent disk.
4105 #
4106 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
4107 # source.
4108 # Acceptable values are greater than 0.
4109 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
4110 # that was created using a consistency group.
4111 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
4112 # that was created using a consistency group.
4113 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
4114 # partial or full URL to the resource. For example, the following are valid
4115 # values:
4116 #
4117 #
4118 # -
4119 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
4120 #
4121 # -
4122 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
4123 #
4124 # -
4125 # projects/project/zones/zone/disks/disk
4126 #
4127 # -
4128 # projects/project/regions/region/disks/disk
4129 #
4130 # -
4131 # zones/zone/disks/disk
4132 #
4133 # -
4134 # regions/region/disks/disk
4135 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
4136 # value identifies the exact disk that was used to create this persistent
4137 # disk. For example, if you created the persistent disk from a disk that
4138 # was later deleted and recreated under the same name, the source disk ID
4139 # would identify the exact version of the disk that was used.
4140 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
4141 # deleted, this field will not be set.
4142 #
4143 # To create a disk with one of the public operating system images, specify
4144 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
4145 #
4146 # projects/debian-cloud/global/images/family/debian-9
4147 #
4148 #
4149 # Alternatively, use a specific version of a public operating system image:
4150 #
4151 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
4152 #
4153 #
4154 # To create a disk with a custom image that you created, specify the
4155 # image name in the following format:
4156 #
4157 # global/images/my-custom-image
4158 #
4159 #
4160 # You can also specify a custom image by its image family, which returns
4161 # the latest version of the image in that family. Replace the image name
4162 # with family/family-name:
4163 #
4164 # global/images/family/my-image-family
4165 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
4166 # encryption key of the source image. Required if the source image is
4167 # protected by a customer-supplied encryption key.
4168 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4169 # For example:
4170 #
4171 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4172 # key_region/cryptoKeys/key
4173 #
4174 # The fully-qualifed key name may be returned for resource GET requests. For
4175 # example:
4176 #
4177 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4178 # key_region/cryptoKeys/key
4179 # /cryptoKeyVersions/1
4180 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4181 # key. If absent, the Compute Engine default service account is used.
4182 # For example:
4183 #
4184 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4185 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4186 # encryption key, encoded in RFC
4187 # 4648 base64 to either encrypt or decrypt this resource. You can
4188 # provide either the rawKey or thersaEncryptedKey.
4189 # For example:
4190 #
4191 # &quot;rawKey&quot;:
4192 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4193 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4194 # customer-supplied encryption key to either encrypt or decrypt this
4195 # resource. You can provide either the rawKey or thersaEncryptedKey.
4196 # For example:
4197 #
4198 # &quot;rsaEncryptedKey&quot;:
4199 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4200 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4201 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4202 #
4203 # The key must meet the following requirements before you can provide it to
4204 # Compute Engine:
4205 #
4206 # 1. The key is wrapped using a RSA public key certificate provided by
4207 # Google.
4208 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4209 # encoding.
4210 #
4211 # Gets the RSA public key certificate provided by Google at:
4212 #
4213 #
4214 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4215 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4216 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4217 # encryption key that protects this resource.
4218 },
4219 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
4220 # value identifies the exact image that was used to create this persistent
4221 # disk. For example, if you created the persistent disk from an image that
4222 # was later deleted and recreated under the same name, the source image ID
4223 # would identify the exact version of the image that was used.
4224 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
4225 # this as a partial or full URL to the resource. For example, the following
4226 # are valid values:
4227 #
4228 #
4229 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
4230 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
4231 # - zones/zone/instantSnapshots/instantSnapshot
4232 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
4233 # disk. This value identifies the exact instant snapshot that was used to
4234 # create this persistent disk. For example, if you created the persistent
4235 # disk from an instant snapshot that was later deleted and recreated under
4236 # the same name, the source instant snapshot ID would identify the exact
4237 # version of the instant snapshot that was used.
4238 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
4239 # partial or full URL to the resource. For example, the following are valid
4240 # values:
4241 #
4242 #
4243 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
4244 # - projects/project/global/machineImages/machineImage
4245 # - global/machineImages/machineImage
4246 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
4247 # source_machine_image must be specified.
4248 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
4249 # encryption key of the source machine image. Required if the source
4250 # machine image is protected by a customer-supplied encryption key.
4251 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4252 # For example:
4253 #
4254 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4255 # key_region/cryptoKeys/key
4256 #
4257 # The fully-qualifed key name may be returned for resource GET requests. For
4258 # example:
4259 #
4260 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4261 # key_region/cryptoKeys/key
4262 # /cryptoKeyVersions/1
4263 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4264 # key. If absent, the Compute Engine default service account is used.
4265 # For example:
4266 #
4267 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4268 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4269 # encryption key, encoded in RFC
4270 # 4648 base64 to either encrypt or decrypt this resource. You can
4271 # provide either the rawKey or thersaEncryptedKey.
4272 # For example:
4273 #
4274 # &quot;rawKey&quot;:
4275 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4276 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4277 # customer-supplied encryption key to either encrypt or decrypt this
4278 # resource. You can provide either the rawKey or thersaEncryptedKey.
4279 # For example:
4280 #
4281 # &quot;rsaEncryptedKey&quot;:
4282 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4283 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4284 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4285 #
4286 # The key must meet the following requirements before you can provide it to
4287 # Compute Engine:
4288 #
4289 # 1. The key is wrapped using a RSA public key certificate provided by
4290 # Google.
4291 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4292 # encoding.
4293 #
4294 # Gets the RSA public key certificate provided by Google at:
4295 #
4296 #
4297 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4298 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4299 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4300 # encryption key that protects this resource.
4301 },
4302 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
4303 # This value identifies the exact machine image that was used to create this
4304 # persistent disk. For example, if you created the persistent disk from a
4305 # machine image that was later deleted and recreated under the same name, the
4306 # source machine image ID would identify the exact version of the machine
4307 # image that was used.
4308 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
4309 # partial or full URL to the resource. For example, the following are valid
4310 # values:
4311 #
4312 #
4313 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
4314 # - projects/project/global/snapshots/snapshot
4315 # - global/snapshots/snapshot
4316 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
4317 # encryption key of the source snapshot. Required if the source snapshot
4318 # is protected by a customer-supplied encryption key.
4319 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4320 # For example:
4321 #
4322 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4323 # key_region/cryptoKeys/key
4324 #
4325 # The fully-qualifed key name may be returned for resource GET requests. For
4326 # example:
4327 #
4328 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4329 # key_region/cryptoKeys/key
4330 # /cryptoKeyVersions/1
4331 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4332 # key. If absent, the Compute Engine default service account is used.
4333 # For example:
4334 #
4335 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4336 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4337 # encryption key, encoded in RFC
4338 # 4648 base64 to either encrypt or decrypt this resource. You can
4339 # provide either the rawKey or thersaEncryptedKey.
4340 # For example:
4341 #
4342 # &quot;rawKey&quot;:
4343 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4344 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4345 # customer-supplied encryption key to either encrypt or decrypt this
4346 # resource. You can provide either the rawKey or thersaEncryptedKey.
4347 # For example:
4348 #
4349 # &quot;rsaEncryptedKey&quot;:
4350 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4351 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4352 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4353 #
4354 # The key must meet the following requirements before you can provide it to
4355 # Compute Engine:
4356 #
4357 # 1. The key is wrapped using a RSA public key certificate provided by
4358 # Google.
4359 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4360 # encoding.
4361 #
4362 # Gets the RSA public key certificate provided by Google at:
4363 #
4364 #
4365 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4366 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4367 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4368 # encryption key that protects this resource.
4369 },
4370 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
4371 # value identifies the exact snapshot that was used to create this persistent
4372 # disk. For example, if you created the persistent disk from a snapshot that
4373 # was later deleted and recreated under the same name, the source snapshot ID
4374 # would identify the exact version of the snapshot that was used.
4375 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
4376 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
4377 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
4378 # https://storage.googleapis.com/. This flag is not optimized for creating
4379 # multiple disks from a source storage object. To create many disks from a
4380 # source storage object, use gcloud compute images
4381 # import instead.
4382 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
4383 #
4384 #
4385 # - CREATING: Disk is provisioning.
4386 # - RESTORING: Source data is being copied into the
4387 # disk.
4388 # - FAILED: Disk creation failed.
4389 # - READY: Disk is ready for use.
4390 # - DELETING: Disk is deleting.
4391 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
4392 # this as a partial or full URL to the resource. For example, the following
4393 # are valid values:
4394 #
4395 #
4396 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
4397 # - projects/project/zones/zone/storagePools/storagePool
4398 # - zones/zone/storagePools/storagePool
4399 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
4400 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
4401 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
4402 # types.
4403 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
4404 # in form:projects/project/zones/zone/instances/instance
4405 &quot;A String&quot;,
4406 ],
4407 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
4408 # You must specify this field as part of the HTTP request URL. It is
4409 # not settable as a field in the request body.
4410 },
4411 ],
4412 &quot;kind&quot;: &quot;compute#diskList&quot;, # Output only. [Output Only] Type of resource. Always compute#diskList for
4413 # lists of disks.
4414 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
4415 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
4416 # the query parameter pageToken in the next list request.
4417 # Subsequent list requests will have their own nextPageToken to
4418 # continue paging through the results.
4419 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
4420 &quot;warning&quot;: { # [Output Only] Informational warning message.
4421 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4422 # Engine returns NO_RESULTS_ON_PAGE if there
4423 # are no results in the response.
4424 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4425 # value format. For example:
4426 #
4427 # &quot;data&quot;: [
4428 # {
4429 # &quot;key&quot;: &quot;scope&quot;,
4430 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4431 # }
4432 {
4433 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4434 # returned. For example, for warnings where there are no results in a list
4435 # request for a particular zone, this key might be scope and
4436 # the key value might be the zone name. Other examples might be a key
4437 # indicating a deprecated resource and a suggested replacement, or a
4438 # warning about invalid network settings (for example, if an instance
4439 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4440 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4441 },
4442 ],
4443 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4444 },
4445 }</pre>
4446 </div>
4447
4448 <div class="method">
4449 <code class="details" id="list_next">list_next()</code>
4450 <pre>Retrieves the next page of results.
4451
4452 Args:
4453 previous_request: The request for the previous page. (required)
4454 previous_response: The response from the request for the previous page. (required)
4455
4456 Returns:
4457 A request object that you can call &#x27;execute()&#x27; on to request the next
4458 page. Returns None if there are no more items in the collection.
4459 </pre>
4460 </div>
4461
4462 <div class="method">
4463 <code class="details" id="removeResourcePolicies">removeResourcePolicies(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
4464 <pre>Removes resource policies from a regional disk.
4465
4466 Args:
4467 project: string, Project ID for this request. (required)
4468 region: string, The name of the region for this request. (required)
4469 disk: string, The disk name for this request. (required)
4470 body: object, The request body.
4471 The object takes the form of:
4472
4473 {
4474 &quot;resourcePolicies&quot;: [ # Resource policies to be removed from this disk.
4475 &quot;A String&quot;,
4476 ],
4477 }
4478
4479 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
4480 that if you must retry your request, the server will know to ignore the
4481 request if it has already been completed.
4482
4483 For example, consider a situation where you make an initial request and
4484 the request times out. If you make the request again with the same
4485 request ID, the server can check if original operation with the same
4486 request ID was received, and if so, will ignore the second request. This
4487 prevents clients from accidentally creating duplicate commitments.
4488
4489 The request ID must be
4490 a valid UUID with the exception that zero UUID is not supported
4491 (00000000-0000-0000-0000-000000000000).
4492 x__xgafv: string, V1 error format.
4493 Allowed values
4494 1 - v1 error format
4495 2 - v2 error format
4496
4497 Returns:
4498 An object of the form:
4499
4500 { # Represents an Operation resource.
4501 #
4502 # Google Compute Engine has three Operation resources:
4503 #
4504 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
4505 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
4506 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
4507 #
4508 # You can use an operation resource to manage asynchronous API requests.
4509 # For more information, readHandling
4510 # API responses.
4511 #
4512 # Operations can be global, regional or zonal.
4513 #
4514 # - For global operations, use the `globalOperations`
4515 # resource.
4516 # - For regional operations, use the
4517 # `regionOperations` resource.
4518 # - For zonal operations, use
4519 # the `zoneOperations` resource.
4520 #
4521 #
4522 #
4523 # For more information, read
4524 # Global, Regional, and Zonal Resources.
4525 #
4526 # Note that completed Operation resources have a limited
4527 # retention period.
4528 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4529 # Not present otherwise.
4530 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4531 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4532 # set when the operation is created.
4533 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4534 # text format.
4535 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4536 # this field will be populated.
4537 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4538 # operation.
4539 {
4540 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4541 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4542 # details. There is a set of defined message types to use for providing
4543 # details.The syntax depends on the error code. For example,
4544 # QuotaExceededInfo will have details when the error code is
4545 # QUOTA_EXCEEDED.
4546 {
4547 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4548 #
4549 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4550 # is not enabled:
4551 #
4552 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4553 # &quot;domain&quot;: &quot;googleapis.com&quot;
4554 # &quot;metadata&quot;: {
4555 # &quot;resource&quot;: &quot;projects/123&quot;,
4556 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4557 # }
4558 # }
4559 #
4560 # This response indicates that the pubsub.googleapis.com API is not enabled.
4561 #
4562 # Example of an error that is returned when attempting to create a Spanner
4563 # instance in a region that is out of stock:
4564 #
4565 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4566 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4567 # &quot;metadata&quot;: {
4568 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4569 # }
4570 # }
4571 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4572 # is typically the registered service name of the tool or product that
4573 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4574 # generated by some common infrastructure, the error domain must be a
4575 # globally unique value that identifies the infrastructure. For Google API
4576 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4577 &quot;metadatas&quot;: { # Additional structured details about this error.
4578 #
4579 # Keys must match a regular expression of `a-z+` but should
4580 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4581 # length. When identifying the current value of an exceeded limit, the units
4582 # should be contained in the key, not the value. For example, rather than
4583 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4584 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4585 # instances that can be created in a single (batch) request.
4586 &quot;a_key&quot;: &quot;A String&quot;,
4587 },
4588 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4589 # proximate cause of the error. Error reasons are unique within a particular
4590 # domain of errors. This should be at most 63 characters and match a
4591 # regular expression of `A-Z+[A-Z0-9]`, which represents
4592 # UPPER_SNAKE_CASE.
4593 },
4594 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4595 #
4596 # For example, if a quota check failed with an error indicating the calling
4597 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4598 # directly to the right place in the developer console to flip the bit.
4599 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4600 { # Describes a URL link.
4601 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4602 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4603 },
4604 ],
4605 },
4606 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4607 # which can be attached to an RPC error.
4608 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4609 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4610 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4611 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4612 },
4613 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4614 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4615 &quot;a_key&quot;: &quot;A String&quot;,
4616 },
4617 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4618 # type or metric.
4619 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4620 # or metric.
4621 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4622 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4623 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4624 },
4625 },
4626 ],
4627 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4628 # This property is optional.
4629 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4630 },
4631 ],
4632 },
4633 &quot;getVersionOperationMetadata&quot;: {
4634 &quot;inlineSbomInfo&quot;: {
4635 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4636 # appropriate identifiers.
4637 &quot;a_key&quot;: &quot;A String&quot;,
4638 },
4639 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4640 # identifiers.
4641 &quot;a_key&quot;: &quot;A String&quot;,
4642 },
4643 },
4644 },
4645 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4646 # message that was returned, such as `NOT FOUND`.
4647 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4648 # status code that was returned. For example, a `404` means the
4649 # resource was not found.
4650 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4651 # defined by the server.
4652 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4653 # This value is inRFC3339
4654 # text format.
4655 &quot;instancesBulkInsertOperationMetadata&quot;: {
4656 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4657 # Example key: zones/us-central1-a
4658 &quot;a_key&quot;: {
4659 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4660 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4661 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4662 # error.
4663 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4664 # if the flow is rolling forward or rolling back.
4665 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4666 },
4667 },
4668 },
4669 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4670 # Operation resources.
4671 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4672 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4673 # group of operations results from a `bulkInsert` API request.
4674 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4675 # `update`, or `delete`, and so on.
4676 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4677 # There is no requirement that this be linear or support any granularity of
4678 # operations. This should not be used to guess when the operation will be
4679 # complete. This number should monotonically increase as the operation
4680 # progresses.
4681 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4682 # applicable when performing regional operations.
4683 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4684 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
4685 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4686 # this field will contain information on all underlying zonal actions and
4687 # their state.
4688 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4689 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4690 # Example key: zones/us-central1-a
4691 &quot;a_key&quot;: {
4692 &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
4693 # populated.
4694 # different programming environments, including REST APIs and RPC APIs. It is
4695 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4696 # three pieces of data: error code, error message, and error details.
4697 #
4698 # You can find out more about this error model and how to work with it in the
4699 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4700 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4701 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4702 # message types for APIs to use.
4703 {
4704 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4705 },
4706 ],
4707 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4708 # user-facing error message should be localized and sent in the
4709 # google.rpc.Status.details field, or localized by the client.
4710 },
4711 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4712 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4713 },
4714 },
4715 },
4716 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4717 # This value is inRFC3339
4718 # text format.
4719 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4720 # following:
4721 # `PENDING`, `RUNNING`, or `DONE`.
4722 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4723 # operation.
4724 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4725 # of the target resource.
4726 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4727 # operations related to creating a snapshot, this points to the disk
4728 # that the snapshot was created from.
4729 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4730 # `[email protected]` or
4731 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4732 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4733 # operation, this field will be populated.
4734 {
4735 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4736 # Engine returns NO_RESULTS_ON_PAGE if there
4737 # are no results in the response.
4738 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4739 # value format. For example:
4740 #
4741 # &quot;data&quot;: [
4742 # {
4743 # &quot;key&quot;: &quot;scope&quot;,
4744 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4745 # }
4746 {
4747 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4748 # returned. For example, for warnings where there are no results in a list
4749 # request for a particular zone, this key might be scope and
4750 # the key value might be the zone name. Other examples might be a key
4751 # indicating a deprecated resource and a suggested replacement, or a
4752 # warning about invalid network settings (for example, if an instance
4753 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4754 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4755 },
4756 ],
4757 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4758 },
4759 ],
4760 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4761 # applicable when performing per-zone operations.
4762 }</pre>
4763 </div>
4764
4765 <div class="method">
4766 <code class="details" id="resize">resize(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
4767 <pre>Resizes the specified regional persistent disk.
4768
4769 Args:
4770 project: string, The project ID for this request. (required)
4771 region: string, Name of the region for this request. (required)
4772 disk: string, Name of the regional persistent disk. (required)
4773 body: object, The request body.
4774 The object takes the form of:
4775
4776 {
4777 &quot;sizeGb&quot;: &quot;A String&quot;, # The new size of the regional persistent disk, which is specified in GB.
4778 }
4779
4780 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
4781 that if you must retry your request, the server will know to ignore the
4782 request if it has already been completed.
4783
4784 For example, consider a situation where you make an initial request and
4785 the request times out. If you make the request again with the same
4786 request ID, the server can check if original operation with the same
4787 request ID was received, and if so, will ignore the second request. This
4788 prevents clients from accidentally creating duplicate commitments.
4789
4790 The request ID must be
4791 a valid UUID with the exception that zero UUID is not supported
4792 (00000000-0000-0000-0000-000000000000).
4793 x__xgafv: string, V1 error format.
4794 Allowed values
4795 1 - v1 error format
4796 2 - v2 error format
4797
4798 Returns:
4799 An object of the form:
4800
4801 { # Represents an Operation resource.
4802 #
4803 # Google Compute Engine has three Operation resources:
4804 #
4805 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
4806 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
4807 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
4808 #
4809 # You can use an operation resource to manage asynchronous API requests.
4810 # For more information, readHandling
4811 # API responses.
4812 #
4813 # Operations can be global, regional or zonal.
4814 #
4815 # - For global operations, use the `globalOperations`
4816 # resource.
4817 # - For regional operations, use the
4818 # `regionOperations` resource.
4819 # - For zonal operations, use
4820 # the `zoneOperations` resource.
4821 #
4822 #
4823 #
4824 # For more information, read
4825 # Global, Regional, and Zonal Resources.
4826 #
4827 # Note that completed Operation resources have a limited
4828 # retention period.
4829 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4830 # Not present otherwise.
4831 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4832 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4833 # set when the operation is created.
4834 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4835 # text format.
4836 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4837 # this field will be populated.
4838 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4839 # operation.
4840 {
4841 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4842 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4843 # details. There is a set of defined message types to use for providing
4844 # details.The syntax depends on the error code. For example,
4845 # QuotaExceededInfo will have details when the error code is
4846 # QUOTA_EXCEEDED.
4847 {
4848 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4849 #
4850 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4851 # is not enabled:
4852 #
4853 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4854 # &quot;domain&quot;: &quot;googleapis.com&quot;
4855 # &quot;metadata&quot;: {
4856 # &quot;resource&quot;: &quot;projects/123&quot;,
4857 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4858 # }
4859 # }
4860 #
4861 # This response indicates that the pubsub.googleapis.com API is not enabled.
4862 #
4863 # Example of an error that is returned when attempting to create a Spanner
4864 # instance in a region that is out of stock:
4865 #
4866 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4867 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4868 # &quot;metadata&quot;: {
4869 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4870 # }
4871 # }
4872 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4873 # is typically the registered service name of the tool or product that
4874 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4875 # generated by some common infrastructure, the error domain must be a
4876 # globally unique value that identifies the infrastructure. For Google API
4877 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4878 &quot;metadatas&quot;: { # Additional structured details about this error.
4879 #
4880 # Keys must match a regular expression of `a-z+` but should
4881 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4882 # length. When identifying the current value of an exceeded limit, the units
4883 # should be contained in the key, not the value. For example, rather than
4884 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4885 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4886 # instances that can be created in a single (batch) request.
4887 &quot;a_key&quot;: &quot;A String&quot;,
4888 },
4889 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4890 # proximate cause of the error. Error reasons are unique within a particular
4891 # domain of errors. This should be at most 63 characters and match a
4892 # regular expression of `A-Z+[A-Z0-9]`, which represents
4893 # UPPER_SNAKE_CASE.
4894 },
4895 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4896 #
4897 # For example, if a quota check failed with an error indicating the calling
4898 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4899 # directly to the right place in the developer console to flip the bit.
4900 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4901 { # Describes a URL link.
4902 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4903 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4904 },
4905 ],
4906 },
4907 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4908 # which can be attached to an RPC error.
4909 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4910 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4911 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4912 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4913 },
4914 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4915 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4916 &quot;a_key&quot;: &quot;A String&quot;,
4917 },
4918 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4919 # type or metric.
4920 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4921 # or metric.
4922 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4923 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4924 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4925 },
4926 },
4927 ],
4928 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4929 # This property is optional.
4930 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4931 },
4932 ],
4933 },
4934 &quot;getVersionOperationMetadata&quot;: {
4935 &quot;inlineSbomInfo&quot;: {
4936 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4937 # appropriate identifiers.
4938 &quot;a_key&quot;: &quot;A String&quot;,
4939 },
4940 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4941 # identifiers.
4942 &quot;a_key&quot;: &quot;A String&quot;,
4943 },
4944 },
4945 },
4946 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4947 # message that was returned, such as `NOT FOUND`.
4948 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4949 # status code that was returned. For example, a `404` means the
4950 # resource was not found.
4951 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4952 # defined by the server.
4953 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4954 # This value is inRFC3339
4955 # text format.
4956 &quot;instancesBulkInsertOperationMetadata&quot;: {
4957 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4958 # Example key: zones/us-central1-a
4959 &quot;a_key&quot;: {
4960 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4961 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4962 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4963 # error.
4964 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4965 # if the flow is rolling forward or rolling back.
4966 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4967 },
4968 },
4969 },
4970 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4971 # Operation resources.
4972 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4973 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4974 # group of operations results from a `bulkInsert` API request.
4975 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4976 # `update`, or `delete`, and so on.
4977 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4978 # There is no requirement that this be linear or support any granularity of
4979 # operations. This should not be used to guess when the operation will be
4980 # complete. This number should monotonically increase as the operation
4981 # progresses.
4982 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4983 # applicable when performing regional operations.
4984 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4985 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
4986 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4987 # this field will contain information on all underlying zonal actions and
4988 # their state.
4989 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4990 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4991 # Example key: zones/us-central1-a
4992 &quot;a_key&quot;: {
4993 &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
4994 # populated.
4995 # different programming environments, including REST APIs and RPC APIs. It is
4996 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4997 # three pieces of data: error code, error message, and error details.
4998 #
4999 # You can find out more about this error model and how to work with it in the
5000 # [API Design Guide](https://cloud.google.com/apis/design/errors).
5001 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
5002 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
5003 # message types for APIs to use.
5004 {
5005 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
5006 },
5007 ],
5008 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
5009 # user-facing error message should be localized and sent in the
5010 # google.rpc.Status.details field, or localized by the client.
5011 },
5012 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
5013 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
5014 },
5015 },
5016 },
5017 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
5018 # This value is inRFC3339
5019 # text format.
5020 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
5021 # following:
5022 # `PENDING`, `RUNNING`, or `DONE`.
5023 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
5024 # operation.
5025 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
5026 # of the target resource.
5027 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
5028 # operations related to creating a snapshot, this points to the disk
5029 # that the snapshot was created from.
5030 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
5031 # `[email protected]` or
5032 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
5033 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
5034 # operation, this field will be populated.
5035 {
5036 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
5037 # Engine returns NO_RESULTS_ON_PAGE if there
5038 # are no results in the response.
5039 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
5040 # value format. For example:
5041 #
5042 # &quot;data&quot;: [
5043 # {
5044 # &quot;key&quot;: &quot;scope&quot;,
5045 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
5046 # }
5047 {
5048 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
5049 # returned. For example, for warnings where there are no results in a list
5050 # request for a particular zone, this key might be scope and
5051 # the key value might be the zone name. Other examples might be a key
5052 # indicating a deprecated resource and a suggested replacement, or a
5053 # warning about invalid network settings (for example, if an instance
5054 # attempts to perform IP forwarding but is not enabled for IP forwarding).
5055 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
5056 },
5057 ],
5058 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
5059 },
5060 ],
5061 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
5062 # applicable when performing per-zone operations.
5063 }</pre>
5064 </div>
5065
5066 <div class="method">
5067 <code class="details" id="setIamPolicy">setIamPolicy(project, region, resource, body=None, x__xgafv=None)</code>
5068 <pre>Sets the access control policy on the specified resource.
5069 Replaces any existing policy.
5070
5071 Args:
5072 project: string, Project ID for this request. (required)
5073 region: string, The name of the region for this request. (required)
5074 resource: string, Name or id of the resource for this request. (required)
5075 body: object, The request body.
5076 The object takes the form of:
5077
5078 {
5079 &quot;bindings&quot;: [ # Flatten Policy to create a backwacd compatible wire-format.
5080 # Deprecated. Use &#x27;policy&#x27; to specify bindings.
5081 { # Associates `members`, or principals, with a `role`.
5082 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
5083 #
5084 # If the condition evaluates to `true`, then this binding applies to the
5085 # current request.
5086 #
5087 # If the condition evaluates to `false`, then this binding does not apply to
5088 # the current request. However, a different role binding might grant the same
5089 # role to one or more of the principals in this binding.
5090 #
5091 # To learn which resources support conditions in their IAM policies, see the
5092 # [IAM
5093 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5094 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
5095 # are documented at https://github.com/google/cel-spec.
5096 #
5097 # Example (Comparison):
5098 #
5099 # title: &quot;Summary size limit&quot;
5100 # description: &quot;Determines if a summary is less than 100 chars&quot;
5101 # expression: &quot;document.summary.size() &lt; 100&quot;
5102 #
5103 # Example (Equality):
5104 #
5105 # title: &quot;Requestor is owner&quot;
5106 # description: &quot;Determines if requestor is the document owner&quot;
5107 # expression: &quot;document.owner == request.auth.claims.email&quot;
5108 #
5109 # Example (Logic):
5110 #
5111 # title: &quot;Public documents&quot;
5112 # description: &quot;Determine whether the document should be publicly visible&quot;
5113 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
5114 #
5115 # Example (Data Manipulation):
5116 #
5117 # title: &quot;Notification string&quot;
5118 # description: &quot;Create a notification string with a timestamp.&quot;
5119 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
5120 #
5121 # The exact variables and functions that may be referenced within an expression
5122 # are determined by the service that evaluates it. See the service
5123 # documentation for additional information.
5124 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
5125 # describes the expression, e.g. when hovered over it in a UI.
5126 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
5127 # syntax.
5128 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
5129 # reporting, e.g. a file name and a position in the file.
5130 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
5131 # its purpose. This can be used e.g. in UIs which allow to enter the
5132 # expression.
5133 },
5134 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
5135 # `members` can have the following values:
5136 #
5137 # * `allUsers`: A special identifier that represents anyone who is
5138 # on the internet; with or without a Google account.
5139 #
5140 # * `allAuthenticatedUsers`: A special identifier that represents anyone
5141 # who is authenticated with a Google account or a service account.
5142 # Does not include identities that come from external identity providers
5143 # (IdPs) through identity federation.
5144 #
5145 # * `user:{emailid}`: An email address that represents a specific Google
5146 # account. For example, `[email protected]` .
5147 #
5148 #
5149 # * `serviceAccount:{emailid}`: An email address that represents a Google
5150 # service account. For example,
5151 # `[email protected]`.
5152 #
5153 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
5154 # identifier for a
5155 # [Kubernetes service
5156 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
5157 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
5158 #
5159 # * `group:{emailid}`: An email address that represents a Google group.
5160 # For example, `[email protected]`.
5161 #
5162 #
5163 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
5164 # users of that domain. For example, `google.com` or `example.com`.
5165 #
5166 #
5167 #
5168 #
5169 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5170 # A single identity in a workforce identity pool.
5171 #
5172 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
5173 # All workforce identities in a group.
5174 #
5175 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5176 # All workforce identities with a specific attribute value.
5177 #
5178 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
5179 # All identities in a workforce identity pool.
5180 #
5181 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
5182 # A single identity in a workload identity pool.
5183 #
5184 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
5185 # A workload identity pool group.
5186 #
5187 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5188 # All identities in a workload identity pool with a certain attribute.
5189 #
5190 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
5191 # All identities in a workload identity pool.
5192 #
5193 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
5194 # identifier) representing a user that has been recently deleted. For
5195 # example, `[email protected]?uid=123456789012345678901`. If the user is
5196 # recovered, this value reverts to `user:{emailid}` and the recovered user
5197 # retains the role in the binding.
5198 #
5199 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
5200 # unique identifier) representing a service account that has been recently
5201 # deleted. For example,
5202 # `[email protected]?uid=123456789012345678901`.
5203 # If the service account is undeleted, this value reverts to
5204 # `serviceAccount:{emailid}` and the undeleted service account retains the
5205 # role in the binding.
5206 #
5207 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
5208 # identifier) representing a Google group that has been recently
5209 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
5210 # the group is recovered, this value reverts to `group:{emailid}` and the
5211 # recovered group retains the role in the binding.
5212 #
5213 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5214 # Deleted single identity in a workforce identity pool. For example,
5215 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
5216 &quot;A String&quot;,
5217 ],
5218 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
5219 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
5220 #
5221 # For an overview of the IAM roles and permissions, see the
5222 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
5223 # a list of the available pre-defined roles, see
5224 # [here](https://cloud.google.com/iam/docs/understanding-roles).
5225 },
5226 ],
5227 &quot;etag&quot;: &quot;A String&quot;, # Flatten Policy to create a backward compatible wire-format.
5228 # Deprecated. Use &#x27;policy&#x27; to specify the etag.
5229 &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
5230 # the policy is limited to a few 10s of KB. An empty policy is in general a
5231 # valid policy but certain services (like Projects) might reject them.
5232 # controls for Google Cloud resources.
5233 #
5234 #
5235 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
5236 # `members`, or principals, to a single `role`. Principals can be user
5237 # accounts, service accounts, Google groups, and domains (such as G Suite). A
5238 # `role` is a named list of permissions; each `role` can be an IAM predefined
5239 # role or a user-created custom role.
5240 #
5241 # For some types of Google Cloud resources, a `binding` can also specify a
5242 # `condition`, which is a logical expression that allows access to a resource
5243 # only if the expression evaluates to `true`. A condition can add constraints
5244 # based on attributes of the request, the resource, or both. To learn which
5245 # resources support conditions in their IAM policies, see the
5246 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5247 #
5248 # **JSON example:**
5249 #
5250 # ```
5251 # {
5252 # &quot;bindings&quot;: [
5253 # {
5254 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
5255 # &quot;members&quot;: [
5256 # &quot;user:[email protected]&quot;,
5257 # &quot;group:[email protected]&quot;,
5258 # &quot;domain:google.com&quot;,
5259 # &quot;serviceAccount:[email protected]&quot;
5260 # ]
5261 # },
5262 # {
5263 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
5264 # &quot;members&quot;: [
5265 # &quot;user:[email protected]&quot;
5266 # ],
5267 # &quot;condition&quot;: {
5268 # &quot;title&quot;: &quot;expirable access&quot;,
5269 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
5270 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
5271 # }
5272 # }
5273 # ],
5274 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
5275 # &quot;version&quot;: 3
5276 # }
5277 # ```
5278 #
5279 # **YAML example:**
5280 #
5281 # ```
5282 # bindings:
5283 # - members:
5284 # - user:[email protected]
5285 # - group:[email protected]
5286 # - domain:google.com
5287 # - serviceAccount:[email protected]
5288 # role: roles/resourcemanager.organizationAdmin
5289 # - members:
5290 # - user:[email protected]
5291 # role: roles/resourcemanager.organizationViewer
5292 # condition:
5293 # title: expirable access
5294 # description: Does not grant access after Sep 2020
5295 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
5296 # etag: BwWWja0YfJA=
5297 # version: 3
5298 # ```
5299 #
5300 # For a description of IAM and its features, see the
5301 # [IAM documentation](https://cloud.google.com/iam/docs/).
5302 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
5303 { # Specifies the audit configuration for a service.
5304 # The configuration determines which permission types are logged, and what
5305 # identities, if any, are exempted from logging.
5306 # An AuditConfig must have one or more AuditLogConfigs.
5307 #
5308 # If there are AuditConfigs for both `allServices` and a specific service,
5309 # the union of the two AuditConfigs is used for that service: the log_types
5310 # specified in each AuditConfig are enabled, and the exempted_members in each
5311 # AuditLogConfig are exempted.
5312 #
5313 # Example Policy with multiple AuditConfigs:
5314 #
5315 # {
5316 # &quot;audit_configs&quot;: [
5317 # {
5318 # &quot;service&quot;: &quot;allServices&quot;,
5319 # &quot;audit_log_configs&quot;: [
5320 # {
5321 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5322 # &quot;exempted_members&quot;: [
5323 # &quot;user:[email protected]&quot;
5324 # ]
5325 # },
5326 # {
5327 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5328 # },
5329 # {
5330 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
5331 # }
5332 # ]
5333 # },
5334 # {
5335 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
5336 # &quot;audit_log_configs&quot;: [
5337 # {
5338 # &quot;log_type&quot;: &quot;DATA_READ&quot;
5339 # },
5340 # {
5341 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
5342 # &quot;exempted_members&quot;: [
5343 # &quot;user:[email protected]&quot;
5344 # ]
5345 # }
5346 # ]
5347 # }
5348 # ]
5349 # }
5350 #
5351 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
5352 # logging. It also exempts `[email protected]` from DATA_READ logging, and
5353 # `[email protected]` from DATA_WRITE logging.
5354 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
5355 { # Provides the configuration for logging a type of permissions.
5356 # Example:
5357 #
5358 # {
5359 # &quot;audit_log_configs&quot;: [
5360 # {
5361 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5362 # &quot;exempted_members&quot;: [
5363 # &quot;user:[email protected]&quot;
5364 # ]
5365 # },
5366 # {
5367 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5368 # }
5369 # ]
5370 # }
5371 #
5372 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
5373 # [email protected] from DATA_READ logging.
5374 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
5375 # permission.
5376 # Follows the same format of Binding.members.
5377 &quot;A String&quot;,
5378 ],
5379 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
5380 },
5381 ],
5382 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
5383 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
5384 # `allServices` is a special value that covers all services.
5385 },
5386 ],
5387 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
5388 # may specify a `condition` that determines how and when the `bindings` are
5389 # applied. Each of the `bindings` must contain at least one principal.
5390 #
5391 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
5392 # of these principals can be Google groups. Each occurrence of a principal
5393 # counts towards these limits. For example, if the `bindings` grant 50
5394 # different roles to `user:[email protected]`, and not to any other
5395 # principal, then you can add another 1,450 principals to the `bindings` in
5396 # the `Policy`.
5397 { # Associates `members`, or principals, with a `role`.
5398 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
5399 #
5400 # If the condition evaluates to `true`, then this binding applies to the
5401 # current request.
5402 #
5403 # If the condition evaluates to `false`, then this binding does not apply to
5404 # the current request. However, a different role binding might grant the same
5405 # role to one or more of the principals in this binding.
5406 #
5407 # To learn which resources support conditions in their IAM policies, see the
5408 # [IAM
5409 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5410 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
5411 # are documented at https://github.com/google/cel-spec.
5412 #
5413 # Example (Comparison):
5414 #
5415 # title: &quot;Summary size limit&quot;
5416 # description: &quot;Determines if a summary is less than 100 chars&quot;
5417 # expression: &quot;document.summary.size() &lt; 100&quot;
5418 #
5419 # Example (Equality):
5420 #
5421 # title: &quot;Requestor is owner&quot;
5422 # description: &quot;Determines if requestor is the document owner&quot;
5423 # expression: &quot;document.owner == request.auth.claims.email&quot;
5424 #
5425 # Example (Logic):
5426 #
5427 # title: &quot;Public documents&quot;
5428 # description: &quot;Determine whether the document should be publicly visible&quot;
5429 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
5430 #
5431 # Example (Data Manipulation):
5432 #
5433 # title: &quot;Notification string&quot;
5434 # description: &quot;Create a notification string with a timestamp.&quot;
5435 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
5436 #
5437 # The exact variables and functions that may be referenced within an expression
5438 # are determined by the service that evaluates it. See the service
5439 # documentation for additional information.
5440 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
5441 # describes the expression, e.g. when hovered over it in a UI.
5442 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
5443 # syntax.
5444 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
5445 # reporting, e.g. a file name and a position in the file.
5446 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
5447 # its purpose. This can be used e.g. in UIs which allow to enter the
5448 # expression.
5449 },
5450 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
5451 # `members` can have the following values:
5452 #
5453 # * `allUsers`: A special identifier that represents anyone who is
5454 # on the internet; with or without a Google account.
5455 #
5456 # * `allAuthenticatedUsers`: A special identifier that represents anyone
5457 # who is authenticated with a Google account or a service account.
5458 # Does not include identities that come from external identity providers
5459 # (IdPs) through identity federation.
5460 #
5461 # * `user:{emailid}`: An email address that represents a specific Google
5462 # account. For example, `[email protected]` .
5463 #
5464 #
5465 # * `serviceAccount:{emailid}`: An email address that represents a Google
5466 # service account. For example,
5467 # `[email protected]`.
5468 #
5469 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
5470 # identifier for a
5471 # [Kubernetes service
5472 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
5473 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
5474 #
5475 # * `group:{emailid}`: An email address that represents a Google group.
5476 # For example, `[email protected]`.
5477 #
5478 #
5479 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
5480 # users of that domain. For example, `google.com` or `example.com`.
5481 #
5482 #
5483 #
5484 #
5485 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5486 # A single identity in a workforce identity pool.
5487 #
5488 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
5489 # All workforce identities in a group.
5490 #
5491 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5492 # All workforce identities with a specific attribute value.
5493 #
5494 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
5495 # All identities in a workforce identity pool.
5496 #
5497 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
5498 # A single identity in a workload identity pool.
5499 #
5500 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
5501 # A workload identity pool group.
5502 #
5503 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5504 # All identities in a workload identity pool with a certain attribute.
5505 #
5506 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
5507 # All identities in a workload identity pool.
5508 #
5509 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
5510 # identifier) representing a user that has been recently deleted. For
5511 # example, `[email protected]?uid=123456789012345678901`. If the user is
5512 # recovered, this value reverts to `user:{emailid}` and the recovered user
5513 # retains the role in the binding.
5514 #
5515 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
5516 # unique identifier) representing a service account that has been recently
5517 # deleted. For example,
5518 # `[email protected]?uid=123456789012345678901`.
5519 # If the service account is undeleted, this value reverts to
5520 # `serviceAccount:{emailid}` and the undeleted service account retains the
5521 # role in the binding.
5522 #
5523 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
5524 # identifier) representing a Google group that has been recently
5525 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
5526 # the group is recovered, this value reverts to `group:{emailid}` and the
5527 # recovered group retains the role in the binding.
5528 #
5529 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5530 # Deleted single identity in a workforce identity pool. For example,
5531 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
5532 &quot;A String&quot;,
5533 ],
5534 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
5535 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
5536 #
5537 # For an overview of the IAM roles and permissions, see the
5538 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
5539 # a list of the available pre-defined roles, see
5540 # [here](https://cloud.google.com/iam/docs/understanding-roles).
5541 },
5542 ],
5543 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
5544 # prevent simultaneous updates of a policy from overwriting each other.
5545 # It is strongly suggested that systems make use of the `etag` in the
5546 # read-modify-write cycle to perform policy updates in order to avoid race
5547 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
5548 # systems are expected to put that etag in the request to `setIamPolicy` to
5549 # ensure that their change will be applied to the same version of the policy.
5550 #
5551 # **Important:** If you use IAM Conditions, you must include the `etag` field
5552 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5553 # you to overwrite a version `3` policy with a version `1` policy, and all of
5554 # the conditions in the version `3` policy are lost.
5555 &quot;version&quot;: 42, # Specifies the format of the policy.
5556 #
5557 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
5558 # are rejected.
5559 #
5560 # Any operation that affects conditional role bindings must specify version
5561 # `3`. This requirement applies to the following operations:
5562 #
5563 # * Getting a policy that includes a conditional role binding
5564 # * Adding a conditional role binding to a policy
5565 # * Changing a conditional role binding in a policy
5566 # * Removing any role binding, with or without a condition, from a policy
5567 # that includes conditions
5568 #
5569 # **Important:** If you use IAM Conditions, you must include the `etag` field
5570 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5571 # you to overwrite a version `3` policy with a version `1` policy, and all of
5572 # the conditions in the version `3` policy are lost.
5573 #
5574 # If a policy does not include any conditions, operations on that policy may
5575 # specify any valid version or leave the field unset.
5576 #
5577 # To learn which resources support conditions in their IAM policies, see the
5578 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5579 },
5580 }
5581
5582 x__xgafv: string, V1 error format.
5583 Allowed values
5584 1 - v1 error format
5585 2 - v2 error format
5586
5587 Returns:
5588 An object of the form:
5589
5590 { # An Identity and Access Management (IAM) policy, which specifies access
5591 # controls for Google Cloud resources.
5592 #
5593 #
5594 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
5595 # `members`, or principals, to a single `role`. Principals can be user
5596 # accounts, service accounts, Google groups, and domains (such as G Suite). A
5597 # `role` is a named list of permissions; each `role` can be an IAM predefined
5598 # role or a user-created custom role.
5599 #
5600 # For some types of Google Cloud resources, a `binding` can also specify a
5601 # `condition`, which is a logical expression that allows access to a resource
5602 # only if the expression evaluates to `true`. A condition can add constraints
5603 # based on attributes of the request, the resource, or both. To learn which
5604 # resources support conditions in their IAM policies, see the
5605 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5606 #
5607 # **JSON example:**
5608 #
5609 # ```
5610 # {
5611 # &quot;bindings&quot;: [
5612 # {
5613 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
5614 # &quot;members&quot;: [
5615 # &quot;user:[email protected]&quot;,
5616 # &quot;group:[email protected]&quot;,
5617 # &quot;domain:google.com&quot;,
5618 # &quot;serviceAccount:[email protected]&quot;
5619 # ]
5620 # },
5621 # {
5622 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
5623 # &quot;members&quot;: [
5624 # &quot;user:[email protected]&quot;
5625 # ],
5626 # &quot;condition&quot;: {
5627 # &quot;title&quot;: &quot;expirable access&quot;,
5628 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
5629 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
5630 # }
5631 # }
5632 # ],
5633 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
5634 # &quot;version&quot;: 3
5635 # }
5636 # ```
5637 #
5638 # **YAML example:**
5639 #
5640 # ```
5641 # bindings:
5642 # - members:
5643 # - user:[email protected]
5644 # - group:[email protected]
5645 # - domain:google.com
5646 # - serviceAccount:[email protected]
5647 # role: roles/resourcemanager.organizationAdmin
5648 # - members:
5649 # - user:[email protected]
5650 # role: roles/resourcemanager.organizationViewer
5651 # condition:
5652 # title: expirable access
5653 # description: Does not grant access after Sep 2020
5654 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
5655 # etag: BwWWja0YfJA=
5656 # version: 3
5657 # ```
5658 #
5659 # For a description of IAM and its features, see the
5660 # [IAM documentation](https://cloud.google.com/iam/docs/).
5661 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
5662 { # Specifies the audit configuration for a service.
5663 # The configuration determines which permission types are logged, and what
5664 # identities, if any, are exempted from logging.
5665 # An AuditConfig must have one or more AuditLogConfigs.
5666 #
5667 # If there are AuditConfigs for both `allServices` and a specific service,
5668 # the union of the two AuditConfigs is used for that service: the log_types
5669 # specified in each AuditConfig are enabled, and the exempted_members in each
5670 # AuditLogConfig are exempted.
5671 #
5672 # Example Policy with multiple AuditConfigs:
5673 #
5674 # {
5675 # &quot;audit_configs&quot;: [
5676 # {
5677 # &quot;service&quot;: &quot;allServices&quot;,
5678 # &quot;audit_log_configs&quot;: [
5679 # {
5680 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5681 # &quot;exempted_members&quot;: [
5682 # &quot;user:[email protected]&quot;
5683 # ]
5684 # },
5685 # {
5686 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5687 # },
5688 # {
5689 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
5690 # }
5691 # ]
5692 # },
5693 # {
5694 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
5695 # &quot;audit_log_configs&quot;: [
5696 # {
5697 # &quot;log_type&quot;: &quot;DATA_READ&quot;
5698 # },
5699 # {
5700 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
5701 # &quot;exempted_members&quot;: [
5702 # &quot;user:[email protected]&quot;
5703 # ]
5704 # }
5705 # ]
5706 # }
5707 # ]
5708 # }
5709 #
5710 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
5711 # logging. It also exempts `[email protected]` from DATA_READ logging, and
5712 # `[email protected]` from DATA_WRITE logging.
5713 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
5714 { # Provides the configuration for logging a type of permissions.
5715 # Example:
5716 #
5717 # {
5718 # &quot;audit_log_configs&quot;: [
5719 # {
5720 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5721 # &quot;exempted_members&quot;: [
5722 # &quot;user:[email protected]&quot;
5723 # ]
5724 # },
5725 # {
5726 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5727 # }
5728 # ]
5729 # }
5730 #
5731 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
5732 # [email protected] from DATA_READ logging.
5733 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
5734 # permission.
5735 # Follows the same format of Binding.members.
5736 &quot;A String&quot;,
5737 ],
5738 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
5739 },
5740 ],
5741 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
5742 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
5743 # `allServices` is a special value that covers all services.
5744 },
5745 ],
5746 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
5747 # may specify a `condition` that determines how and when the `bindings` are
5748 # applied. Each of the `bindings` must contain at least one principal.
5749 #
5750 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
5751 # of these principals can be Google groups. Each occurrence of a principal
5752 # counts towards these limits. For example, if the `bindings` grant 50
5753 # different roles to `user:[email protected]`, and not to any other
5754 # principal, then you can add another 1,450 principals to the `bindings` in
5755 # the `Policy`.
5756 { # Associates `members`, or principals, with a `role`.
5757 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
5758 #
5759 # If the condition evaluates to `true`, then this binding applies to the
5760 # current request.
5761 #
5762 # If the condition evaluates to `false`, then this binding does not apply to
5763 # the current request. However, a different role binding might grant the same
5764 # role to one or more of the principals in this binding.
5765 #
5766 # To learn which resources support conditions in their IAM policies, see the
5767 # [IAM
5768 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5769 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
5770 # are documented at https://github.com/google/cel-spec.
5771 #
5772 # Example (Comparison):
5773 #
5774 # title: &quot;Summary size limit&quot;
5775 # description: &quot;Determines if a summary is less than 100 chars&quot;
5776 # expression: &quot;document.summary.size() &lt; 100&quot;
5777 #
5778 # Example (Equality):
5779 #
5780 # title: &quot;Requestor is owner&quot;
5781 # description: &quot;Determines if requestor is the document owner&quot;
5782 # expression: &quot;document.owner == request.auth.claims.email&quot;
5783 #
5784 # Example (Logic):
5785 #
5786 # title: &quot;Public documents&quot;
5787 # description: &quot;Determine whether the document should be publicly visible&quot;
5788 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
5789 #
5790 # Example (Data Manipulation):
5791 #
5792 # title: &quot;Notification string&quot;
5793 # description: &quot;Create a notification string with a timestamp.&quot;
5794 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
5795 #
5796 # The exact variables and functions that may be referenced within an expression
5797 # are determined by the service that evaluates it. See the service
5798 # documentation for additional information.
5799 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
5800 # describes the expression, e.g. when hovered over it in a UI.
5801 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
5802 # syntax.
5803 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
5804 # reporting, e.g. a file name and a position in the file.
5805 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
5806 # its purpose. This can be used e.g. in UIs which allow to enter the
5807 # expression.
5808 },
5809 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
5810 # `members` can have the following values:
5811 #
5812 # * `allUsers`: A special identifier that represents anyone who is
5813 # on the internet; with or without a Google account.
5814 #
5815 # * `allAuthenticatedUsers`: A special identifier that represents anyone
5816 # who is authenticated with a Google account or a service account.
5817 # Does not include identities that come from external identity providers
5818 # (IdPs) through identity federation.
5819 #
5820 # * `user:{emailid}`: An email address that represents a specific Google
5821 # account. For example, `[email protected]` .
5822 #
5823 #
5824 # * `serviceAccount:{emailid}`: An email address that represents a Google
5825 # service account. For example,
5826 # `[email protected]`.
5827 #
5828 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
5829 # identifier for a
5830 # [Kubernetes service
5831 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
5832 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
5833 #
5834 # * `group:{emailid}`: An email address that represents a Google group.
5835 # For example, `[email protected]`.
5836 #
5837 #
5838 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
5839 # users of that domain. For example, `google.com` or `example.com`.
5840 #
5841 #
5842 #
5843 #
5844 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5845 # A single identity in a workforce identity pool.
5846 #
5847 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
5848 # All workforce identities in a group.
5849 #
5850 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5851 # All workforce identities with a specific attribute value.
5852 #
5853 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
5854 # All identities in a workforce identity pool.
5855 #
5856 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
5857 # A single identity in a workload identity pool.
5858 #
5859 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
5860 # A workload identity pool group.
5861 #
5862 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5863 # All identities in a workload identity pool with a certain attribute.
5864 #
5865 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
5866 # All identities in a workload identity pool.
5867 #
5868 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
5869 # identifier) representing a user that has been recently deleted. For
5870 # example, `[email protected]?uid=123456789012345678901`. If the user is
5871 # recovered, this value reverts to `user:{emailid}` and the recovered user
5872 # retains the role in the binding.
5873 #
5874 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
5875 # unique identifier) representing a service account that has been recently
5876 # deleted. For example,
5877 # `[email protected]?uid=123456789012345678901`.
5878 # If the service account is undeleted, this value reverts to
5879 # `serviceAccount:{emailid}` and the undeleted service account retains the
5880 # role in the binding.
5881 #
5882 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
5883 # identifier) representing a Google group that has been recently
5884 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
5885 # the group is recovered, this value reverts to `group:{emailid}` and the
5886 # recovered group retains the role in the binding.
5887 #
5888 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5889 # Deleted single identity in a workforce identity pool. For example,
5890 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
5891 &quot;A String&quot;,
5892 ],
5893 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
5894 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
5895 #
5896 # For an overview of the IAM roles and permissions, see the
5897 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
5898 # a list of the available pre-defined roles, see
5899 # [here](https://cloud.google.com/iam/docs/understanding-roles).
5900 },
5901 ],
5902 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
5903 # prevent simultaneous updates of a policy from overwriting each other.
5904 # It is strongly suggested that systems make use of the `etag` in the
5905 # read-modify-write cycle to perform policy updates in order to avoid race
5906 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
5907 # systems are expected to put that etag in the request to `setIamPolicy` to
5908 # ensure that their change will be applied to the same version of the policy.
5909 #
5910 # **Important:** If you use IAM Conditions, you must include the `etag` field
5911 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5912 # you to overwrite a version `3` policy with a version `1` policy, and all of
5913 # the conditions in the version `3` policy are lost.
5914 &quot;version&quot;: 42, # Specifies the format of the policy.
5915 #
5916 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
5917 # are rejected.
5918 #
5919 # Any operation that affects conditional role bindings must specify version
5920 # `3`. This requirement applies to the following operations:
5921 #
5922 # * Getting a policy that includes a conditional role binding
5923 # * Adding a conditional role binding to a policy
5924 # * Changing a conditional role binding in a policy
5925 # * Removing any role binding, with or without a condition, from a policy
5926 # that includes conditions
5927 #
5928 # **Important:** If you use IAM Conditions, you must include the `etag` field
5929 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5930 # you to overwrite a version `3` policy with a version `1` policy, and all of
5931 # the conditions in the version `3` policy are lost.
5932 #
5933 # If a policy does not include any conditions, operations on that policy may
5934 # specify any valid version or leave the field unset.
5935 #
5936 # To learn which resources support conditions in their IAM policies, see the
5937 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5938 }</pre>
5939 </div>
5940
5941 <div class="method">
5942 <code class="details" id="setLabels">setLabels(project, region, resource, body=None, requestId=None, x__xgafv=None)</code>
5943 <pre>Sets the labels on the target regional disk.
5944
5945 Args:
5946 project: string, Project ID for this request. (required)
5947 region: string, The region for this request. (required)
5948 resource: string, Name or id of the resource for this request. (required)
5949 body: object, The request body.
5950 The object takes the form of:
5951
5952 {
5953 &quot;labelFingerprint&quot;: &quot;A String&quot;, # The fingerprint of the previous set of labels for this resource,
5954 # used to detect conflicts. The fingerprint is initially generated by Compute
5955 # Engine and changes after every request to modify or update labels. You must
5956 # always provide an up-to-date fingerprint hash in order to update or change
5957 # labels. Make a get() request to the resource to get the latest
5958 # fingerprint.
5959 &quot;labels&quot;: { # The labels to set for this resource.
5960 &quot;a_key&quot;: &quot;A String&quot;,
5961 },
5962 }
5963
5964 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
5965 that if you must retry your request, the server will know to ignore the
5966 request if it has already been completed.
5967
5968 For example, consider a situation where you make an initial request and
5969 the request times out. If you make the request again with the same
5970 request ID, the server can check if original operation with the same
5971 request ID was received, and if so, will ignore the second request. This
5972 prevents clients from accidentally creating duplicate commitments.
5973
5974 The request ID must be
5975 a valid UUID with the exception that zero UUID is not supported
5976 (00000000-0000-0000-0000-000000000000).
5977 x__xgafv: string, V1 error format.
5978 Allowed values
5979 1 - v1 error format
5980 2 - v2 error format
5981
5982 Returns:
5983 An object of the form:
5984
5985 { # Represents an Operation resource.
5986 #
5987 # Google Compute Engine has three Operation resources:
5988 #
5989 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
5990 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
5991 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
5992 #
5993 # You can use an operation resource to manage asynchronous API requests.
5994 # For more information, readHandling
5995 # API responses.
5996 #
5997 # Operations can be global, regional or zonal.
5998 #
5999 # - For global operations, use the `globalOperations`
6000 # resource.
6001 # - For regional operations, use the
6002 # `regionOperations` resource.
6003 # - For zonal operations, use
6004 # the `zoneOperations` resource.
6005 #
6006 #
6007 #
6008 # For more information, read
6009 # Global, Regional, and Zonal Resources.
6010 #
6011 # Note that completed Operation resources have a limited
6012 # retention period.
6013 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6014 # Not present otherwise.
6015 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6016 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6017 # set when the operation is created.
6018 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6019 # text format.
6020 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6021 # this field will be populated.
6022 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6023 # operation.
6024 {
6025 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6026 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6027 # details. There is a set of defined message types to use for providing
6028 # details.The syntax depends on the error code. For example,
6029 # QuotaExceededInfo will have details when the error code is
6030 # QUOTA_EXCEEDED.
6031 {
6032 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6033 #
6034 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6035 # is not enabled:
6036 #
6037 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6038 # &quot;domain&quot;: &quot;googleapis.com&quot;
6039 # &quot;metadata&quot;: {
6040 # &quot;resource&quot;: &quot;projects/123&quot;,
6041 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6042 # }
6043 # }
6044 #
6045 # This response indicates that the pubsub.googleapis.com API is not enabled.
6046 #
6047 # Example of an error that is returned when attempting to create a Spanner
6048 # instance in a region that is out of stock:
6049 #
6050 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6051 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6052 # &quot;metadata&quot;: {
6053 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6054 # }
6055 # }
6056 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6057 # is typically the registered service name of the tool or product that
6058 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6059 # generated by some common infrastructure, the error domain must be a
6060 # globally unique value that identifies the infrastructure. For Google API
6061 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6062 &quot;metadatas&quot;: { # Additional structured details about this error.
6063 #
6064 # Keys must match a regular expression of `a-z+` but should
6065 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6066 # length. When identifying the current value of an exceeded limit, the units
6067 # should be contained in the key, not the value. For example, rather than
6068 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6069 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6070 # instances that can be created in a single (batch) request.
6071 &quot;a_key&quot;: &quot;A String&quot;,
6072 },
6073 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6074 # proximate cause of the error. Error reasons are unique within a particular
6075 # domain of errors. This should be at most 63 characters and match a
6076 # regular expression of `A-Z+[A-Z0-9]`, which represents
6077 # UPPER_SNAKE_CASE.
6078 },
6079 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6080 #
6081 # For example, if a quota check failed with an error indicating the calling
6082 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6083 # directly to the right place in the developer console to flip the bit.
6084 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6085 { # Describes a URL link.
6086 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6087 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6088 },
6089 ],
6090 },
6091 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6092 # which can be attached to an RPC error.
6093 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6094 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6095 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6096 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6097 },
6098 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6099 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6100 &quot;a_key&quot;: &quot;A String&quot;,
6101 },
6102 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6103 # type or metric.
6104 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6105 # or metric.
6106 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6107 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6108 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6109 },
6110 },
6111 ],
6112 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6113 # This property is optional.
6114 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6115 },
6116 ],
6117 },
6118 &quot;getVersionOperationMetadata&quot;: {
6119 &quot;inlineSbomInfo&quot;: {
6120 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6121 # appropriate identifiers.
6122 &quot;a_key&quot;: &quot;A String&quot;,
6123 },
6124 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6125 # identifiers.
6126 &quot;a_key&quot;: &quot;A String&quot;,
6127 },
6128 },
6129 },
6130 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6131 # message that was returned, such as `NOT FOUND`.
6132 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6133 # status code that was returned. For example, a `404` means the
6134 # resource was not found.
6135 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6136 # defined by the server.
6137 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6138 # This value is inRFC3339
6139 # text format.
6140 &quot;instancesBulkInsertOperationMetadata&quot;: {
6141 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6142 # Example key: zones/us-central1-a
6143 &quot;a_key&quot;: {
6144 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6145 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6146 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6147 # error.
6148 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6149 # if the flow is rolling forward or rolling back.
6150 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6151 },
6152 },
6153 },
6154 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6155 # Operation resources.
6156 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6157 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6158 # group of operations results from a `bulkInsert` API request.
6159 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6160 # `update`, or `delete`, and so on.
6161 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6162 # There is no requirement that this be linear or support any granularity of
6163 # operations. This should not be used to guess when the operation will be
6164 # complete. This number should monotonically increase as the operation
6165 # progresses.
6166 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6167 # applicable when performing regional operations.
6168 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6169 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
6170 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6171 # this field will contain information on all underlying zonal actions and
6172 # their state.
6173 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6174 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6175 # Example key: zones/us-central1-a
6176 &quot;a_key&quot;: {
6177 &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
6178 # populated.
6179 # different programming environments, including REST APIs and RPC APIs. It is
6180 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6181 # three pieces of data: error code, error message, and error details.
6182 #
6183 # You can find out more about this error model and how to work with it in the
6184 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6185 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6186 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6187 # message types for APIs to use.
6188 {
6189 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6190 },
6191 ],
6192 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6193 # user-facing error message should be localized and sent in the
6194 # google.rpc.Status.details field, or localized by the client.
6195 },
6196 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6197 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6198 },
6199 },
6200 },
6201 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6202 # This value is inRFC3339
6203 # text format.
6204 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6205 # following:
6206 # `PENDING`, `RUNNING`, or `DONE`.
6207 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6208 # operation.
6209 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6210 # of the target resource.
6211 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6212 # operations related to creating a snapshot, this points to the disk
6213 # that the snapshot was created from.
6214 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6215 # `[email protected]` or
6216 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6217 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6218 # operation, this field will be populated.
6219 {
6220 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6221 # Engine returns NO_RESULTS_ON_PAGE if there
6222 # are no results in the response.
6223 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6224 # value format. For example:
6225 #
6226 # &quot;data&quot;: [
6227 # {
6228 # &quot;key&quot;: &quot;scope&quot;,
6229 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6230 # }
6231 {
6232 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6233 # returned. For example, for warnings where there are no results in a list
6234 # request for a particular zone, this key might be scope and
6235 # the key value might be the zone name. Other examples might be a key
6236 # indicating a deprecated resource and a suggested replacement, or a
6237 # warning about invalid network settings (for example, if an instance
6238 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6239 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6240 },
6241 ],
6242 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6243 },
6244 ],
6245 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6246 # applicable when performing per-zone operations.
6247 }</pre>
6248 </div>
6249
6250 <div class="method">
6251 <code class="details" id="startAsyncReplication">startAsyncReplication(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
6252 <pre>Starts asynchronous replication.
6253 Must be invoked on the primary disk.
6254
6255 Args:
6256 project: string, Project ID for this request. (required)
6257 region: string, The name of the region for this request. (required)
6258 disk: string, The name of the persistent disk. (required)
6259 body: object, The request body.
6260 The object takes the form of:
6261
6262 {
6263 &quot;asyncSecondaryDisk&quot;: &quot;A String&quot;, # The secondary disk to start asynchronous replication to.
6264 # You can provide this as a partial or full URL to the resource. For example,
6265 # the following are valid values:
6266 #
6267 #
6268 # -
6269 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
6270 #
6271 # -
6272 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
6273 #
6274 # -
6275 # projects/project/zones/zone/disks/disk
6276 #
6277 # -
6278 # projects/project/regions/region/disks/disk
6279 #
6280 # -
6281 # zones/zone/disks/disk
6282 #
6283 # -
6284 # regions/region/disks/disk
6285 }
6286
6287 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6288 that if you must retry your request, the server will know to ignore the
6289 request if it has already been completed.
6290
6291 For example, consider a situation where you make an initial request and
6292 the request times out. If you make the request again with the same
6293 request ID, the server can check if original operation with the same
6294 request ID was received, and if so, will ignore the second request. This
6295 prevents clients from accidentally creating duplicate commitments.
6296
6297 The request ID must be
6298 a valid UUID with the exception that zero UUID is not supported
6299 (00000000-0000-0000-0000-000000000000).
6300 x__xgafv: string, V1 error format.
6301 Allowed values
6302 1 - v1 error format
6303 2 - v2 error format
6304
6305 Returns:
6306 An object of the form:
6307
6308 { # Represents an Operation resource.
6309 #
6310 # Google Compute Engine has three Operation resources:
6311 #
6312 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
6313 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
6314 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
6315 #
6316 # You can use an operation resource to manage asynchronous API requests.
6317 # For more information, readHandling
6318 # API responses.
6319 #
6320 # Operations can be global, regional or zonal.
6321 #
6322 # - For global operations, use the `globalOperations`
6323 # resource.
6324 # - For regional operations, use the
6325 # `regionOperations` resource.
6326 # - For zonal operations, use
6327 # the `zoneOperations` resource.
6328 #
6329 #
6330 #
6331 # For more information, read
6332 # Global, Regional, and Zonal Resources.
6333 #
6334 # Note that completed Operation resources have a limited
6335 # retention period.
6336 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6337 # Not present otherwise.
6338 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6339 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6340 # set when the operation is created.
6341 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6342 # text format.
6343 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6344 # this field will be populated.
6345 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6346 # operation.
6347 {
6348 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6349 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6350 # details. There is a set of defined message types to use for providing
6351 # details.The syntax depends on the error code. For example,
6352 # QuotaExceededInfo will have details when the error code is
6353 # QUOTA_EXCEEDED.
6354 {
6355 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6356 #
6357 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6358 # is not enabled:
6359 #
6360 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6361 # &quot;domain&quot;: &quot;googleapis.com&quot;
6362 # &quot;metadata&quot;: {
6363 # &quot;resource&quot;: &quot;projects/123&quot;,
6364 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6365 # }
6366 # }
6367 #
6368 # This response indicates that the pubsub.googleapis.com API is not enabled.
6369 #
6370 # Example of an error that is returned when attempting to create a Spanner
6371 # instance in a region that is out of stock:
6372 #
6373 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6374 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6375 # &quot;metadata&quot;: {
6376 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6377 # }
6378 # }
6379 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6380 # is typically the registered service name of the tool or product that
6381 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6382 # generated by some common infrastructure, the error domain must be a
6383 # globally unique value that identifies the infrastructure. For Google API
6384 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6385 &quot;metadatas&quot;: { # Additional structured details about this error.
6386 #
6387 # Keys must match a regular expression of `a-z+` but should
6388 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6389 # length. When identifying the current value of an exceeded limit, the units
6390 # should be contained in the key, not the value. For example, rather than
6391 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6392 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6393 # instances that can be created in a single (batch) request.
6394 &quot;a_key&quot;: &quot;A String&quot;,
6395 },
6396 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6397 # proximate cause of the error. Error reasons are unique within a particular
6398 # domain of errors. This should be at most 63 characters and match a
6399 # regular expression of `A-Z+[A-Z0-9]`, which represents
6400 # UPPER_SNAKE_CASE.
6401 },
6402 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6403 #
6404 # For example, if a quota check failed with an error indicating the calling
6405 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6406 # directly to the right place in the developer console to flip the bit.
6407 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6408 { # Describes a URL link.
6409 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6410 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6411 },
6412 ],
6413 },
6414 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6415 # which can be attached to an RPC error.
6416 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6417 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6418 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6419 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6420 },
6421 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6422 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6423 &quot;a_key&quot;: &quot;A String&quot;,
6424 },
6425 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6426 # type or metric.
6427 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6428 # or metric.
6429 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6430 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6431 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6432 },
6433 },
6434 ],
6435 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6436 # This property is optional.
6437 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6438 },
6439 ],
6440 },
6441 &quot;getVersionOperationMetadata&quot;: {
6442 &quot;inlineSbomInfo&quot;: {
6443 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6444 # appropriate identifiers.
6445 &quot;a_key&quot;: &quot;A String&quot;,
6446 },
6447 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6448 # identifiers.
6449 &quot;a_key&quot;: &quot;A String&quot;,
6450 },
6451 },
6452 },
6453 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6454 # message that was returned, such as `NOT FOUND`.
6455 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6456 # status code that was returned. For example, a `404` means the
6457 # resource was not found.
6458 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6459 # defined by the server.
6460 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6461 # This value is inRFC3339
6462 # text format.
6463 &quot;instancesBulkInsertOperationMetadata&quot;: {
6464 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6465 # Example key: zones/us-central1-a
6466 &quot;a_key&quot;: {
6467 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6468 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6469 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6470 # error.
6471 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6472 # if the flow is rolling forward or rolling back.
6473 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6474 },
6475 },
6476 },
6477 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6478 # Operation resources.
6479 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6480 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6481 # group of operations results from a `bulkInsert` API request.
6482 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6483 # `update`, or `delete`, and so on.
6484 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6485 # There is no requirement that this be linear or support any granularity of
6486 # operations. This should not be used to guess when the operation will be
6487 # complete. This number should monotonically increase as the operation
6488 # progresses.
6489 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6490 # applicable when performing regional operations.
6491 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6492 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
6493 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6494 # this field will contain information on all underlying zonal actions and
6495 # their state.
6496 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6497 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6498 # Example key: zones/us-central1-a
6499 &quot;a_key&quot;: {
6500 &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
6501 # populated.
6502 # different programming environments, including REST APIs and RPC APIs. It is
6503 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6504 # three pieces of data: error code, error message, and error details.
6505 #
6506 # You can find out more about this error model and how to work with it in the
6507 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6508 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6509 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6510 # message types for APIs to use.
6511 {
6512 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6513 },
6514 ],
6515 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6516 # user-facing error message should be localized and sent in the
6517 # google.rpc.Status.details field, or localized by the client.
6518 },
6519 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6520 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6521 },
6522 },
6523 },
6524 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6525 # This value is inRFC3339
6526 # text format.
6527 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6528 # following:
6529 # `PENDING`, `RUNNING`, or `DONE`.
6530 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6531 # operation.
6532 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6533 # of the target resource.
6534 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6535 # operations related to creating a snapshot, this points to the disk
6536 # that the snapshot was created from.
6537 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6538 # `[email protected]` or
6539 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6540 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6541 # operation, this field will be populated.
6542 {
6543 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6544 # Engine returns NO_RESULTS_ON_PAGE if there
6545 # are no results in the response.
6546 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6547 # value format. For example:
6548 #
6549 # &quot;data&quot;: [
6550 # {
6551 # &quot;key&quot;: &quot;scope&quot;,
6552 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6553 # }
6554 {
6555 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6556 # returned. For example, for warnings where there are no results in a list
6557 # request for a particular zone, this key might be scope and
6558 # the key value might be the zone name. Other examples might be a key
6559 # indicating a deprecated resource and a suggested replacement, or a
6560 # warning about invalid network settings (for example, if an instance
6561 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6562 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6563 },
6564 ],
6565 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6566 },
6567 ],
6568 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6569 # applicable when performing per-zone operations.
6570 }</pre>
6571 </div>
6572
6573 <div class="method">
6574 <code class="details" id="stopAsyncReplication">stopAsyncReplication(project, region, disk, requestId=None, x__xgafv=None)</code>
6575 <pre>Stops asynchronous replication.
6576 Can be invoked either on the primary or on the secondary disk.
6577
6578 Args:
6579 project: string, Project ID for this request. (required)
6580 region: string, The name of the region for this request. (required)
6581 disk: string, The name of the persistent disk. (required)
6582 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6583 that if you must retry your request, the server will know to ignore the
6584 request if it has already been completed.
6585
6586 For example, consider a situation where you make an initial request and
6587 the request times out. If you make the request again with the same
6588 request ID, the server can check if original operation with the same
6589 request ID was received, and if so, will ignore the second request. This
6590 prevents clients from accidentally creating duplicate commitments.
6591
6592 The request ID must be
6593 a valid UUID with the exception that zero UUID is not supported
6594 (00000000-0000-0000-0000-000000000000).
6595 x__xgafv: string, V1 error format.
6596 Allowed values
6597 1 - v1 error format
6598 2 - v2 error format
6599
6600 Returns:
6601 An object of the form:
6602
6603 { # Represents an Operation resource.
6604 #
6605 # Google Compute Engine has three Operation resources:
6606 #
6607 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
6608 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
6609 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
6610 #
6611 # You can use an operation resource to manage asynchronous API requests.
6612 # For more information, readHandling
6613 # API responses.
6614 #
6615 # Operations can be global, regional or zonal.
6616 #
6617 # - For global operations, use the `globalOperations`
6618 # resource.
6619 # - For regional operations, use the
6620 # `regionOperations` resource.
6621 # - For zonal operations, use
6622 # the `zoneOperations` resource.
6623 #
6624 #
6625 #
6626 # For more information, read
6627 # Global, Regional, and Zonal Resources.
6628 #
6629 # Note that completed Operation resources have a limited
6630 # retention period.
6631 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6632 # Not present otherwise.
6633 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6634 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6635 # set when the operation is created.
6636 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6637 # text format.
6638 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6639 # this field will be populated.
6640 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6641 # operation.
6642 {
6643 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6644 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6645 # details. There is a set of defined message types to use for providing
6646 # details.The syntax depends on the error code. For example,
6647 # QuotaExceededInfo will have details when the error code is
6648 # QUOTA_EXCEEDED.
6649 {
6650 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6651 #
6652 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6653 # is not enabled:
6654 #
6655 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6656 # &quot;domain&quot;: &quot;googleapis.com&quot;
6657 # &quot;metadata&quot;: {
6658 # &quot;resource&quot;: &quot;projects/123&quot;,
6659 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6660 # }
6661 # }
6662 #
6663 # This response indicates that the pubsub.googleapis.com API is not enabled.
6664 #
6665 # Example of an error that is returned when attempting to create a Spanner
6666 # instance in a region that is out of stock:
6667 #
6668 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6669 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6670 # &quot;metadata&quot;: {
6671 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6672 # }
6673 # }
6674 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6675 # is typically the registered service name of the tool or product that
6676 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6677 # generated by some common infrastructure, the error domain must be a
6678 # globally unique value that identifies the infrastructure. For Google API
6679 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6680 &quot;metadatas&quot;: { # Additional structured details about this error.
6681 #
6682 # Keys must match a regular expression of `a-z+` but should
6683 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6684 # length. When identifying the current value of an exceeded limit, the units
6685 # should be contained in the key, not the value. For example, rather than
6686 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6687 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6688 # instances that can be created in a single (batch) request.
6689 &quot;a_key&quot;: &quot;A String&quot;,
6690 },
6691 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6692 # proximate cause of the error. Error reasons are unique within a particular
6693 # domain of errors. This should be at most 63 characters and match a
6694 # regular expression of `A-Z+[A-Z0-9]`, which represents
6695 # UPPER_SNAKE_CASE.
6696 },
6697 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6698 #
6699 # For example, if a quota check failed with an error indicating the calling
6700 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6701 # directly to the right place in the developer console to flip the bit.
6702 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6703 { # Describes a URL link.
6704 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6705 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6706 },
6707 ],
6708 },
6709 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6710 # which can be attached to an RPC error.
6711 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6712 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6713 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6714 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6715 },
6716 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6717 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6718 &quot;a_key&quot;: &quot;A String&quot;,
6719 },
6720 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6721 # type or metric.
6722 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6723 # or metric.
6724 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6725 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6726 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6727 },
6728 },
6729 ],
6730 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6731 # This property is optional.
6732 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6733 },
6734 ],
6735 },
6736 &quot;getVersionOperationMetadata&quot;: {
6737 &quot;inlineSbomInfo&quot;: {
6738 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6739 # appropriate identifiers.
6740 &quot;a_key&quot;: &quot;A String&quot;,
6741 },
6742 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6743 # identifiers.
6744 &quot;a_key&quot;: &quot;A String&quot;,
6745 },
6746 },
6747 },
6748 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6749 # message that was returned, such as `NOT FOUND`.
6750 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6751 # status code that was returned. For example, a `404` means the
6752 # resource was not found.
6753 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6754 # defined by the server.
6755 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6756 # This value is inRFC3339
6757 # text format.
6758 &quot;instancesBulkInsertOperationMetadata&quot;: {
6759 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6760 # Example key: zones/us-central1-a
6761 &quot;a_key&quot;: {
6762 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6763 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6764 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6765 # error.
6766 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6767 # if the flow is rolling forward or rolling back.
6768 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6769 },
6770 },
6771 },
6772 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6773 # Operation resources.
6774 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6775 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6776 # group of operations results from a `bulkInsert` API request.
6777 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6778 # `update`, or `delete`, and so on.
6779 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6780 # There is no requirement that this be linear or support any granularity of
6781 # operations. This should not be used to guess when the operation will be
6782 # complete. This number should monotonically increase as the operation
6783 # progresses.
6784 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6785 # applicable when performing regional operations.
6786 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6787 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
6788 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6789 # this field will contain information on all underlying zonal actions and
6790 # their state.
6791 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6792 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6793 # Example key: zones/us-central1-a
6794 &quot;a_key&quot;: {
6795 &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
6796 # populated.
6797 # different programming environments, including REST APIs and RPC APIs. It is
6798 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6799 # three pieces of data: error code, error message, and error details.
6800 #
6801 # You can find out more about this error model and how to work with it in the
6802 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6803 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6804 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6805 # message types for APIs to use.
6806 {
6807 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6808 },
6809 ],
6810 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6811 # user-facing error message should be localized and sent in the
6812 # google.rpc.Status.details field, or localized by the client.
6813 },
6814 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6815 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6816 },
6817 },
6818 },
6819 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6820 # This value is inRFC3339
6821 # text format.
6822 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6823 # following:
6824 # `PENDING`, `RUNNING`, or `DONE`.
6825 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6826 # operation.
6827 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6828 # of the target resource.
6829 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6830 # operations related to creating a snapshot, this points to the disk
6831 # that the snapshot was created from.
6832 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6833 # `[email protected]` or
6834 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6835 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6836 # operation, this field will be populated.
6837 {
6838 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6839 # Engine returns NO_RESULTS_ON_PAGE if there
6840 # are no results in the response.
6841 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6842 # value format. For example:
6843 #
6844 # &quot;data&quot;: [
6845 # {
6846 # &quot;key&quot;: &quot;scope&quot;,
6847 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6848 # }
6849 {
6850 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6851 # returned. For example, for warnings where there are no results in a list
6852 # request for a particular zone, this key might be scope and
6853 # the key value might be the zone name. Other examples might be a key
6854 # indicating a deprecated resource and a suggested replacement, or a
6855 # warning about invalid network settings (for example, if an instance
6856 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6857 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6858 },
6859 ],
6860 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6861 },
6862 ],
6863 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6864 # applicable when performing per-zone operations.
6865 }</pre>
6866 </div>
6867
6868 <div class="method">
6869 <code class="details" id="stopGroupAsyncReplication">stopGroupAsyncReplication(project, region, body=None, requestId=None, x__xgafv=None)</code>
6870 <pre>Stops asynchronous replication for a consistency group of disks.
6871 Can be invoked either in the primary or secondary scope.
6872
6873 Args:
6874 project: string, Project ID for this request. (required)
6875 region: string, The name of the region for this request. This must be the region of the
6876 primary or secondary disks in the consistency group. (required)
6877 body: object, The request body.
6878 The object takes the form of:
6879
6880 { # A transient resource used in compute.disks.stopGroupAsyncReplication and
6881 # compute.regionDisks.stopGroupAsyncReplication. It is only used to process
6882 # requests and is not persisted.
6883 &quot;resourcePolicy&quot;: &quot;A String&quot;, # The URL of the DiskConsistencyGroupPolicy for the group of disks to stop.
6884 # This may be a full or partial URL, such as:
6885 #
6886 #
6887 # -
6888 # https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
6889 #
6890 # -
6891 # projects/project/regions/region/resourcePolicies/resourcePolicy
6892 #
6893 # -
6894 # regions/region/resourcePolicies/resourcePolicy
6895 }
6896
6897 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6898 that if you must retry your request, the server will know to ignore the
6899 request if it has already been completed.
6900
6901 For example, consider a situation where you make an initial request and
6902 the request times out. If you make the request again with the same
6903 request ID, the server can check if original operation with the same
6904 request ID was received, and if so, will ignore the second request. This
6905 prevents clients from accidentally creating duplicate commitments.
6906
6907 The request ID must be
6908 a valid UUID with the exception that zero UUID is not supported
6909 (00000000-0000-0000-0000-000000000000).
6910 x__xgafv: string, V1 error format.
6911 Allowed values
6912 1 - v1 error format
6913 2 - v2 error format
6914
6915 Returns:
6916 An object of the form:
6917
6918 { # Represents an Operation resource.
6919 #
6920 # Google Compute Engine has three Operation resources:
6921 #
6922 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
6923 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
6924 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
6925 #
6926 # You can use an operation resource to manage asynchronous API requests.
6927 # For more information, readHandling
6928 # API responses.
6929 #
6930 # Operations can be global, regional or zonal.
6931 #
6932 # - For global operations, use the `globalOperations`
6933 # resource.
6934 # - For regional operations, use the
6935 # `regionOperations` resource.
6936 # - For zonal operations, use
6937 # the `zoneOperations` resource.
6938 #
6939 #
6940 #
6941 # For more information, read
6942 # Global, Regional, and Zonal Resources.
6943 #
6944 # Note that completed Operation resources have a limited
6945 # retention period.
6946 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6947 # Not present otherwise.
6948 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6949 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6950 # set when the operation is created.
6951 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6952 # text format.
6953 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6954 # this field will be populated.
6955 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6956 # operation.
6957 {
6958 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6959 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6960 # details. There is a set of defined message types to use for providing
6961 # details.The syntax depends on the error code. For example,
6962 # QuotaExceededInfo will have details when the error code is
6963 # QUOTA_EXCEEDED.
6964 {
6965 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6966 #
6967 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6968 # is not enabled:
6969 #
6970 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6971 # &quot;domain&quot;: &quot;googleapis.com&quot;
6972 # &quot;metadata&quot;: {
6973 # &quot;resource&quot;: &quot;projects/123&quot;,
6974 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6975 # }
6976 # }
6977 #
6978 # This response indicates that the pubsub.googleapis.com API is not enabled.
6979 #
6980 # Example of an error that is returned when attempting to create a Spanner
6981 # instance in a region that is out of stock:
6982 #
6983 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6984 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6985 # &quot;metadata&quot;: {
6986 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6987 # }
6988 # }
6989 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6990 # is typically the registered service name of the tool or product that
6991 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6992 # generated by some common infrastructure, the error domain must be a
6993 # globally unique value that identifies the infrastructure. For Google API
6994 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6995 &quot;metadatas&quot;: { # Additional structured details about this error.
6996 #
6997 # Keys must match a regular expression of `a-z+` but should
6998 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6999 # length. When identifying the current value of an exceeded limit, the units
7000 # should be contained in the key, not the value. For example, rather than
7001 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7002 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7003 # instances that can be created in a single (batch) request.
7004 &quot;a_key&quot;: &quot;A String&quot;,
7005 },
7006 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7007 # proximate cause of the error. Error reasons are unique within a particular
7008 # domain of errors. This should be at most 63 characters and match a
7009 # regular expression of `A-Z+[A-Z0-9]`, which represents
7010 # UPPER_SNAKE_CASE.
7011 },
7012 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7013 #
7014 # For example, if a quota check failed with an error indicating the calling
7015 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7016 # directly to the right place in the developer console to flip the bit.
7017 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7018 { # Describes a URL link.
7019 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7020 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7021 },
7022 ],
7023 },
7024 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7025 # which can be attached to an RPC error.
7026 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7027 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7028 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7029 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7030 },
7031 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7032 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7033 &quot;a_key&quot;: &quot;A String&quot;,
7034 },
7035 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7036 # type or metric.
7037 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7038 # or metric.
7039 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7040 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7041 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7042 },
7043 },
7044 ],
7045 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7046 # This property is optional.
7047 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7048 },
7049 ],
7050 },
7051 &quot;getVersionOperationMetadata&quot;: {
7052 &quot;inlineSbomInfo&quot;: {
7053 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
7054 # appropriate identifiers.
7055 &quot;a_key&quot;: &quot;A String&quot;,
7056 },
7057 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
7058 # identifiers.
7059 &quot;a_key&quot;: &quot;A String&quot;,
7060 },
7061 },
7062 },
7063 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
7064 # message that was returned, such as `NOT FOUND`.
7065 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
7066 # status code that was returned. For example, a `404` means the
7067 # resource was not found.
7068 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
7069 # defined by the server.
7070 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
7071 # This value is inRFC3339
7072 # text format.
7073 &quot;instancesBulkInsertOperationMetadata&quot;: {
7074 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
7075 # Example key: zones/us-central1-a
7076 &quot;a_key&quot;: {
7077 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
7078 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
7079 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
7080 # error.
7081 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
7082 # if the flow is rolling forward or rolling back.
7083 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
7084 },
7085 },
7086 },
7087 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
7088 # Operation resources.
7089 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
7090 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
7091 # group of operations results from a `bulkInsert` API request.
7092 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
7093 # `update`, or `delete`, and so on.
7094 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
7095 # There is no requirement that this be linear or support any granularity of
7096 # operations. This should not be used to guess when the operation will be
7097 # complete. This number should monotonically increase as the operation
7098 # progresses.
7099 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
7100 # applicable when performing regional operations.
7101 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7102 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
7103 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
7104 # this field will contain information on all underlying zonal actions and
7105 # their state.
7106 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
7107 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
7108 # Example key: zones/us-central1-a
7109 &quot;a_key&quot;: {
7110 &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
7111 # populated.
7112 # different programming environments, including REST APIs and RPC APIs. It is
7113 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
7114 # three pieces of data: error code, error message, and error details.
7115 #
7116 # You can find out more about this error model and how to work with it in the
7117 # [API Design Guide](https://cloud.google.com/apis/design/errors).
7118 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
7119 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
7120 # message types for APIs to use.
7121 {
7122 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
7123 },
7124 ],
7125 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
7126 # user-facing error message should be localized and sent in the
7127 # google.rpc.Status.details field, or localized by the client.
7128 },
7129 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
7130 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
7131 },
7132 },
7133 },
7134 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
7135 # This value is inRFC3339
7136 # text format.
7137 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
7138 # following:
7139 # `PENDING`, `RUNNING`, or `DONE`.
7140 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
7141 # operation.
7142 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
7143 # of the target resource.
7144 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
7145 # operations related to creating a snapshot, this points to the disk
7146 # that the snapshot was created from.
7147 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
7148 # `[email protected]` or
7149 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
7150 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
7151 # operation, this field will be populated.
7152 {
7153 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
7154 # Engine returns NO_RESULTS_ON_PAGE if there
7155 # are no results in the response.
7156 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
7157 # value format. For example:
7158 #
7159 # &quot;data&quot;: [
7160 # {
7161 # &quot;key&quot;: &quot;scope&quot;,
7162 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
7163 # }
7164 {
7165 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
7166 # returned. For example, for warnings where there are no results in a list
7167 # request for a particular zone, this key might be scope and
7168 # the key value might be the zone name. Other examples might be a key
7169 # indicating a deprecated resource and a suggested replacement, or a
7170 # warning about invalid network settings (for example, if an instance
7171 # attempts to perform IP forwarding but is not enabled for IP forwarding).
7172 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
7173 },
7174 ],
7175 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
7176 },
7177 ],
7178 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
7179 # applicable when performing per-zone operations.
7180 }</pre>
7181 </div>
7182
7183 <div class="method">
7184 <code class="details" id="testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</code>
7185 <pre>Returns permissions that a caller has on the specified resource.
7186
7187 Args:
7188 project: string, Project ID for this request. (required)
7189 region: string, The name of the region for this request. (required)
7190 resource: string, Name or id of the resource for this request. (required)
7191 body: object, The request body.
7192 The object takes the form of:
7193
7194 {
7195 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
7196 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
7197 &quot;A String&quot;,
7198 ],
7199 }
7200
7201 x__xgafv: string, V1 error format.
7202 Allowed values
7203 1 - v1 error format
7204 2 - v2 error format
7205
7206 Returns:
7207 An object of the form:
7208
7209 {
7210 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
7211 # allowed.
7212 &quot;A String&quot;,
7213 ],
7214 }</pre>
7215 </div>
7216
7217 <div class="method">
7218 <code class="details" id="update">update(project, region, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)</code>
7219 <pre>Update the specified disk with the data included in the request. Update is
7220 performed only on selected fields included as part of update-mask.
7221
7222 Args:
7223 project: string, Project ID for this request. (required)
7224 region: string, The name of the region for this request. (required)
7225 disk: string, The disk name for this request. (required)
7226 body: object, The request body.
7227 The object takes the form of:
7228
7229 { # Represents a Persistent Disk resource.
7230 #
7231 # Google Compute Engine has two Disk resources:
7232 #
7233 # * [Zonal](/compute/docs/reference/rest/alpha/disks)
7234 # * [Regional](/compute/docs/reference/rest/alpha/regionDisks)
7235 #
7236 # Persistent disks are required for running your VM instances.
7237 # Create both boot and non-boot (data) persistent disks. For more information,
7238 # read Persistent Disks. For more
7239 # storage options, read Storage options.
7240 #
7241 # The disks resource represents a zonal persistent disk.
7242 # For more information, readZonal persistent disks.
7243 #
7244 # The regionDisks resource represents a
7245 # regional persistent disk. For more information, read
7246 # Regional resources.
7247 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
7248 #
7249 #
7250 # - READ_WRITE_SINGLE: The default AccessMode, means the
7251 # disk can be attached to single instance in RW mode.
7252 # - READ_WRITE_MANY: The AccessMode means the disk can be
7253 # attached to multiple instances in RW mode.
7254 # - READ_ONLY_MANY: The AccessMode means the disk can be
7255 # attached to multiple instances in RO mode.
7256 #
7257 #
7258 # The AccessMode is only valid for Hyperdisk disk types.
7259 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
7260 # ARM64 or X86_64.
7261 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
7262 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
7263 # started on the disk as a member of a group.
7264 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
7265 # started on the disk as a member of a group.
7266 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
7267 # You can provide this as a partial or full URL to the resource.
7268 # For example, the following are valid values:
7269 #
7270 #
7271 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
7272 # - projects/project/zones/zone/disks/disk
7273 # - zones/zone/disks/disk
7274 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
7275 # to or from the current disk. This value identifies the exact disk that
7276 # was used to create this replication. For example, if you started
7277 # replicating the persistent disk from a disk that was later deleted and
7278 # recreated under the same name, the disk ID would identify the exact
7279 # version of the disk that was used.
7280 },
7281 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
7282 &quot;a_key&quot;: {
7283 &quot;asyncReplicationDisk&quot;: {
7284 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
7285 # started on the disk as a member of a group.
7286 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
7287 # started on the disk as a member of a group.
7288 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
7289 # You can provide this as a partial or full URL to the resource.
7290 # For example, the following are valid values:
7291 #
7292 #
7293 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
7294 # - projects/project/zones/zone/disks/disk
7295 # - zones/zone/disks/disk
7296 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
7297 # to or from the current disk. This value identifies the exact disk that
7298 # was used to create this replication. For example, if you started
7299 # replicating the persistent disk from a disk that was later deleted and
7300 # recreated under the same name, the disk ID would identify the exact
7301 # version of the disk that was used.
7302 },
7303 },
7304 },
7305 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
7306 # text format.
7307 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
7308 # create the resource.
7309 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
7310 # customer-supplied encryption key or a
7311 # customer-managed encryption key.
7312 #
7313 # Encryption keys do not protect access to metadata of the disk.
7314 #
7315 # After you encrypt a disk with a customer-supplied key, you must provide the
7316 # same key if you use the disk later. For example, to create a disk snapshot,
7317 # to create a disk image, to create a machine image, or to attach the disk to
7318 # a virtual machine.
7319 #
7320 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
7321 # name once the disk is created. The disk is encrypted with this version of
7322 # the key. In the response, diskEncryptionKey.kmsKeyName appears
7323 # in the following format:
7324 #
7325 # &quot;diskEncryptionKey.kmsKeyName&quot;:
7326 # &quot;projects/kms_project_id/locations/region/keyRings/
7327 # key_region/cryptoKeys/key
7328 # /cryptoKeysVersions/version
7329 #
7330 # If you do not provide an encryption key when creating the disk, then the
7331 # disk is encrypted using an automatically generated key and you don&#x27;t need
7332 # to provide a key to use the disk later.
7333 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7334 # For example:
7335 #
7336 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7337 # key_region/cryptoKeys/key
7338 #
7339 # The fully-qualifed key name may be returned for resource GET requests. For
7340 # example:
7341 #
7342 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7343 # key_region/cryptoKeys/key
7344 # /cryptoKeyVersions/1
7345 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7346 # key. If absent, the Compute Engine default service account is used.
7347 # For example:
7348 #
7349 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7350 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7351 # encryption key, encoded in RFC
7352 # 4648 base64 to either encrypt or decrypt this resource. You can
7353 # provide either the rawKey or thersaEncryptedKey.
7354 # For example:
7355 #
7356 # &quot;rawKey&quot;:
7357 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7358 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7359 # customer-supplied encryption key to either encrypt or decrypt this
7360 # resource. You can provide either the rawKey or thersaEncryptedKey.
7361 # For example:
7362 #
7363 # &quot;rsaEncryptedKey&quot;:
7364 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7365 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7366 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7367 #
7368 # The key must meet the following requirements before you can provide it to
7369 # Compute Engine:
7370 #
7371 # 1. The key is wrapped using a RSA public key certificate provided by
7372 # Google.
7373 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7374 # encoding.
7375 #
7376 # Gets the RSA public key certificate provided by Google at:
7377 #
7378 #
7379 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7380 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7381 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7382 # encryption key that protects this resource.
7383 },
7384 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
7385 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
7386 # Windows specific VSS signature.
7387 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7388 # only for bootable images. Read
7389 # Enabling guest operating system features to see a list of available
7390 # options.
7391 { # Guest OS features.
7392 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7393 # separate values. Set to one or more of the following values:
7394 #
7395 # - VIRTIO_SCSI_MULTIQUEUE
7396 # - WINDOWS
7397 # - MULTI_IP_SUBNET
7398 # - UEFI_COMPATIBLE
7399 # - GVNIC
7400 # - SEV_CAPABLE
7401 # - SUSPEND_RESUME_COMPATIBLE
7402 # - SEV_LIVE_MIGRATABLE_V2
7403 # - SEV_SNP_CAPABLE
7404 # - TDX_CAPABLE
7405 # - IDPF
7406 # - SNP_SVSM_CAPABLE
7407 # - CCA_CAPABLE
7408 #
7409 #
7410 # For more information, see
7411 # Enabling guest operating system features.
7412 },
7413 ],
7414 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
7415 # defined by the server.
7416 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
7417 # which is either SCSI or NVME. The default isSCSI.
7418 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
7419 # disks.
7420 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
7421 # essentially a hash of the labels set used for optimistic locking. The
7422 # fingerprint is initially generated by Compute Engine and changes after
7423 # every request to modify or update labels. You must always provide an
7424 # up-to-date fingerprint hash in order to update or change labels,
7425 # otherwise the request will fail with error412 conditionNotMet.
7426 #
7427 # To see the latest fingerprint, make a get() request to
7428 # retrieve a disk.
7429 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
7430 # the setLabels method.
7431 &quot;a_key&quot;: &quot;A String&quot;,
7432 },
7433 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
7434 # text format.
7435 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
7436 # text format.
7437 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
7438 &quot;A String&quot;,
7439 ],
7440 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
7441 &quot;A String&quot;,
7442 ],
7443 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
7444 # This field is for use by internal tools that use the public API.
7445 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
7446 # source image. Attachment of a disk created from a locked source image will
7447 # cause the following operations to become irreversibly prohibited:
7448 #
7449 # - R/W or R/O disk attachment to any other instance
7450 # - Disk detachment. And the disk can only be deleted when the instance
7451 # is deleted
7452 # - Creation of images or snapshots
7453 # - Disk cloning
7454 #
7455 #
7456 #
7457 # Furthermore, the instance with at least one disk with locked flag set to
7458 # true will be prohibited from performing the operations below:
7459 #
7460 # - Further attachment of secondary disks.
7461 # - Detachment of any disks
7462 # - Create machine images
7463 # - Create instance template
7464 # - Delete the instance with --keep-disk parameter set to true for locked
7465 # disks
7466 # - Attach a locked disk with --auto-delete parameter set to false
7467 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
7468 # more than one instance.
7469 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
7470 # The name must be 1-63 characters long, and comply withRFC1035.
7471 # Specifically, the name must be 1-63 characters long and match the regular
7472 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
7473 # which means the first character must be a lowercase letter, and all
7474 # following characters must be a dash, lowercase letter, or digit, except
7475 # the last character, which cannot be a dash.
7476 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
7477 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
7478 # as part of resource payload.
7479 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
7480 # have the same definition as resource
7481 # manager tags. Keys and values can be either in numeric format,
7482 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
7483 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
7484 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
7485 # PATCH) when empty.
7486 &quot;a_key&quot;: &quot;A String&quot;,
7487 },
7488 },
7489 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
7490 # If not present in a request, a default value is used.
7491 # The currently supported size is 4096, other sizes may be added in
7492 # the future.
7493 # If an unsupported value is requested, the error message will list
7494 # the supported values for the caller&#x27;s project.
7495 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
7496 # of I/O operations per second that the disk can handle. Values must be
7497 # between 10,000 and 120,000. For more details, see theExtreme persistent
7498 # disk documentation.
7499 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
7500 # number of throughput mb per second that the disk can handle. Values must be
7501 # greater than or equal to 1.
7502 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
7503 # regional resources.
7504 # You must specify this field as part of the HTTP request URL. It is
7505 # not settable as a field in the request body.
7506 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
7507 # for regional resources.
7508 &quot;A String&quot;,
7509 ],
7510 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
7511 &quot;A String&quot;,
7512 ],
7513 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
7514 &quot;asyncPrimaryDisk&quot;: {
7515 &quot;state&quot;: &quot;A String&quot;,
7516 },
7517 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
7518 &quot;a_key&quot;: {
7519 &quot;state&quot;: &quot;A String&quot;,
7520 },
7521 },
7522 &quot;usedBytes&quot;: &quot;A String&quot;, # [Output Only] Space used by data stored in the disk (in bytes). Note that
7523 # this field is set only when the disk is in a storage pool.
7524 },
7525 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
7526 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
7527 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
7528 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
7529 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
7530 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
7531 # persistent disk.
7532 #
7533 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
7534 # source.
7535 # Acceptable values are greater than 0.
7536 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
7537 # that was created using a consistency group.
7538 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
7539 # that was created using a consistency group.
7540 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
7541 # partial or full URL to the resource. For example, the following are valid
7542 # values:
7543 #
7544 #
7545 # -
7546 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
7547 #
7548 # -
7549 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
7550 #
7551 # -
7552 # projects/project/zones/zone/disks/disk
7553 #
7554 # -
7555 # projects/project/regions/region/disks/disk
7556 #
7557 # -
7558 # zones/zone/disks/disk
7559 #
7560 # -
7561 # regions/region/disks/disk
7562 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
7563 # value identifies the exact disk that was used to create this persistent
7564 # disk. For example, if you created the persistent disk from a disk that
7565 # was later deleted and recreated under the same name, the source disk ID
7566 # would identify the exact version of the disk that was used.
7567 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
7568 # deleted, this field will not be set.
7569 #
7570 # To create a disk with one of the public operating system images, specify
7571 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
7572 #
7573 # projects/debian-cloud/global/images/family/debian-9
7574 #
7575 #
7576 # Alternatively, use a specific version of a public operating system image:
7577 #
7578 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
7579 #
7580 #
7581 # To create a disk with a custom image that you created, specify the
7582 # image name in the following format:
7583 #
7584 # global/images/my-custom-image
7585 #
7586 #
7587 # You can also specify a custom image by its image family, which returns
7588 # the latest version of the image in that family. Replace the image name
7589 # with family/family-name:
7590 #
7591 # global/images/family/my-image-family
7592 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
7593 # encryption key of the source image. Required if the source image is
7594 # protected by a customer-supplied encryption key.
7595 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7596 # For example:
7597 #
7598 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7599 # key_region/cryptoKeys/key
7600 #
7601 # The fully-qualifed key name may be returned for resource GET requests. For
7602 # example:
7603 #
7604 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7605 # key_region/cryptoKeys/key
7606 # /cryptoKeyVersions/1
7607 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7608 # key. If absent, the Compute Engine default service account is used.
7609 # For example:
7610 #
7611 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7612 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7613 # encryption key, encoded in RFC
7614 # 4648 base64 to either encrypt or decrypt this resource. You can
7615 # provide either the rawKey or thersaEncryptedKey.
7616 # For example:
7617 #
7618 # &quot;rawKey&quot;:
7619 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7620 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7621 # customer-supplied encryption key to either encrypt or decrypt this
7622 # resource. You can provide either the rawKey or thersaEncryptedKey.
7623 # For example:
7624 #
7625 # &quot;rsaEncryptedKey&quot;:
7626 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7627 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7628 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7629 #
7630 # The key must meet the following requirements before you can provide it to
7631 # Compute Engine:
7632 #
7633 # 1. The key is wrapped using a RSA public key certificate provided by
7634 # Google.
7635 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7636 # encoding.
7637 #
7638 # Gets the RSA public key certificate provided by Google at:
7639 #
7640 #
7641 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7642 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7643 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7644 # encryption key that protects this resource.
7645 },
7646 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
7647 # value identifies the exact image that was used to create this persistent
7648 # disk. For example, if you created the persistent disk from an image that
7649 # was later deleted and recreated under the same name, the source image ID
7650 # would identify the exact version of the image that was used.
7651 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
7652 # this as a partial or full URL to the resource. For example, the following
7653 # are valid values:
7654 #
7655 #
7656 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
7657 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
7658 # - zones/zone/instantSnapshots/instantSnapshot
7659 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
7660 # disk. This value identifies the exact instant snapshot that was used to
7661 # create this persistent disk. For example, if you created the persistent
7662 # disk from an instant snapshot that was later deleted and recreated under
7663 # the same name, the source instant snapshot ID would identify the exact
7664 # version of the instant snapshot that was used.
7665 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
7666 # partial or full URL to the resource. For example, the following are valid
7667 # values:
7668 #
7669 #
7670 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
7671 # - projects/project/global/machineImages/machineImage
7672 # - global/machineImages/machineImage
7673 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
7674 # source_machine_image must be specified.
7675 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
7676 # encryption key of the source machine image. Required if the source
7677 # machine image is protected by a customer-supplied encryption key.
7678 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7679 # For example:
7680 #
7681 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7682 # key_region/cryptoKeys/key
7683 #
7684 # The fully-qualifed key name may be returned for resource GET requests. For
7685 # example:
7686 #
7687 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7688 # key_region/cryptoKeys/key
7689 # /cryptoKeyVersions/1
7690 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7691 # key. If absent, the Compute Engine default service account is used.
7692 # For example:
7693 #
7694 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7695 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7696 # encryption key, encoded in RFC
7697 # 4648 base64 to either encrypt or decrypt this resource. You can
7698 # provide either the rawKey or thersaEncryptedKey.
7699 # For example:
7700 #
7701 # &quot;rawKey&quot;:
7702 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7703 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7704 # customer-supplied encryption key to either encrypt or decrypt this
7705 # resource. You can provide either the rawKey or thersaEncryptedKey.
7706 # For example:
7707 #
7708 # &quot;rsaEncryptedKey&quot;:
7709 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7710 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7711 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7712 #
7713 # The key must meet the following requirements before you can provide it to
7714 # Compute Engine:
7715 #
7716 # 1. The key is wrapped using a RSA public key certificate provided by
7717 # Google.
7718 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7719 # encoding.
7720 #
7721 # Gets the RSA public key certificate provided by Google at:
7722 #
7723 #
7724 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7725 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7726 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7727 # encryption key that protects this resource.
7728 },
7729 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
7730 # This value identifies the exact machine image that was used to create this
7731 # persistent disk. For example, if you created the persistent disk from a
7732 # machine image that was later deleted and recreated under the same name, the
7733 # source machine image ID would identify the exact version of the machine
7734 # image that was used.
7735 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
7736 # partial or full URL to the resource. For example, the following are valid
7737 # values:
7738 #
7739 #
7740 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
7741 # - projects/project/global/snapshots/snapshot
7742 # - global/snapshots/snapshot
7743 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
7744 # encryption key of the source snapshot. Required if the source snapshot
7745 # is protected by a customer-supplied encryption key.
7746 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7747 # For example:
7748 #
7749 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7750 # key_region/cryptoKeys/key
7751 #
7752 # The fully-qualifed key name may be returned for resource GET requests. For
7753 # example:
7754 #
7755 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7756 # key_region/cryptoKeys/key
7757 # /cryptoKeyVersions/1
7758 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7759 # key. If absent, the Compute Engine default service account is used.
7760 # For example:
7761 #
7762 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7763 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7764 # encryption key, encoded in RFC
7765 # 4648 base64 to either encrypt or decrypt this resource. You can
7766 # provide either the rawKey or thersaEncryptedKey.
7767 # For example:
7768 #
7769 # &quot;rawKey&quot;:
7770 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7771 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7772 # customer-supplied encryption key to either encrypt or decrypt this
7773 # resource. You can provide either the rawKey or thersaEncryptedKey.
7774 # For example:
7775 #
7776 # &quot;rsaEncryptedKey&quot;:
7777 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7778 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7779 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7780 #
7781 # The key must meet the following requirements before you can provide it to
7782 # Compute Engine:
7783 #
7784 # 1. The key is wrapped using a RSA public key certificate provided by
7785 # Google.
7786 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7787 # encoding.
7788 #
7789 # Gets the RSA public key certificate provided by Google at:
7790 #
7791 #
7792 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7793 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7794 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7795 # encryption key that protects this resource.
7796 },
7797 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
7798 # value identifies the exact snapshot that was used to create this persistent
7799 # disk. For example, if you created the persistent disk from a snapshot that
7800 # was later deleted and recreated under the same name, the source snapshot ID
7801 # would identify the exact version of the snapshot that was used.
7802 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
7803 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
7804 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
7805 # https://storage.googleapis.com/. This flag is not optimized for creating
7806 # multiple disks from a source storage object. To create many disks from a
7807 # source storage object, use gcloud compute images
7808 # import instead.
7809 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
7810 #
7811 #
7812 # - CREATING: Disk is provisioning.
7813 # - RESTORING: Source data is being copied into the
7814 # disk.
7815 # - FAILED: Disk creation failed.
7816 # - READY: Disk is ready for use.
7817 # - DELETING: Disk is deleting.
7818 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7819 # this as a partial or full URL to the resource. For example, the following
7820 # are valid values:
7821 #
7822 #
7823 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7824 # - projects/project/zones/zone/storagePools/storagePool
7825 # - zones/zone/storagePools/storagePool
7826 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
7827 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
7828 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
7829 # types.
7830 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
7831 # in form:projects/project/zones/zone/instances/instance
7832 &quot;A String&quot;,
7833 ],
7834 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
7835 # You must specify this field as part of the HTTP request URL. It is
7836 # not settable as a field in the request body.
7837 }
7838
7839 paths: string, A parameter (repeated)
7840 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
7841 that if you must retry your request, the server will know to ignore the
7842 request if it has already been completed.
7843
7844 For example, consider a situation where you make an initial request and
7845 the request times out. If you make the request again with the same
7846 request ID, the server can check if original operation with the same
7847 request ID was received, and if so, will ignore the second request. This
7848 prevents clients from accidentally creating duplicate commitments.
7849
7850 The request ID must be
7851 a valid UUID with the exception that zero UUID is not supported
7852 (00000000-0000-0000-0000-000000000000).
7853 updateMask: string, update_mask indicates fields to be updated as part of this request.
7854 x__xgafv: string, V1 error format.
7855 Allowed values
7856 1 - v1 error format
7857 2 - v2 error format
7858
7859 Returns:
7860 An object of the form:
7861
7862 { # Represents an Operation resource.
7863 #
7864 # Google Compute Engine has three Operation resources:
7865 #
7866 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
7867 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
7868 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
7869 #
7870 # You can use an operation resource to manage asynchronous API requests.
7871 # For more information, readHandling
7872 # API responses.
7873 #
7874 # Operations can be global, regional or zonal.
7875 #
7876 # - For global operations, use the `globalOperations`
7877 # resource.
7878 # - For regional operations, use the
7879 # `regionOperations` resource.
7880 # - For zonal operations, use
7881 # the `zoneOperations` resource.
7882 #
7883 #
7884 #
7885 # For more information, read
7886 # Global, Regional, and Zonal Resources.
7887 #
7888 # Note that completed Operation resources have a limited
7889 # retention period.
7890 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
7891 # Not present otherwise.
7892 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
7893 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
7894 # set when the operation is created.
7895 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
7896 # text format.
7897 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
7898 # this field will be populated.
7899 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7900 # operation.
7901 {
7902 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7903 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7904 # details. There is a set of defined message types to use for providing
7905 # details.The syntax depends on the error code. For example,
7906 # QuotaExceededInfo will have details when the error code is
7907 # QUOTA_EXCEEDED.
7908 {
7909 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7910 #
7911 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7912 # is not enabled:
7913 #
7914 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7915 # &quot;domain&quot;: &quot;googleapis.com&quot;
7916 # &quot;metadata&quot;: {
7917 # &quot;resource&quot;: &quot;projects/123&quot;,
7918 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7919 # }
7920 # }
7921 #
7922 # This response indicates that the pubsub.googleapis.com API is not enabled.
7923 #
7924 # Example of an error that is returned when attempting to create a Spanner
7925 # instance in a region that is out of stock:
7926 #
7927 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7928 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7929 # &quot;metadata&quot;: {
7930 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7931 # }
7932 # }
7933 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7934 # is typically the registered service name of the tool or product that
7935 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7936 # generated by some common infrastructure, the error domain must be a
7937 # globally unique value that identifies the infrastructure. For Google API
7938 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7939 &quot;metadatas&quot;: { # Additional structured details about this error.
7940 #
7941 # Keys must match a regular expression of `a-z+` but should
7942 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7943 # length. When identifying the current value of an exceeded limit, the units
7944 # should be contained in the key, not the value. For example, rather than
7945 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7946 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7947 # instances that can be created in a single (batch) request.
7948 &quot;a_key&quot;: &quot;A String&quot;,
7949 },
7950 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7951 # proximate cause of the error. Error reasons are unique within a particular
7952 # domain of errors. This should be at most 63 characters and match a
7953 # regular expression of `A-Z+[A-Z0-9]`, which represents
7954 # UPPER_SNAKE_CASE.
7955 },
7956 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7957 #
7958 # For example, if a quota check failed with an error indicating the calling
7959 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7960 # directly to the right place in the developer console to flip the bit.
7961 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7962 { # Describes a URL link.
7963 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7964 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7965 },
7966 ],
7967 },
7968 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7969 # which can be attached to an RPC error.
7970 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7971 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7972 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7973 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7974 },
7975 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7976 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7977 &quot;a_key&quot;: &quot;A String&quot;,
7978 },
7979 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7980 # type or metric.
7981 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7982 # or metric.
7983 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7984 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7985 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7986 },
7987 },
7988 ],
7989 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7990 # This property is optional.
7991 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7992 },
7993 ],
7994 },
7995 &quot;getVersionOperationMetadata&quot;: {
7996 &quot;inlineSbomInfo&quot;: {
7997 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
7998 # appropriate identifiers.
7999 &quot;a_key&quot;: &quot;A String&quot;,
8000 },
8001 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8002 # identifiers.
8003 &quot;a_key&quot;: &quot;A String&quot;,
8004 },
8005 },
8006 },
8007 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8008 # message that was returned, such as `NOT FOUND`.
8009 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8010 # status code that was returned. For example, a `404` means the
8011 # resource was not found.
8012 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8013 # defined by the server.
8014 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8015 # This value is inRFC3339
8016 # text format.
8017 &quot;instancesBulkInsertOperationMetadata&quot;: {
8018 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8019 # Example key: zones/us-central1-a
8020 &quot;a_key&quot;: {
8021 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8022 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8023 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8024 # error.
8025 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8026 # if the flow is rolling forward or rolling back.
8027 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8028 },
8029 },
8030 },
8031 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8032 # Operation resources.
8033 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8034 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8035 # group of operations results from a `bulkInsert` API request.
8036 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8037 # `update`, or `delete`, and so on.
8038 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8039 # There is no requirement that this be linear or support any granularity of
8040 # operations. This should not be used to guess when the operation will be
8041 # complete. This number should monotonically increase as the operation
8042 # progresses.
8043 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8044 # applicable when performing regional operations.
8045 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8046 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
8047 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8048 # this field will contain information on all underlying zonal actions and
8049 # their state.
8050 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8051 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8052 # Example key: zones/us-central1-a
8053 &quot;a_key&quot;: {
8054 &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
8055 # populated.
8056 # different programming environments, including REST APIs and RPC APIs. It is
8057 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8058 # three pieces of data: error code, error message, and error details.
8059 #
8060 # You can find out more about this error model and how to work with it in the
8061 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8062 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8063 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8064 # message types for APIs to use.
8065 {
8066 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8067 },
8068 ],
8069 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8070 # user-facing error message should be localized and sent in the
8071 # google.rpc.Status.details field, or localized by the client.
8072 },
8073 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8074 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8075 },
8076 },
8077 },
8078 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8079 # This value is inRFC3339
8080 # text format.
8081 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8082 # following:
8083 # `PENDING`, `RUNNING`, or `DONE`.
8084 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8085 # operation.
8086 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8087 # of the target resource.
8088 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8089 # operations related to creating a snapshot, this points to the disk
8090 # that the snapshot was created from.
8091 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8092 # `[email protected]` or
8093 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8094 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8095 # operation, this field will be populated.
8096 {
8097 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8098 # Engine returns NO_RESULTS_ON_PAGE if there
8099 # are no results in the response.
8100 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8101 # value format. For example:
8102 #
8103 # &quot;data&quot;: [
8104 # {
8105 # &quot;key&quot;: &quot;scope&quot;,
8106 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8107 # }
8108 {
8109 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8110 # returned. For example, for warnings where there are no results in a list
8111 # request for a particular zone, this key might be scope and
8112 # the key value might be the zone name. Other examples might be a key
8113 # indicating a deprecated resource and a suggested replacement, or a
8114 # warning about invalid network settings (for example, if an instance
8115 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8116 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8117 },
8118 ],
8119 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8120 },
8121 ],
8122 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8123 # applicable when performing per-zone operations.
8124 }</pre>
8125 </div>
8126
8127 <div class="method">
8128 <code class="details" id="updateKmsKey">updateKmsKey(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
8129 <pre>Rotates the customer-managed
8130 encryption key to the latest version for the specified persistent disk.
8131
8132 Args:
8133 project: string, Project ID for this request. (required)
8134 region: string, The name of the region for this request. (required)
8135 disk: string, Name of the Disk resource, should conform to RFC1035. (required)
8136 body: object, The request body.
8137 The object takes the form of:
8138
8139 {
8140 &quot;kmsKeyName&quot;: &quot;A String&quot;, # Optional. The new KMS key to replace the current one on the disk. If empty, the disk
8141 # will be re-encrypted using the primary version of the disk&#x27;s current KMS
8142 # key.
8143 #
8144 # The KMS key can be provided in the following formats:
8145 #
8146 #
8147 # - projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key
8148 #
8149 #
8150 # Where project is the project ID or
8151 # project number.
8152 }
8153
8154 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
8155 that if you must retry your request, the server will know to ignore the
8156 request if it has already been completed.
8157
8158 For example, consider a situation where you make an initial request and
8159 the request times out. If you make the request again with the same
8160 request ID, the server can check if original operation with the same
8161 request ID was received, and if so, will ignore the second request. This
8162 prevents clients from accidentally creating duplicate commitments.
8163
8164 The request ID must be
8165 a valid UUID with the exception that zero UUID is not supported
8166 (00000000-0000-0000-0000-000000000000).
8167 x__xgafv: string, V1 error format.
8168 Allowed values
8169 1 - v1 error format
8170 2 - v2 error format
8171
8172 Returns:
8173 An object of the form:
8174
8175 { # Represents an Operation resource.
8176 #
8177 # Google Compute Engine has three Operation resources:
8178 #
8179 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
8180 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
8181 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
8182 #
8183 # You can use an operation resource to manage asynchronous API requests.
8184 # For more information, readHandling
8185 # API responses.
8186 #
8187 # Operations can be global, regional or zonal.
8188 #
8189 # - For global operations, use the `globalOperations`
8190 # resource.
8191 # - For regional operations, use the
8192 # `regionOperations` resource.
8193 # - For zonal operations, use
8194 # the `zoneOperations` resource.
8195 #
8196 #
8197 #
8198 # For more information, read
8199 # Global, Regional, and Zonal Resources.
8200 #
8201 # Note that completed Operation resources have a limited
8202 # retention period.
8203 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
8204 # Not present otherwise.
8205 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
8206 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
8207 # set when the operation is created.
8208 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
8209 # text format.
8210 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
8211 # this field will be populated.
8212 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8213 # operation.
8214 {
8215 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8216 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8217 # details. There is a set of defined message types to use for providing
8218 # details.The syntax depends on the error code. For example,
8219 # QuotaExceededInfo will have details when the error code is
8220 # QUOTA_EXCEEDED.
8221 {
8222 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8223 #
8224 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8225 # is not enabled:
8226 #
8227 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8228 # &quot;domain&quot;: &quot;googleapis.com&quot;
8229 # &quot;metadata&quot;: {
8230 # &quot;resource&quot;: &quot;projects/123&quot;,
8231 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8232 # }
8233 # }
8234 #
8235 # This response indicates that the pubsub.googleapis.com API is not enabled.
8236 #
8237 # Example of an error that is returned when attempting to create a Spanner
8238 # instance in a region that is out of stock:
8239 #
8240 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8241 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8242 # &quot;metadata&quot;: {
8243 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8244 # }
8245 # }
8246 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8247 # is typically the registered service name of the tool or product that
8248 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8249 # generated by some common infrastructure, the error domain must be a
8250 # globally unique value that identifies the infrastructure. For Google API
8251 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8252 &quot;metadatas&quot;: { # Additional structured details about this error.
8253 #
8254 # Keys must match a regular expression of `a-z+` but should
8255 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8256 # length. When identifying the current value of an exceeded limit, the units
8257 # should be contained in the key, not the value. For example, rather than
8258 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8259 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8260 # instances that can be created in a single (batch) request.
8261 &quot;a_key&quot;: &quot;A String&quot;,
8262 },
8263 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8264 # proximate cause of the error. Error reasons are unique within a particular
8265 # domain of errors. This should be at most 63 characters and match a
8266 # regular expression of `A-Z+[A-Z0-9]`, which represents
8267 # UPPER_SNAKE_CASE.
8268 },
8269 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8270 #
8271 # For example, if a quota check failed with an error indicating the calling
8272 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8273 # directly to the right place in the developer console to flip the bit.
8274 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8275 { # Describes a URL link.
8276 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8277 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8278 },
8279 ],
8280 },
8281 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8282 # which can be attached to an RPC error.
8283 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8284 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8285 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8286 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8287 },
8288 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8289 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8290 &quot;a_key&quot;: &quot;A String&quot;,
8291 },
8292 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8293 # type or metric.
8294 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8295 # or metric.
8296 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8297 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8298 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8299 },
8300 },
8301 ],
8302 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8303 # This property is optional.
8304 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8305 },
8306 ],
8307 },
8308 &quot;getVersionOperationMetadata&quot;: {
8309 &quot;inlineSbomInfo&quot;: {
8310 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
8311 # appropriate identifiers.
8312 &quot;a_key&quot;: &quot;A String&quot;,
8313 },
8314 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8315 # identifiers.
8316 &quot;a_key&quot;: &quot;A String&quot;,
8317 },
8318 },
8319 },
8320 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8321 # message that was returned, such as `NOT FOUND`.
8322 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8323 # status code that was returned. For example, a `404` means the
8324 # resource was not found.
8325 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8326 # defined by the server.
8327 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8328 # This value is inRFC3339
8329 # text format.
8330 &quot;instancesBulkInsertOperationMetadata&quot;: {
8331 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8332 # Example key: zones/us-central1-a
8333 &quot;a_key&quot;: {
8334 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8335 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8336 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8337 # error.
8338 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8339 # if the flow is rolling forward or rolling back.
8340 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8341 },
8342 },
8343 },
8344 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8345 # Operation resources.
8346 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8347 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8348 # group of operations results from a `bulkInsert` API request.
8349 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8350 # `update`, or `delete`, and so on.
8351 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8352 # There is no requirement that this be linear or support any granularity of
8353 # operations. This should not be used to guess when the operation will be
8354 # complete. This number should monotonically increase as the operation
8355 # progresses.
8356 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8357 # applicable when performing regional operations.
8358 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8359 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
8360 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8361 # this field will contain information on all underlying zonal actions and
8362 # their state.
8363 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8364 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8365 # Example key: zones/us-central1-a
8366 &quot;a_key&quot;: {
8367 &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
8368 # populated.
8369 # different programming environments, including REST APIs and RPC APIs. It is
8370 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8371 # three pieces of data: error code, error message, and error details.
8372 #
8373 # You can find out more about this error model and how to work with it in the
8374 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8375 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8376 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8377 # message types for APIs to use.
8378 {
8379 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8380 },
8381 ],
8382 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8383 # user-facing error message should be localized and sent in the
8384 # google.rpc.Status.details field, or localized by the client.
8385 },
8386 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8387 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8388 },
8389 },
8390 },
8391 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8392 # This value is inRFC3339
8393 # text format.
8394 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8395 # following:
8396 # `PENDING`, `RUNNING`, or `DONE`.
8397 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8398 # operation.
8399 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8400 # of the target resource.
8401 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8402 # operations related to creating a snapshot, this points to the disk
8403 # that the snapshot was created from.
8404 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8405 # `[email protected]` or
8406 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8407 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8408 # operation, this field will be populated.
8409 {
8410 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8411 # Engine returns NO_RESULTS_ON_PAGE if there
8412 # are no results in the response.
8413 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8414 # value format. For example:
8415 #
8416 # &quot;data&quot;: [
8417 # {
8418 # &quot;key&quot;: &quot;scope&quot;,
8419 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8420 # }
8421 {
8422 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8423 # returned. For example, for warnings where there are no results in a list
8424 # request for a particular zone, this key might be scope and
8425 # the key value might be the zone name. Other examples might be a key
8426 # indicating a deprecated resource and a suggested replacement, or a
8427 # warning about invalid network settings (for example, if an instance
8428 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8429 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8430 },
8431 ],
8432 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8433 },
8434 ],
8435 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8436 # applicable when performing per-zone operations.
8437 }</pre>
8438 </div>
8439
8440 <div class="method">
8441 <code class="details" id="waitForReplicationCatchUp">waitForReplicationCatchUp(project, region, disk, body=None, requestId=None, x__xgafv=None)</code>
8442 <pre>Wait for replication to catch up on the secondary disk.
8443
8444 Args:
8445 project: string, Project ID for this request. (required)
8446 region: string, Name of the region for this request. (required)
8447 disk: string, The name of the persistent disk.
8448 Name should conform to RFC1035 or be an unsigned long integer. (required)
8449 body: object, The request body.
8450 The object takes the form of:
8451
8452 {
8453 &quot;maxWaitDuration&quot;: &quot;A String&quot;,
8454 }
8455
8456 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
8457 that if you must retry your request, the server will know to ignore the
8458 request if it has already been completed.
8459
8460 For example, consider a situation where you make an initial request and
8461 the request times out. If you make the request again with the same
8462 request ID, the server can check if original operation with the same
8463 request ID was received, and if so, will ignore the second request. This
8464 prevents clients from accidentally creating duplicate commitments.
8465
8466 The request ID must be
8467 a valid UUID with the exception that zero UUID is not supported
8468 (00000000-0000-0000-0000-000000000000).
8469 x__xgafv: string, V1 error format.
8470 Allowed values
8471 1 - v1 error format
8472 2 - v2 error format
8473
8474 Returns:
8475 An object of the form:
8476
8477 { # Represents an Operation resource.
8478 #
8479 # Google Compute Engine has three Operation resources:
8480 #
8481 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
8482 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
8483 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
8484 #
8485 # You can use an operation resource to manage asynchronous API requests.
8486 # For more information, readHandling
8487 # API responses.
8488 #
8489 # Operations can be global, regional or zonal.
8490 #
8491 # - For global operations, use the `globalOperations`
8492 # resource.
8493 # - For regional operations, use the
8494 # `regionOperations` resource.
8495 # - For zonal operations, use
8496 # the `zoneOperations` resource.
8497 #
8498 #
8499 #
8500 # For more information, read
8501 # Global, Regional, and Zonal Resources.
8502 #
8503 # Note that completed Operation resources have a limited
8504 # retention period.
8505 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
8506 # Not present otherwise.
8507 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
8508 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
8509 # set when the operation is created.
8510 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
8511 # text format.
8512 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
8513 # this field will be populated.
8514 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8515 # operation.
8516 {
8517 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8518 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8519 # details. There is a set of defined message types to use for providing
8520 # details.The syntax depends on the error code. For example,
8521 # QuotaExceededInfo will have details when the error code is
8522 # QUOTA_EXCEEDED.
8523 {
8524 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8525 #
8526 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8527 # is not enabled:
8528 #
8529 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8530 # &quot;domain&quot;: &quot;googleapis.com&quot;
8531 # &quot;metadata&quot;: {
8532 # &quot;resource&quot;: &quot;projects/123&quot;,
8533 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8534 # }
8535 # }
8536 #
8537 # This response indicates that the pubsub.googleapis.com API is not enabled.
8538 #
8539 # Example of an error that is returned when attempting to create a Spanner
8540 # instance in a region that is out of stock:
8541 #
8542 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8543 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8544 # &quot;metadata&quot;: {
8545 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8546 # }
8547 # }
8548 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8549 # is typically the registered service name of the tool or product that
8550 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8551 # generated by some common infrastructure, the error domain must be a
8552 # globally unique value that identifies the infrastructure. For Google API
8553 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8554 &quot;metadatas&quot;: { # Additional structured details about this error.
8555 #
8556 # Keys must match a regular expression of `a-z+` but should
8557 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8558 # length. When identifying the current value of an exceeded limit, the units
8559 # should be contained in the key, not the value. For example, rather than
8560 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8561 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8562 # instances that can be created in a single (batch) request.
8563 &quot;a_key&quot;: &quot;A String&quot;,
8564 },
8565 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8566 # proximate cause of the error. Error reasons are unique within a particular
8567 # domain of errors. This should be at most 63 characters and match a
8568 # regular expression of `A-Z+[A-Z0-9]`, which represents
8569 # UPPER_SNAKE_CASE.
8570 },
8571 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8572 #
8573 # For example, if a quota check failed with an error indicating the calling
8574 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8575 # directly to the right place in the developer console to flip the bit.
8576 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8577 { # Describes a URL link.
8578 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8579 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8580 },
8581 ],
8582 },
8583 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8584 # which can be attached to an RPC error.
8585 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8586 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8587 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8588 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8589 },
8590 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8591 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8592 &quot;a_key&quot;: &quot;A String&quot;,
8593 },
8594 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8595 # type or metric.
8596 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8597 # or metric.
8598 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8599 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8600 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8601 },
8602 },
8603 ],
8604 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8605 # This property is optional.
8606 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8607 },
8608 ],
8609 },
8610 &quot;getVersionOperationMetadata&quot;: {
8611 &quot;inlineSbomInfo&quot;: {
8612 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
8613 # appropriate identifiers.
8614 &quot;a_key&quot;: &quot;A String&quot;,
8615 },
8616 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8617 # identifiers.
8618 &quot;a_key&quot;: &quot;A String&quot;,
8619 },
8620 },
8621 },
8622 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8623 # message that was returned, such as `NOT FOUND`.
8624 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8625 # status code that was returned. For example, a `404` means the
8626 # resource was not found.
8627 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8628 # defined by the server.
8629 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8630 # This value is inRFC3339
8631 # text format.
8632 &quot;instancesBulkInsertOperationMetadata&quot;: {
8633 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8634 # Example key: zones/us-central1-a
8635 &quot;a_key&quot;: {
8636 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8637 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8638 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8639 # error.
8640 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8641 # if the flow is rolling forward or rolling back.
8642 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8643 },
8644 },
8645 },
8646 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8647 # Operation resources.
8648 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8649 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8650 # group of operations results from a `bulkInsert` API request.
8651 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8652 # `update`, or `delete`, and so on.
8653 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8654 # There is no requirement that this be linear or support any granularity of
8655 # operations. This should not be used to guess when the operation will be
8656 # complete. This number should monotonically increase as the operation
8657 # progresses.
8658 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8659 # applicable when performing regional operations.
8660 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8661 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
8662 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8663 # this field will contain information on all underlying zonal actions and
8664 # their state.
8665 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8666 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8667 # Example key: zones/us-central1-a
8668 &quot;a_key&quot;: {
8669 &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
8670 # populated.
8671 # different programming environments, including REST APIs and RPC APIs. It is
8672 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8673 # three pieces of data: error code, error message, and error details.
8674 #
8675 # You can find out more about this error model and how to work with it in the
8676 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8677 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8678 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8679 # message types for APIs to use.
8680 {
8681 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8682 },
8683 ],
8684 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8685 # user-facing error message should be localized and sent in the
8686 # google.rpc.Status.details field, or localized by the client.
8687 },
8688 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8689 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8690 },
8691 },
8692 },
8693 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8694 # This value is inRFC3339
8695 # text format.
8696 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8697 # following:
8698 # `PENDING`, `RUNNING`, or `DONE`.
8699 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8700 # operation.
8701 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8702 # of the target resource.
8703 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8704 # operations related to creating a snapshot, this points to the disk
8705 # that the snapshot was created from.
8706 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8707 # `[email protected]` or
8708 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8709 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8710 # operation, this field will be populated.
8711 {
8712 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8713 # Engine returns NO_RESULTS_ON_PAGE if there
8714 # are no results in the response.
8715 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8716 # value format. For example:
8717 #
8718 # &quot;data&quot;: [
8719 # {
8720 # &quot;key&quot;: &quot;scope&quot;,
8721 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8722 # }
8723 {
8724 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8725 # returned. For example, for warnings where there are no results in a list
8726 # request for a particular zone, this key might be scope and
8727 # the key value might be the zone name. Other examples might be a key
8728 # indicating a deprecated resource and a suggested replacement, or a
8729 # warning about invalid network settings (for example, if an instance
8730 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8731 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8732 },
8733 ],
8734 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8735 },
8736 ],
8737 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8738 # applicable when performing per-zone operations.
8739 }</pre>
8740 </div>
8741
8742 </body></html>