Debian Codegraph @

docs/dyn/compute_alpha.disks.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.disks.html">disks</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#addResourcePolicies">addResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Adds existing resource policies to a disk. You can only add one</p>
80 <p class="toc_element">
81 <code><a href="#aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Retrieves an aggregated list of persistent disks.</p>
83 <p class="toc_element">
84 <code><a href="#aggregatedList_next">aggregatedList_next()</a></code></p>
85 <p class="firstline">Retrieves the next page of results.</p>
86 <p class="toc_element">
87 <code><a href="#bulkInsert">bulkInsert(project, zone, body=None, requestId=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Bulk create a set of disks.</p>
89 <p class="toc_element">
90 <code><a href="#bulkSetLabels">bulkSetLabels(project, zone, body=None, requestId=None, resource=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Sets the labels on many disks at once. To learn more about labels, read theLabeling</p>
92 <p class="toc_element">
93 <code><a href="#close">close()</a></code></p>
94 <p class="firstline">Close httplib2 connections.</p>
95 <p class="toc_element">
96 <code><a href="#convert">convert(project, zone, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Converts a persistent disk to support Gen4+ VMs.</p>
98 <p class="toc_element">
99 <code><a href="#createSnapshot">createSnapshot(project, zone, disk, body=None, guestFlush=None, requestId=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Creates a snapshot of a specified persistent disk. For regular snapshot</p>
101 <p class="toc_element">
102 <code><a href="#delete">delete(project, zone, disk, requestId=None, x__xgafv=None)</a></code></p>
103 <p class="firstline">Deletes the specified persistent disk. Deleting a disk removes its data</p>
104 <p class="toc_element">
105 <code><a href="#get">get(project, zone, disk, x__xgafv=None)</a></code></p>
106 <p class="firstline">Returns the specified persistent disk.</p>
107 <p class="toc_element">
108 <code><a href="#getAsyncReplicationStatus">getAsyncReplicationStatus(project, zone, disk, x__xgafv=None)</a></code></p>
109 <p class="firstline">Gets the status of current async replication for a given device.</p>
110 <p class="toc_element">
111 <code><a href="#getIamPolicy">getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</a></code></p>
112 <p class="firstline">Gets the access control policy for a resource. May be empty if no such</p>
113 <p class="toc_element">
114 <code><a href="#insert">insert(project, zone, body=None, requestId=None, sourceImage=None, x__xgafv=None)</a></code></p>
115 <p class="firstline">Creates a persistent disk in the specified project using the data</p>
116 <p class="toc_element">
117 <code><a href="#list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
118 <p class="firstline">Retrieves a list of persistent disks contained within</p>
119 <p class="toc_element">
120 <code><a href="#list_next">list_next()</a></code></p>
121 <p class="firstline">Retrieves the next page of results.</p>
122 <p class="toc_element">
123 <code><a href="#removeResourcePolicies">removeResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
124 <p class="firstline">Removes resource policies from a disk.</p>
125 <p class="toc_element">
126 <code><a href="#resize">resize(project, zone, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
127 <p class="firstline">Resizes the specified persistent disk.</p>
128 <p class="toc_element">
129 <code><a href="#setIamPolicy">setIamPolicy(project, zone, resource, body=None, x__xgafv=None)</a></code></p>
130 <p class="firstline">Sets the access control policy on the specified resource.</p>
131 <p class="toc_element">
132 <code><a href="#setLabels">setLabels(project, zone, resource, body=None, requestId=None, x__xgafv=None)</a></code></p>
133 <p class="firstline">Sets the labels on a disk. To learn more about labels, read theLabeling</p>
134 <p class="toc_element">
135 <code><a href="#startAsyncReplication">startAsyncReplication(project, zone, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
136 <p class="firstline">Starts asynchronous replication.</p>
137 <p class="toc_element">
138 <code><a href="#stopAsyncReplication">stopAsyncReplication(project, zone, disk, requestId=None, x__xgafv=None)</a></code></p>
139 <p class="firstline">Stops asynchronous replication.</p>
140 <p class="toc_element">
141 <code><a href="#stopGroupAsyncReplication">stopGroupAsyncReplication(project, zone, body=None, requestId=None, x__xgafv=None)</a></code></p>
142 <p class="firstline">Stops asynchronous replication for a consistency group of disks.</p>
143 <p class="toc_element">
144 <code><a href="#testIamPermissions">testIamPermissions(project, zone, resource, body=None, x__xgafv=None)</a></code></p>
145 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
146 <p class="toc_element">
147 <code><a href="#update">update(project, zone, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)</a></code></p>
148 <p class="firstline">Updates the specified disk with the data included in the request.</p>
149 <p class="toc_element">
150 <code><a href="#updateKmsKey">updateKmsKey(project, zone, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
151 <p class="firstline">Rotates the customer-managed</p>
152 <p class="toc_element">
153 <code><a href="#waitForReplicationCatchUp">waitForReplicationCatchUp(project, zone, disk, body=None, requestId=None, x__xgafv=None)</a></code></p>
154 <p class="firstline">Wait for replication to catch up on the secondary disk.</p>
155 <h3>Method Details</h3>
156 <div class="method">
157 <code class="details" id="addResourcePolicies">addResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None)</code>
158 <pre>Adds existing resource policies to a disk. You can only add one
159 policy which will be applied to this disk for scheduling snapshot
160 creation.
161
162 Args:
163 project: string, Project ID for this request. (required)
164 zone: string, The name of the zone for this request. (required)
165 disk: string, The disk name for this request. (required)
166 body: object, The request body.
167 The object takes the form of:
168
169 {
170 &quot;resourcePolicies&quot;: [ # Full or relative path to the resource policy to be added to this disk. You
171 # can only specify one resource policy.
172 &quot;A String&quot;,
173 ],
174 }
175
176 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
177 that if you must retry your request, the server will know to ignore the
178 request if it has already been completed.
179
180 For example, consider a situation where you make an initial request and
181 the request times out. If you make the request again with the same
182 request ID, the server can check if original operation with the same
183 request ID was received, and if so, will ignore the second request. This
184 prevents clients from accidentally creating duplicate commitments.
185
186 The request ID must be
187 a valid UUID with the exception that zero UUID is not supported
188 (00000000-0000-0000-0000-000000000000).
189 x__xgafv: string, V1 error format.
190 Allowed values
191 1 - v1 error format
192 2 - v2 error format
193
194 Returns:
195 An object of the form:
196
197 { # Represents an Operation resource.
198 #
199 # Google Compute Engine has three Operation resources:
200 #
201 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
202 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
203 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
204 #
205 # You can use an operation resource to manage asynchronous API requests.
206 # For more information, readHandling
207 # API responses.
208 #
209 # Operations can be global, regional or zonal.
210 #
211 # - For global operations, use the `globalOperations`
212 # resource.
213 # - For regional operations, use the
214 # `regionOperations` resource.
215 # - For zonal operations, use
216 # the `zoneOperations` resource.
217 #
218 #
219 #
220 # For more information, read
221 # Global, Regional, and Zonal Resources.
222 #
223 # Note that completed Operation resources have a limited
224 # retention period.
225 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
226 # Not present otherwise.
227 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
228 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
229 # set when the operation is created.
230 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
231 # text format.
232 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
233 # this field will be populated.
234 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
235 # operation.
236 {
237 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
238 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
239 # details. There is a set of defined message types to use for providing
240 # details.The syntax depends on the error code. For example,
241 # QuotaExceededInfo will have details when the error code is
242 # QUOTA_EXCEEDED.
243 {
244 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
245 #
246 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
247 # is not enabled:
248 #
249 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
250 # &quot;domain&quot;: &quot;googleapis.com&quot;
251 # &quot;metadata&quot;: {
252 # &quot;resource&quot;: &quot;projects/123&quot;,
253 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
254 # }
255 # }
256 #
257 # This response indicates that the pubsub.googleapis.com API is not enabled.
258 #
259 # Example of an error that is returned when attempting to create a Spanner
260 # instance in a region that is out of stock:
261 #
262 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
263 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
264 # &quot;metadata&quot;: {
265 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
266 # }
267 # }
268 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
269 # is typically the registered service name of the tool or product that
270 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
271 # generated by some common infrastructure, the error domain must be a
272 # globally unique value that identifies the infrastructure. For Google API
273 # infrastructure, the error domain is &quot;googleapis.com&quot;.
274 &quot;metadatas&quot;: { # Additional structured details about this error.
275 #
276 # Keys must match a regular expression of `a-z+` but should
277 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
278 # length. When identifying the current value of an exceeded limit, the units
279 # should be contained in the key, not the value. For example, rather than
280 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
281 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
282 # instances that can be created in a single (batch) request.
283 &quot;a_key&quot;: &quot;A String&quot;,
284 },
285 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
286 # proximate cause of the error. Error reasons are unique within a particular
287 # domain of errors. This should be at most 63 characters and match a
288 # regular expression of `A-Z+[A-Z0-9]`, which represents
289 # UPPER_SNAKE_CASE.
290 },
291 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
292 #
293 # For example, if a quota check failed with an error indicating the calling
294 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
295 # directly to the right place in the developer console to flip the bit.
296 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
297 { # Describes a URL link.
298 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
299 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
300 },
301 ],
302 },
303 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
304 # which can be attached to an RPC error.
305 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
306 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
307 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
308 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
309 },
310 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
311 &quot;dimensions&quot;: { # The map holding related quota dimensions.
312 &quot;a_key&quot;: &quot;A String&quot;,
313 },
314 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
315 # type or metric.
316 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
317 # or metric.
318 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
319 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
320 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
321 },
322 },
323 ],
324 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
325 # This property is optional.
326 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
327 },
328 ],
329 },
330 &quot;getVersionOperationMetadata&quot;: {
331 &quot;inlineSbomInfo&quot;: {
332 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
333 # appropriate identifiers.
334 &quot;a_key&quot;: &quot;A String&quot;,
335 },
336 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
337 # identifiers.
338 &quot;a_key&quot;: &quot;A String&quot;,
339 },
340 },
341 },
342 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
343 # message that was returned, such as `NOT FOUND`.
344 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
345 # status code that was returned. For example, a `404` means the
346 # resource was not found.
347 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
348 # defined by the server.
349 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
350 # This value is inRFC3339
351 # text format.
352 &quot;instancesBulkInsertOperationMetadata&quot;: {
353 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
354 # Example key: zones/us-central1-a
355 &quot;a_key&quot;: {
356 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
357 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
358 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
359 # error.
360 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
361 # if the flow is rolling forward or rolling back.
362 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
363 },
364 },
365 },
366 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
367 # Operation resources.
368 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
369 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
370 # group of operations results from a `bulkInsert` API request.
371 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
372 # `update`, or `delete`, and so on.
373 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
374 # There is no requirement that this be linear or support any granularity of
375 # operations. This should not be used to guess when the operation will be
376 # complete. This number should monotonically increase as the operation
377 # progresses.
378 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
379 # applicable when performing regional operations.
380 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
381 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
382 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
383 # this field will contain information on all underlying zonal actions and
384 # their state.
385 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
386 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
387 # Example key: zones/us-central1-a
388 &quot;a_key&quot;: {
389 &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
390 # populated.
391 # different programming environments, including REST APIs and RPC APIs. It is
392 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
393 # three pieces of data: error code, error message, and error details.
394 #
395 # You can find out more about this error model and how to work with it in the
396 # [API Design Guide](https://cloud.google.com/apis/design/errors).
397 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
398 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
399 # message types for APIs to use.
400 {
401 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
402 },
403 ],
404 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
405 # user-facing error message should be localized and sent in the
406 # google.rpc.Status.details field, or localized by the client.
407 },
408 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
409 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
410 },
411 },
412 },
413 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
414 # This value is inRFC3339
415 # text format.
416 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
417 # following:
418 # `PENDING`, `RUNNING`, or `DONE`.
419 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
420 # operation.
421 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
422 # of the target resource.
423 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
424 # operations related to creating a snapshot, this points to the disk
425 # that the snapshot was created from.
426 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
427 # `[email protected]` or
428 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
429 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
430 # operation, this field will be populated.
431 {
432 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
433 # Engine returns NO_RESULTS_ON_PAGE if there
434 # are no results in the response.
435 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
436 # value format. For example:
437 #
438 # &quot;data&quot;: [
439 # {
440 # &quot;key&quot;: &quot;scope&quot;,
441 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
442 # }
443 {
444 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
445 # returned. For example, for warnings where there are no results in a list
446 # request for a particular zone, this key might be scope and
447 # the key value might be the zone name. Other examples might be a key
448 # indicating a deprecated resource and a suggested replacement, or a
449 # warning about invalid network settings (for example, if an instance
450 # attempts to perform IP forwarding but is not enabled for IP forwarding).
451 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
452 },
453 ],
454 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
455 },
456 ],
457 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
458 # applicable when performing per-zone operations.
459 }</pre>
460 </div>
461
462 <div class="method">
463 <code class="details" id="aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</code>
464 <pre>Retrieves an aggregated list of persistent disks.
465
466 To prevent failure, it is recommended that you set the
467 `returnPartialSuccess` parameter to `true`.
468
469 Args:
470 project: string, Project ID for this request. (required)
471 filter: string, A filter expression that filters resources listed in the response. Most
472 Compute resources support two types of filter expressions:
473 expressions that support regular expressions and expressions that follow
474 API improvement proposal AIP-160.
475 These two types of filter expressions cannot be mixed in one request.
476
477 If you want to use AIP-160, your expression must specify the field name, an
478 operator, and the value that you want to use for filtering. The value
479 must be a string, a number, or a boolean. The operator
480 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
481
482 For example, if you are filtering Compute Engine instances, you can
483 exclude instances named `example-instance` by specifying
484 `name != example-instance`.
485
486 The `:*` comparison can be used to test whether a key has been defined.
487 For example, to find all objects with `owner` label use:
488 ```
489 labels.owner:*
490 ```
491
492 You can also filter nested fields. For example, you could specify
493 `scheduling.automaticRestart = false` to include instances only
494 if they are not scheduled for automatic restarts. You can use filtering
495 on nested fields to filter based onresource labels.
496
497 To filter on multiple expressions, provide each separate expression within
498 parentheses. For example:
499 ```
500 (scheduling.automaticRestart = true)
501 (cpuPlatform = &quot;Intel Skylake&quot;)
502 ```
503 By default, each expression is an `AND` expression. However, you
504 can include `AND` and `OR` expressions explicitly.
505 For example:
506 ```
507 (cpuPlatform = &quot;Intel Skylake&quot;) OR
508 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
509 (scheduling.automaticRestart = true)
510 ```
511
512 If you want to use a regular expression, use the `eq` (equal) or `ne`
513 (not equal) operator against a single un-parenthesized expression with or
514 without quotes or against multiple parenthesized expressions. Examples:
515
516 `fieldname eq unquoted literal`
517 `fieldname eq &#x27;single quoted literal&#x27;`
518 `fieldname eq &quot;double quoted literal&quot;`
519 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
520
521 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
522 The literal value must match the entire field.
523
524 For example, to filter for instances that do not end with name &quot;instance&quot;,
525 you would use `name ne .*instance`.
526
527 You cannot combine constraints on multiple fields using regular
528 expressions.
529 includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region,
530 global) should be included in the response. For new resource types added
531 after this field, the flag has no effect as new resource types will always
532 include every visible scope for each scope type in response. For resource
533 types which predate this field, if this flag is omitted or false, only
534 scopes of the scope types where the resource type is expected to be found
535 will be included.
536 maxResults: integer, The maximum number of results per page that should be returned.
537 If the number of available results is larger than `maxResults`,
538 Compute Engine returns a `nextPageToken` that can be used to get
539 the next page of results in subsequent list requests. Acceptable values are
540 `0` to `500`, inclusive. (Default: `500`)
541 orderBy: string, Sorts list results by a certain order. By default, results
542 are returned in alphanumerical order based on the resource name.
543
544 You can also sort results in descending order based on the creation
545 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
546 results based on the `creationTimestamp` field in
547 reverse chronological order (newest result first). Use this to sort
548 resources like operations so that the newest operation is returned first.
549
550 Currently, only sorting by `name` or
551 `creationTimestamp desc` is supported.
552 pageToken: string, Specifies a page token to use. Set `pageToken` to the
553 `nextPageToken` returned by a previous list request to get
554 the next page of results.
555 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
556 of failure. The default value is false.
557
558 For example, when partial success behavior is enabled, aggregatedList for a
559 single zone scope either returns all resources in the zone or no resources,
560 with an error code.
561 serviceProjectNumber: string, The Shared VPC service project id or service project number for which
562 aggregated list request is invoked for subnetworks list-usable api.
563 x__xgafv: string, V1 error format.
564 Allowed values
565 1 - v1 error format
566 2 - v2 error format
567
568 Returns:
569 An object of the form:
570
571 {
572 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
573 &quot;items&quot;: { # A list of DisksScopedList resources.
574 &quot;a_key&quot;: { # [Output Only] Name of the scope containing this set of disks.
575 &quot;disks&quot;: [ # [Output Only] A list of disks contained in this scope.
576 { # Represents a Persistent Disk resource.
577 #
578 # Google Compute Engine has two Disk resources:
579 #
580 # * [Zonal](/compute/docs/reference/rest/alpha/disks)
581 # * [Regional](/compute/docs/reference/rest/alpha/regionDisks)
582 #
583 # Persistent disks are required for running your VM instances.
584 # Create both boot and non-boot (data) persistent disks. For more information,
585 # read Persistent Disks. For more
586 # storage options, read Storage options.
587 #
588 # The disks resource represents a zonal persistent disk.
589 # For more information, readZonal persistent disks.
590 #
591 # The regionDisks resource represents a
592 # regional persistent disk. For more information, read
593 # Regional resources.
594 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
595 #
596 #
597 # - READ_WRITE_SINGLE: The default AccessMode, means the
598 # disk can be attached to single instance in RW mode.
599 # - READ_WRITE_MANY: The AccessMode means the disk can be
600 # attached to multiple instances in RW mode.
601 # - READ_ONLY_MANY: The AccessMode means the disk can be
602 # attached to multiple instances in RO mode.
603 #
604 #
605 # The AccessMode is only valid for Hyperdisk disk types.
606 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
607 # ARM64 or X86_64.
608 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
609 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
610 # started on the disk as a member of a group.
611 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
612 # started on the disk as a member of a group.
613 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
614 # You can provide this as a partial or full URL to the resource.
615 # For example, the following are valid values:
616 #
617 #
618 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
619 # - projects/project/zones/zone/disks/disk
620 # - zones/zone/disks/disk
621 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
622 # to or from the current disk. This value identifies the exact disk that
623 # was used to create this replication. For example, if you started
624 # replicating the persistent disk from a disk that was later deleted and
625 # recreated under the same name, the disk ID would identify the exact
626 # version of the disk that was used.
627 },
628 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
629 &quot;a_key&quot;: {
630 &quot;asyncReplicationDisk&quot;: {
631 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
632 # started on the disk as a member of a group.
633 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
634 # started on the disk as a member of a group.
635 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
636 # You can provide this as a partial or full URL to the resource.
637 # For example, the following are valid values:
638 #
639 #
640 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
641 # - projects/project/zones/zone/disks/disk
642 # - zones/zone/disks/disk
643 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
644 # to or from the current disk. This value identifies the exact disk that
645 # was used to create this replication. For example, if you started
646 # replicating the persistent disk from a disk that was later deleted and
647 # recreated under the same name, the disk ID would identify the exact
648 # version of the disk that was used.
649 },
650 },
651 },
652 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
653 # text format.
654 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
655 # create the resource.
656 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
657 # customer-supplied encryption key or a
658 # customer-managed encryption key.
659 #
660 # Encryption keys do not protect access to metadata of the disk.
661 #
662 # After you encrypt a disk with a customer-supplied key, you must provide the
663 # same key if you use the disk later. For example, to create a disk snapshot,
664 # to create a disk image, to create a machine image, or to attach the disk to
665 # a virtual machine.
666 #
667 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
668 # name once the disk is created. The disk is encrypted with this version of
669 # the key. In the response, diskEncryptionKey.kmsKeyName appears
670 # in the following format:
671 #
672 # &quot;diskEncryptionKey.kmsKeyName&quot;:
673 # &quot;projects/kms_project_id/locations/region/keyRings/
674 # key_region/cryptoKeys/key
675 # /cryptoKeysVersions/version
676 #
677 # If you do not provide an encryption key when creating the disk, then the
678 # disk is encrypted using an automatically generated key and you don&#x27;t need
679 # to provide a key to use the disk later.
680 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
681 # For example:
682 #
683 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
684 # key_region/cryptoKeys/key
685 #
686 # The fully-qualifed key name may be returned for resource GET requests. For
687 # example:
688 #
689 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
690 # key_region/cryptoKeys/key
691 # /cryptoKeyVersions/1
692 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
693 # key. If absent, the Compute Engine default service account is used.
694 # For example:
695 #
696 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
697 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
698 # encryption key, encoded in RFC
699 # 4648 base64 to either encrypt or decrypt this resource. You can
700 # provide either the rawKey or thersaEncryptedKey.
701 # For example:
702 #
703 # &quot;rawKey&quot;:
704 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
705 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
706 # customer-supplied encryption key to either encrypt or decrypt this
707 # resource. You can provide either the rawKey or thersaEncryptedKey.
708 # For example:
709 #
710 # &quot;rsaEncryptedKey&quot;:
711 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
712 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
713 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
714 #
715 # The key must meet the following requirements before you can provide it to
716 # Compute Engine:
717 #
718 # 1. The key is wrapped using a RSA public key certificate provided by
719 # Google.
720 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
721 # encoding.
722 #
723 # Gets the RSA public key certificate provided by Google at:
724 #
725 #
726 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
727 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
728 # 4648 base64 encoded SHA-256 hash of the customer-supplied
729 # encryption key that protects this resource.
730 },
731 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
732 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
733 # Windows specific VSS signature.
734 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
735 # only for bootable images. Read
736 # Enabling guest operating system features to see a list of available
737 # options.
738 { # Guest OS features.
739 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
740 # separate values. Set to one or more of the following values:
741 #
742 # - VIRTIO_SCSI_MULTIQUEUE
743 # - WINDOWS
744 # - MULTI_IP_SUBNET
745 # - UEFI_COMPATIBLE
746 # - GVNIC
747 # - SEV_CAPABLE
748 # - SUSPEND_RESUME_COMPATIBLE
749 # - SEV_LIVE_MIGRATABLE_V2
750 # - SEV_SNP_CAPABLE
751 # - TDX_CAPABLE
752 # - IDPF
753 # - SNP_SVSM_CAPABLE
754 # - CCA_CAPABLE
755 #
756 #
757 # For more information, see
758 # Enabling guest operating system features.
759 },
760 ],
761 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
762 # defined by the server.
763 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
764 # which is either SCSI or NVME. The default isSCSI.
765 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
766 # disks.
767 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
768 # essentially a hash of the labels set used for optimistic locking. The
769 # fingerprint is initially generated by Compute Engine and changes after
770 # every request to modify or update labels. You must always provide an
771 # up-to-date fingerprint hash in order to update or change labels,
772 # otherwise the request will fail with error412 conditionNotMet.
773 #
774 # To see the latest fingerprint, make a get() request to
775 # retrieve a disk.
776 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
777 # the setLabels method.
778 &quot;a_key&quot;: &quot;A String&quot;,
779 },
780 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
781 # text format.
782 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
783 # text format.
784 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
785 &quot;A String&quot;,
786 ],
787 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
788 &quot;A String&quot;,
789 ],
790 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
791 # This field is for use by internal tools that use the public API.
792 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
793 # source image. Attachment of a disk created from a locked source image will
794 # cause the following operations to become irreversibly prohibited:
795 #
796 # - R/W or R/O disk attachment to any other instance
797 # - Disk detachment. And the disk can only be deleted when the instance
798 # is deleted
799 # - Creation of images or snapshots
800 # - Disk cloning
801 #
802 #
803 #
804 # Furthermore, the instance with at least one disk with locked flag set to
805 # true will be prohibited from performing the operations below:
806 #
807 # - Further attachment of secondary disks.
808 # - Detachment of any disks
809 # - Create machine images
810 # - Create instance template
811 # - Delete the instance with --keep-disk parameter set to true for locked
812 # disks
813 # - Attach a locked disk with --auto-delete parameter set to false
814 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
815 # more than one instance.
816 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
817 # The name must be 1-63 characters long, and comply withRFC1035.
818 # Specifically, the name must be 1-63 characters long and match the regular
819 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
820 # which means the first character must be a lowercase letter, and all
821 # following characters must be a dash, lowercase letter, or digit, except
822 # the last character, which cannot be a dash.
823 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
824 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
825 # as part of resource payload.
826 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
827 # have the same definition as resource
828 # manager tags. Keys and values can be either in numeric format,
829 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
830 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
831 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
832 # PATCH) when empty.
833 &quot;a_key&quot;: &quot;A String&quot;,
834 },
835 },
836 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
837 # If not present in a request, a default value is used.
838 # The currently supported size is 4096, other sizes may be added in
839 # the future.
840 # If an unsupported value is requested, the error message will list
841 # the supported values for the caller&#x27;s project.
842 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
843 # of I/O operations per second that the disk can handle. Values must be
844 # between 10,000 and 120,000. For more details, see theExtreme persistent
845 # disk documentation.
846 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
847 # number of throughput mb per second that the disk can handle. Values must be
848 # greater than or equal to 1.
849 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
850 # regional resources.
851 # You must specify this field as part of the HTTP request URL. It is
852 # not settable as a field in the request body.
853 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
854 # for regional resources.
855 &quot;A String&quot;,
856 ],
857 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
858 &quot;A String&quot;,
859 ],
860 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
861 &quot;asyncPrimaryDisk&quot;: {
862 &quot;state&quot;: &quot;A String&quot;,
863 },
864 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
865 &quot;a_key&quot;: {
866 &quot;state&quot;: &quot;A String&quot;,
867 },
868 },
869 &quot;usedBytes&quot;: &quot;A String&quot;, # [Output Only] Space used by data stored in the disk (in bytes). Note that
870 # this field is set only when the disk is in a storage pool.
871 },
872 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
873 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
874 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
875 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
876 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
877 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
878 # persistent disk.
879 #
880 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
881 # source.
882 # Acceptable values are greater than 0.
883 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
884 # that was created using a consistency group.
885 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
886 # that was created using a consistency group.
887 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
888 # partial or full URL to the resource. For example, the following are valid
889 # values:
890 #
891 #
892 # -
893 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
894 #
895 # -
896 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
897 #
898 # -
899 # projects/project/zones/zone/disks/disk
900 #
901 # -
902 # projects/project/regions/region/disks/disk
903 #
904 # -
905 # zones/zone/disks/disk
906 #
907 # -
908 # regions/region/disks/disk
909 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
910 # value identifies the exact disk that was used to create this persistent
911 # disk. For example, if you created the persistent disk from a disk that
912 # was later deleted and recreated under the same name, the source disk ID
913 # would identify the exact version of the disk that was used.
914 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
915 # deleted, this field will not be set.
916 #
917 # To create a disk with one of the public operating system images, specify
918 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
919 #
920 # projects/debian-cloud/global/images/family/debian-9
921 #
922 #
923 # Alternatively, use a specific version of a public operating system image:
924 #
925 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
926 #
927 #
928 # To create a disk with a custom image that you created, specify the
929 # image name in the following format:
930 #
931 # global/images/my-custom-image
932 #
933 #
934 # You can also specify a custom image by its image family, which returns
935 # the latest version of the image in that family. Replace the image name
936 # with family/family-name:
937 #
938 # global/images/family/my-image-family
939 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
940 # encryption key of the source image. Required if the source image is
941 # protected by a customer-supplied encryption key.
942 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
943 # For example:
944 #
945 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
946 # key_region/cryptoKeys/key
947 #
948 # The fully-qualifed key name may be returned for resource GET requests. For
949 # example:
950 #
951 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
952 # key_region/cryptoKeys/key
953 # /cryptoKeyVersions/1
954 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
955 # key. If absent, the Compute Engine default service account is used.
956 # For example:
957 #
958 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
959 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
960 # encryption key, encoded in RFC
961 # 4648 base64 to either encrypt or decrypt this resource. You can
962 # provide either the rawKey or thersaEncryptedKey.
963 # For example:
964 #
965 # &quot;rawKey&quot;:
966 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
967 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
968 # customer-supplied encryption key to either encrypt or decrypt this
969 # resource. You can provide either the rawKey or thersaEncryptedKey.
970 # For example:
971 #
972 # &quot;rsaEncryptedKey&quot;:
973 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
974 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
975 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
976 #
977 # The key must meet the following requirements before you can provide it to
978 # Compute Engine:
979 #
980 # 1. The key is wrapped using a RSA public key certificate provided by
981 # Google.
982 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
983 # encoding.
984 #
985 # Gets the RSA public key certificate provided by Google at:
986 #
987 #
988 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
989 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
990 # 4648 base64 encoded SHA-256 hash of the customer-supplied
991 # encryption key that protects this resource.
992 },
993 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
994 # value identifies the exact image that was used to create this persistent
995 # disk. For example, if you created the persistent disk from an image that
996 # was later deleted and recreated under the same name, the source image ID
997 # would identify the exact version of the image that was used.
998 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
999 # this as a partial or full URL to the resource. For example, the following
1000 # are valid values:
1001 #
1002 #
1003 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
1004 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
1005 # - zones/zone/instantSnapshots/instantSnapshot
1006 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
1007 # disk. This value identifies the exact instant snapshot that was used to
1008 # create this persistent disk. For example, if you created the persistent
1009 # disk from an instant snapshot that was later deleted and recreated under
1010 # the same name, the source instant snapshot ID would identify the exact
1011 # version of the instant snapshot that was used.
1012 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
1013 # partial or full URL to the resource. For example, the following are valid
1014 # values:
1015 #
1016 #
1017 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
1018 # - projects/project/global/machineImages/machineImage
1019 # - global/machineImages/machineImage
1020 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
1021 # source_machine_image must be specified.
1022 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
1023 # encryption key of the source machine image. Required if the source
1024 # machine image is protected by a customer-supplied encryption key.
1025 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1026 # For example:
1027 #
1028 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1029 # key_region/cryptoKeys/key
1030 #
1031 # The fully-qualifed key name may be returned for resource GET requests. For
1032 # example:
1033 #
1034 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1035 # key_region/cryptoKeys/key
1036 # /cryptoKeyVersions/1
1037 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1038 # key. If absent, the Compute Engine default service account is used.
1039 # For example:
1040 #
1041 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1042 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1043 # encryption key, encoded in RFC
1044 # 4648 base64 to either encrypt or decrypt this resource. You can
1045 # provide either the rawKey or thersaEncryptedKey.
1046 # For example:
1047 #
1048 # &quot;rawKey&quot;:
1049 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1050 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1051 # customer-supplied encryption key to either encrypt or decrypt this
1052 # resource. You can provide either the rawKey or thersaEncryptedKey.
1053 # For example:
1054 #
1055 # &quot;rsaEncryptedKey&quot;:
1056 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1057 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1058 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1059 #
1060 # The key must meet the following requirements before you can provide it to
1061 # Compute Engine:
1062 #
1063 # 1. The key is wrapped using a RSA public key certificate provided by
1064 # Google.
1065 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1066 # encoding.
1067 #
1068 # Gets the RSA public key certificate provided by Google at:
1069 #
1070 #
1071 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1072 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1073 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1074 # encryption key that protects this resource.
1075 },
1076 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
1077 # This value identifies the exact machine image that was used to create this
1078 # persistent disk. For example, if you created the persistent disk from a
1079 # machine image that was later deleted and recreated under the same name, the
1080 # source machine image ID would identify the exact version of the machine
1081 # image that was used.
1082 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
1083 # partial or full URL to the resource. For example, the following are valid
1084 # values:
1085 #
1086 #
1087 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
1088 # - projects/project/global/snapshots/snapshot
1089 # - global/snapshots/snapshot
1090 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
1091 # encryption key of the source snapshot. Required if the source snapshot
1092 # is protected by a customer-supplied encryption key.
1093 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1094 # For example:
1095 #
1096 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1097 # key_region/cryptoKeys/key
1098 #
1099 # The fully-qualifed key name may be returned for resource GET requests. For
1100 # example:
1101 #
1102 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1103 # key_region/cryptoKeys/key
1104 # /cryptoKeyVersions/1
1105 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1106 # key. If absent, the Compute Engine default service account is used.
1107 # For example:
1108 #
1109 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1110 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1111 # encryption key, encoded in RFC
1112 # 4648 base64 to either encrypt or decrypt this resource. You can
1113 # provide either the rawKey or thersaEncryptedKey.
1114 # For example:
1115 #
1116 # &quot;rawKey&quot;:
1117 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1118 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1119 # customer-supplied encryption key to either encrypt or decrypt this
1120 # resource. You can provide either the rawKey or thersaEncryptedKey.
1121 # For example:
1122 #
1123 # &quot;rsaEncryptedKey&quot;:
1124 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1125 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1126 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1127 #
1128 # The key must meet the following requirements before you can provide it to
1129 # Compute Engine:
1130 #
1131 # 1. The key is wrapped using a RSA public key certificate provided by
1132 # Google.
1133 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1134 # encoding.
1135 #
1136 # Gets the RSA public key certificate provided by Google at:
1137 #
1138 #
1139 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1140 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1141 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1142 # encryption key that protects this resource.
1143 },
1144 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
1145 # value identifies the exact snapshot that was used to create this persistent
1146 # disk. For example, if you created the persistent disk from a snapshot that
1147 # was later deleted and recreated under the same name, the source snapshot ID
1148 # would identify the exact version of the snapshot that was used.
1149 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
1150 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
1151 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
1152 # https://storage.googleapis.com/. This flag is not optimized for creating
1153 # multiple disks from a source storage object. To create many disks from a
1154 # source storage object, use gcloud compute images
1155 # import instead.
1156 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
1157 #
1158 #
1159 # - CREATING: Disk is provisioning.
1160 # - RESTORING: Source data is being copied into the
1161 # disk.
1162 # - FAILED: Disk creation failed.
1163 # - READY: Disk is ready for use.
1164 # - DELETING: Disk is deleting.
1165 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
1166 # this as a partial or full URL to the resource. For example, the following
1167 # are valid values:
1168 #
1169 #
1170 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
1171 # - projects/project/zones/zone/storagePools/storagePool
1172 # - zones/zone/storagePools/storagePool
1173 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
1174 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
1175 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
1176 # types.
1177 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
1178 # in form:projects/project/zones/zone/instances/instance
1179 &quot;A String&quot;,
1180 ],
1181 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
1182 # You must specify this field as part of the HTTP request URL. It is
1183 # not settable as a field in the request body.
1184 },
1185 ],
1186 &quot;warning&quot;: { # [Output Only] Informational warning which replaces the list of disks when
1187 # the list is empty.
1188 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1189 # Engine returns NO_RESULTS_ON_PAGE if there
1190 # are no results in the response.
1191 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1192 # value format. For example:
1193 #
1194 # &quot;data&quot;: [
1195 # {
1196 # &quot;key&quot;: &quot;scope&quot;,
1197 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1198 # }
1199 {
1200 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1201 # returned. For example, for warnings where there are no results in a list
1202 # request for a particular zone, this key might be scope and
1203 # the key value might be the zone name. Other examples might be a key
1204 # indicating a deprecated resource and a suggested replacement, or a
1205 # warning about invalid network settings (for example, if an instance
1206 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1207 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1208 },
1209 ],
1210 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1211 },
1212 },
1213 },
1214 &quot;kind&quot;: &quot;compute#diskAggregatedList&quot;, # Output only. [Output Only] Type of resource. Alwayscompute#diskAggregatedList for aggregated lists of persistent
1215 # disks.
1216 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
1217 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
1218 # the query parameter pageToken in the next list request.
1219 # Subsequent list requests will have their own nextPageToken to
1220 # continue paging through the results.
1221 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
1222 &quot;unreachables&quot;: [ # Output only. [Output Only] Unreachable resources.
1223 &quot;A String&quot;,
1224 ],
1225 &quot;warning&quot;: { # [Output Only] Informational warning message.
1226 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1227 # Engine returns NO_RESULTS_ON_PAGE if there
1228 # are no results in the response.
1229 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1230 # value format. For example:
1231 #
1232 # &quot;data&quot;: [
1233 # {
1234 # &quot;key&quot;: &quot;scope&quot;,
1235 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1236 # }
1237 {
1238 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1239 # returned. For example, for warnings where there are no results in a list
1240 # request for a particular zone, this key might be scope and
1241 # the key value might be the zone name. Other examples might be a key
1242 # indicating a deprecated resource and a suggested replacement, or a
1243 # warning about invalid network settings (for example, if an instance
1244 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1245 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1246 },
1247 ],
1248 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1249 },
1250 }</pre>
1251 </div>
1252
1253 <div class="method">
1254 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
1255 <pre>Retrieves the next page of results.
1256
1257 Args:
1258 previous_request: The request for the previous page. (required)
1259 previous_response: The response from the request for the previous page. (required)
1260
1261 Returns:
1262 A request object that you can call &#x27;execute()&#x27; on to request the next
1263 page. Returns None if there are no more items in the collection.
1264 </pre>
1265 </div>
1266
1267 <div class="method">
1268 <code class="details" id="bulkInsert">bulkInsert(project, zone, body=None, requestId=None, x__xgafv=None)</code>
1269 <pre>Bulk create a set of disks.
1270
1271 Args:
1272 project: string, Project ID for this request. (required)
1273 zone: string, The name of the zone for this request. (required)
1274 body: object, The request body.
1275 The object takes the form of:
1276
1277 { # A transient resource used in compute.disks.bulkInsert and
1278 # compute.regionDisks.bulkInsert. It is only used to process
1279 # requests and is not persisted.
1280 &quot;instantSnapshotGroupParameters&quot;: { # The parameters for the instant snapshot group.
1281 &quot;sourceInstantSnapshotGroup&quot;: &quot;A String&quot;, # The source instant snapshot group used to create disks. You can provide
1282 # this as a partial or full URL to the resource. For example, the following
1283 # are valid values:
1284 #
1285 #
1286 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup
1287 # - projects/project/zones/zone/instantSnapshotGroups/instantSnapshotGroup
1288 # - zones/zone/instantSnapshotGroups/instantSnapshotGroup
1289 },
1290 &quot;snapshotGroupParameters&quot;: { # The parameters for the snapshot group. The usage of snapshot group feature
1291 # is restricted.
1292 &quot;replicaZones&quot;: [ # URLs of the zones where disks should be replicated to. Only applicable
1293 # for regional resources.
1294 &quot;A String&quot;,
1295 ],
1296 &quot;sourceSnapshotGroup&quot;: &quot;A String&quot;, # The source snapshot group used to create disks. You can provide this as a
1297 # partial or full URL to the resource. For example, the following are valid
1298 # values:
1299 #
1300 #
1301 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshotGroups/snapshotGroup
1302 # - projects/project/global/snapshotGroups/snapshotGroup
1303 # - global/snapshotGroups/snapshotGroup
1304 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
1305 # disks. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
1306 # types.
1307 },
1308 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # The URL of the DiskConsistencyGroupPolicy for the group of disks to clone.
1309 # This may be a full or partial URL, such as:
1310 #
1311 #
1312 # -
1313 # https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
1314 #
1315 # -
1316 # projects/project/regions/region/resourcePolicies/resourcePolicy
1317 #
1318 # -
1319 # regions/region/resourcePolicies/resourcePolicy
1320 }
1321
1322 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1323 that if you must retry your request, the server will know to ignore the
1324 request if it has already been completed.
1325
1326 For example, consider a situation where you make an initial request and
1327 the request times out. If you make the request again with the same
1328 request ID, the server can check if original operation with the same
1329 request ID was received, and if so, will ignore the second request. This
1330 prevents clients from accidentally creating duplicate commitments.
1331
1332 The request ID must be
1333 a valid UUID with the exception that zero UUID is not supported
1334 (00000000-0000-0000-0000-000000000000).
1335 x__xgafv: string, V1 error format.
1336 Allowed values
1337 1 - v1 error format
1338 2 - v2 error format
1339
1340 Returns:
1341 An object of the form:
1342
1343 { # Represents an Operation resource.
1344 #
1345 # Google Compute Engine has three Operation resources:
1346 #
1347 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1348 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1349 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1350 #
1351 # You can use an operation resource to manage asynchronous API requests.
1352 # For more information, readHandling
1353 # API responses.
1354 #
1355 # Operations can be global, regional or zonal.
1356 #
1357 # - For global operations, use the `globalOperations`
1358 # resource.
1359 # - For regional operations, use the
1360 # `regionOperations` resource.
1361 # - For zonal operations, use
1362 # the `zoneOperations` resource.
1363 #
1364 #
1365 #
1366 # For more information, read
1367 # Global, Regional, and Zonal Resources.
1368 #
1369 # Note that completed Operation resources have a limited
1370 # retention period.
1371 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1372 # Not present otherwise.
1373 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1374 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1375 # set when the operation is created.
1376 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1377 # text format.
1378 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1379 # this field will be populated.
1380 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1381 # operation.
1382 {
1383 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1384 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1385 # details. There is a set of defined message types to use for providing
1386 # details.The syntax depends on the error code. For example,
1387 # QuotaExceededInfo will have details when the error code is
1388 # QUOTA_EXCEEDED.
1389 {
1390 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1391 #
1392 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1393 # is not enabled:
1394 #
1395 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1396 # &quot;domain&quot;: &quot;googleapis.com&quot;
1397 # &quot;metadata&quot;: {
1398 # &quot;resource&quot;: &quot;projects/123&quot;,
1399 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1400 # }
1401 # }
1402 #
1403 # This response indicates that the pubsub.googleapis.com API is not enabled.
1404 #
1405 # Example of an error that is returned when attempting to create a Spanner
1406 # instance in a region that is out of stock:
1407 #
1408 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1409 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1410 # &quot;metadata&quot;: {
1411 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1412 # }
1413 # }
1414 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1415 # is typically the registered service name of the tool or product that
1416 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1417 # generated by some common infrastructure, the error domain must be a
1418 # globally unique value that identifies the infrastructure. For Google API
1419 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1420 &quot;metadatas&quot;: { # Additional structured details about this error.
1421 #
1422 # Keys must match a regular expression of `a-z+` but should
1423 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1424 # length. When identifying the current value of an exceeded limit, the units
1425 # should be contained in the key, not the value. For example, rather than
1426 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1427 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1428 # instances that can be created in a single (batch) request.
1429 &quot;a_key&quot;: &quot;A String&quot;,
1430 },
1431 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1432 # proximate cause of the error. Error reasons are unique within a particular
1433 # domain of errors. This should be at most 63 characters and match a
1434 # regular expression of `A-Z+[A-Z0-9]`, which represents
1435 # UPPER_SNAKE_CASE.
1436 },
1437 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1438 #
1439 # For example, if a quota check failed with an error indicating the calling
1440 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1441 # directly to the right place in the developer console to flip the bit.
1442 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1443 { # Describes a URL link.
1444 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1445 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1446 },
1447 ],
1448 },
1449 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1450 # which can be attached to an RPC error.
1451 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1452 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1453 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1454 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1455 },
1456 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1457 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1458 &quot;a_key&quot;: &quot;A String&quot;,
1459 },
1460 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1461 # type or metric.
1462 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1463 # or metric.
1464 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1465 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1466 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1467 },
1468 },
1469 ],
1470 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1471 # This property is optional.
1472 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1473 },
1474 ],
1475 },
1476 &quot;getVersionOperationMetadata&quot;: {
1477 &quot;inlineSbomInfo&quot;: {
1478 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1479 # appropriate identifiers.
1480 &quot;a_key&quot;: &quot;A String&quot;,
1481 },
1482 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1483 # identifiers.
1484 &quot;a_key&quot;: &quot;A String&quot;,
1485 },
1486 },
1487 },
1488 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1489 # message that was returned, such as `NOT FOUND`.
1490 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1491 # status code that was returned. For example, a `404` means the
1492 # resource was not found.
1493 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1494 # defined by the server.
1495 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1496 # This value is inRFC3339
1497 # text format.
1498 &quot;instancesBulkInsertOperationMetadata&quot;: {
1499 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1500 # Example key: zones/us-central1-a
1501 &quot;a_key&quot;: {
1502 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1503 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1504 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1505 # error.
1506 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1507 # if the flow is rolling forward or rolling back.
1508 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1509 },
1510 },
1511 },
1512 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1513 # Operation resources.
1514 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1515 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1516 # group of operations results from a `bulkInsert` API request.
1517 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1518 # `update`, or `delete`, and so on.
1519 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1520 # There is no requirement that this be linear or support any granularity of
1521 # operations. This should not be used to guess when the operation will be
1522 # complete. This number should monotonically increase as the operation
1523 # progresses.
1524 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1525 # applicable when performing regional operations.
1526 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1527 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1528 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1529 # this field will contain information on all underlying zonal actions and
1530 # their state.
1531 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1532 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1533 # Example key: zones/us-central1-a
1534 &quot;a_key&quot;: {
1535 &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
1536 # populated.
1537 # different programming environments, including REST APIs and RPC APIs. It is
1538 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1539 # three pieces of data: error code, error message, and error details.
1540 #
1541 # You can find out more about this error model and how to work with it in the
1542 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1543 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1544 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1545 # message types for APIs to use.
1546 {
1547 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1548 },
1549 ],
1550 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1551 # user-facing error message should be localized and sent in the
1552 # google.rpc.Status.details field, or localized by the client.
1553 },
1554 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1555 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1556 },
1557 },
1558 },
1559 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1560 # This value is inRFC3339
1561 # text format.
1562 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1563 # following:
1564 # `PENDING`, `RUNNING`, or `DONE`.
1565 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1566 # operation.
1567 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1568 # of the target resource.
1569 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1570 # operations related to creating a snapshot, this points to the disk
1571 # that the snapshot was created from.
1572 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1573 # `[email protected]` or
1574 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1575 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1576 # operation, this field will be populated.
1577 {
1578 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1579 # Engine returns NO_RESULTS_ON_PAGE if there
1580 # are no results in the response.
1581 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1582 # value format. For example:
1583 #
1584 # &quot;data&quot;: [
1585 # {
1586 # &quot;key&quot;: &quot;scope&quot;,
1587 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1588 # }
1589 {
1590 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1591 # returned. For example, for warnings where there are no results in a list
1592 # request for a particular zone, this key might be scope and
1593 # the key value might be the zone name. Other examples might be a key
1594 # indicating a deprecated resource and a suggested replacement, or a
1595 # warning about invalid network settings (for example, if an instance
1596 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1597 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1598 },
1599 ],
1600 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1601 },
1602 ],
1603 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1604 # applicable when performing per-zone operations.
1605 }</pre>
1606 </div>
1607
1608 <div class="method">
1609 <code class="details" id="bulkSetLabels">bulkSetLabels(project, zone, body=None, requestId=None, resource=None, x__xgafv=None)</code>
1610 <pre>Sets the labels on many disks at once. To learn more about labels, read theLabeling
1611 Resources documentation.
1612
1613 Args:
1614 project: string, Project ID for this request. (required)
1615 zone: string, The name of the zone for this request. (required)
1616 body: object, The request body.
1617 The object takes the form of:
1618
1619 {
1620 &quot;requests&quot;: [
1621 {
1622 &quot;labelFingerprint&quot;: &quot;A String&quot;, # The fingerprint of the previous set of labels for this resource,
1623 # used to detect conflicts. The fingerprint is initially generated by Compute
1624 # Engine and changes after every request to modify or update labels. You may
1625 # optionally provide an up-to-date fingerprint hash in order to update or
1626 # change labels. Make a get() request to the resource to get the
1627 # latest fingerprint.
1628 &quot;labels&quot;: { # The labels to set for this resource.
1629 &quot;a_key&quot;: &quot;A String&quot;,
1630 },
1631 },
1632 ],
1633 }
1634
1635 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1636 that if you must retry your request, the server will know to ignore the
1637 request if it has already been completed.
1638
1639 For example, consider a situation where you make an initial request and
1640 the request times out. If you make the request again with the same
1641 request ID, the server can check if original operation with the same
1642 request ID was received, and if so, will ignore the second request. This
1643 prevents clients from accidentally creating duplicate commitments.
1644
1645 The request ID must be
1646 a valid UUID with the exception that zero UUID is not supported
1647 (00000000-0000-0000-0000-000000000000).
1648 resource: string, Name or id of the resource for this request.
1649 x__xgafv: string, V1 error format.
1650 Allowed values
1651 1 - v1 error format
1652 2 - v2 error format
1653
1654 Returns:
1655 An object of the form:
1656
1657 { # Represents an Operation resource.
1658 #
1659 # Google Compute Engine has three Operation resources:
1660 #
1661 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1662 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1663 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1664 #
1665 # You can use an operation resource to manage asynchronous API requests.
1666 # For more information, readHandling
1667 # API responses.
1668 #
1669 # Operations can be global, regional or zonal.
1670 #
1671 # - For global operations, use the `globalOperations`
1672 # resource.
1673 # - For regional operations, use the
1674 # `regionOperations` resource.
1675 # - For zonal operations, use
1676 # the `zoneOperations` resource.
1677 #
1678 #
1679 #
1680 # For more information, read
1681 # Global, Regional, and Zonal Resources.
1682 #
1683 # Note that completed Operation resources have a limited
1684 # retention period.
1685 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1686 # Not present otherwise.
1687 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1688 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1689 # set when the operation is created.
1690 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1691 # text format.
1692 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1693 # this field will be populated.
1694 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1695 # operation.
1696 {
1697 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1698 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1699 # details. There is a set of defined message types to use for providing
1700 # details.The syntax depends on the error code. For example,
1701 # QuotaExceededInfo will have details when the error code is
1702 # QUOTA_EXCEEDED.
1703 {
1704 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1705 #
1706 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1707 # is not enabled:
1708 #
1709 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1710 # &quot;domain&quot;: &quot;googleapis.com&quot;
1711 # &quot;metadata&quot;: {
1712 # &quot;resource&quot;: &quot;projects/123&quot;,
1713 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1714 # }
1715 # }
1716 #
1717 # This response indicates that the pubsub.googleapis.com API is not enabled.
1718 #
1719 # Example of an error that is returned when attempting to create a Spanner
1720 # instance in a region that is out of stock:
1721 #
1722 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1723 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1724 # &quot;metadata&quot;: {
1725 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1726 # }
1727 # }
1728 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1729 # is typically the registered service name of the tool or product that
1730 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1731 # generated by some common infrastructure, the error domain must be a
1732 # globally unique value that identifies the infrastructure. For Google API
1733 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1734 &quot;metadatas&quot;: { # Additional structured details about this error.
1735 #
1736 # Keys must match a regular expression of `a-z+` but should
1737 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1738 # length. When identifying the current value of an exceeded limit, the units
1739 # should be contained in the key, not the value. For example, rather than
1740 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1741 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1742 # instances that can be created in a single (batch) request.
1743 &quot;a_key&quot;: &quot;A String&quot;,
1744 },
1745 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1746 # proximate cause of the error. Error reasons are unique within a particular
1747 # domain of errors. This should be at most 63 characters and match a
1748 # regular expression of `A-Z+[A-Z0-9]`, which represents
1749 # UPPER_SNAKE_CASE.
1750 },
1751 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1752 #
1753 # For example, if a quota check failed with an error indicating the calling
1754 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1755 # directly to the right place in the developer console to flip the bit.
1756 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1757 { # Describes a URL link.
1758 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1759 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1760 },
1761 ],
1762 },
1763 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1764 # which can be attached to an RPC error.
1765 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1766 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1767 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1768 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1769 },
1770 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1771 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1772 &quot;a_key&quot;: &quot;A String&quot;,
1773 },
1774 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1775 # type or metric.
1776 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1777 # or metric.
1778 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1779 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1780 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1781 },
1782 },
1783 ],
1784 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1785 # This property is optional.
1786 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1787 },
1788 ],
1789 },
1790 &quot;getVersionOperationMetadata&quot;: {
1791 &quot;inlineSbomInfo&quot;: {
1792 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1793 # appropriate identifiers.
1794 &quot;a_key&quot;: &quot;A String&quot;,
1795 },
1796 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1797 # identifiers.
1798 &quot;a_key&quot;: &quot;A String&quot;,
1799 },
1800 },
1801 },
1802 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1803 # message that was returned, such as `NOT FOUND`.
1804 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1805 # status code that was returned. For example, a `404` means the
1806 # resource was not found.
1807 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1808 # defined by the server.
1809 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1810 # This value is inRFC3339
1811 # text format.
1812 &quot;instancesBulkInsertOperationMetadata&quot;: {
1813 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1814 # Example key: zones/us-central1-a
1815 &quot;a_key&quot;: {
1816 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1817 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1818 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1819 # error.
1820 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1821 # if the flow is rolling forward or rolling back.
1822 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1823 },
1824 },
1825 },
1826 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1827 # Operation resources.
1828 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1829 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1830 # group of operations results from a `bulkInsert` API request.
1831 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1832 # `update`, or `delete`, and so on.
1833 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1834 # There is no requirement that this be linear or support any granularity of
1835 # operations. This should not be used to guess when the operation will be
1836 # complete. This number should monotonically increase as the operation
1837 # progresses.
1838 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1839 # applicable when performing regional operations.
1840 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1841 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1842 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1843 # this field will contain information on all underlying zonal actions and
1844 # their state.
1845 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1846 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1847 # Example key: zones/us-central1-a
1848 &quot;a_key&quot;: {
1849 &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
1850 # populated.
1851 # different programming environments, including REST APIs and RPC APIs. It is
1852 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1853 # three pieces of data: error code, error message, and error details.
1854 #
1855 # You can find out more about this error model and how to work with it in the
1856 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1857 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1858 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1859 # message types for APIs to use.
1860 {
1861 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1862 },
1863 ],
1864 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1865 # user-facing error message should be localized and sent in the
1866 # google.rpc.Status.details field, or localized by the client.
1867 },
1868 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1869 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1870 },
1871 },
1872 },
1873 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1874 # This value is inRFC3339
1875 # text format.
1876 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1877 # following:
1878 # `PENDING`, `RUNNING`, or `DONE`.
1879 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1880 # operation.
1881 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1882 # of the target resource.
1883 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1884 # operations related to creating a snapshot, this points to the disk
1885 # that the snapshot was created from.
1886 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1887 # `[email protected]` or
1888 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1889 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1890 # operation, this field will be populated.
1891 {
1892 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1893 # Engine returns NO_RESULTS_ON_PAGE if there
1894 # are no results in the response.
1895 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1896 # value format. For example:
1897 #
1898 # &quot;data&quot;: [
1899 # {
1900 # &quot;key&quot;: &quot;scope&quot;,
1901 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1902 # }
1903 {
1904 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1905 # returned. For example, for warnings where there are no results in a list
1906 # request for a particular zone, this key might be scope and
1907 # the key value might be the zone name. Other examples might be a key
1908 # indicating a deprecated resource and a suggested replacement, or a
1909 # warning about invalid network settings (for example, if an instance
1910 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1911 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1912 },
1913 ],
1914 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1915 },
1916 ],
1917 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1918 # applicable when performing per-zone operations.
1919 }</pre>
1920 </div>
1921
1922 <div class="method">
1923 <code class="details" id="close">close()</code>
1924 <pre>Close httplib2 connections.</pre>
1925 </div>
1926
1927 <div class="method">
1928 <code class="details" id="convert">convert(project, zone, disk, body=None, requestId=None, x__xgafv=None)</code>
1929 <pre>Converts a persistent disk to support Gen4+ VMs.
1930
1931 Args:
1932 project: string, Project ID for this request. (required)
1933 zone: string, The name of the zone for this request. (required)
1934 disk: string, Name of the Disk resource, should conform to RFC1035. (required)
1935 body: object, The request body.
1936 The object takes the form of:
1937
1938 {
1939 &quot;params&quot;: {
1940 &quot;forceStopInProgressSnapshot&quot;: True or False,
1941 &quot;provisionedIops&quot;: &quot;A String&quot;,
1942 &quot;provisionedThroughput&quot;: &quot;A String&quot;,
1943 &quot;quickConversionOnly&quot;: True or False,
1944 &quot;resetSupportedVmFamilies&quot;: True or False,
1945 &quot;targetDiskType&quot;: &quot;A String&quot;,
1946 },
1947 }
1948
1949 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1950 that if you must retry your request, the server will know to ignore the
1951 request if it has already been completed.
1952
1953 For example, consider a situation where you make an initial request and
1954 the request times out. If you make the request again with the same
1955 request ID, the server can check if original operation with the same
1956 request ID was received, and if so, will ignore the second request. This
1957 prevents clients from accidentally creating duplicate commitments.
1958
1959 The request ID must be
1960 a valid UUID with the exception that zero UUID is not supported
1961 (00000000-0000-0000-0000-000000000000).
1962 x__xgafv: string, V1 error format.
1963 Allowed values
1964 1 - v1 error format
1965 2 - v2 error format
1966
1967 Returns:
1968 An object of the form:
1969
1970 { # Represents an Operation resource.
1971 #
1972 # Google Compute Engine has three Operation resources:
1973 #
1974 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1975 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1976 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1977 #
1978 # You can use an operation resource to manage asynchronous API requests.
1979 # For more information, readHandling
1980 # API responses.
1981 #
1982 # Operations can be global, regional or zonal.
1983 #
1984 # - For global operations, use the `globalOperations`
1985 # resource.
1986 # - For regional operations, use the
1987 # `regionOperations` resource.
1988 # - For zonal operations, use
1989 # the `zoneOperations` resource.
1990 #
1991 #
1992 #
1993 # For more information, read
1994 # Global, Regional, and Zonal Resources.
1995 #
1996 # Note that completed Operation resources have a limited
1997 # retention period.
1998 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1999 # Not present otherwise.
2000 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2001 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2002 # set when the operation is created.
2003 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2004 # text format.
2005 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2006 # this field will be populated.
2007 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2008 # operation.
2009 {
2010 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2011 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2012 # details. There is a set of defined message types to use for providing
2013 # details.The syntax depends on the error code. For example,
2014 # QuotaExceededInfo will have details when the error code is
2015 # QUOTA_EXCEEDED.
2016 {
2017 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2018 #
2019 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2020 # is not enabled:
2021 #
2022 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2023 # &quot;domain&quot;: &quot;googleapis.com&quot;
2024 # &quot;metadata&quot;: {
2025 # &quot;resource&quot;: &quot;projects/123&quot;,
2026 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2027 # }
2028 # }
2029 #
2030 # This response indicates that the pubsub.googleapis.com API is not enabled.
2031 #
2032 # Example of an error that is returned when attempting to create a Spanner
2033 # instance in a region that is out of stock:
2034 #
2035 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2036 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2037 # &quot;metadata&quot;: {
2038 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2039 # }
2040 # }
2041 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2042 # is typically the registered service name of the tool or product that
2043 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2044 # generated by some common infrastructure, the error domain must be a
2045 # globally unique value that identifies the infrastructure. For Google API
2046 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2047 &quot;metadatas&quot;: { # Additional structured details about this error.
2048 #
2049 # Keys must match a regular expression of `a-z+` but should
2050 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2051 # length. When identifying the current value of an exceeded limit, the units
2052 # should be contained in the key, not the value. For example, rather than
2053 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2054 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2055 # instances that can be created in a single (batch) request.
2056 &quot;a_key&quot;: &quot;A String&quot;,
2057 },
2058 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2059 # proximate cause of the error. Error reasons are unique within a particular
2060 # domain of errors. This should be at most 63 characters and match a
2061 # regular expression of `A-Z+[A-Z0-9]`, which represents
2062 # UPPER_SNAKE_CASE.
2063 },
2064 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2065 #
2066 # For example, if a quota check failed with an error indicating the calling
2067 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2068 # directly to the right place in the developer console to flip the bit.
2069 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2070 { # Describes a URL link.
2071 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2072 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2073 },
2074 ],
2075 },
2076 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2077 # which can be attached to an RPC error.
2078 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2079 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2080 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2081 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2082 },
2083 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2084 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2085 &quot;a_key&quot;: &quot;A String&quot;,
2086 },
2087 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2088 # type or metric.
2089 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2090 # or metric.
2091 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2092 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2093 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2094 },
2095 },
2096 ],
2097 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2098 # This property is optional.
2099 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2100 },
2101 ],
2102 },
2103 &quot;getVersionOperationMetadata&quot;: {
2104 &quot;inlineSbomInfo&quot;: {
2105 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2106 # appropriate identifiers.
2107 &quot;a_key&quot;: &quot;A String&quot;,
2108 },
2109 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2110 # identifiers.
2111 &quot;a_key&quot;: &quot;A String&quot;,
2112 },
2113 },
2114 },
2115 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2116 # message that was returned, such as `NOT FOUND`.
2117 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2118 # status code that was returned. For example, a `404` means the
2119 # resource was not found.
2120 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2121 # defined by the server.
2122 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2123 # This value is inRFC3339
2124 # text format.
2125 &quot;instancesBulkInsertOperationMetadata&quot;: {
2126 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2127 # Example key: zones/us-central1-a
2128 &quot;a_key&quot;: {
2129 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2130 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2131 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2132 # error.
2133 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2134 # if the flow is rolling forward or rolling back.
2135 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2136 },
2137 },
2138 },
2139 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2140 # Operation resources.
2141 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2142 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2143 # group of operations results from a `bulkInsert` API request.
2144 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2145 # `update`, or `delete`, and so on.
2146 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2147 # There is no requirement that this be linear or support any granularity of
2148 # operations. This should not be used to guess when the operation will be
2149 # complete. This number should monotonically increase as the operation
2150 # progresses.
2151 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2152 # applicable when performing regional operations.
2153 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2154 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
2155 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2156 # this field will contain information on all underlying zonal actions and
2157 # their state.
2158 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2159 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2160 # Example key: zones/us-central1-a
2161 &quot;a_key&quot;: {
2162 &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
2163 # populated.
2164 # different programming environments, including REST APIs and RPC APIs. It is
2165 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2166 # three pieces of data: error code, error message, and error details.
2167 #
2168 # You can find out more about this error model and how to work with it in the
2169 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2170 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2171 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2172 # message types for APIs to use.
2173 {
2174 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2175 },
2176 ],
2177 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2178 # user-facing error message should be localized and sent in the
2179 # google.rpc.Status.details field, or localized by the client.
2180 },
2181 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2182 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2183 },
2184 },
2185 },
2186 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2187 # This value is inRFC3339
2188 # text format.
2189 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2190 # following:
2191 # `PENDING`, `RUNNING`, or `DONE`.
2192 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2193 # operation.
2194 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2195 # of the target resource.
2196 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2197 # operations related to creating a snapshot, this points to the disk
2198 # that the snapshot was created from.
2199 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2200 # `[email protected]` or
2201 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2202 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2203 # operation, this field will be populated.
2204 {
2205 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2206 # Engine returns NO_RESULTS_ON_PAGE if there
2207 # are no results in the response.
2208 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2209 # value format. For example:
2210 #
2211 # &quot;data&quot;: [
2212 # {
2213 # &quot;key&quot;: &quot;scope&quot;,
2214 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2215 # }
2216 {
2217 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2218 # returned. For example, for warnings where there are no results in a list
2219 # request for a particular zone, this key might be scope and
2220 # the key value might be the zone name. Other examples might be a key
2221 # indicating a deprecated resource and a suggested replacement, or a
2222 # warning about invalid network settings (for example, if an instance
2223 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2224 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2225 },
2226 ],
2227 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2228 },
2229 ],
2230 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2231 # applicable when performing per-zone operations.
2232 }</pre>
2233 </div>
2234
2235 <div class="method">
2236 <code class="details" id="createSnapshot">createSnapshot(project, zone, disk, body=None, guestFlush=None, requestId=None, x__xgafv=None)</code>
2237 <pre>Creates a snapshot of a specified persistent disk. For regular snapshot
2238 creation, consider using snapshots.insert
2239 instead, as that method supports more features, such as creating snapshots
2240 in a project different from the source disk project.
2241
2242 Args:
2243 project: string, Project ID for this request. (required)
2244 zone: string, The name of the zone for this request. (required)
2245 disk: string, Name of the persistent disk to snapshot. (required)
2246 body: object, The request body.
2247 The object takes the form of:
2248
2249 { # Represents a Persistent Disk Snapshot resource.
2250 #
2251 # You can use snapshots to back up data on a regular interval. For more
2252 # information, read Creating
2253 # persistent disk snapshots.
2254 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the snapshot. Valid values are
2255 # ARM64 or X86_64.
2256 &quot;autoCreated&quot;: True or False, # Output only. [Output Only] Set to true if snapshots are automatically created by
2257 # applying resource policy on the target disk.
2258 &quot;chainName&quot;: &quot;A String&quot;, # Creates the new snapshot in the snapshot chain labeled with the
2259 # specified name. The chain name must be 1-63 characters long and comply
2260 # with RFC1035. This is an uncommon option only for advanced service
2261 # owners who needs to create separate snapshot chains, for example,
2262 # for chargeback tracking. When you describe your snapshot resource, this
2263 # field is visible only if it has a non-empty value.
2264 &quot;creationSizeBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Size in bytes of the snapshot at creation time.
2265 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
2266 # text format.
2267 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
2268 # create the resource.
2269 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Output only. [Output Only] Size of the source disk, specified in GB.
2270 &quot;downloadBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Number of bytes downloaded to restore a snapshot to a disk.
2271 &quot;enableConfidentialCompute&quot;: True or False, # Output only. Whether this snapshot is created from a confidential compute mode disk.
2272 # [Output Only]: This field is not set by user, but from source disk.
2273 &quot;guestFlush&quot;: True or False, # [Input Only] Whether to attempt an application consistent snapshot by
2274 # informing the OS to prepare for the snapshot process.
2275 &quot;guestOsFeatures&quot;: [ # Output only. [Output Only] A list of features to enable on the guest operating system.
2276 # Applicable only for bootable images. Read
2277 # Enabling guest operating system features to see a list of available
2278 # options.
2279 { # Guest OS features.
2280 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2281 # separate values. Set to one or more of the following values:
2282 #
2283 # - VIRTIO_SCSI_MULTIQUEUE
2284 # - WINDOWS
2285 # - MULTI_IP_SUBNET
2286 # - UEFI_COMPATIBLE
2287 # - GVNIC
2288 # - SEV_CAPABLE
2289 # - SUSPEND_RESUME_COMPATIBLE
2290 # - SEV_LIVE_MIGRATABLE_V2
2291 # - SEV_SNP_CAPABLE
2292 # - TDX_CAPABLE
2293 # - IDPF
2294 # - SNP_SVSM_CAPABLE
2295 # - CCA_CAPABLE
2296 #
2297 #
2298 # For more information, see
2299 # Enabling guest operating system features.
2300 },
2301 ],
2302 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
2303 # defined by the server.
2304 &quot;kind&quot;: &quot;compute#snapshot&quot;, # Output only. [Output Only] Type of the resource. Always compute#snapshot
2305 # for Snapshot resources.
2306 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this snapshot, which is
2307 # essentially a hash of the labels set used for optimistic locking. The
2308 # fingerprint is initially generated by Compute Engine and changes after
2309 # every request to modify or update labels. You must always provide an
2310 # up-to-date fingerprint hash in order to update or change labels,
2311 # otherwise the request will fail with error412 conditionNotMet.
2312 #
2313 # To see the latest fingerprint, make a get() request to
2314 # retrieve a snapshot.
2315 &quot;labels&quot;: { # Labels to apply to this snapshot. These can be later modified by
2316 # the setLabels method.
2317 # Label values may be empty.
2318 &quot;a_key&quot;: &quot;A String&quot;,
2319 },
2320 &quot;licenseCodes&quot;: [ # Output only. [Output Only] Integer license codes indicating which licenses are attached
2321 # to this snapshot.
2322 &quot;A String&quot;,
2323 ],
2324 &quot;licenses&quot;: [ # Output only. [Output Only] A list of public visible licenses that apply to this
2325 # snapshot. This can be because the original image had licenses attached
2326 # (such as a Windows image).
2327 &quot;A String&quot;,
2328 ],
2329 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the snapshot close to other
2330 # resources.
2331 # This field is for use by internal tools that use the public API.
2332 &quot;maxRetentionDays&quot;: 42, # Number of days the snapshot should be retained before being deleted
2333 # automatically.
2334 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
2335 # The name must be 1-63 characters long, and comply withRFC1035.
2336 # Specifically, the name must be 1-63 characters long and match the regular
2337 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
2338 # character must be a lowercase letter, and all following characters must be
2339 # a dash, lowercase letter, or digit, except the last character, which cannot
2340 # be a dash.
2341 &quot;params&quot;: { # Additional snapshot params. # Input only. [Input Only] Additional params passed with the request, but not persisted
2342 # as part of resource payload.
2343 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the snapshot. Tag keys and values have
2344 # the same definition as resource
2345 # manager tags. Keys and values can be either in numeric format,
2346 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
2347 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
2348 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
2349 # PATCH) when empty.
2350 &quot;a_key&quot;: &quot;A String&quot;,
2351 },
2352 },
2353 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the snapshot resides. Only applicable
2354 # for regional snapshots.
2355 &quot;resourceStatus&quot;: { # Output only. [Output only] ResourceStatus of the Snapshot resource
2356 &quot;scheduledDeletionTime&quot;: &quot;A String&quot;, # Output only. [Output only] Scheduled deletion time of the snapshot. The snapshot will
2357 # be deleted by the at any point within one hour after the deletion time.
2358 },
2359 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
2360 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
2361 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for the resource.
2362 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
2363 &quot;snapshotEncryptionKey&quot;: { # Encrypts the snapshot using acustomer-supplied
2364 # encryption key.
2365 #
2366 # After you encrypt a snapshot using a customer-supplied key, you must
2367 # provide the same key if you use the snapshot later. For example, you must
2368 # provide the encryption key when you create a disk from the encrypted
2369 # snapshot in a future request.
2370 #
2371 # Customer-supplied encryption keys do not protect access to metadata
2372 # of the snapshot.
2373 #
2374 # If you do not provide an encryption key when creating the snapshot, then
2375 # the snapshot will be encrypted using an automatically generated key and you
2376 # do not need to provide a key to use the snapshot later.
2377 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2378 # For example:
2379 #
2380 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2381 # key_region/cryptoKeys/key
2382 #
2383 # The fully-qualifed key name may be returned for resource GET requests. For
2384 # example:
2385 #
2386 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2387 # key_region/cryptoKeys/key
2388 # /cryptoKeyVersions/1
2389 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2390 # key. If absent, the Compute Engine default service account is used.
2391 # For example:
2392 #
2393 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2394 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2395 # encryption key, encoded in RFC
2396 # 4648 base64 to either encrypt or decrypt this resource. You can
2397 # provide either the rawKey or thersaEncryptedKey.
2398 # For example:
2399 #
2400 # &quot;rawKey&quot;:
2401 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2402 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2403 # customer-supplied encryption key to either encrypt or decrypt this
2404 # resource. You can provide either the rawKey or thersaEncryptedKey.
2405 # For example:
2406 #
2407 # &quot;rsaEncryptedKey&quot;:
2408 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2409 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2410 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2411 #
2412 # The key must meet the following requirements before you can provide it to
2413 # Compute Engine:
2414 #
2415 # 1. The key is wrapped using a RSA public key certificate provided by
2416 # Google.
2417 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2418 # encoding.
2419 #
2420 # Gets the RSA public key certificate provided by Google at:
2421 #
2422 #
2423 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2424 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2425 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2426 # encryption key that protects this resource.
2427 },
2428 &quot;snapshotGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot group that this snapshot
2429 # belongs to. The usage of snapshot group feature is restricted.
2430 &quot;snapshotGroupName&quot;: &quot;A String&quot;, # Output only. [Output only] The snapshot group that this snapshot belongs to. The usage
2431 # of snapshot group feature is restricted.
2432 &quot;snapshotType&quot;: &quot;A String&quot;, # Indicates the type of the snapshot.
2433 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this snapshot.
2434 &quot;sourceDiskEncryptionKey&quot;: { # The customer-supplied
2435 # encryption key of the source disk. Required if the source disk is
2436 # protected by a customer-supplied encryption key.
2437 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2438 # For example:
2439 #
2440 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2441 # key_region/cryptoKeys/key
2442 #
2443 # The fully-qualifed key name may be returned for resource GET requests. For
2444 # example:
2445 #
2446 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2447 # key_region/cryptoKeys/key
2448 # /cryptoKeyVersions/1
2449 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2450 # key. If absent, the Compute Engine default service account is used.
2451 # For example:
2452 #
2453 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2454 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2455 # encryption key, encoded in RFC
2456 # 4648 base64 to either encrypt or decrypt this resource. You can
2457 # provide either the rawKey or thersaEncryptedKey.
2458 # For example:
2459 #
2460 # &quot;rawKey&quot;:
2461 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2462 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2463 # customer-supplied encryption key to either encrypt or decrypt this
2464 # resource. You can provide either the rawKey or thersaEncryptedKey.
2465 # For example:
2466 #
2467 # &quot;rsaEncryptedKey&quot;:
2468 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2469 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2470 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2471 #
2472 # The key must meet the following requirements before you can provide it to
2473 # Compute Engine:
2474 #
2475 # 1. The key is wrapped using a RSA public key certificate provided by
2476 # Google.
2477 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2478 # encoding.
2479 #
2480 # Gets the RSA public key certificate provided by Google at:
2481 #
2482 #
2483 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2484 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2485 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2486 # encryption key that protects this resource.
2487 },
2488 &quot;sourceDiskForRecoveryCheckpoint&quot;: &quot;A String&quot;, # The source disk whose recovery checkpoint will be used to create this
2489 # snapshot.
2490 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the disk used to create this snapshot. This
2491 # value may be used to determine whether the snapshot was taken from the
2492 # current or a previous instance of a given disk name.
2493 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this snapshot. You can provide
2494 # this as a partial or full URL to the resource. For example, the following
2495 # are valid values:
2496 #
2497 #
2498 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
2499 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
2500 # - zones/zone/instantSnapshots/instantSnapshot
2501 &quot;sourceInstantSnapshotEncryptionKey&quot;: { # Customer provided encryption key when creating Snapshot from Instant
2502 # Snapshot.
2503 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2504 # For example:
2505 #
2506 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2507 # key_region/cryptoKeys/key
2508 #
2509 # The fully-qualifed key name may be returned for resource GET requests. For
2510 # example:
2511 #
2512 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2513 # key_region/cryptoKeys/key
2514 # /cryptoKeyVersions/1
2515 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2516 # key. If absent, the Compute Engine default service account is used.
2517 # For example:
2518 #
2519 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2520 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2521 # encryption key, encoded in RFC
2522 # 4648 base64 to either encrypt or decrypt this resource. You can
2523 # provide either the rawKey or thersaEncryptedKey.
2524 # For example:
2525 #
2526 # &quot;rawKey&quot;:
2527 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2528 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2529 # customer-supplied encryption key to either encrypt or decrypt this
2530 # resource. You can provide either the rawKey or thersaEncryptedKey.
2531 # For example:
2532 #
2533 # &quot;rsaEncryptedKey&quot;:
2534 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2535 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2536 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2537 #
2538 # The key must meet the following requirements before you can provide it to
2539 # Compute Engine:
2540 #
2541 # 1. The key is wrapped using a RSA public key certificate provided by
2542 # Google.
2543 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2544 # encoding.
2545 #
2546 # Gets the RSA public key certificate provided by Google at:
2547 #
2548 #
2549 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2550 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2551 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2552 # encryption key that protects this resource.
2553 },
2554 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
2555 # snapshot. This value identifies the exact instant snapshot that was used to
2556 # create this snapshot. For example, if you created the snapshot from an
2557 # instant snapshot that was later deleted and recreated under the same name,
2558 # the source instant snapshot ID would identify the exact instant snapshot
2559 # that was used.
2560 &quot;sourceSnapshotSchedulePolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the resource policy which created this
2561 # scheduled snapshot.
2562 &quot;sourceSnapshotSchedulePolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the resource policy which created this
2563 # scheduled snapshot.
2564 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the snapshot. This can beCREATING, DELETING, FAILED,READY, or UPLOADING.
2565 &quot;storageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] A size of the storage used by the snapshot. As snapshots
2566 # share storage, this number is expected to change with snapshot
2567 # creation/deletion.
2568 &quot;storageBytesStatus&quot;: &quot;A String&quot;, # Output only. [Deprecated] Instead, check the storageBytes field. After
2569 # snapshot creation, the storageBytesStatus field is alwaysUP_TO_DATE.
2570 # [Output Only] An indicator whether storageBytes is in a
2571 # stable state or it is being adjusted as a result of shared storage
2572 # reallocation. This status can either be unset, meaning the snapshot is
2573 # being created, or UP_TO_DATE, meaning the size of the snapshot
2574 # is up-to-date.
2575 &quot;storageLocations&quot;: [ # Cloud Storage bucket storage location of the snapshot (regional or
2576 # multi-regional).
2577 &quot;A String&quot;,
2578 ],
2579 }
2580
2581 guestFlush: boolean, [Input Only] Whether to attempt an application consistent snapshot by
2582 informing the OS to prepare for the snapshot process.
2583 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2584 that if you must retry your request, the server will know to ignore the
2585 request if it has already been completed.
2586
2587 For example, consider a situation where you make an initial request and
2588 the request times out. If you make the request again with the same
2589 request ID, the server can check if original operation with the same
2590 request ID was received, and if so, will ignore the second request. This
2591 prevents clients from accidentally creating duplicate commitments.
2592
2593 The request ID must be
2594 a valid UUID with the exception that zero UUID is not supported
2595 (00000000-0000-0000-0000-000000000000).
2596 x__xgafv: string, V1 error format.
2597 Allowed values
2598 1 - v1 error format
2599 2 - v2 error format
2600
2601 Returns:
2602 An object of the form:
2603
2604 { # Represents an Operation resource.
2605 #
2606 # Google Compute Engine has three Operation resources:
2607 #
2608 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
2609 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
2610 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
2611 #
2612 # You can use an operation resource to manage asynchronous API requests.
2613 # For more information, readHandling
2614 # API responses.
2615 #
2616 # Operations can be global, regional or zonal.
2617 #
2618 # - For global operations, use the `globalOperations`
2619 # resource.
2620 # - For regional operations, use the
2621 # `regionOperations` resource.
2622 # - For zonal operations, use
2623 # the `zoneOperations` resource.
2624 #
2625 #
2626 #
2627 # For more information, read
2628 # Global, Regional, and Zonal Resources.
2629 #
2630 # Note that completed Operation resources have a limited
2631 # retention period.
2632 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2633 # Not present otherwise.
2634 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2635 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2636 # set when the operation is created.
2637 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2638 # text format.
2639 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2640 # this field will be populated.
2641 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2642 # operation.
2643 {
2644 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2645 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2646 # details. There is a set of defined message types to use for providing
2647 # details.The syntax depends on the error code. For example,
2648 # QuotaExceededInfo will have details when the error code is
2649 # QUOTA_EXCEEDED.
2650 {
2651 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2652 #
2653 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2654 # is not enabled:
2655 #
2656 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2657 # &quot;domain&quot;: &quot;googleapis.com&quot;
2658 # &quot;metadata&quot;: {
2659 # &quot;resource&quot;: &quot;projects/123&quot;,
2660 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2661 # }
2662 # }
2663 #
2664 # This response indicates that the pubsub.googleapis.com API is not enabled.
2665 #
2666 # Example of an error that is returned when attempting to create a Spanner
2667 # instance in a region that is out of stock:
2668 #
2669 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2670 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2671 # &quot;metadata&quot;: {
2672 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2673 # }
2674 # }
2675 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2676 # is typically the registered service name of the tool or product that
2677 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2678 # generated by some common infrastructure, the error domain must be a
2679 # globally unique value that identifies the infrastructure. For Google API
2680 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2681 &quot;metadatas&quot;: { # Additional structured details about this error.
2682 #
2683 # Keys must match a regular expression of `a-z+` but should
2684 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2685 # length. When identifying the current value of an exceeded limit, the units
2686 # should be contained in the key, not the value. For example, rather than
2687 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2688 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2689 # instances that can be created in a single (batch) request.
2690 &quot;a_key&quot;: &quot;A String&quot;,
2691 },
2692 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2693 # proximate cause of the error. Error reasons are unique within a particular
2694 # domain of errors. This should be at most 63 characters and match a
2695 # regular expression of `A-Z+[A-Z0-9]`, which represents
2696 # UPPER_SNAKE_CASE.
2697 },
2698 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2699 #
2700 # For example, if a quota check failed with an error indicating the calling
2701 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2702 # directly to the right place in the developer console to flip the bit.
2703 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2704 { # Describes a URL link.
2705 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2706 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2707 },
2708 ],
2709 },
2710 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2711 # which can be attached to an RPC error.
2712 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2713 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2714 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2715 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2716 },
2717 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2718 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2719 &quot;a_key&quot;: &quot;A String&quot;,
2720 },
2721 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2722 # type or metric.
2723 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2724 # or metric.
2725 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2726 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2727 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2728 },
2729 },
2730 ],
2731 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2732 # This property is optional.
2733 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2734 },
2735 ],
2736 },
2737 &quot;getVersionOperationMetadata&quot;: {
2738 &quot;inlineSbomInfo&quot;: {
2739 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2740 # appropriate identifiers.
2741 &quot;a_key&quot;: &quot;A String&quot;,
2742 },
2743 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2744 # identifiers.
2745 &quot;a_key&quot;: &quot;A String&quot;,
2746 },
2747 },
2748 },
2749 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2750 # message that was returned, such as `NOT FOUND`.
2751 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2752 # status code that was returned. For example, a `404` means the
2753 # resource was not found.
2754 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2755 # defined by the server.
2756 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2757 # This value is inRFC3339
2758 # text format.
2759 &quot;instancesBulkInsertOperationMetadata&quot;: {
2760 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2761 # Example key: zones/us-central1-a
2762 &quot;a_key&quot;: {
2763 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2764 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2765 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2766 # error.
2767 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2768 # if the flow is rolling forward or rolling back.
2769 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2770 },
2771 },
2772 },
2773 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2774 # Operation resources.
2775 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2776 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2777 # group of operations results from a `bulkInsert` API request.
2778 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2779 # `update`, or `delete`, and so on.
2780 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2781 # There is no requirement that this be linear or support any granularity of
2782 # operations. This should not be used to guess when the operation will be
2783 # complete. This number should monotonically increase as the operation
2784 # progresses.
2785 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2786 # applicable when performing regional operations.
2787 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2788 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
2789 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2790 # this field will contain information on all underlying zonal actions and
2791 # their state.
2792 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2793 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2794 # Example key: zones/us-central1-a
2795 &quot;a_key&quot;: {
2796 &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
2797 # populated.
2798 # different programming environments, including REST APIs and RPC APIs. It is
2799 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2800 # three pieces of data: error code, error message, and error details.
2801 #
2802 # You can find out more about this error model and how to work with it in the
2803 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2804 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2805 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2806 # message types for APIs to use.
2807 {
2808 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2809 },
2810 ],
2811 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2812 # user-facing error message should be localized and sent in the
2813 # google.rpc.Status.details field, or localized by the client.
2814 },
2815 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2816 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2817 },
2818 },
2819 },
2820 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2821 # This value is inRFC3339
2822 # text format.
2823 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2824 # following:
2825 # `PENDING`, `RUNNING`, or `DONE`.
2826 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2827 # operation.
2828 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2829 # of the target resource.
2830 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2831 # operations related to creating a snapshot, this points to the disk
2832 # that the snapshot was created from.
2833 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2834 # `[email protected]` or
2835 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2836 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2837 # operation, this field will be populated.
2838 {
2839 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2840 # Engine returns NO_RESULTS_ON_PAGE if there
2841 # are no results in the response.
2842 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2843 # value format. For example:
2844 #
2845 # &quot;data&quot;: [
2846 # {
2847 # &quot;key&quot;: &quot;scope&quot;,
2848 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2849 # }
2850 {
2851 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2852 # returned. For example, for warnings where there are no results in a list
2853 # request for a particular zone, this key might be scope and
2854 # the key value might be the zone name. Other examples might be a key
2855 # indicating a deprecated resource and a suggested replacement, or a
2856 # warning about invalid network settings (for example, if an instance
2857 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2858 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2859 },
2860 ],
2861 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2862 },
2863 ],
2864 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2865 # applicable when performing per-zone operations.
2866 }</pre>
2867 </div>
2868
2869 <div class="method">
2870 <code class="details" id="delete">delete(project, zone, disk, requestId=None, x__xgafv=None)</code>
2871 <pre>Deletes the specified persistent disk. Deleting a disk removes its data
2872 permanently and is irreversible. However, deleting a disk does not
2873 delete any snapshots
2874 previously made from the disk. You must separatelydelete
2875 snapshots.
2876
2877 Args:
2878 project: string, Project ID for this request. (required)
2879 zone: string, The name of the zone for this request. (required)
2880 disk: string, Name of the persistent disk to delete. (required)
2881 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2882 that if you must retry your request, the server will know to ignore the
2883 request if it has already been completed.
2884
2885 For example, consider a situation where you make an initial request and
2886 the request times out. If you make the request again with the same
2887 request ID, the server can check if original operation with the same
2888 request ID was received, and if so, will ignore the second request. This
2889 prevents clients from accidentally creating duplicate commitments.
2890
2891 The request ID must be
2892 a valid UUID with the exception that zero UUID is not supported
2893 (00000000-0000-0000-0000-000000000000).
2894 x__xgafv: string, V1 error format.
2895 Allowed values
2896 1 - v1 error format
2897 2 - v2 error format
2898
2899 Returns:
2900 An object of the form:
2901
2902 { # Represents an Operation resource.
2903 #
2904 # Google Compute Engine has three Operation resources:
2905 #
2906 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
2907 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
2908 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
2909 #
2910 # You can use an operation resource to manage asynchronous API requests.
2911 # For more information, readHandling
2912 # API responses.
2913 #
2914 # Operations can be global, regional or zonal.
2915 #
2916 # - For global operations, use the `globalOperations`
2917 # resource.
2918 # - For regional operations, use the
2919 # `regionOperations` resource.
2920 # - For zonal operations, use
2921 # the `zoneOperations` resource.
2922 #
2923 #
2924 #
2925 # For more information, read
2926 # Global, Regional, and Zonal Resources.
2927 #
2928 # Note that completed Operation resources have a limited
2929 # retention period.
2930 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2931 # Not present otherwise.
2932 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2933 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2934 # set when the operation is created.
2935 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2936 # text format.
2937 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2938 # this field will be populated.
2939 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2940 # operation.
2941 {
2942 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2943 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2944 # details. There is a set of defined message types to use for providing
2945 # details.The syntax depends on the error code. For example,
2946 # QuotaExceededInfo will have details when the error code is
2947 # QUOTA_EXCEEDED.
2948 {
2949 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2950 #
2951 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2952 # is not enabled:
2953 #
2954 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2955 # &quot;domain&quot;: &quot;googleapis.com&quot;
2956 # &quot;metadata&quot;: {
2957 # &quot;resource&quot;: &quot;projects/123&quot;,
2958 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2959 # }
2960 # }
2961 #
2962 # This response indicates that the pubsub.googleapis.com API is not enabled.
2963 #
2964 # Example of an error that is returned when attempting to create a Spanner
2965 # instance in a region that is out of stock:
2966 #
2967 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2968 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2969 # &quot;metadata&quot;: {
2970 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2971 # }
2972 # }
2973 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2974 # is typically the registered service name of the tool or product that
2975 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2976 # generated by some common infrastructure, the error domain must be a
2977 # globally unique value that identifies the infrastructure. For Google API
2978 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2979 &quot;metadatas&quot;: { # Additional structured details about this error.
2980 #
2981 # Keys must match a regular expression of `a-z+` but should
2982 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2983 # length. When identifying the current value of an exceeded limit, the units
2984 # should be contained in the key, not the value. For example, rather than
2985 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2986 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2987 # instances that can be created in a single (batch) request.
2988 &quot;a_key&quot;: &quot;A String&quot;,
2989 },
2990 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2991 # proximate cause of the error. Error reasons are unique within a particular
2992 # domain of errors. This should be at most 63 characters and match a
2993 # regular expression of `A-Z+[A-Z0-9]`, which represents
2994 # UPPER_SNAKE_CASE.
2995 },
2996 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2997 #
2998 # For example, if a quota check failed with an error indicating the calling
2999 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3000 # directly to the right place in the developer console to flip the bit.
3001 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3002 { # Describes a URL link.
3003 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3004 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3005 },
3006 ],
3007 },
3008 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3009 # which can be attached to an RPC error.
3010 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3011 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3012 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3013 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3014 },
3015 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3016 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3017 &quot;a_key&quot;: &quot;A String&quot;,
3018 },
3019 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3020 # type or metric.
3021 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3022 # or metric.
3023 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3024 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3025 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3026 },
3027 },
3028 ],
3029 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3030 # This property is optional.
3031 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3032 },
3033 ],
3034 },
3035 &quot;getVersionOperationMetadata&quot;: {
3036 &quot;inlineSbomInfo&quot;: {
3037 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3038 # appropriate identifiers.
3039 &quot;a_key&quot;: &quot;A String&quot;,
3040 },
3041 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3042 # identifiers.
3043 &quot;a_key&quot;: &quot;A String&quot;,
3044 },
3045 },
3046 },
3047 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3048 # message that was returned, such as `NOT FOUND`.
3049 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3050 # status code that was returned. For example, a `404` means the
3051 # resource was not found.
3052 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3053 # defined by the server.
3054 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3055 # This value is inRFC3339
3056 # text format.
3057 &quot;instancesBulkInsertOperationMetadata&quot;: {
3058 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3059 # Example key: zones/us-central1-a
3060 &quot;a_key&quot;: {
3061 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3062 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3063 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3064 # error.
3065 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3066 # if the flow is rolling forward or rolling back.
3067 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3068 },
3069 },
3070 },
3071 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3072 # Operation resources.
3073 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3074 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3075 # group of operations results from a `bulkInsert` API request.
3076 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3077 # `update`, or `delete`, and so on.
3078 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3079 # There is no requirement that this be linear or support any granularity of
3080 # operations. This should not be used to guess when the operation will be
3081 # complete. This number should monotonically increase as the operation
3082 # progresses.
3083 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3084 # applicable when performing regional operations.
3085 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3086 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
3087 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3088 # this field will contain information on all underlying zonal actions and
3089 # their state.
3090 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3091 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3092 # Example key: zones/us-central1-a
3093 &quot;a_key&quot;: {
3094 &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
3095 # populated.
3096 # different programming environments, including REST APIs and RPC APIs. It is
3097 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3098 # three pieces of data: error code, error message, and error details.
3099 #
3100 # You can find out more about this error model and how to work with it in the
3101 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3102 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3103 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3104 # message types for APIs to use.
3105 {
3106 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3107 },
3108 ],
3109 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3110 # user-facing error message should be localized and sent in the
3111 # google.rpc.Status.details field, or localized by the client.
3112 },
3113 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3114 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3115 },
3116 },
3117 },
3118 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3119 # This value is inRFC3339
3120 # text format.
3121 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3122 # following:
3123 # `PENDING`, `RUNNING`, or `DONE`.
3124 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3125 # operation.
3126 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3127 # of the target resource.
3128 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3129 # operations related to creating a snapshot, this points to the disk
3130 # that the snapshot was created from.
3131 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3132 # `[email protected]` or
3133 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3134 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3135 # operation, this field will be populated.
3136 {
3137 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3138 # Engine returns NO_RESULTS_ON_PAGE if there
3139 # are no results in the response.
3140 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3141 # value format. For example:
3142 #
3143 # &quot;data&quot;: [
3144 # {
3145 # &quot;key&quot;: &quot;scope&quot;,
3146 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3147 # }
3148 {
3149 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3150 # returned. For example, for warnings where there are no results in a list
3151 # request for a particular zone, this key might be scope and
3152 # the key value might be the zone name. Other examples might be a key
3153 # indicating a deprecated resource and a suggested replacement, or a
3154 # warning about invalid network settings (for example, if an instance
3155 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3156 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3157 },
3158 ],
3159 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3160 },
3161 ],
3162 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3163 # applicable when performing per-zone operations.
3164 }</pre>
3165 </div>
3166
3167 <div class="method">
3168 <code class="details" id="get">get(project, zone, disk, x__xgafv=None)</code>
3169 <pre>Returns the specified persistent disk.
3170
3171 Args:
3172 project: string, Project ID for this request. (required)
3173 zone: string, The name of the zone for this request. (required)
3174 disk: string, Name of the persistent disk to return. (required)
3175 x__xgafv: string, V1 error format.
3176 Allowed values
3177 1 - v1 error format
3178 2 - v2 error format
3179
3180 Returns:
3181 An object of the form:
3182
3183 { # Represents a Persistent Disk resource.
3184 #
3185 # Google Compute Engine has two Disk resources:
3186 #
3187 # * [Zonal](/compute/docs/reference/rest/alpha/disks)
3188 # * [Regional](/compute/docs/reference/rest/alpha/regionDisks)
3189 #
3190 # Persistent disks are required for running your VM instances.
3191 # Create both boot and non-boot (data) persistent disks. For more information,
3192 # read Persistent Disks. For more
3193 # storage options, read Storage options.
3194 #
3195 # The disks resource represents a zonal persistent disk.
3196 # For more information, readZonal persistent disks.
3197 #
3198 # The regionDisks resource represents a
3199 # regional persistent disk. For more information, read
3200 # Regional resources.
3201 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
3202 #
3203 #
3204 # - READ_WRITE_SINGLE: The default AccessMode, means the
3205 # disk can be attached to single instance in RW mode.
3206 # - READ_WRITE_MANY: The AccessMode means the disk can be
3207 # attached to multiple instances in RW mode.
3208 # - READ_ONLY_MANY: The AccessMode means the disk can be
3209 # attached to multiple instances in RO mode.
3210 #
3211 #
3212 # The AccessMode is only valid for Hyperdisk disk types.
3213 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
3214 # ARM64 or X86_64.
3215 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
3216 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
3217 # started on the disk as a member of a group.
3218 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
3219 # started on the disk as a member of a group.
3220 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
3221 # You can provide this as a partial or full URL to the resource.
3222 # For example, the following are valid values:
3223 #
3224 #
3225 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3226 # - projects/project/zones/zone/disks/disk
3227 # - zones/zone/disks/disk
3228 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
3229 # to or from the current disk. This value identifies the exact disk that
3230 # was used to create this replication. For example, if you started
3231 # replicating the persistent disk from a disk that was later deleted and
3232 # recreated under the same name, the disk ID would identify the exact
3233 # version of the disk that was used.
3234 },
3235 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
3236 &quot;a_key&quot;: {
3237 &quot;asyncReplicationDisk&quot;: {
3238 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
3239 # started on the disk as a member of a group.
3240 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
3241 # started on the disk as a member of a group.
3242 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
3243 # You can provide this as a partial or full URL to the resource.
3244 # For example, the following are valid values:
3245 #
3246 #
3247 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3248 # - projects/project/zones/zone/disks/disk
3249 # - zones/zone/disks/disk
3250 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
3251 # to or from the current disk. This value identifies the exact disk that
3252 # was used to create this replication. For example, if you started
3253 # replicating the persistent disk from a disk that was later deleted and
3254 # recreated under the same name, the disk ID would identify the exact
3255 # version of the disk that was used.
3256 },
3257 },
3258 },
3259 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
3260 # text format.
3261 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
3262 # create the resource.
3263 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
3264 # customer-supplied encryption key or a
3265 # customer-managed encryption key.
3266 #
3267 # Encryption keys do not protect access to metadata of the disk.
3268 #
3269 # After you encrypt a disk with a customer-supplied key, you must provide the
3270 # same key if you use the disk later. For example, to create a disk snapshot,
3271 # to create a disk image, to create a machine image, or to attach the disk to
3272 # a virtual machine.
3273 #
3274 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
3275 # name once the disk is created. The disk is encrypted with this version of
3276 # the key. In the response, diskEncryptionKey.kmsKeyName appears
3277 # in the following format:
3278 #
3279 # &quot;diskEncryptionKey.kmsKeyName&quot;:
3280 # &quot;projects/kms_project_id/locations/region/keyRings/
3281 # key_region/cryptoKeys/key
3282 # /cryptoKeysVersions/version
3283 #
3284 # If you do not provide an encryption key when creating the disk, then the
3285 # disk is encrypted using an automatically generated key and you don&#x27;t need
3286 # to provide a key to use the disk later.
3287 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3288 # For example:
3289 #
3290 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3291 # key_region/cryptoKeys/key
3292 #
3293 # The fully-qualifed key name may be returned for resource GET requests. For
3294 # example:
3295 #
3296 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3297 # key_region/cryptoKeys/key
3298 # /cryptoKeyVersions/1
3299 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3300 # key. If absent, the Compute Engine default service account is used.
3301 # For example:
3302 #
3303 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3304 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3305 # encryption key, encoded in RFC
3306 # 4648 base64 to either encrypt or decrypt this resource. You can
3307 # provide either the rawKey or thersaEncryptedKey.
3308 # For example:
3309 #
3310 # &quot;rawKey&quot;:
3311 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3312 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3313 # customer-supplied encryption key to either encrypt or decrypt this
3314 # resource. You can provide either the rawKey or thersaEncryptedKey.
3315 # For example:
3316 #
3317 # &quot;rsaEncryptedKey&quot;:
3318 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3319 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3320 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3321 #
3322 # The key must meet the following requirements before you can provide it to
3323 # Compute Engine:
3324 #
3325 # 1. The key is wrapped using a RSA public key certificate provided by
3326 # Google.
3327 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3328 # encoding.
3329 #
3330 # Gets the RSA public key certificate provided by Google at:
3331 #
3332 #
3333 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3334 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3335 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3336 # encryption key that protects this resource.
3337 },
3338 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
3339 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
3340 # Windows specific VSS signature.
3341 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
3342 # only for bootable images. Read
3343 # Enabling guest operating system features to see a list of available
3344 # options.
3345 { # Guest OS features.
3346 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
3347 # separate values. Set to one or more of the following values:
3348 #
3349 # - VIRTIO_SCSI_MULTIQUEUE
3350 # - WINDOWS
3351 # - MULTI_IP_SUBNET
3352 # - UEFI_COMPATIBLE
3353 # - GVNIC
3354 # - SEV_CAPABLE
3355 # - SUSPEND_RESUME_COMPATIBLE
3356 # - SEV_LIVE_MIGRATABLE_V2
3357 # - SEV_SNP_CAPABLE
3358 # - TDX_CAPABLE
3359 # - IDPF
3360 # - SNP_SVSM_CAPABLE
3361 # - CCA_CAPABLE
3362 #
3363 #
3364 # For more information, see
3365 # Enabling guest operating system features.
3366 },
3367 ],
3368 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
3369 # defined by the server.
3370 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
3371 # which is either SCSI or NVME. The default isSCSI.
3372 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
3373 # disks.
3374 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
3375 # essentially a hash of the labels set used for optimistic locking. The
3376 # fingerprint is initially generated by Compute Engine and changes after
3377 # every request to modify or update labels. You must always provide an
3378 # up-to-date fingerprint hash in order to update or change labels,
3379 # otherwise the request will fail with error412 conditionNotMet.
3380 #
3381 # To see the latest fingerprint, make a get() request to
3382 # retrieve a disk.
3383 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
3384 # the setLabels method.
3385 &quot;a_key&quot;: &quot;A String&quot;,
3386 },
3387 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
3388 # text format.
3389 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
3390 # text format.
3391 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
3392 &quot;A String&quot;,
3393 ],
3394 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
3395 &quot;A String&quot;,
3396 ],
3397 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
3398 # This field is for use by internal tools that use the public API.
3399 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
3400 # source image. Attachment of a disk created from a locked source image will
3401 # cause the following operations to become irreversibly prohibited:
3402 #
3403 # - R/W or R/O disk attachment to any other instance
3404 # - Disk detachment. And the disk can only be deleted when the instance
3405 # is deleted
3406 # - Creation of images or snapshots
3407 # - Disk cloning
3408 #
3409 #
3410 #
3411 # Furthermore, the instance with at least one disk with locked flag set to
3412 # true will be prohibited from performing the operations below:
3413 #
3414 # - Further attachment of secondary disks.
3415 # - Detachment of any disks
3416 # - Create machine images
3417 # - Create instance template
3418 # - Delete the instance with --keep-disk parameter set to true for locked
3419 # disks
3420 # - Attach a locked disk with --auto-delete parameter set to false
3421 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
3422 # more than one instance.
3423 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
3424 # The name must be 1-63 characters long, and comply withRFC1035.
3425 # Specifically, the name must be 1-63 characters long and match the regular
3426 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
3427 # which means the first character must be a lowercase letter, and all
3428 # following characters must be a dash, lowercase letter, or digit, except
3429 # the last character, which cannot be a dash.
3430 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
3431 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
3432 # as part of resource payload.
3433 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
3434 # have the same definition as resource
3435 # manager tags. Keys and values can be either in numeric format,
3436 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3437 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3438 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
3439 # PATCH) when empty.
3440 &quot;a_key&quot;: &quot;A String&quot;,
3441 },
3442 },
3443 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
3444 # If not present in a request, a default value is used.
3445 # The currently supported size is 4096, other sizes may be added in
3446 # the future.
3447 # If an unsupported value is requested, the error message will list
3448 # the supported values for the caller&#x27;s project.
3449 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
3450 # of I/O operations per second that the disk can handle. Values must be
3451 # between 10,000 and 120,000. For more details, see theExtreme persistent
3452 # disk documentation.
3453 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
3454 # number of throughput mb per second that the disk can handle. Values must be
3455 # greater than or equal to 1.
3456 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
3457 # regional resources.
3458 # You must specify this field as part of the HTTP request URL. It is
3459 # not settable as a field in the request body.
3460 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
3461 # for regional resources.
3462 &quot;A String&quot;,
3463 ],
3464 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
3465 &quot;A String&quot;,
3466 ],
3467 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
3468 &quot;asyncPrimaryDisk&quot;: {
3469 &quot;state&quot;: &quot;A String&quot;,
3470 },
3471 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
3472 &quot;a_key&quot;: {
3473 &quot;state&quot;: &quot;A String&quot;,
3474 },
3475 },
3476 &quot;usedBytes&quot;: &quot;A String&quot;, # [Output Only] Space used by data stored in the disk (in bytes). Note that
3477 # this field is set only when the disk is in a storage pool.
3478 },
3479 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
3480 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
3481 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
3482 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
3483 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
3484 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
3485 # persistent disk.
3486 #
3487 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
3488 # source.
3489 # Acceptable values are greater than 0.
3490 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
3491 # that was created using a consistency group.
3492 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
3493 # that was created using a consistency group.
3494 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
3495 # partial or full URL to the resource. For example, the following are valid
3496 # values:
3497 #
3498 #
3499 # -
3500 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3501 #
3502 # -
3503 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
3504 #
3505 # -
3506 # projects/project/zones/zone/disks/disk
3507 #
3508 # -
3509 # projects/project/regions/region/disks/disk
3510 #
3511 # -
3512 # zones/zone/disks/disk
3513 #
3514 # -
3515 # regions/region/disks/disk
3516 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
3517 # value identifies the exact disk that was used to create this persistent
3518 # disk. For example, if you created the persistent disk from a disk that
3519 # was later deleted and recreated under the same name, the source disk ID
3520 # would identify the exact version of the disk that was used.
3521 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
3522 # deleted, this field will not be set.
3523 #
3524 # To create a disk with one of the public operating system images, specify
3525 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
3526 #
3527 # projects/debian-cloud/global/images/family/debian-9
3528 #
3529 #
3530 # Alternatively, use a specific version of a public operating system image:
3531 #
3532 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
3533 #
3534 #
3535 # To create a disk with a custom image that you created, specify the
3536 # image name in the following format:
3537 #
3538 # global/images/my-custom-image
3539 #
3540 #
3541 # You can also specify a custom image by its image family, which returns
3542 # the latest version of the image in that family. Replace the image name
3543 # with family/family-name:
3544 #
3545 # global/images/family/my-image-family
3546 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
3547 # encryption key of the source image. Required if the source image is
3548 # protected by a customer-supplied encryption key.
3549 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3550 # For example:
3551 #
3552 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3553 # key_region/cryptoKeys/key
3554 #
3555 # The fully-qualifed key name may be returned for resource GET requests. For
3556 # example:
3557 #
3558 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3559 # key_region/cryptoKeys/key
3560 # /cryptoKeyVersions/1
3561 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3562 # key. If absent, the Compute Engine default service account is used.
3563 # For example:
3564 #
3565 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3566 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3567 # encryption key, encoded in RFC
3568 # 4648 base64 to either encrypt or decrypt this resource. You can
3569 # provide either the rawKey or thersaEncryptedKey.
3570 # For example:
3571 #
3572 # &quot;rawKey&quot;:
3573 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3574 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3575 # customer-supplied encryption key to either encrypt or decrypt this
3576 # resource. You can provide either the rawKey or thersaEncryptedKey.
3577 # For example:
3578 #
3579 # &quot;rsaEncryptedKey&quot;:
3580 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3581 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3582 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3583 #
3584 # The key must meet the following requirements before you can provide it to
3585 # Compute Engine:
3586 #
3587 # 1. The key is wrapped using a RSA public key certificate provided by
3588 # Google.
3589 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3590 # encoding.
3591 #
3592 # Gets the RSA public key certificate provided by Google at:
3593 #
3594 #
3595 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3596 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3597 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3598 # encryption key that protects this resource.
3599 },
3600 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
3601 # value identifies the exact image that was used to create this persistent
3602 # disk. For example, if you created the persistent disk from an image that
3603 # was later deleted and recreated under the same name, the source image ID
3604 # would identify the exact version of the image that was used.
3605 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
3606 # this as a partial or full URL to the resource. For example, the following
3607 # are valid values:
3608 #
3609 #
3610 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
3611 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
3612 # - zones/zone/instantSnapshots/instantSnapshot
3613 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
3614 # disk. This value identifies the exact instant snapshot that was used to
3615 # create this persistent disk. For example, if you created the persistent
3616 # disk from an instant snapshot that was later deleted and recreated under
3617 # the same name, the source instant snapshot ID would identify the exact
3618 # version of the instant snapshot that was used.
3619 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
3620 # partial or full URL to the resource. For example, the following are valid
3621 # values:
3622 #
3623 #
3624 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
3625 # - projects/project/global/machineImages/machineImage
3626 # - global/machineImages/machineImage
3627 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
3628 # source_machine_image must be specified.
3629 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
3630 # encryption key of the source machine image. Required if the source
3631 # machine image is protected by a customer-supplied encryption key.
3632 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3633 # For example:
3634 #
3635 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3636 # key_region/cryptoKeys/key
3637 #
3638 # The fully-qualifed key name may be returned for resource GET requests. For
3639 # example:
3640 #
3641 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3642 # key_region/cryptoKeys/key
3643 # /cryptoKeyVersions/1
3644 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3645 # key. If absent, the Compute Engine default service account is used.
3646 # For example:
3647 #
3648 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3649 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3650 # encryption key, encoded in RFC
3651 # 4648 base64 to either encrypt or decrypt this resource. You can
3652 # provide either the rawKey or thersaEncryptedKey.
3653 # For example:
3654 #
3655 # &quot;rawKey&quot;:
3656 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3657 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3658 # customer-supplied encryption key to either encrypt or decrypt this
3659 # resource. You can provide either the rawKey or thersaEncryptedKey.
3660 # For example:
3661 #
3662 # &quot;rsaEncryptedKey&quot;:
3663 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3664 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3665 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3666 #
3667 # The key must meet the following requirements before you can provide it to
3668 # Compute Engine:
3669 #
3670 # 1. The key is wrapped using a RSA public key certificate provided by
3671 # Google.
3672 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3673 # encoding.
3674 #
3675 # Gets the RSA public key certificate provided by Google at:
3676 #
3677 #
3678 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3679 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3680 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3681 # encryption key that protects this resource.
3682 },
3683 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
3684 # This value identifies the exact machine image that was used to create this
3685 # persistent disk. For example, if you created the persistent disk from a
3686 # machine image that was later deleted and recreated under the same name, the
3687 # source machine image ID would identify the exact version of the machine
3688 # image that was used.
3689 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
3690 # partial or full URL to the resource. For example, the following are valid
3691 # values:
3692 #
3693 #
3694 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
3695 # - projects/project/global/snapshots/snapshot
3696 # - global/snapshots/snapshot
3697 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3698 # encryption key of the source snapshot. Required if the source snapshot
3699 # is protected by a customer-supplied encryption key.
3700 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3701 # For example:
3702 #
3703 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3704 # key_region/cryptoKeys/key
3705 #
3706 # The fully-qualifed key name may be returned for resource GET requests. For
3707 # example:
3708 #
3709 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3710 # key_region/cryptoKeys/key
3711 # /cryptoKeyVersions/1
3712 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3713 # key. If absent, the Compute Engine default service account is used.
3714 # For example:
3715 #
3716 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3717 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3718 # encryption key, encoded in RFC
3719 # 4648 base64 to either encrypt or decrypt this resource. You can
3720 # provide either the rawKey or thersaEncryptedKey.
3721 # For example:
3722 #
3723 # &quot;rawKey&quot;:
3724 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3725 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3726 # customer-supplied encryption key to either encrypt or decrypt this
3727 # resource. You can provide either the rawKey or thersaEncryptedKey.
3728 # For example:
3729 #
3730 # &quot;rsaEncryptedKey&quot;:
3731 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3732 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3733 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3734 #
3735 # The key must meet the following requirements before you can provide it to
3736 # Compute Engine:
3737 #
3738 # 1. The key is wrapped using a RSA public key certificate provided by
3739 # Google.
3740 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3741 # encoding.
3742 #
3743 # Gets the RSA public key certificate provided by Google at:
3744 #
3745 #
3746 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3747 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3748 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3749 # encryption key that protects this resource.
3750 },
3751 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
3752 # value identifies the exact snapshot that was used to create this persistent
3753 # disk. For example, if you created the persistent disk from a snapshot that
3754 # was later deleted and recreated under the same name, the source snapshot ID
3755 # would identify the exact version of the snapshot that was used.
3756 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
3757 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
3758 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
3759 # https://storage.googleapis.com/. This flag is not optimized for creating
3760 # multiple disks from a source storage object. To create many disks from a
3761 # source storage object, use gcloud compute images
3762 # import instead.
3763 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
3764 #
3765 #
3766 # - CREATING: Disk is provisioning.
3767 # - RESTORING: Source data is being copied into the
3768 # disk.
3769 # - FAILED: Disk creation failed.
3770 # - READY: Disk is ready for use.
3771 # - DELETING: Disk is deleting.
3772 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3773 # this as a partial or full URL to the resource. For example, the following
3774 # are valid values:
3775 #
3776 #
3777 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3778 # - projects/project/zones/zone/storagePools/storagePool
3779 # - zones/zone/storagePools/storagePool
3780 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
3781 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
3782 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
3783 # types.
3784 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
3785 # in form:projects/project/zones/zone/instances/instance
3786 &quot;A String&quot;,
3787 ],
3788 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
3789 # You must specify this field as part of the HTTP request URL. It is
3790 # not settable as a field in the request body.
3791 }</pre>
3792 </div>
3793
3794 <div class="method">
3795 <code class="details" id="getAsyncReplicationStatus">getAsyncReplicationStatus(project, zone, disk, x__xgafv=None)</code>
3796 <pre>Gets the status of current async replication for a given device.
3797
3798 Args:
3799 project: string, Project ID for this request. (required)
3800 zone: string, The name of the zone for this request. (required)
3801 disk: string, Name of the Disk resource whose Async replication details are requested.
3802 Name should conform to RFC1035 or be an unsigned long integer. (required)
3803 x__xgafv: string, V1 error format.
3804 Allowed values
3805 1 - v1 error format
3806 2 - v2 error format
3807
3808 Returns:
3809 An object of the form:
3810
3811 {
3812 &quot;asyncReplicationStatus&quot;: {
3813 &quot;diskPairReplicationState&quot;: {
3814 &quot;dataReplicationState&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
3815 #
3816 #
3817 # - ASYNC_REPLICATION_STATE_INITIALIZING: The device is
3818 # doing the initial replication after starting the
3819 # replication.
3820 #
3821 # - ASYNC_REPLICATION_STATE_REPLICATING_HEALTHY: The
3822 # primary disk is healthily replicating to the secondary device i.e.
3823 # last_replication_time is within RPO.
3824 #
3825 # - ASYNC_REPLICATION_STATE_REPLICATING_BEHIND_HIGH_CHURN:
3826 # The replication is lagging above the SLO limit due to the disk&#x27;s change
3827 # rate being above the supported limit.
3828 #
3829 # - ASYNC_REPLICATION_STATE_REPLICATING_BEHIND_SYSTEM_LAGGING:
3830 # The replication is lagging, and the RPO is not being met due to some
3831 # internal issue.
3832 #
3833 # - ASYNC_REPLICATION_STATE_REPLICATION_STUCK: The
3834 # replication is completely stuck due to some internal error.
3835 #
3836 # - ASYNC_REPLICATION_STATE_STOPPING: The replication
3837 # is under the process of being stopped. This is a transient state.
3838 #
3839 # - ASYNC_REPLICATION_STATE_STOPPED: The replication
3840 # between the disk-pairs have stopped.
3841 #
3842 # - ASYNC_REPLICATION_STATE_REPLICATING_BEHIND_CG_HIGH_CHURN:
3843 # The replication is lagging above the SLO limit for the disk in the
3844 # consistency group due to disk&#x27;s change rate being above the supported
3845 # limit.
3846 &quot;replicationDiskPair&quot;: {
3847 &quot;primaryDisk&quot;: &quot;A String&quot;, # Output only. URL of the primary disk.
3848 &quot;secondaryDisk&quot;: &quot;A String&quot;, # Output only. URL of the secondary disk.
3849 },
3850 },
3851 &quot;lastReplicationDetails&quot;: {
3852 &quot;lastReplicationTime&quot;: &quot;A String&quot;, # Output only. The last sync time of the device pair.
3853 &quot;secondsSinceLastReplication&quot;: &quot;A String&quot;, # Output only. Replication lag in seconds. This will only be populated if device is in
3854 # replicating state. Note that the value is calculated sometime during
3855 # request processing and at the instant the client receives the response,
3856 # the current replication_lag may have changed.
3857 },
3858 },
3859 &quot;etag&quot;: &quot;A String&quot;, # end_interface: MixerGetResponseWithEtagBuilder
3860 }</pre>
3861 </div>
3862
3863 <div class="method">
3864 <code class="details" id="getIamPolicy">getIamPolicy(project, zone, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</code>
3865 <pre>Gets the access control policy for a resource. May be empty if no such
3866 policy or resource exists.
3867
3868 Args:
3869 project: string, Project ID for this request. (required)
3870 zone: string, The name of the zone for this request. (required)
3871 resource: string, Name or id of the resource for this request. (required)
3872 optionsRequestedPolicyVersion: integer, Requested IAM Policy version.
3873 x__xgafv: string, V1 error format.
3874 Allowed values
3875 1 - v1 error format
3876 2 - v2 error format
3877
3878 Returns:
3879 An object of the form:
3880
3881 { # An Identity and Access Management (IAM) policy, which specifies access
3882 # controls for Google Cloud resources.
3883 #
3884 #
3885 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
3886 # `members`, or principals, to a single `role`. Principals can be user
3887 # accounts, service accounts, Google groups, and domains (such as G Suite). A
3888 # `role` is a named list of permissions; each `role` can be an IAM predefined
3889 # role or a user-created custom role.
3890 #
3891 # For some types of Google Cloud resources, a `binding` can also specify a
3892 # `condition`, which is a logical expression that allows access to a resource
3893 # only if the expression evaluates to `true`. A condition can add constraints
3894 # based on attributes of the request, the resource, or both. To learn which
3895 # resources support conditions in their IAM policies, see the
3896 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
3897 #
3898 # **JSON example:**
3899 #
3900 # ```
3901 # {
3902 # &quot;bindings&quot;: [
3903 # {
3904 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
3905 # &quot;members&quot;: [
3906 # &quot;user:[email protected]&quot;,
3907 # &quot;group:[email protected]&quot;,
3908 # &quot;domain:google.com&quot;,
3909 # &quot;serviceAccount:[email protected]&quot;
3910 # ]
3911 # },
3912 # {
3913 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
3914 # &quot;members&quot;: [
3915 # &quot;user:[email protected]&quot;
3916 # ],
3917 # &quot;condition&quot;: {
3918 # &quot;title&quot;: &quot;expirable access&quot;,
3919 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
3920 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
3921 # }
3922 # }
3923 # ],
3924 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
3925 # &quot;version&quot;: 3
3926 # }
3927 # ```
3928 #
3929 # **YAML example:**
3930 #
3931 # ```
3932 # bindings:
3933 # - members:
3934 # - user:[email protected]
3935 # - group:[email protected]
3936 # - domain:google.com
3937 # - serviceAccount:[email protected]
3938 # role: roles/resourcemanager.organizationAdmin
3939 # - members:
3940 # - user:[email protected]
3941 # role: roles/resourcemanager.organizationViewer
3942 # condition:
3943 # title: expirable access
3944 # description: Does not grant access after Sep 2020
3945 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
3946 # etag: BwWWja0YfJA=
3947 # version: 3
3948 # ```
3949 #
3950 # For a description of IAM and its features, see the
3951 # [IAM documentation](https://cloud.google.com/iam/docs/).
3952 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
3953 { # Specifies the audit configuration for a service.
3954 # The configuration determines which permission types are logged, and what
3955 # identities, if any, are exempted from logging.
3956 # An AuditConfig must have one or more AuditLogConfigs.
3957 #
3958 # If there are AuditConfigs for both `allServices` and a specific service,
3959 # the union of the two AuditConfigs is used for that service: the log_types
3960 # specified in each AuditConfig are enabled, and the exempted_members in each
3961 # AuditLogConfig are exempted.
3962 #
3963 # Example Policy with multiple AuditConfigs:
3964 #
3965 # {
3966 # &quot;audit_configs&quot;: [
3967 # {
3968 # &quot;service&quot;: &quot;allServices&quot;,
3969 # &quot;audit_log_configs&quot;: [
3970 # {
3971 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
3972 # &quot;exempted_members&quot;: [
3973 # &quot;user:[email protected]&quot;
3974 # ]
3975 # },
3976 # {
3977 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
3978 # },
3979 # {
3980 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
3981 # }
3982 # ]
3983 # },
3984 # {
3985 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
3986 # &quot;audit_log_configs&quot;: [
3987 # {
3988 # &quot;log_type&quot;: &quot;DATA_READ&quot;
3989 # },
3990 # {
3991 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
3992 # &quot;exempted_members&quot;: [
3993 # &quot;user:[email protected]&quot;
3994 # ]
3995 # }
3996 # ]
3997 # }
3998 # ]
3999 # }
4000 #
4001 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
4002 # logging. It also exempts `[email protected]` from DATA_READ logging, and
4003 # `[email protected]` from DATA_WRITE logging.
4004 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
4005 { # Provides the configuration for logging a type of permissions.
4006 # Example:
4007 #
4008 # {
4009 # &quot;audit_log_configs&quot;: [
4010 # {
4011 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
4012 # &quot;exempted_members&quot;: [
4013 # &quot;user:[email protected]&quot;
4014 # ]
4015 # },
4016 # {
4017 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
4018 # }
4019 # ]
4020 # }
4021 #
4022 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
4023 # [email protected] from DATA_READ logging.
4024 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
4025 # permission.
4026 # Follows the same format of Binding.members.
4027 &quot;A String&quot;,
4028 ],
4029 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
4030 },
4031 ],
4032 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
4033 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
4034 # `allServices` is a special value that covers all services.
4035 },
4036 ],
4037 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
4038 # may specify a `condition` that determines how and when the `bindings` are
4039 # applied. Each of the `bindings` must contain at least one principal.
4040 #
4041 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
4042 # of these principals can be Google groups. Each occurrence of a principal
4043 # counts towards these limits. For example, if the `bindings` grant 50
4044 # different roles to `user:[email protected]`, and not to any other
4045 # principal, then you can add another 1,450 principals to the `bindings` in
4046 # the `Policy`.
4047 { # Associates `members`, or principals, with a `role`.
4048 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
4049 #
4050 # If the condition evaluates to `true`, then this binding applies to the
4051 # current request.
4052 #
4053 # If the condition evaluates to `false`, then this binding does not apply to
4054 # the current request. However, a different role binding might grant the same
4055 # role to one or more of the principals in this binding.
4056 #
4057 # To learn which resources support conditions in their IAM policies, see the
4058 # [IAM
4059 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
4060 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
4061 # are documented at https://github.com/google/cel-spec.
4062 #
4063 # Example (Comparison):
4064 #
4065 # title: &quot;Summary size limit&quot;
4066 # description: &quot;Determines if a summary is less than 100 chars&quot;
4067 # expression: &quot;document.summary.size() &lt; 100&quot;
4068 #
4069 # Example (Equality):
4070 #
4071 # title: &quot;Requestor is owner&quot;
4072 # description: &quot;Determines if requestor is the document owner&quot;
4073 # expression: &quot;document.owner == request.auth.claims.email&quot;
4074 #
4075 # Example (Logic):
4076 #
4077 # title: &quot;Public documents&quot;
4078 # description: &quot;Determine whether the document should be publicly visible&quot;
4079 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
4080 #
4081 # Example (Data Manipulation):
4082 #
4083 # title: &quot;Notification string&quot;
4084 # description: &quot;Create a notification string with a timestamp.&quot;
4085 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
4086 #
4087 # The exact variables and functions that may be referenced within an expression
4088 # are determined by the service that evaluates it. See the service
4089 # documentation for additional information.
4090 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
4091 # describes the expression, e.g. when hovered over it in a UI.
4092 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
4093 # syntax.
4094 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
4095 # reporting, e.g. a file name and a position in the file.
4096 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
4097 # its purpose. This can be used e.g. in UIs which allow to enter the
4098 # expression.
4099 },
4100 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
4101 # `members` can have the following values:
4102 #
4103 # * `allUsers`: A special identifier that represents anyone who is
4104 # on the internet; with or without a Google account.
4105 #
4106 # * `allAuthenticatedUsers`: A special identifier that represents anyone
4107 # who is authenticated with a Google account or a service account.
4108 # Does not include identities that come from external identity providers
4109 # (IdPs) through identity federation.
4110 #
4111 # * `user:{emailid}`: An email address that represents a specific Google
4112 # account. For example, `[email protected]` .
4113 #
4114 #
4115 # * `serviceAccount:{emailid}`: An email address that represents a Google
4116 # service account. For example,
4117 # `[email protected]`.
4118 #
4119 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
4120 # identifier for a
4121 # [Kubernetes service
4122 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
4123 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
4124 #
4125 # * `group:{emailid}`: An email address that represents a Google group.
4126 # For example, `[email protected]`.
4127 #
4128 #
4129 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
4130 # users of that domain. For example, `google.com` or `example.com`.
4131 #
4132 #
4133 #
4134 #
4135 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
4136 # A single identity in a workforce identity pool.
4137 #
4138 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
4139 # All workforce identities in a group.
4140 #
4141 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
4142 # All workforce identities with a specific attribute value.
4143 #
4144 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
4145 # All identities in a workforce identity pool.
4146 #
4147 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
4148 # A single identity in a workload identity pool.
4149 #
4150 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
4151 # A workload identity pool group.
4152 #
4153 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
4154 # All identities in a workload identity pool with a certain attribute.
4155 #
4156 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
4157 # All identities in a workload identity pool.
4158 #
4159 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
4160 # identifier) representing a user that has been recently deleted. For
4161 # example, `[email protected]?uid=123456789012345678901`. If the user is
4162 # recovered, this value reverts to `user:{emailid}` and the recovered user
4163 # retains the role in the binding.
4164 #
4165 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
4166 # unique identifier) representing a service account that has been recently
4167 # deleted. For example,
4168 # `[email protected]?uid=123456789012345678901`.
4169 # If the service account is undeleted, this value reverts to
4170 # `serviceAccount:{emailid}` and the undeleted service account retains the
4171 # role in the binding.
4172 #
4173 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
4174 # identifier) representing a Google group that has been recently
4175 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
4176 # the group is recovered, this value reverts to `group:{emailid}` and the
4177 # recovered group retains the role in the binding.
4178 #
4179 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
4180 # Deleted single identity in a workforce identity pool. For example,
4181 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
4182 &quot;A String&quot;,
4183 ],
4184 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
4185 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
4186 #
4187 # For an overview of the IAM roles and permissions, see the
4188 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
4189 # a list of the available pre-defined roles, see
4190 # [here](https://cloud.google.com/iam/docs/understanding-roles).
4191 },
4192 ],
4193 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
4194 # prevent simultaneous updates of a policy from overwriting each other.
4195 # It is strongly suggested that systems make use of the `etag` in the
4196 # read-modify-write cycle to perform policy updates in order to avoid race
4197 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
4198 # systems are expected to put that etag in the request to `setIamPolicy` to
4199 # ensure that their change will be applied to the same version of the policy.
4200 #
4201 # **Important:** If you use IAM Conditions, you must include the `etag` field
4202 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
4203 # you to overwrite a version `3` policy with a version `1` policy, and all of
4204 # the conditions in the version `3` policy are lost.
4205 &quot;version&quot;: 42, # Specifies the format of the policy.
4206 #
4207 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
4208 # are rejected.
4209 #
4210 # Any operation that affects conditional role bindings must specify version
4211 # `3`. This requirement applies to the following operations:
4212 #
4213 # * Getting a policy that includes a conditional role binding
4214 # * Adding a conditional role binding to a policy
4215 # * Changing a conditional role binding in a policy
4216 # * Removing any role binding, with or without a condition, from a policy
4217 # that includes conditions
4218 #
4219 # **Important:** If you use IAM Conditions, you must include the `etag` field
4220 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
4221 # you to overwrite a version `3` policy with a version `1` policy, and all of
4222 # the conditions in the version `3` policy are lost.
4223 #
4224 # If a policy does not include any conditions, operations on that policy may
4225 # specify any valid version or leave the field unset.
4226 #
4227 # To learn which resources support conditions in their IAM policies, see the
4228 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
4229 }</pre>
4230 </div>
4231
4232 <div class="method">
4233 <code class="details" id="insert">insert(project, zone, body=None, requestId=None, sourceImage=None, x__xgafv=None)</code>
4234 <pre>Creates a persistent disk in the specified project using the data
4235 in the request. You can create a disk from a source
4236 (sourceImage, sourceSnapshot, orsourceDisk) or create an empty 500 GB data disk by
4237 omitting all properties. You can also create a disk that is larger than
4238 the default size by specifying the sizeGb property.
4239
4240 Args:
4241 project: string, Project ID for this request. (required)
4242 zone: string, The name of the zone for this request. (required)
4243 body: object, The request body.
4244 The object takes the form of:
4245
4246 { # Represents a Persistent Disk resource.
4247 #
4248 # Google Compute Engine has two Disk resources:
4249 #
4250 # * [Zonal](/compute/docs/reference/rest/alpha/disks)
4251 # * [Regional](/compute/docs/reference/rest/alpha/regionDisks)
4252 #
4253 # Persistent disks are required for running your VM instances.
4254 # Create both boot and non-boot (data) persistent disks. For more information,
4255 # read Persistent Disks. For more
4256 # storage options, read Storage options.
4257 #
4258 # The disks resource represents a zonal persistent disk.
4259 # For more information, readZonal persistent disks.
4260 #
4261 # The regionDisks resource represents a
4262 # regional persistent disk. For more information, read
4263 # Regional resources.
4264 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
4265 #
4266 #
4267 # - READ_WRITE_SINGLE: The default AccessMode, means the
4268 # disk can be attached to single instance in RW mode.
4269 # - READ_WRITE_MANY: The AccessMode means the disk can be
4270 # attached to multiple instances in RW mode.
4271 # - READ_ONLY_MANY: The AccessMode means the disk can be
4272 # attached to multiple instances in RO mode.
4273 #
4274 #
4275 # The AccessMode is only valid for Hyperdisk disk types.
4276 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
4277 # ARM64 or X86_64.
4278 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
4279 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
4280 # started on the disk as a member of a group.
4281 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
4282 # started on the disk as a member of a group.
4283 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
4284 # You can provide this as a partial or full URL to the resource.
4285 # For example, the following are valid values:
4286 #
4287 #
4288 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
4289 # - projects/project/zones/zone/disks/disk
4290 # - zones/zone/disks/disk
4291 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
4292 # to or from the current disk. This value identifies the exact disk that
4293 # was used to create this replication. For example, if you started
4294 # replicating the persistent disk from a disk that was later deleted and
4295 # recreated under the same name, the disk ID would identify the exact
4296 # version of the disk that was used.
4297 },
4298 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
4299 &quot;a_key&quot;: {
4300 &quot;asyncReplicationDisk&quot;: {
4301 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
4302 # started on the disk as a member of a group.
4303 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
4304 # started on the disk as a member of a group.
4305 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
4306 # You can provide this as a partial or full URL to the resource.
4307 # For example, the following are valid values:
4308 #
4309 #
4310 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
4311 # - projects/project/zones/zone/disks/disk
4312 # - zones/zone/disks/disk
4313 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
4314 # to or from the current disk. This value identifies the exact disk that
4315 # was used to create this replication. For example, if you started
4316 # replicating the persistent disk from a disk that was later deleted and
4317 # recreated under the same name, the disk ID would identify the exact
4318 # version of the disk that was used.
4319 },
4320 },
4321 },
4322 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
4323 # text format.
4324 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
4325 # create the resource.
4326 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
4327 # customer-supplied encryption key or a
4328 # customer-managed encryption key.
4329 #
4330 # Encryption keys do not protect access to metadata of the disk.
4331 #
4332 # After you encrypt a disk with a customer-supplied key, you must provide the
4333 # same key if you use the disk later. For example, to create a disk snapshot,
4334 # to create a disk image, to create a machine image, or to attach the disk to
4335 # a virtual machine.
4336 #
4337 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
4338 # name once the disk is created. The disk is encrypted with this version of
4339 # the key. In the response, diskEncryptionKey.kmsKeyName appears
4340 # in the following format:
4341 #
4342 # &quot;diskEncryptionKey.kmsKeyName&quot;:
4343 # &quot;projects/kms_project_id/locations/region/keyRings/
4344 # key_region/cryptoKeys/key
4345 # /cryptoKeysVersions/version
4346 #
4347 # If you do not provide an encryption key when creating the disk, then the
4348 # disk is encrypted using an automatically generated key and you don&#x27;t need
4349 # to provide a key to use the disk later.
4350 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4351 # For example:
4352 #
4353 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4354 # key_region/cryptoKeys/key
4355 #
4356 # The fully-qualifed key name may be returned for resource GET requests. For
4357 # example:
4358 #
4359 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4360 # key_region/cryptoKeys/key
4361 # /cryptoKeyVersions/1
4362 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4363 # key. If absent, the Compute Engine default service account is used.
4364 # For example:
4365 #
4366 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4367 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4368 # encryption key, encoded in RFC
4369 # 4648 base64 to either encrypt or decrypt this resource. You can
4370 # provide either the rawKey or thersaEncryptedKey.
4371 # For example:
4372 #
4373 # &quot;rawKey&quot;:
4374 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4375 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4376 # customer-supplied encryption key to either encrypt or decrypt this
4377 # resource. You can provide either the rawKey or thersaEncryptedKey.
4378 # For example:
4379 #
4380 # &quot;rsaEncryptedKey&quot;:
4381 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4382 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4383 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4384 #
4385 # The key must meet the following requirements before you can provide it to
4386 # Compute Engine:
4387 #
4388 # 1. The key is wrapped using a RSA public key certificate provided by
4389 # Google.
4390 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4391 # encoding.
4392 #
4393 # Gets the RSA public key certificate provided by Google at:
4394 #
4395 #
4396 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4397 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4398 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4399 # encryption key that protects this resource.
4400 },
4401 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
4402 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
4403 # Windows specific VSS signature.
4404 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4405 # only for bootable images. Read
4406 # Enabling guest operating system features to see a list of available
4407 # options.
4408 { # Guest OS features.
4409 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4410 # separate values. Set to one or more of the following values:
4411 #
4412 # - VIRTIO_SCSI_MULTIQUEUE
4413 # - WINDOWS
4414 # - MULTI_IP_SUBNET
4415 # - UEFI_COMPATIBLE
4416 # - GVNIC
4417 # - SEV_CAPABLE
4418 # - SUSPEND_RESUME_COMPATIBLE
4419 # - SEV_LIVE_MIGRATABLE_V2
4420 # - SEV_SNP_CAPABLE
4421 # - TDX_CAPABLE
4422 # - IDPF
4423 # - SNP_SVSM_CAPABLE
4424 # - CCA_CAPABLE
4425 #
4426 #
4427 # For more information, see
4428 # Enabling guest operating system features.
4429 },
4430 ],
4431 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
4432 # defined by the server.
4433 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
4434 # which is either SCSI or NVME. The default isSCSI.
4435 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
4436 # disks.
4437 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
4438 # essentially a hash of the labels set used for optimistic locking. The
4439 # fingerprint is initially generated by Compute Engine and changes after
4440 # every request to modify or update labels. You must always provide an
4441 # up-to-date fingerprint hash in order to update or change labels,
4442 # otherwise the request will fail with error412 conditionNotMet.
4443 #
4444 # To see the latest fingerprint, make a get() request to
4445 # retrieve a disk.
4446 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
4447 # the setLabels method.
4448 &quot;a_key&quot;: &quot;A String&quot;,
4449 },
4450 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
4451 # text format.
4452 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
4453 # text format.
4454 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
4455 &quot;A String&quot;,
4456 ],
4457 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
4458 &quot;A String&quot;,
4459 ],
4460 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
4461 # This field is for use by internal tools that use the public API.
4462 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
4463 # source image. Attachment of a disk created from a locked source image will
4464 # cause the following operations to become irreversibly prohibited:
4465 #
4466 # - R/W or R/O disk attachment to any other instance
4467 # - Disk detachment. And the disk can only be deleted when the instance
4468 # is deleted
4469 # - Creation of images or snapshots
4470 # - Disk cloning
4471 #
4472 #
4473 #
4474 # Furthermore, the instance with at least one disk with locked flag set to
4475 # true will be prohibited from performing the operations below:
4476 #
4477 # - Further attachment of secondary disks.
4478 # - Detachment of any disks
4479 # - Create machine images
4480 # - Create instance template
4481 # - Delete the instance with --keep-disk parameter set to true for locked
4482 # disks
4483 # - Attach a locked disk with --auto-delete parameter set to false
4484 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
4485 # more than one instance.
4486 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
4487 # The name must be 1-63 characters long, and comply withRFC1035.
4488 # Specifically, the name must be 1-63 characters long and match the regular
4489 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
4490 # which means the first character must be a lowercase letter, and all
4491 # following characters must be a dash, lowercase letter, or digit, except
4492 # the last character, which cannot be a dash.
4493 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
4494 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
4495 # as part of resource payload.
4496 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
4497 # have the same definition as resource
4498 # manager tags. Keys and values can be either in numeric format,
4499 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4500 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4501 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
4502 # PATCH) when empty.
4503 &quot;a_key&quot;: &quot;A String&quot;,
4504 },
4505 },
4506 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
4507 # If not present in a request, a default value is used.
4508 # The currently supported size is 4096, other sizes may be added in
4509 # the future.
4510 # If an unsupported value is requested, the error message will list
4511 # the supported values for the caller&#x27;s project.
4512 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
4513 # of I/O operations per second that the disk can handle. Values must be
4514 # between 10,000 and 120,000. For more details, see theExtreme persistent
4515 # disk documentation.
4516 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
4517 # number of throughput mb per second that the disk can handle. Values must be
4518 # greater than or equal to 1.
4519 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
4520 # regional resources.
4521 # You must specify this field as part of the HTTP request URL. It is
4522 # not settable as a field in the request body.
4523 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
4524 # for regional resources.
4525 &quot;A String&quot;,
4526 ],
4527 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
4528 &quot;A String&quot;,
4529 ],
4530 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
4531 &quot;asyncPrimaryDisk&quot;: {
4532 &quot;state&quot;: &quot;A String&quot;,
4533 },
4534 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
4535 &quot;a_key&quot;: {
4536 &quot;state&quot;: &quot;A String&quot;,
4537 },
4538 },
4539 &quot;usedBytes&quot;: &quot;A String&quot;, # [Output Only] Space used by data stored in the disk (in bytes). Note that
4540 # this field is set only when the disk is in a storage pool.
4541 },
4542 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
4543 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
4544 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
4545 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
4546 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
4547 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
4548 # persistent disk.
4549 #
4550 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
4551 # source.
4552 # Acceptable values are greater than 0.
4553 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
4554 # that was created using a consistency group.
4555 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
4556 # that was created using a consistency group.
4557 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
4558 # partial or full URL to the resource. For example, the following are valid
4559 # values:
4560 #
4561 #
4562 # -
4563 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
4564 #
4565 # -
4566 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
4567 #
4568 # -
4569 # projects/project/zones/zone/disks/disk
4570 #
4571 # -
4572 # projects/project/regions/region/disks/disk
4573 #
4574 # -
4575 # zones/zone/disks/disk
4576 #
4577 # -
4578 # regions/region/disks/disk
4579 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
4580 # value identifies the exact disk that was used to create this persistent
4581 # disk. For example, if you created the persistent disk from a disk that
4582 # was later deleted and recreated under the same name, the source disk ID
4583 # would identify the exact version of the disk that was used.
4584 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
4585 # deleted, this field will not be set.
4586 #
4587 # To create a disk with one of the public operating system images, specify
4588 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
4589 #
4590 # projects/debian-cloud/global/images/family/debian-9
4591 #
4592 #
4593 # Alternatively, use a specific version of a public operating system image:
4594 #
4595 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
4596 #
4597 #
4598 # To create a disk with a custom image that you created, specify the
4599 # image name in the following format:
4600 #
4601 # global/images/my-custom-image
4602 #
4603 #
4604 # You can also specify a custom image by its image family, which returns
4605 # the latest version of the image in that family. Replace the image name
4606 # with family/family-name:
4607 #
4608 # global/images/family/my-image-family
4609 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
4610 # encryption key of the source image. Required if the source image is
4611 # protected by a customer-supplied encryption key.
4612 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4613 # For example:
4614 #
4615 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4616 # key_region/cryptoKeys/key
4617 #
4618 # The fully-qualifed key name may be returned for resource GET requests. For
4619 # example:
4620 #
4621 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4622 # key_region/cryptoKeys/key
4623 # /cryptoKeyVersions/1
4624 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4625 # key. If absent, the Compute Engine default service account is used.
4626 # For example:
4627 #
4628 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4629 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4630 # encryption key, encoded in RFC
4631 # 4648 base64 to either encrypt or decrypt this resource. You can
4632 # provide either the rawKey or thersaEncryptedKey.
4633 # For example:
4634 #
4635 # &quot;rawKey&quot;:
4636 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4637 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4638 # customer-supplied encryption key to either encrypt or decrypt this
4639 # resource. You can provide either the rawKey or thersaEncryptedKey.
4640 # For example:
4641 #
4642 # &quot;rsaEncryptedKey&quot;:
4643 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4644 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4645 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4646 #
4647 # The key must meet the following requirements before you can provide it to
4648 # Compute Engine:
4649 #
4650 # 1. The key is wrapped using a RSA public key certificate provided by
4651 # Google.
4652 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4653 # encoding.
4654 #
4655 # Gets the RSA public key certificate provided by Google at:
4656 #
4657 #
4658 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4659 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4660 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4661 # encryption key that protects this resource.
4662 },
4663 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
4664 # value identifies the exact image that was used to create this persistent
4665 # disk. For example, if you created the persistent disk from an image that
4666 # was later deleted and recreated under the same name, the source image ID
4667 # would identify the exact version of the image that was used.
4668 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
4669 # this as a partial or full URL to the resource. For example, the following
4670 # are valid values:
4671 #
4672 #
4673 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
4674 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
4675 # - zones/zone/instantSnapshots/instantSnapshot
4676 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
4677 # disk. This value identifies the exact instant snapshot that was used to
4678 # create this persistent disk. For example, if you created the persistent
4679 # disk from an instant snapshot that was later deleted and recreated under
4680 # the same name, the source instant snapshot ID would identify the exact
4681 # version of the instant snapshot that was used.
4682 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
4683 # partial or full URL to the resource. For example, the following are valid
4684 # values:
4685 #
4686 #
4687 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
4688 # - projects/project/global/machineImages/machineImage
4689 # - global/machineImages/machineImage
4690 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
4691 # source_machine_image must be specified.
4692 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
4693 # encryption key of the source machine image. Required if the source
4694 # machine image is protected by a customer-supplied encryption key.
4695 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4696 # For example:
4697 #
4698 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4699 # key_region/cryptoKeys/key
4700 #
4701 # The fully-qualifed key name may be returned for resource GET requests. For
4702 # example:
4703 #
4704 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4705 # key_region/cryptoKeys/key
4706 # /cryptoKeyVersions/1
4707 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4708 # key. If absent, the Compute Engine default service account is used.
4709 # For example:
4710 #
4711 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4712 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4713 # encryption key, encoded in RFC
4714 # 4648 base64 to either encrypt or decrypt this resource. You can
4715 # provide either the rawKey or thersaEncryptedKey.
4716 # For example:
4717 #
4718 # &quot;rawKey&quot;:
4719 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4720 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4721 # customer-supplied encryption key to either encrypt or decrypt this
4722 # resource. You can provide either the rawKey or thersaEncryptedKey.
4723 # For example:
4724 #
4725 # &quot;rsaEncryptedKey&quot;:
4726 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4727 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4728 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4729 #
4730 # The key must meet the following requirements before you can provide it to
4731 # Compute Engine:
4732 #
4733 # 1. The key is wrapped using a RSA public key certificate provided by
4734 # Google.
4735 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4736 # encoding.
4737 #
4738 # Gets the RSA public key certificate provided by Google at:
4739 #
4740 #
4741 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4742 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4743 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4744 # encryption key that protects this resource.
4745 },
4746 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
4747 # This value identifies the exact machine image that was used to create this
4748 # persistent disk. For example, if you created the persistent disk from a
4749 # machine image that was later deleted and recreated under the same name, the
4750 # source machine image ID would identify the exact version of the machine
4751 # image that was used.
4752 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
4753 # partial or full URL to the resource. For example, the following are valid
4754 # values:
4755 #
4756 #
4757 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
4758 # - projects/project/global/snapshots/snapshot
4759 # - global/snapshots/snapshot
4760 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
4761 # encryption key of the source snapshot. Required if the source snapshot
4762 # is protected by a customer-supplied encryption key.
4763 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4764 # For example:
4765 #
4766 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4767 # key_region/cryptoKeys/key
4768 #
4769 # The fully-qualifed key name may be returned for resource GET requests. For
4770 # example:
4771 #
4772 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4773 # key_region/cryptoKeys/key
4774 # /cryptoKeyVersions/1
4775 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4776 # key. If absent, the Compute Engine default service account is used.
4777 # For example:
4778 #
4779 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4780 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4781 # encryption key, encoded in RFC
4782 # 4648 base64 to either encrypt or decrypt this resource. You can
4783 # provide either the rawKey or thersaEncryptedKey.
4784 # For example:
4785 #
4786 # &quot;rawKey&quot;:
4787 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4788 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4789 # customer-supplied encryption key to either encrypt or decrypt this
4790 # resource. You can provide either the rawKey or thersaEncryptedKey.
4791 # For example:
4792 #
4793 # &quot;rsaEncryptedKey&quot;:
4794 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4795 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4796 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4797 #
4798 # The key must meet the following requirements before you can provide it to
4799 # Compute Engine:
4800 #
4801 # 1. The key is wrapped using a RSA public key certificate provided by
4802 # Google.
4803 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4804 # encoding.
4805 #
4806 # Gets the RSA public key certificate provided by Google at:
4807 #
4808 #
4809 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4810 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4811 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4812 # encryption key that protects this resource.
4813 },
4814 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
4815 # value identifies the exact snapshot that was used to create this persistent
4816 # disk. For example, if you created the persistent disk from a snapshot that
4817 # was later deleted and recreated under the same name, the source snapshot ID
4818 # would identify the exact version of the snapshot that was used.
4819 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
4820 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
4821 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
4822 # https://storage.googleapis.com/. This flag is not optimized for creating
4823 # multiple disks from a source storage object. To create many disks from a
4824 # source storage object, use gcloud compute images
4825 # import instead.
4826 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
4827 #
4828 #
4829 # - CREATING: Disk is provisioning.
4830 # - RESTORING: Source data is being copied into the
4831 # disk.
4832 # - FAILED: Disk creation failed.
4833 # - READY: Disk is ready for use.
4834 # - DELETING: Disk is deleting.
4835 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
4836 # this as a partial or full URL to the resource. For example, the following
4837 # are valid values:
4838 #
4839 #
4840 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
4841 # - projects/project/zones/zone/storagePools/storagePool
4842 # - zones/zone/storagePools/storagePool
4843 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
4844 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
4845 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
4846 # types.
4847 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
4848 # in form:projects/project/zones/zone/instances/instance
4849 &quot;A String&quot;,
4850 ],
4851 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
4852 # You must specify this field as part of the HTTP request URL. It is
4853 # not settable as a field in the request body.
4854 }
4855
4856 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
4857 that if you must retry your request, the server will know to ignore the
4858 request if it has already been completed.
4859
4860 For example, consider a situation where you make an initial request and
4861 the request times out. If you make the request again with the same
4862 request ID, the server can check if original operation with the same
4863 request ID was received, and if so, will ignore the second request. This
4864 prevents clients from accidentally creating duplicate commitments.
4865
4866 The request ID must be
4867 a valid UUID with the exception that zero UUID is not supported
4868 (00000000-0000-0000-0000-000000000000).
4869 sourceImage: string, Source image to restore onto a disk. This field is optional.
4870 x__xgafv: string, V1 error format.
4871 Allowed values
4872 1 - v1 error format
4873 2 - v2 error format
4874
4875 Returns:
4876 An object of the form:
4877
4878 { # Represents an Operation resource.
4879 #
4880 # Google Compute Engine has three Operation resources:
4881 #
4882 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
4883 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
4884 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
4885 #
4886 # You can use an operation resource to manage asynchronous API requests.
4887 # For more information, readHandling
4888 # API responses.
4889 #
4890 # Operations can be global, regional or zonal.
4891 #
4892 # - For global operations, use the `globalOperations`
4893 # resource.
4894 # - For regional operations, use the
4895 # `regionOperations` resource.
4896 # - For zonal operations, use
4897 # the `zoneOperations` resource.
4898 #
4899 #
4900 #
4901 # For more information, read
4902 # Global, Regional, and Zonal Resources.
4903 #
4904 # Note that completed Operation resources have a limited
4905 # retention period.
4906 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4907 # Not present otherwise.
4908 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4909 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4910 # set when the operation is created.
4911 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4912 # text format.
4913 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4914 # this field will be populated.
4915 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4916 # operation.
4917 {
4918 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4919 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4920 # details. There is a set of defined message types to use for providing
4921 # details.The syntax depends on the error code. For example,
4922 # QuotaExceededInfo will have details when the error code is
4923 # QUOTA_EXCEEDED.
4924 {
4925 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4926 #
4927 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4928 # is not enabled:
4929 #
4930 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4931 # &quot;domain&quot;: &quot;googleapis.com&quot;
4932 # &quot;metadata&quot;: {
4933 # &quot;resource&quot;: &quot;projects/123&quot;,
4934 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4935 # }
4936 # }
4937 #
4938 # This response indicates that the pubsub.googleapis.com API is not enabled.
4939 #
4940 # Example of an error that is returned when attempting to create a Spanner
4941 # instance in a region that is out of stock:
4942 #
4943 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4944 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4945 # &quot;metadata&quot;: {
4946 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4947 # }
4948 # }
4949 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4950 # is typically the registered service name of the tool or product that
4951 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4952 # generated by some common infrastructure, the error domain must be a
4953 # globally unique value that identifies the infrastructure. For Google API
4954 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4955 &quot;metadatas&quot;: { # Additional structured details about this error.
4956 #
4957 # Keys must match a regular expression of `a-z+` but should
4958 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4959 # length. When identifying the current value of an exceeded limit, the units
4960 # should be contained in the key, not the value. For example, rather than
4961 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4962 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4963 # instances that can be created in a single (batch) request.
4964 &quot;a_key&quot;: &quot;A String&quot;,
4965 },
4966 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4967 # proximate cause of the error. Error reasons are unique within a particular
4968 # domain of errors. This should be at most 63 characters and match a
4969 # regular expression of `A-Z+[A-Z0-9]`, which represents
4970 # UPPER_SNAKE_CASE.
4971 },
4972 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4973 #
4974 # For example, if a quota check failed with an error indicating the calling
4975 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4976 # directly to the right place in the developer console to flip the bit.
4977 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4978 { # Describes a URL link.
4979 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4980 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4981 },
4982 ],
4983 },
4984 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4985 # which can be attached to an RPC error.
4986 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4987 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4988 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4989 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4990 },
4991 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4992 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4993 &quot;a_key&quot;: &quot;A String&quot;,
4994 },
4995 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4996 # type or metric.
4997 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4998 # or metric.
4999 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
5000 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
5001 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
5002 },
5003 },
5004 ],
5005 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
5006 # This property is optional.
5007 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
5008 },
5009 ],
5010 },
5011 &quot;getVersionOperationMetadata&quot;: {
5012 &quot;inlineSbomInfo&quot;: {
5013 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
5014 # appropriate identifiers.
5015 &quot;a_key&quot;: &quot;A String&quot;,
5016 },
5017 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
5018 # identifiers.
5019 &quot;a_key&quot;: &quot;A String&quot;,
5020 },
5021 },
5022 },
5023 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
5024 # message that was returned, such as `NOT FOUND`.
5025 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
5026 # status code that was returned. For example, a `404` means the
5027 # resource was not found.
5028 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
5029 # defined by the server.
5030 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
5031 # This value is inRFC3339
5032 # text format.
5033 &quot;instancesBulkInsertOperationMetadata&quot;: {
5034 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
5035 # Example key: zones/us-central1-a
5036 &quot;a_key&quot;: {
5037 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
5038 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
5039 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
5040 # error.
5041 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
5042 # if the flow is rolling forward or rolling back.
5043 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
5044 },
5045 },
5046 },
5047 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
5048 # Operation resources.
5049 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
5050 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
5051 # group of operations results from a `bulkInsert` API request.
5052 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
5053 # `update`, or `delete`, and so on.
5054 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
5055 # There is no requirement that this be linear or support any granularity of
5056 # operations. This should not be used to guess when the operation will be
5057 # complete. This number should monotonically increase as the operation
5058 # progresses.
5059 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
5060 # applicable when performing regional operations.
5061 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
5062 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
5063 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
5064 # this field will contain information on all underlying zonal actions and
5065 # their state.
5066 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
5067 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
5068 # Example key: zones/us-central1-a
5069 &quot;a_key&quot;: {
5070 &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
5071 # populated.
5072 # different programming environments, including REST APIs and RPC APIs. It is
5073 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
5074 # three pieces of data: error code, error message, and error details.
5075 #
5076 # You can find out more about this error model and how to work with it in the
5077 # [API Design Guide](https://cloud.google.com/apis/design/errors).
5078 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
5079 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
5080 # message types for APIs to use.
5081 {
5082 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
5083 },
5084 ],
5085 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
5086 # user-facing error message should be localized and sent in the
5087 # google.rpc.Status.details field, or localized by the client.
5088 },
5089 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
5090 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
5091 },
5092 },
5093 },
5094 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
5095 # This value is inRFC3339
5096 # text format.
5097 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
5098 # following:
5099 # `PENDING`, `RUNNING`, or `DONE`.
5100 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
5101 # operation.
5102 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
5103 # of the target resource.
5104 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
5105 # operations related to creating a snapshot, this points to the disk
5106 # that the snapshot was created from.
5107 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
5108 # `[email protected]` or
5109 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
5110 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
5111 # operation, this field will be populated.
5112 {
5113 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
5114 # Engine returns NO_RESULTS_ON_PAGE if there
5115 # are no results in the response.
5116 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
5117 # value format. For example:
5118 #
5119 # &quot;data&quot;: [
5120 # {
5121 # &quot;key&quot;: &quot;scope&quot;,
5122 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
5123 # }
5124 {
5125 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
5126 # returned. For example, for warnings where there are no results in a list
5127 # request for a particular zone, this key might be scope and
5128 # the key value might be the zone name. Other examples might be a key
5129 # indicating a deprecated resource and a suggested replacement, or a
5130 # warning about invalid network settings (for example, if an instance
5131 # attempts to perform IP forwarding but is not enabled for IP forwarding).
5132 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
5133 },
5134 ],
5135 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
5136 },
5137 ],
5138 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
5139 # applicable when performing per-zone operations.
5140 }</pre>
5141 </div>
5142
5143 <div class="method">
5144 <code class="details" id="list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
5145 <pre>Retrieves a list of persistent disks contained within
5146 the specified zone.
5147
5148 Args:
5149 project: string, Project ID for this request. (required)
5150 zone: string, The name of the zone for this request. (required)
5151 filter: string, A filter expression that filters resources listed in the response. Most
5152 Compute resources support two types of filter expressions:
5153 expressions that support regular expressions and expressions that follow
5154 API improvement proposal AIP-160.
5155 These two types of filter expressions cannot be mixed in one request.
5156
5157 If you want to use AIP-160, your expression must specify the field name, an
5158 operator, and the value that you want to use for filtering. The value
5159 must be a string, a number, or a boolean. The operator
5160 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
5161
5162 For example, if you are filtering Compute Engine instances, you can
5163 exclude instances named `example-instance` by specifying
5164 `name != example-instance`.
5165
5166 The `:*` comparison can be used to test whether a key has been defined.
5167 For example, to find all objects with `owner` label use:
5168 ```
5169 labels.owner:*
5170 ```
5171
5172 You can also filter nested fields. For example, you could specify
5173 `scheduling.automaticRestart = false` to include instances only
5174 if they are not scheduled for automatic restarts. You can use filtering
5175 on nested fields to filter based onresource labels.
5176
5177 To filter on multiple expressions, provide each separate expression within
5178 parentheses. For example:
5179 ```
5180 (scheduling.automaticRestart = true)
5181 (cpuPlatform = &quot;Intel Skylake&quot;)
5182 ```
5183 By default, each expression is an `AND` expression. However, you
5184 can include `AND` and `OR` expressions explicitly.
5185 For example:
5186 ```
5187 (cpuPlatform = &quot;Intel Skylake&quot;) OR
5188 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
5189 (scheduling.automaticRestart = true)
5190 ```
5191
5192 If you want to use a regular expression, use the `eq` (equal) or `ne`
5193 (not equal) operator against a single un-parenthesized expression with or
5194 without quotes or against multiple parenthesized expressions. Examples:
5195
5196 `fieldname eq unquoted literal`
5197 `fieldname eq &#x27;single quoted literal&#x27;`
5198 `fieldname eq &quot;double quoted literal&quot;`
5199 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
5200
5201 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
5202 The literal value must match the entire field.
5203
5204 For example, to filter for instances that do not end with name &quot;instance&quot;,
5205 you would use `name ne .*instance`.
5206
5207 You cannot combine constraints on multiple fields using regular
5208 expressions.
5209 maxResults: integer, The maximum number of results per page that should be returned.
5210 If the number of available results is larger than `maxResults`,
5211 Compute Engine returns a `nextPageToken` that can be used to get
5212 the next page of results in subsequent list requests. Acceptable values are
5213 `0` to `500`, inclusive. (Default: `500`)
5214 orderBy: string, Sorts list results by a certain order. By default, results
5215 are returned in alphanumerical order based on the resource name.
5216
5217 You can also sort results in descending order based on the creation
5218 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
5219 results based on the `creationTimestamp` field in
5220 reverse chronological order (newest result first). Use this to sort
5221 resources like operations so that the newest operation is returned first.
5222
5223 Currently, only sorting by `name` or
5224 `creationTimestamp desc` is supported.
5225 pageToken: string, Specifies a page token to use. Set `pageToken` to the
5226 `nextPageToken` returned by a previous list request to get
5227 the next page of results.
5228 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
5229 of failure. The default value is false.
5230
5231 For example, when partial success behavior is enabled, aggregatedList for a
5232 single zone scope either returns all resources in the zone or no resources,
5233 with an error code.
5234 x__xgafv: string, V1 error format.
5235 Allowed values
5236 1 - v1 error format
5237 2 - v2 error format
5238
5239 Returns:
5240 An object of the form:
5241
5242 { # A list of Disk resources.
5243 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
5244 &quot;items&quot;: [ # A list of Disk resources.
5245 { # Represents a Persistent Disk resource.
5246 #
5247 # Google Compute Engine has two Disk resources:
5248 #
5249 # * [Zonal](/compute/docs/reference/rest/alpha/disks)
5250 # * [Regional](/compute/docs/reference/rest/alpha/regionDisks)
5251 #
5252 # Persistent disks are required for running your VM instances.
5253 # Create both boot and non-boot (data) persistent disks. For more information,
5254 # read Persistent Disks. For more
5255 # storage options, read Storage options.
5256 #
5257 # The disks resource represents a zonal persistent disk.
5258 # For more information, readZonal persistent disks.
5259 #
5260 # The regionDisks resource represents a
5261 # regional persistent disk. For more information, read
5262 # Regional resources.
5263 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
5264 #
5265 #
5266 # - READ_WRITE_SINGLE: The default AccessMode, means the
5267 # disk can be attached to single instance in RW mode.
5268 # - READ_WRITE_MANY: The AccessMode means the disk can be
5269 # attached to multiple instances in RW mode.
5270 # - READ_ONLY_MANY: The AccessMode means the disk can be
5271 # attached to multiple instances in RO mode.
5272 #
5273 #
5274 # The AccessMode is only valid for Hyperdisk disk types.
5275 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
5276 # ARM64 or X86_64.
5277 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
5278 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
5279 # started on the disk as a member of a group.
5280 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
5281 # started on the disk as a member of a group.
5282 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
5283 # You can provide this as a partial or full URL to the resource.
5284 # For example, the following are valid values:
5285 #
5286 #
5287 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
5288 # - projects/project/zones/zone/disks/disk
5289 # - zones/zone/disks/disk
5290 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
5291 # to or from the current disk. This value identifies the exact disk that
5292 # was used to create this replication. For example, if you started
5293 # replicating the persistent disk from a disk that was later deleted and
5294 # recreated under the same name, the disk ID would identify the exact
5295 # version of the disk that was used.
5296 },
5297 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
5298 &quot;a_key&quot;: {
5299 &quot;asyncReplicationDisk&quot;: {
5300 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
5301 # started on the disk as a member of a group.
5302 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
5303 # started on the disk as a member of a group.
5304 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
5305 # You can provide this as a partial or full URL to the resource.
5306 # For example, the following are valid values:
5307 #
5308 #
5309 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
5310 # - projects/project/zones/zone/disks/disk
5311 # - zones/zone/disks/disk
5312 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
5313 # to or from the current disk. This value identifies the exact disk that
5314 # was used to create this replication. For example, if you started
5315 # replicating the persistent disk from a disk that was later deleted and
5316 # recreated under the same name, the disk ID would identify the exact
5317 # version of the disk that was used.
5318 },
5319 },
5320 },
5321 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
5322 # text format.
5323 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
5324 # create the resource.
5325 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
5326 # customer-supplied encryption key or a
5327 # customer-managed encryption key.
5328 #
5329 # Encryption keys do not protect access to metadata of the disk.
5330 #
5331 # After you encrypt a disk with a customer-supplied key, you must provide the
5332 # same key if you use the disk later. For example, to create a disk snapshot,
5333 # to create a disk image, to create a machine image, or to attach the disk to
5334 # a virtual machine.
5335 #
5336 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
5337 # name once the disk is created. The disk is encrypted with this version of
5338 # the key. In the response, diskEncryptionKey.kmsKeyName appears
5339 # in the following format:
5340 #
5341 # &quot;diskEncryptionKey.kmsKeyName&quot;:
5342 # &quot;projects/kms_project_id/locations/region/keyRings/
5343 # key_region/cryptoKeys/key
5344 # /cryptoKeysVersions/version
5345 #
5346 # If you do not provide an encryption key when creating the disk, then the
5347 # disk is encrypted using an automatically generated key and you don&#x27;t need
5348 # to provide a key to use the disk later.
5349 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5350 # For example:
5351 #
5352 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5353 # key_region/cryptoKeys/key
5354 #
5355 # The fully-qualifed key name may be returned for resource GET requests. For
5356 # example:
5357 #
5358 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5359 # key_region/cryptoKeys/key
5360 # /cryptoKeyVersions/1
5361 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5362 # key. If absent, the Compute Engine default service account is used.
5363 # For example:
5364 #
5365 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5366 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5367 # encryption key, encoded in RFC
5368 # 4648 base64 to either encrypt or decrypt this resource. You can
5369 # provide either the rawKey or thersaEncryptedKey.
5370 # For example:
5371 #
5372 # &quot;rawKey&quot;:
5373 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5374 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5375 # customer-supplied encryption key to either encrypt or decrypt this
5376 # resource. You can provide either the rawKey or thersaEncryptedKey.
5377 # For example:
5378 #
5379 # &quot;rsaEncryptedKey&quot;:
5380 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5381 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5382 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5383 #
5384 # The key must meet the following requirements before you can provide it to
5385 # Compute Engine:
5386 #
5387 # 1. The key is wrapped using a RSA public key certificate provided by
5388 # Google.
5389 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5390 # encoding.
5391 #
5392 # Gets the RSA public key certificate provided by Google at:
5393 #
5394 #
5395 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5396 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5397 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5398 # encryption key that protects this resource.
5399 },
5400 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
5401 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
5402 # Windows specific VSS signature.
5403 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5404 # only for bootable images. Read
5405 # Enabling guest operating system features to see a list of available
5406 # options.
5407 { # Guest OS features.
5408 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5409 # separate values. Set to one or more of the following values:
5410 #
5411 # - VIRTIO_SCSI_MULTIQUEUE
5412 # - WINDOWS
5413 # - MULTI_IP_SUBNET
5414 # - UEFI_COMPATIBLE
5415 # - GVNIC
5416 # - SEV_CAPABLE
5417 # - SUSPEND_RESUME_COMPATIBLE
5418 # - SEV_LIVE_MIGRATABLE_V2
5419 # - SEV_SNP_CAPABLE
5420 # - TDX_CAPABLE
5421 # - IDPF
5422 # - SNP_SVSM_CAPABLE
5423 # - CCA_CAPABLE
5424 #
5425 #
5426 # For more information, see
5427 # Enabling guest operating system features.
5428 },
5429 ],
5430 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
5431 # defined by the server.
5432 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
5433 # which is either SCSI or NVME. The default isSCSI.
5434 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
5435 # disks.
5436 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
5437 # essentially a hash of the labels set used for optimistic locking. The
5438 # fingerprint is initially generated by Compute Engine and changes after
5439 # every request to modify or update labels. You must always provide an
5440 # up-to-date fingerprint hash in order to update or change labels,
5441 # otherwise the request will fail with error412 conditionNotMet.
5442 #
5443 # To see the latest fingerprint, make a get() request to
5444 # retrieve a disk.
5445 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
5446 # the setLabels method.
5447 &quot;a_key&quot;: &quot;A String&quot;,
5448 },
5449 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
5450 # text format.
5451 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
5452 # text format.
5453 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
5454 &quot;A String&quot;,
5455 ],
5456 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
5457 &quot;A String&quot;,
5458 ],
5459 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
5460 # This field is for use by internal tools that use the public API.
5461 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
5462 # source image. Attachment of a disk created from a locked source image will
5463 # cause the following operations to become irreversibly prohibited:
5464 #
5465 # - R/W or R/O disk attachment to any other instance
5466 # - Disk detachment. And the disk can only be deleted when the instance
5467 # is deleted
5468 # - Creation of images or snapshots
5469 # - Disk cloning
5470 #
5471 #
5472 #
5473 # Furthermore, the instance with at least one disk with locked flag set to
5474 # true will be prohibited from performing the operations below:
5475 #
5476 # - Further attachment of secondary disks.
5477 # - Detachment of any disks
5478 # - Create machine images
5479 # - Create instance template
5480 # - Delete the instance with --keep-disk parameter set to true for locked
5481 # disks
5482 # - Attach a locked disk with --auto-delete parameter set to false
5483 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
5484 # more than one instance.
5485 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
5486 # The name must be 1-63 characters long, and comply withRFC1035.
5487 # Specifically, the name must be 1-63 characters long and match the regular
5488 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
5489 # which means the first character must be a lowercase letter, and all
5490 # following characters must be a dash, lowercase letter, or digit, except
5491 # the last character, which cannot be a dash.
5492 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
5493 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
5494 # as part of resource payload.
5495 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
5496 # have the same definition as resource
5497 # manager tags. Keys and values can be either in numeric format,
5498 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
5499 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
5500 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
5501 # PATCH) when empty.
5502 &quot;a_key&quot;: &quot;A String&quot;,
5503 },
5504 },
5505 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
5506 # If not present in a request, a default value is used.
5507 # The currently supported size is 4096, other sizes may be added in
5508 # the future.
5509 # If an unsupported value is requested, the error message will list
5510 # the supported values for the caller&#x27;s project.
5511 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
5512 # of I/O operations per second that the disk can handle. Values must be
5513 # between 10,000 and 120,000. For more details, see theExtreme persistent
5514 # disk documentation.
5515 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
5516 # number of throughput mb per second that the disk can handle. Values must be
5517 # greater than or equal to 1.
5518 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
5519 # regional resources.
5520 # You must specify this field as part of the HTTP request URL. It is
5521 # not settable as a field in the request body.
5522 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
5523 # for regional resources.
5524 &quot;A String&quot;,
5525 ],
5526 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
5527 &quot;A String&quot;,
5528 ],
5529 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
5530 &quot;asyncPrimaryDisk&quot;: {
5531 &quot;state&quot;: &quot;A String&quot;,
5532 },
5533 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
5534 &quot;a_key&quot;: {
5535 &quot;state&quot;: &quot;A String&quot;,
5536 },
5537 },
5538 &quot;usedBytes&quot;: &quot;A String&quot;, # [Output Only] Space used by data stored in the disk (in bytes). Note that
5539 # this field is set only when the disk is in a storage pool.
5540 },
5541 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
5542 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
5543 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
5544 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
5545 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
5546 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
5547 # persistent disk.
5548 #
5549 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
5550 # source.
5551 # Acceptable values are greater than 0.
5552 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
5553 # that was created using a consistency group.
5554 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
5555 # that was created using a consistency group.
5556 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
5557 # partial or full URL to the resource. For example, the following are valid
5558 # values:
5559 #
5560 #
5561 # -
5562 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
5563 #
5564 # -
5565 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
5566 #
5567 # -
5568 # projects/project/zones/zone/disks/disk
5569 #
5570 # -
5571 # projects/project/regions/region/disks/disk
5572 #
5573 # -
5574 # zones/zone/disks/disk
5575 #
5576 # -
5577 # regions/region/disks/disk
5578 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
5579 # value identifies the exact disk that was used to create this persistent
5580 # disk. For example, if you created the persistent disk from a disk that
5581 # was later deleted and recreated under the same name, the source disk ID
5582 # would identify the exact version of the disk that was used.
5583 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
5584 # deleted, this field will not be set.
5585 #
5586 # To create a disk with one of the public operating system images, specify
5587 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
5588 #
5589 # projects/debian-cloud/global/images/family/debian-9
5590 #
5591 #
5592 # Alternatively, use a specific version of a public operating system image:
5593 #
5594 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
5595 #
5596 #
5597 # To create a disk with a custom image that you created, specify the
5598 # image name in the following format:
5599 #
5600 # global/images/my-custom-image
5601 #
5602 #
5603 # You can also specify a custom image by its image family, which returns
5604 # the latest version of the image in that family. Replace the image name
5605 # with family/family-name:
5606 #
5607 # global/images/family/my-image-family
5608 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
5609 # encryption key of the source image. Required if the source image is
5610 # protected by a customer-supplied encryption key.
5611 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5612 # For example:
5613 #
5614 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5615 # key_region/cryptoKeys/key
5616 #
5617 # The fully-qualifed key name may be returned for resource GET requests. For
5618 # example:
5619 #
5620 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5621 # key_region/cryptoKeys/key
5622 # /cryptoKeyVersions/1
5623 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5624 # key. If absent, the Compute Engine default service account is used.
5625 # For example:
5626 #
5627 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5628 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5629 # encryption key, encoded in RFC
5630 # 4648 base64 to either encrypt or decrypt this resource. You can
5631 # provide either the rawKey or thersaEncryptedKey.
5632 # For example:
5633 #
5634 # &quot;rawKey&quot;:
5635 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5636 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5637 # customer-supplied encryption key to either encrypt or decrypt this
5638 # resource. You can provide either the rawKey or thersaEncryptedKey.
5639 # For example:
5640 #
5641 # &quot;rsaEncryptedKey&quot;:
5642 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5643 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5644 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5645 #
5646 # The key must meet the following requirements before you can provide it to
5647 # Compute Engine:
5648 #
5649 # 1. The key is wrapped using a RSA public key certificate provided by
5650 # Google.
5651 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5652 # encoding.
5653 #
5654 # Gets the RSA public key certificate provided by Google at:
5655 #
5656 #
5657 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5658 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5659 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5660 # encryption key that protects this resource.
5661 },
5662 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
5663 # value identifies the exact image that was used to create this persistent
5664 # disk. For example, if you created the persistent disk from an image that
5665 # was later deleted and recreated under the same name, the source image ID
5666 # would identify the exact version of the image that was used.
5667 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
5668 # this as a partial or full URL to the resource. For example, the following
5669 # are valid values:
5670 #
5671 #
5672 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
5673 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
5674 # - zones/zone/instantSnapshots/instantSnapshot
5675 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
5676 # disk. This value identifies the exact instant snapshot that was used to
5677 # create this persistent disk. For example, if you created the persistent
5678 # disk from an instant snapshot that was later deleted and recreated under
5679 # the same name, the source instant snapshot ID would identify the exact
5680 # version of the instant snapshot that was used.
5681 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
5682 # partial or full URL to the resource. For example, the following are valid
5683 # values:
5684 #
5685 #
5686 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
5687 # - projects/project/global/machineImages/machineImage
5688 # - global/machineImages/machineImage
5689 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
5690 # source_machine_image must be specified.
5691 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
5692 # encryption key of the source machine image. Required if the source
5693 # machine image is protected by a customer-supplied encryption key.
5694 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5695 # For example:
5696 #
5697 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5698 # key_region/cryptoKeys/key
5699 #
5700 # The fully-qualifed key name may be returned for resource GET requests. For
5701 # example:
5702 #
5703 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5704 # key_region/cryptoKeys/key
5705 # /cryptoKeyVersions/1
5706 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5707 # key. If absent, the Compute Engine default service account is used.
5708 # For example:
5709 #
5710 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5711 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5712 # encryption key, encoded in RFC
5713 # 4648 base64 to either encrypt or decrypt this resource. You can
5714 # provide either the rawKey or thersaEncryptedKey.
5715 # For example:
5716 #
5717 # &quot;rawKey&quot;:
5718 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5719 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5720 # customer-supplied encryption key to either encrypt or decrypt this
5721 # resource. You can provide either the rawKey or thersaEncryptedKey.
5722 # For example:
5723 #
5724 # &quot;rsaEncryptedKey&quot;:
5725 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5726 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5727 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5728 #
5729 # The key must meet the following requirements before you can provide it to
5730 # Compute Engine:
5731 #
5732 # 1. The key is wrapped using a RSA public key certificate provided by
5733 # Google.
5734 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5735 # encoding.
5736 #
5737 # Gets the RSA public key certificate provided by Google at:
5738 #
5739 #
5740 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5741 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5742 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5743 # encryption key that protects this resource.
5744 },
5745 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
5746 # This value identifies the exact machine image that was used to create this
5747 # persistent disk. For example, if you created the persistent disk from a
5748 # machine image that was later deleted and recreated under the same name, the
5749 # source machine image ID would identify the exact version of the machine
5750 # image that was used.
5751 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
5752 # partial or full URL to the resource. For example, the following are valid
5753 # values:
5754 #
5755 #
5756 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
5757 # - projects/project/global/snapshots/snapshot
5758 # - global/snapshots/snapshot
5759 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
5760 # encryption key of the source snapshot. Required if the source snapshot
5761 # is protected by a customer-supplied encryption key.
5762 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5763 # For example:
5764 #
5765 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5766 # key_region/cryptoKeys/key
5767 #
5768 # The fully-qualifed key name may be returned for resource GET requests. For
5769 # example:
5770 #
5771 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5772 # key_region/cryptoKeys/key
5773 # /cryptoKeyVersions/1
5774 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5775 # key. If absent, the Compute Engine default service account is used.
5776 # For example:
5777 #
5778 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5779 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5780 # encryption key, encoded in RFC
5781 # 4648 base64 to either encrypt or decrypt this resource. You can
5782 # provide either the rawKey or thersaEncryptedKey.
5783 # For example:
5784 #
5785 # &quot;rawKey&quot;:
5786 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5787 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5788 # customer-supplied encryption key to either encrypt or decrypt this
5789 # resource. You can provide either the rawKey or thersaEncryptedKey.
5790 # For example:
5791 #
5792 # &quot;rsaEncryptedKey&quot;:
5793 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5794 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5795 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5796 #
5797 # The key must meet the following requirements before you can provide it to
5798 # Compute Engine:
5799 #
5800 # 1. The key is wrapped using a RSA public key certificate provided by
5801 # Google.
5802 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5803 # encoding.
5804 #
5805 # Gets the RSA public key certificate provided by Google at:
5806 #
5807 #
5808 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5809 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5810 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5811 # encryption key that protects this resource.
5812 },
5813 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
5814 # value identifies the exact snapshot that was used to create this persistent
5815 # disk. For example, if you created the persistent disk from a snapshot that
5816 # was later deleted and recreated under the same name, the source snapshot ID
5817 # would identify the exact version of the snapshot that was used.
5818 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
5819 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
5820 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
5821 # https://storage.googleapis.com/. This flag is not optimized for creating
5822 # multiple disks from a source storage object. To create many disks from a
5823 # source storage object, use gcloud compute images
5824 # import instead.
5825 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
5826 #
5827 #
5828 # - CREATING: Disk is provisioning.
5829 # - RESTORING: Source data is being copied into the
5830 # disk.
5831 # - FAILED: Disk creation failed.
5832 # - READY: Disk is ready for use.
5833 # - DELETING: Disk is deleting.
5834 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
5835 # this as a partial or full URL to the resource. For example, the following
5836 # are valid values:
5837 #
5838 #
5839 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
5840 # - projects/project/zones/zone/storagePools/storagePool
5841 # - zones/zone/storagePools/storagePool
5842 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
5843 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
5844 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
5845 # types.
5846 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
5847 # in form:projects/project/zones/zone/instances/instance
5848 &quot;A String&quot;,
5849 ],
5850 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
5851 # You must specify this field as part of the HTTP request URL. It is
5852 # not settable as a field in the request body.
5853 },
5854 ],
5855 &quot;kind&quot;: &quot;compute#diskList&quot;, # Output only. [Output Only] Type of resource. Always compute#diskList for
5856 # lists of disks.
5857 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
5858 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
5859 # the query parameter pageToken in the next list request.
5860 # Subsequent list requests will have their own nextPageToken to
5861 # continue paging through the results.
5862 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
5863 &quot;warning&quot;: { # [Output Only] Informational warning message.
5864 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
5865 # Engine returns NO_RESULTS_ON_PAGE if there
5866 # are no results in the response.
5867 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
5868 # value format. For example:
5869 #
5870 # &quot;data&quot;: [
5871 # {
5872 # &quot;key&quot;: &quot;scope&quot;,
5873 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
5874 # }
5875 {
5876 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
5877 # returned. For example, for warnings where there are no results in a list
5878 # request for a particular zone, this key might be scope and
5879 # the key value might be the zone name. Other examples might be a key
5880 # indicating a deprecated resource and a suggested replacement, or a
5881 # warning about invalid network settings (for example, if an instance
5882 # attempts to perform IP forwarding but is not enabled for IP forwarding).
5883 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
5884 },
5885 ],
5886 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
5887 },
5888 }</pre>
5889 </div>
5890
5891 <div class="method">
5892 <code class="details" id="list_next">list_next()</code>
5893 <pre>Retrieves the next page of results.
5894
5895 Args:
5896 previous_request: The request for the previous page. (required)
5897 previous_response: The response from the request for the previous page. (required)
5898
5899 Returns:
5900 A request object that you can call &#x27;execute()&#x27; on to request the next
5901 page. Returns None if there are no more items in the collection.
5902 </pre>
5903 </div>
5904
5905 <div class="method">
5906 <code class="details" id="removeResourcePolicies">removeResourcePolicies(project, zone, disk, body=None, requestId=None, x__xgafv=None)</code>
5907 <pre>Removes resource policies from a disk.
5908
5909 Args:
5910 project: string, Project ID for this request. (required)
5911 zone: string, The name of the zone for this request. (required)
5912 disk: string, The disk name for this request. (required)
5913 body: object, The request body.
5914 The object takes the form of:
5915
5916 {
5917 &quot;resourcePolicies&quot;: [ # Resource policies to be removed from this disk.
5918 &quot;A String&quot;,
5919 ],
5920 }
5921
5922 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
5923 that if you must retry your request, the server will know to ignore the
5924 request if it has already been completed.
5925
5926 For example, consider a situation where you make an initial request and
5927 the request times out. If you make the request again with the same
5928 request ID, the server can check if original operation with the same
5929 request ID was received, and if so, will ignore the second request. This
5930 prevents clients from accidentally creating duplicate commitments.
5931
5932 The request ID must be
5933 a valid UUID with the exception that zero UUID is not supported
5934 (00000000-0000-0000-0000-000000000000).
5935 x__xgafv: string, V1 error format.
5936 Allowed values
5937 1 - v1 error format
5938 2 - v2 error format
5939
5940 Returns:
5941 An object of the form:
5942
5943 { # Represents an Operation resource.
5944 #
5945 # Google Compute Engine has three Operation resources:
5946 #
5947 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
5948 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
5949 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
5950 #
5951 # You can use an operation resource to manage asynchronous API requests.
5952 # For more information, readHandling
5953 # API responses.
5954 #
5955 # Operations can be global, regional or zonal.
5956 #
5957 # - For global operations, use the `globalOperations`
5958 # resource.
5959 # - For regional operations, use the
5960 # `regionOperations` resource.
5961 # - For zonal operations, use
5962 # the `zoneOperations` resource.
5963 #
5964 #
5965 #
5966 # For more information, read
5967 # Global, Regional, and Zonal Resources.
5968 #
5969 # Note that completed Operation resources have a limited
5970 # retention period.
5971 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
5972 # Not present otherwise.
5973 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
5974 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
5975 # set when the operation is created.
5976 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
5977 # text format.
5978 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
5979 # this field will be populated.
5980 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
5981 # operation.
5982 {
5983 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
5984 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
5985 # details. There is a set of defined message types to use for providing
5986 # details.The syntax depends on the error code. For example,
5987 # QuotaExceededInfo will have details when the error code is
5988 # QUOTA_EXCEEDED.
5989 {
5990 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
5991 #
5992 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
5993 # is not enabled:
5994 #
5995 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
5996 # &quot;domain&quot;: &quot;googleapis.com&quot;
5997 # &quot;metadata&quot;: {
5998 # &quot;resource&quot;: &quot;projects/123&quot;,
5999 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6000 # }
6001 # }
6002 #
6003 # This response indicates that the pubsub.googleapis.com API is not enabled.
6004 #
6005 # Example of an error that is returned when attempting to create a Spanner
6006 # instance in a region that is out of stock:
6007 #
6008 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6009 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6010 # &quot;metadata&quot;: {
6011 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6012 # }
6013 # }
6014 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6015 # is typically the registered service name of the tool or product that
6016 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6017 # generated by some common infrastructure, the error domain must be a
6018 # globally unique value that identifies the infrastructure. For Google API
6019 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6020 &quot;metadatas&quot;: { # Additional structured details about this error.
6021 #
6022 # Keys must match a regular expression of `a-z+` but should
6023 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6024 # length. When identifying the current value of an exceeded limit, the units
6025 # should be contained in the key, not the value. For example, rather than
6026 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6027 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6028 # instances that can be created in a single (batch) request.
6029 &quot;a_key&quot;: &quot;A String&quot;,
6030 },
6031 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6032 # proximate cause of the error. Error reasons are unique within a particular
6033 # domain of errors. This should be at most 63 characters and match a
6034 # regular expression of `A-Z+[A-Z0-9]`, which represents
6035 # UPPER_SNAKE_CASE.
6036 },
6037 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6038 #
6039 # For example, if a quota check failed with an error indicating the calling
6040 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6041 # directly to the right place in the developer console to flip the bit.
6042 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6043 { # Describes a URL link.
6044 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6045 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6046 },
6047 ],
6048 },
6049 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6050 # which can be attached to an RPC error.
6051 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6052 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6053 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6054 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6055 },
6056 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6057 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6058 &quot;a_key&quot;: &quot;A String&quot;,
6059 },
6060 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6061 # type or metric.
6062 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6063 # or metric.
6064 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6065 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6066 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6067 },
6068 },
6069 ],
6070 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6071 # This property is optional.
6072 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6073 },
6074 ],
6075 },
6076 &quot;getVersionOperationMetadata&quot;: {
6077 &quot;inlineSbomInfo&quot;: {
6078 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6079 # appropriate identifiers.
6080 &quot;a_key&quot;: &quot;A String&quot;,
6081 },
6082 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6083 # identifiers.
6084 &quot;a_key&quot;: &quot;A String&quot;,
6085 },
6086 },
6087 },
6088 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6089 # message that was returned, such as `NOT FOUND`.
6090 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6091 # status code that was returned. For example, a `404` means the
6092 # resource was not found.
6093 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6094 # defined by the server.
6095 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6096 # This value is inRFC3339
6097 # text format.
6098 &quot;instancesBulkInsertOperationMetadata&quot;: {
6099 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6100 # Example key: zones/us-central1-a
6101 &quot;a_key&quot;: {
6102 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6103 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6104 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6105 # error.
6106 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6107 # if the flow is rolling forward or rolling back.
6108 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6109 },
6110 },
6111 },
6112 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6113 # Operation resources.
6114 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6115 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6116 # group of operations results from a `bulkInsert` API request.
6117 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6118 # `update`, or `delete`, and so on.
6119 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6120 # There is no requirement that this be linear or support any granularity of
6121 # operations. This should not be used to guess when the operation will be
6122 # complete. This number should monotonically increase as the operation
6123 # progresses.
6124 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6125 # applicable when performing regional operations.
6126 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6127 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
6128 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6129 # this field will contain information on all underlying zonal actions and
6130 # their state.
6131 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6132 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6133 # Example key: zones/us-central1-a
6134 &quot;a_key&quot;: {
6135 &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
6136 # populated.
6137 # different programming environments, including REST APIs and RPC APIs. It is
6138 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6139 # three pieces of data: error code, error message, and error details.
6140 #
6141 # You can find out more about this error model and how to work with it in the
6142 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6143 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6144 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6145 # message types for APIs to use.
6146 {
6147 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6148 },
6149 ],
6150 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6151 # user-facing error message should be localized and sent in the
6152 # google.rpc.Status.details field, or localized by the client.
6153 },
6154 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6155 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6156 },
6157 },
6158 },
6159 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6160 # This value is inRFC3339
6161 # text format.
6162 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6163 # following:
6164 # `PENDING`, `RUNNING`, or `DONE`.
6165 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6166 # operation.
6167 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6168 # of the target resource.
6169 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6170 # operations related to creating a snapshot, this points to the disk
6171 # that the snapshot was created from.
6172 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6173 # `[email protected]` or
6174 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6175 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6176 # operation, this field will be populated.
6177 {
6178 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6179 # Engine returns NO_RESULTS_ON_PAGE if there
6180 # are no results in the response.
6181 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6182 # value format. For example:
6183 #
6184 # &quot;data&quot;: [
6185 # {
6186 # &quot;key&quot;: &quot;scope&quot;,
6187 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6188 # }
6189 {
6190 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6191 # returned. For example, for warnings where there are no results in a list
6192 # request for a particular zone, this key might be scope and
6193 # the key value might be the zone name. Other examples might be a key
6194 # indicating a deprecated resource and a suggested replacement, or a
6195 # warning about invalid network settings (for example, if an instance
6196 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6197 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6198 },
6199 ],
6200 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6201 },
6202 ],
6203 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6204 # applicable when performing per-zone operations.
6205 }</pre>
6206 </div>
6207
6208 <div class="method">
6209 <code class="details" id="resize">resize(project, zone, disk, body=None, requestId=None, x__xgafv=None)</code>
6210 <pre>Resizes the specified persistent disk.
6211 You can only increase the size of the disk.
6212
6213 Args:
6214 project: string, Project ID for this request. (required)
6215 zone: string, The name of the zone for this request. (required)
6216 disk: string, The name of the persistent disk. (required)
6217 body: object, The request body.
6218 The object takes the form of:
6219
6220 {
6221 &quot;sizeGb&quot;: &quot;A String&quot;, # The new size of the persistent disk, which is specified in GB.
6222 }
6223
6224 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6225 that if you must retry your request, the server will know to ignore the
6226 request if it has already been completed.
6227
6228 For example, consider a situation where you make an initial request and
6229 the request times out. If you make the request again with the same
6230 request ID, the server can check if original operation with the same
6231 request ID was received, and if so, will ignore the second request. This
6232 prevents clients from accidentally creating duplicate commitments.
6233
6234 The request ID must be
6235 a valid UUID with the exception that zero UUID is not supported
6236 (00000000-0000-0000-0000-000000000000).
6237 x__xgafv: string, V1 error format.
6238 Allowed values
6239 1 - v1 error format
6240 2 - v2 error format
6241
6242 Returns:
6243 An object of the form:
6244
6245 { # Represents an Operation resource.
6246 #
6247 # Google Compute Engine has three Operation resources:
6248 #
6249 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
6250 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
6251 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
6252 #
6253 # You can use an operation resource to manage asynchronous API requests.
6254 # For more information, readHandling
6255 # API responses.
6256 #
6257 # Operations can be global, regional or zonal.
6258 #
6259 # - For global operations, use the `globalOperations`
6260 # resource.
6261 # - For regional operations, use the
6262 # `regionOperations` resource.
6263 # - For zonal operations, use
6264 # the `zoneOperations` resource.
6265 #
6266 #
6267 #
6268 # For more information, read
6269 # Global, Regional, and Zonal Resources.
6270 #
6271 # Note that completed Operation resources have a limited
6272 # retention period.
6273 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6274 # Not present otherwise.
6275 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6276 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6277 # set when the operation is created.
6278 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6279 # text format.
6280 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6281 # this field will be populated.
6282 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6283 # operation.
6284 {
6285 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6286 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6287 # details. There is a set of defined message types to use for providing
6288 # details.The syntax depends on the error code. For example,
6289 # QuotaExceededInfo will have details when the error code is
6290 # QUOTA_EXCEEDED.
6291 {
6292 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6293 #
6294 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6295 # is not enabled:
6296 #
6297 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6298 # &quot;domain&quot;: &quot;googleapis.com&quot;
6299 # &quot;metadata&quot;: {
6300 # &quot;resource&quot;: &quot;projects/123&quot;,
6301 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6302 # }
6303 # }
6304 #
6305 # This response indicates that the pubsub.googleapis.com API is not enabled.
6306 #
6307 # Example of an error that is returned when attempting to create a Spanner
6308 # instance in a region that is out of stock:
6309 #
6310 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6311 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6312 # &quot;metadata&quot;: {
6313 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6314 # }
6315 # }
6316 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6317 # is typically the registered service name of the tool or product that
6318 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6319 # generated by some common infrastructure, the error domain must be a
6320 # globally unique value that identifies the infrastructure. For Google API
6321 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6322 &quot;metadatas&quot;: { # Additional structured details about this error.
6323 #
6324 # Keys must match a regular expression of `a-z+` but should
6325 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6326 # length. When identifying the current value of an exceeded limit, the units
6327 # should be contained in the key, not the value. For example, rather than
6328 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6329 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6330 # instances that can be created in a single (batch) request.
6331 &quot;a_key&quot;: &quot;A String&quot;,
6332 },
6333 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6334 # proximate cause of the error. Error reasons are unique within a particular
6335 # domain of errors. This should be at most 63 characters and match a
6336 # regular expression of `A-Z+[A-Z0-9]`, which represents
6337 # UPPER_SNAKE_CASE.
6338 },
6339 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6340 #
6341 # For example, if a quota check failed with an error indicating the calling
6342 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6343 # directly to the right place in the developer console to flip the bit.
6344 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6345 { # Describes a URL link.
6346 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6347 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6348 },
6349 ],
6350 },
6351 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6352 # which can be attached to an RPC error.
6353 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6354 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6355 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6356 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6357 },
6358 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6359 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6360 &quot;a_key&quot;: &quot;A String&quot;,
6361 },
6362 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6363 # type or metric.
6364 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6365 # or metric.
6366 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6367 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6368 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6369 },
6370 },
6371 ],
6372 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6373 # This property is optional.
6374 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6375 },
6376 ],
6377 },
6378 &quot;getVersionOperationMetadata&quot;: {
6379 &quot;inlineSbomInfo&quot;: {
6380 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6381 # appropriate identifiers.
6382 &quot;a_key&quot;: &quot;A String&quot;,
6383 },
6384 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6385 # identifiers.
6386 &quot;a_key&quot;: &quot;A String&quot;,
6387 },
6388 },
6389 },
6390 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6391 # message that was returned, such as `NOT FOUND`.
6392 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6393 # status code that was returned. For example, a `404` means the
6394 # resource was not found.
6395 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6396 # defined by the server.
6397 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6398 # This value is inRFC3339
6399 # text format.
6400 &quot;instancesBulkInsertOperationMetadata&quot;: {
6401 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6402 # Example key: zones/us-central1-a
6403 &quot;a_key&quot;: {
6404 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6405 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6406 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6407 # error.
6408 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6409 # if the flow is rolling forward or rolling back.
6410 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6411 },
6412 },
6413 },
6414 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6415 # Operation resources.
6416 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6417 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6418 # group of operations results from a `bulkInsert` API request.
6419 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6420 # `update`, or `delete`, and so on.
6421 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6422 # There is no requirement that this be linear or support any granularity of
6423 # operations. This should not be used to guess when the operation will be
6424 # complete. This number should monotonically increase as the operation
6425 # progresses.
6426 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6427 # applicable when performing regional operations.
6428 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6429 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
6430 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6431 # this field will contain information on all underlying zonal actions and
6432 # their state.
6433 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6434 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6435 # Example key: zones/us-central1-a
6436 &quot;a_key&quot;: {
6437 &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
6438 # populated.
6439 # different programming environments, including REST APIs and RPC APIs. It is
6440 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6441 # three pieces of data: error code, error message, and error details.
6442 #
6443 # You can find out more about this error model and how to work with it in the
6444 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6445 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6446 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6447 # message types for APIs to use.
6448 {
6449 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6450 },
6451 ],
6452 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6453 # user-facing error message should be localized and sent in the
6454 # google.rpc.Status.details field, or localized by the client.
6455 },
6456 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6457 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6458 },
6459 },
6460 },
6461 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6462 # This value is inRFC3339
6463 # text format.
6464 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6465 # following:
6466 # `PENDING`, `RUNNING`, or `DONE`.
6467 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6468 # operation.
6469 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6470 # of the target resource.
6471 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6472 # operations related to creating a snapshot, this points to the disk
6473 # that the snapshot was created from.
6474 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6475 # `[email protected]` or
6476 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6477 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6478 # operation, this field will be populated.
6479 {
6480 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6481 # Engine returns NO_RESULTS_ON_PAGE if there
6482 # are no results in the response.
6483 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6484 # value format. For example:
6485 #
6486 # &quot;data&quot;: [
6487 # {
6488 # &quot;key&quot;: &quot;scope&quot;,
6489 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6490 # }
6491 {
6492 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6493 # returned. For example, for warnings where there are no results in a list
6494 # request for a particular zone, this key might be scope and
6495 # the key value might be the zone name. Other examples might be a key
6496 # indicating a deprecated resource and a suggested replacement, or a
6497 # warning about invalid network settings (for example, if an instance
6498 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6499 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6500 },
6501 ],
6502 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6503 },
6504 ],
6505 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6506 # applicable when performing per-zone operations.
6507 }</pre>
6508 </div>
6509
6510 <div class="method">
6511 <code class="details" id="setIamPolicy">setIamPolicy(project, zone, resource, body=None, x__xgafv=None)</code>
6512 <pre>Sets the access control policy on the specified resource.
6513 Replaces any existing policy.
6514
6515 Args:
6516 project: string, Project ID for this request. (required)
6517 zone: string, The name of the zone for this request. (required)
6518 resource: string, Name or id of the resource for this request. (required)
6519 body: object, The request body.
6520 The object takes the form of:
6521
6522 {
6523 &quot;bindings&quot;: [ # Flatten Policy to create a backwacd compatible wire-format.
6524 # Deprecated. Use &#x27;policy&#x27; to specify bindings.
6525 { # Associates `members`, or principals, with a `role`.
6526 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
6527 #
6528 # If the condition evaluates to `true`, then this binding applies to the
6529 # current request.
6530 #
6531 # If the condition evaluates to `false`, then this binding does not apply to
6532 # the current request. However, a different role binding might grant the same
6533 # role to one or more of the principals in this binding.
6534 #
6535 # To learn which resources support conditions in their IAM policies, see the
6536 # [IAM
6537 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
6538 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
6539 # are documented at https://github.com/google/cel-spec.
6540 #
6541 # Example (Comparison):
6542 #
6543 # title: &quot;Summary size limit&quot;
6544 # description: &quot;Determines if a summary is less than 100 chars&quot;
6545 # expression: &quot;document.summary.size() &lt; 100&quot;
6546 #
6547 # Example (Equality):
6548 #
6549 # title: &quot;Requestor is owner&quot;
6550 # description: &quot;Determines if requestor is the document owner&quot;
6551 # expression: &quot;document.owner == request.auth.claims.email&quot;
6552 #
6553 # Example (Logic):
6554 #
6555 # title: &quot;Public documents&quot;
6556 # description: &quot;Determine whether the document should be publicly visible&quot;
6557 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
6558 #
6559 # Example (Data Manipulation):
6560 #
6561 # title: &quot;Notification string&quot;
6562 # description: &quot;Create a notification string with a timestamp.&quot;
6563 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
6564 #
6565 # The exact variables and functions that may be referenced within an expression
6566 # are determined by the service that evaluates it. See the service
6567 # documentation for additional information.
6568 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
6569 # describes the expression, e.g. when hovered over it in a UI.
6570 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
6571 # syntax.
6572 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
6573 # reporting, e.g. a file name and a position in the file.
6574 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
6575 # its purpose. This can be used e.g. in UIs which allow to enter the
6576 # expression.
6577 },
6578 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
6579 # `members` can have the following values:
6580 #
6581 # * `allUsers`: A special identifier that represents anyone who is
6582 # on the internet; with or without a Google account.
6583 #
6584 # * `allAuthenticatedUsers`: A special identifier that represents anyone
6585 # who is authenticated with a Google account or a service account.
6586 # Does not include identities that come from external identity providers
6587 # (IdPs) through identity federation.
6588 #
6589 # * `user:{emailid}`: An email address that represents a specific Google
6590 # account. For example, `[email protected]` .
6591 #
6592 #
6593 # * `serviceAccount:{emailid}`: An email address that represents a Google
6594 # service account. For example,
6595 # `[email protected]`.
6596 #
6597 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
6598 # identifier for a
6599 # [Kubernetes service
6600 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
6601 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
6602 #
6603 # * `group:{emailid}`: An email address that represents a Google group.
6604 # For example, `[email protected]`.
6605 #
6606 #
6607 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
6608 # users of that domain. For example, `google.com` or `example.com`.
6609 #
6610 #
6611 #
6612 #
6613 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
6614 # A single identity in a workforce identity pool.
6615 #
6616 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
6617 # All workforce identities in a group.
6618 #
6619 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
6620 # All workforce identities with a specific attribute value.
6621 #
6622 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
6623 # All identities in a workforce identity pool.
6624 #
6625 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
6626 # A single identity in a workload identity pool.
6627 #
6628 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
6629 # A workload identity pool group.
6630 #
6631 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
6632 # All identities in a workload identity pool with a certain attribute.
6633 #
6634 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
6635 # All identities in a workload identity pool.
6636 #
6637 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
6638 # identifier) representing a user that has been recently deleted. For
6639 # example, `[email protected]?uid=123456789012345678901`. If the user is
6640 # recovered, this value reverts to `user:{emailid}` and the recovered user
6641 # retains the role in the binding.
6642 #
6643 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
6644 # unique identifier) representing a service account that has been recently
6645 # deleted. For example,
6646 # `[email protected]?uid=123456789012345678901`.
6647 # If the service account is undeleted, this value reverts to
6648 # `serviceAccount:{emailid}` and the undeleted service account retains the
6649 # role in the binding.
6650 #
6651 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
6652 # identifier) representing a Google group that has been recently
6653 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
6654 # the group is recovered, this value reverts to `group:{emailid}` and the
6655 # recovered group retains the role in the binding.
6656 #
6657 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
6658 # Deleted single identity in a workforce identity pool. For example,
6659 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
6660 &quot;A String&quot;,
6661 ],
6662 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
6663 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
6664 #
6665 # For an overview of the IAM roles and permissions, see the
6666 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
6667 # a list of the available pre-defined roles, see
6668 # [here](https://cloud.google.com/iam/docs/understanding-roles).
6669 },
6670 ],
6671 &quot;etag&quot;: &quot;A String&quot;, # Flatten Policy to create a backward compatible wire-format.
6672 # Deprecated. Use &#x27;policy&#x27; to specify the etag.
6673 &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
6674 # the policy is limited to a few 10s of KB. An empty policy is in general a
6675 # valid policy but certain services (like Projects) might reject them.
6676 # controls for Google Cloud resources.
6677 #
6678 #
6679 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
6680 # `members`, or principals, to a single `role`. Principals can be user
6681 # accounts, service accounts, Google groups, and domains (such as G Suite). A
6682 # `role` is a named list of permissions; each `role` can be an IAM predefined
6683 # role or a user-created custom role.
6684 #
6685 # For some types of Google Cloud resources, a `binding` can also specify a
6686 # `condition`, which is a logical expression that allows access to a resource
6687 # only if the expression evaluates to `true`. A condition can add constraints
6688 # based on attributes of the request, the resource, or both. To learn which
6689 # resources support conditions in their IAM policies, see the
6690 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
6691 #
6692 # **JSON example:**
6693 #
6694 # ```
6695 # {
6696 # &quot;bindings&quot;: [
6697 # {
6698 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
6699 # &quot;members&quot;: [
6700 # &quot;user:[email protected]&quot;,
6701 # &quot;group:[email protected]&quot;,
6702 # &quot;domain:google.com&quot;,
6703 # &quot;serviceAccount:[email protected]&quot;
6704 # ]
6705 # },
6706 # {
6707 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
6708 # &quot;members&quot;: [
6709 # &quot;user:[email protected]&quot;
6710 # ],
6711 # &quot;condition&quot;: {
6712 # &quot;title&quot;: &quot;expirable access&quot;,
6713 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
6714 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
6715 # }
6716 # }
6717 # ],
6718 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
6719 # &quot;version&quot;: 3
6720 # }
6721 # ```
6722 #
6723 # **YAML example:**
6724 #
6725 # ```
6726 # bindings:
6727 # - members:
6728 # - user:[email protected]
6729 # - group:[email protected]
6730 # - domain:google.com
6731 # - serviceAccount:[email protected]
6732 # role: roles/resourcemanager.organizationAdmin
6733 # - members:
6734 # - user:[email protected]
6735 # role: roles/resourcemanager.organizationViewer
6736 # condition:
6737 # title: expirable access
6738 # description: Does not grant access after Sep 2020
6739 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
6740 # etag: BwWWja0YfJA=
6741 # version: 3
6742 # ```
6743 #
6744 # For a description of IAM and its features, see the
6745 # [IAM documentation](https://cloud.google.com/iam/docs/).
6746 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
6747 { # Specifies the audit configuration for a service.
6748 # The configuration determines which permission types are logged, and what
6749 # identities, if any, are exempted from logging.
6750 # An AuditConfig must have one or more AuditLogConfigs.
6751 #
6752 # If there are AuditConfigs for both `allServices` and a specific service,
6753 # the union of the two AuditConfigs is used for that service: the log_types
6754 # specified in each AuditConfig are enabled, and the exempted_members in each
6755 # AuditLogConfig are exempted.
6756 #
6757 # Example Policy with multiple AuditConfigs:
6758 #
6759 # {
6760 # &quot;audit_configs&quot;: [
6761 # {
6762 # &quot;service&quot;: &quot;allServices&quot;,
6763 # &quot;audit_log_configs&quot;: [
6764 # {
6765 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
6766 # &quot;exempted_members&quot;: [
6767 # &quot;user:[email protected]&quot;
6768 # ]
6769 # },
6770 # {
6771 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
6772 # },
6773 # {
6774 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
6775 # }
6776 # ]
6777 # },
6778 # {
6779 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
6780 # &quot;audit_log_configs&quot;: [
6781 # {
6782 # &quot;log_type&quot;: &quot;DATA_READ&quot;
6783 # },
6784 # {
6785 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
6786 # &quot;exempted_members&quot;: [
6787 # &quot;user:[email protected]&quot;
6788 # ]
6789 # }
6790 # ]
6791 # }
6792 # ]
6793 # }
6794 #
6795 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
6796 # logging. It also exempts `[email protected]` from DATA_READ logging, and
6797 # `[email protected]` from DATA_WRITE logging.
6798 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
6799 { # Provides the configuration for logging a type of permissions.
6800 # Example:
6801 #
6802 # {
6803 # &quot;audit_log_configs&quot;: [
6804 # {
6805 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
6806 # &quot;exempted_members&quot;: [
6807 # &quot;user:[email protected]&quot;
6808 # ]
6809 # },
6810 # {
6811 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
6812 # }
6813 # ]
6814 # }
6815 #
6816 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
6817 # [email protected] from DATA_READ logging.
6818 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
6819 # permission.
6820 # Follows the same format of Binding.members.
6821 &quot;A String&quot;,
6822 ],
6823 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
6824 },
6825 ],
6826 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
6827 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
6828 # `allServices` is a special value that covers all services.
6829 },
6830 ],
6831 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
6832 # may specify a `condition` that determines how and when the `bindings` are
6833 # applied. Each of the `bindings` must contain at least one principal.
6834 #
6835 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
6836 # of these principals can be Google groups. Each occurrence of a principal
6837 # counts towards these limits. For example, if the `bindings` grant 50
6838 # different roles to `user:[email protected]`, and not to any other
6839 # principal, then you can add another 1,450 principals to the `bindings` in
6840 # the `Policy`.
6841 { # Associates `members`, or principals, with a `role`.
6842 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
6843 #
6844 # If the condition evaluates to `true`, then this binding applies to the
6845 # current request.
6846 #
6847 # If the condition evaluates to `false`, then this binding does not apply to
6848 # the current request. However, a different role binding might grant the same
6849 # role to one or more of the principals in this binding.
6850 #
6851 # To learn which resources support conditions in their IAM policies, see the
6852 # [IAM
6853 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
6854 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
6855 # are documented at https://github.com/google/cel-spec.
6856 #
6857 # Example (Comparison):
6858 #
6859 # title: &quot;Summary size limit&quot;
6860 # description: &quot;Determines if a summary is less than 100 chars&quot;
6861 # expression: &quot;document.summary.size() &lt; 100&quot;
6862 #
6863 # Example (Equality):
6864 #
6865 # title: &quot;Requestor is owner&quot;
6866 # description: &quot;Determines if requestor is the document owner&quot;
6867 # expression: &quot;document.owner == request.auth.claims.email&quot;
6868 #
6869 # Example (Logic):
6870 #
6871 # title: &quot;Public documents&quot;
6872 # description: &quot;Determine whether the document should be publicly visible&quot;
6873 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
6874 #
6875 # Example (Data Manipulation):
6876 #
6877 # title: &quot;Notification string&quot;
6878 # description: &quot;Create a notification string with a timestamp.&quot;
6879 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
6880 #
6881 # The exact variables and functions that may be referenced within an expression
6882 # are determined by the service that evaluates it. See the service
6883 # documentation for additional information.
6884 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
6885 # describes the expression, e.g. when hovered over it in a UI.
6886 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
6887 # syntax.
6888 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
6889 # reporting, e.g. a file name and a position in the file.
6890 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
6891 # its purpose. This can be used e.g. in UIs which allow to enter the
6892 # expression.
6893 },
6894 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
6895 # `members` can have the following values:
6896 #
6897 # * `allUsers`: A special identifier that represents anyone who is
6898 # on the internet; with or without a Google account.
6899 #
6900 # * `allAuthenticatedUsers`: A special identifier that represents anyone
6901 # who is authenticated with a Google account or a service account.
6902 # Does not include identities that come from external identity providers
6903 # (IdPs) through identity federation.
6904 #
6905 # * `user:{emailid}`: An email address that represents a specific Google
6906 # account. For example, `[email protected]` .
6907 #
6908 #
6909 # * `serviceAccount:{emailid}`: An email address that represents a Google
6910 # service account. For example,
6911 # `[email protected]`.
6912 #
6913 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
6914 # identifier for a
6915 # [Kubernetes service
6916 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
6917 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
6918 #
6919 # * `group:{emailid}`: An email address that represents a Google group.
6920 # For example, `[email protected]`.
6921 #
6922 #
6923 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
6924 # users of that domain. For example, `google.com` or `example.com`.
6925 #
6926 #
6927 #
6928 #
6929 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
6930 # A single identity in a workforce identity pool.
6931 #
6932 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
6933 # All workforce identities in a group.
6934 #
6935 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
6936 # All workforce identities with a specific attribute value.
6937 #
6938 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
6939 # All identities in a workforce identity pool.
6940 #
6941 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
6942 # A single identity in a workload identity pool.
6943 #
6944 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
6945 # A workload identity pool group.
6946 #
6947 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
6948 # All identities in a workload identity pool with a certain attribute.
6949 #
6950 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
6951 # All identities in a workload identity pool.
6952 #
6953 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
6954 # identifier) representing a user that has been recently deleted. For
6955 # example, `[email protected]?uid=123456789012345678901`. If the user is
6956 # recovered, this value reverts to `user:{emailid}` and the recovered user
6957 # retains the role in the binding.
6958 #
6959 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
6960 # unique identifier) representing a service account that has been recently
6961 # deleted. For example,
6962 # `[email protected]?uid=123456789012345678901`.
6963 # If the service account is undeleted, this value reverts to
6964 # `serviceAccount:{emailid}` and the undeleted service account retains the
6965 # role in the binding.
6966 #
6967 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
6968 # identifier) representing a Google group that has been recently
6969 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
6970 # the group is recovered, this value reverts to `group:{emailid}` and the
6971 # recovered group retains the role in the binding.
6972 #
6973 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
6974 # Deleted single identity in a workforce identity pool. For example,
6975 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
6976 &quot;A String&quot;,
6977 ],
6978 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
6979 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
6980 #
6981 # For an overview of the IAM roles and permissions, see the
6982 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
6983 # a list of the available pre-defined roles, see
6984 # [here](https://cloud.google.com/iam/docs/understanding-roles).
6985 },
6986 ],
6987 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
6988 # prevent simultaneous updates of a policy from overwriting each other.
6989 # It is strongly suggested that systems make use of the `etag` in the
6990 # read-modify-write cycle to perform policy updates in order to avoid race
6991 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
6992 # systems are expected to put that etag in the request to `setIamPolicy` to
6993 # ensure that their change will be applied to the same version of the policy.
6994 #
6995 # **Important:** If you use IAM Conditions, you must include the `etag` field
6996 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
6997 # you to overwrite a version `3` policy with a version `1` policy, and all of
6998 # the conditions in the version `3` policy are lost.
6999 &quot;version&quot;: 42, # Specifies the format of the policy.
7000 #
7001 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
7002 # are rejected.
7003 #
7004 # Any operation that affects conditional role bindings must specify version
7005 # `3`. This requirement applies to the following operations:
7006 #
7007 # * Getting a policy that includes a conditional role binding
7008 # * Adding a conditional role binding to a policy
7009 # * Changing a conditional role binding in a policy
7010 # * Removing any role binding, with or without a condition, from a policy
7011 # that includes conditions
7012 #
7013 # **Important:** If you use IAM Conditions, you must include the `etag` field
7014 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
7015 # you to overwrite a version `3` policy with a version `1` policy, and all of
7016 # the conditions in the version `3` policy are lost.
7017 #
7018 # If a policy does not include any conditions, operations on that policy may
7019 # specify any valid version or leave the field unset.
7020 #
7021 # To learn which resources support conditions in their IAM policies, see the
7022 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7023 },
7024 }
7025
7026 x__xgafv: string, V1 error format.
7027 Allowed values
7028 1 - v1 error format
7029 2 - v2 error format
7030
7031 Returns:
7032 An object of the form:
7033
7034 { # An Identity and Access Management (IAM) policy, which specifies access
7035 # controls for Google Cloud resources.
7036 #
7037 #
7038 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
7039 # `members`, or principals, to a single `role`. Principals can be user
7040 # accounts, service accounts, Google groups, and domains (such as G Suite). A
7041 # `role` is a named list of permissions; each `role` can be an IAM predefined
7042 # role or a user-created custom role.
7043 #
7044 # For some types of Google Cloud resources, a `binding` can also specify a
7045 # `condition`, which is a logical expression that allows access to a resource
7046 # only if the expression evaluates to `true`. A condition can add constraints
7047 # based on attributes of the request, the resource, or both. To learn which
7048 # resources support conditions in their IAM policies, see the
7049 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7050 #
7051 # **JSON example:**
7052 #
7053 # ```
7054 # {
7055 # &quot;bindings&quot;: [
7056 # {
7057 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
7058 # &quot;members&quot;: [
7059 # &quot;user:[email protected]&quot;,
7060 # &quot;group:[email protected]&quot;,
7061 # &quot;domain:google.com&quot;,
7062 # &quot;serviceAccount:[email protected]&quot;
7063 # ]
7064 # },
7065 # {
7066 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
7067 # &quot;members&quot;: [
7068 # &quot;user:[email protected]&quot;
7069 # ],
7070 # &quot;condition&quot;: {
7071 # &quot;title&quot;: &quot;expirable access&quot;,
7072 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
7073 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
7074 # }
7075 # }
7076 # ],
7077 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
7078 # &quot;version&quot;: 3
7079 # }
7080 # ```
7081 #
7082 # **YAML example:**
7083 #
7084 # ```
7085 # bindings:
7086 # - members:
7087 # - user:[email protected]
7088 # - group:[email protected]
7089 # - domain:google.com
7090 # - serviceAccount:[email protected]
7091 # role: roles/resourcemanager.organizationAdmin
7092 # - members:
7093 # - user:[email protected]
7094 # role: roles/resourcemanager.organizationViewer
7095 # condition:
7096 # title: expirable access
7097 # description: Does not grant access after Sep 2020
7098 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
7099 # etag: BwWWja0YfJA=
7100 # version: 3
7101 # ```
7102 #
7103 # For a description of IAM and its features, see the
7104 # [IAM documentation](https://cloud.google.com/iam/docs/).
7105 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
7106 { # Specifies the audit configuration for a service.
7107 # The configuration determines which permission types are logged, and what
7108 # identities, if any, are exempted from logging.
7109 # An AuditConfig must have one or more AuditLogConfigs.
7110 #
7111 # If there are AuditConfigs for both `allServices` and a specific service,
7112 # the union of the two AuditConfigs is used for that service: the log_types
7113 # specified in each AuditConfig are enabled, and the exempted_members in each
7114 # AuditLogConfig are exempted.
7115 #
7116 # Example Policy with multiple AuditConfigs:
7117 #
7118 # {
7119 # &quot;audit_configs&quot;: [
7120 # {
7121 # &quot;service&quot;: &quot;allServices&quot;,
7122 # &quot;audit_log_configs&quot;: [
7123 # {
7124 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
7125 # &quot;exempted_members&quot;: [
7126 # &quot;user:[email protected]&quot;
7127 # ]
7128 # },
7129 # {
7130 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
7131 # },
7132 # {
7133 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
7134 # }
7135 # ]
7136 # },
7137 # {
7138 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
7139 # &quot;audit_log_configs&quot;: [
7140 # {
7141 # &quot;log_type&quot;: &quot;DATA_READ&quot;
7142 # },
7143 # {
7144 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
7145 # &quot;exempted_members&quot;: [
7146 # &quot;user:[email protected]&quot;
7147 # ]
7148 # }
7149 # ]
7150 # }
7151 # ]
7152 # }
7153 #
7154 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
7155 # logging. It also exempts `[email protected]` from DATA_READ logging, and
7156 # `[email protected]` from DATA_WRITE logging.
7157 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
7158 { # Provides the configuration for logging a type of permissions.
7159 # Example:
7160 #
7161 # {
7162 # &quot;audit_log_configs&quot;: [
7163 # {
7164 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
7165 # &quot;exempted_members&quot;: [
7166 # &quot;user:[email protected]&quot;
7167 # ]
7168 # },
7169 # {
7170 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
7171 # }
7172 # ]
7173 # }
7174 #
7175 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
7176 # [email protected] from DATA_READ logging.
7177 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
7178 # permission.
7179 # Follows the same format of Binding.members.
7180 &quot;A String&quot;,
7181 ],
7182 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
7183 },
7184 ],
7185 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
7186 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
7187 # `allServices` is a special value that covers all services.
7188 },
7189 ],
7190 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
7191 # may specify a `condition` that determines how and when the `bindings` are
7192 # applied. Each of the `bindings` must contain at least one principal.
7193 #
7194 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
7195 # of these principals can be Google groups. Each occurrence of a principal
7196 # counts towards these limits. For example, if the `bindings` grant 50
7197 # different roles to `user:[email protected]`, and not to any other
7198 # principal, then you can add another 1,450 principals to the `bindings` in
7199 # the `Policy`.
7200 { # Associates `members`, or principals, with a `role`.
7201 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
7202 #
7203 # If the condition evaluates to `true`, then this binding applies to the
7204 # current request.
7205 #
7206 # If the condition evaluates to `false`, then this binding does not apply to
7207 # the current request. However, a different role binding might grant the same
7208 # role to one or more of the principals in this binding.
7209 #
7210 # To learn which resources support conditions in their IAM policies, see the
7211 # [IAM
7212 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7213 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
7214 # are documented at https://github.com/google/cel-spec.
7215 #
7216 # Example (Comparison):
7217 #
7218 # title: &quot;Summary size limit&quot;
7219 # description: &quot;Determines if a summary is less than 100 chars&quot;
7220 # expression: &quot;document.summary.size() &lt; 100&quot;
7221 #
7222 # Example (Equality):
7223 #
7224 # title: &quot;Requestor is owner&quot;
7225 # description: &quot;Determines if requestor is the document owner&quot;
7226 # expression: &quot;document.owner == request.auth.claims.email&quot;
7227 #
7228 # Example (Logic):
7229 #
7230 # title: &quot;Public documents&quot;
7231 # description: &quot;Determine whether the document should be publicly visible&quot;
7232 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
7233 #
7234 # Example (Data Manipulation):
7235 #
7236 # title: &quot;Notification string&quot;
7237 # description: &quot;Create a notification string with a timestamp.&quot;
7238 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
7239 #
7240 # The exact variables and functions that may be referenced within an expression
7241 # are determined by the service that evaluates it. See the service
7242 # documentation for additional information.
7243 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
7244 # describes the expression, e.g. when hovered over it in a UI.
7245 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
7246 # syntax.
7247 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
7248 # reporting, e.g. a file name and a position in the file.
7249 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
7250 # its purpose. This can be used e.g. in UIs which allow to enter the
7251 # expression.
7252 },
7253 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
7254 # `members` can have the following values:
7255 #
7256 # * `allUsers`: A special identifier that represents anyone who is
7257 # on the internet; with or without a Google account.
7258 #
7259 # * `allAuthenticatedUsers`: A special identifier that represents anyone
7260 # who is authenticated with a Google account or a service account.
7261 # Does not include identities that come from external identity providers
7262 # (IdPs) through identity federation.
7263 #
7264 # * `user:{emailid}`: An email address that represents a specific Google
7265 # account. For example, `[email protected]` .
7266 #
7267 #
7268 # * `serviceAccount:{emailid}`: An email address that represents a Google
7269 # service account. For example,
7270 # `[email protected]`.
7271 #
7272 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
7273 # identifier for a
7274 # [Kubernetes service
7275 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
7276 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
7277 #
7278 # * `group:{emailid}`: An email address that represents a Google group.
7279 # For example, `[email protected]`.
7280 #
7281 #
7282 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
7283 # users of that domain. For example, `google.com` or `example.com`.
7284 #
7285 #
7286 #
7287 #
7288 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
7289 # A single identity in a workforce identity pool.
7290 #
7291 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
7292 # All workforce identities in a group.
7293 #
7294 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
7295 # All workforce identities with a specific attribute value.
7296 #
7297 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
7298 # All identities in a workforce identity pool.
7299 #
7300 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
7301 # A single identity in a workload identity pool.
7302 #
7303 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
7304 # A workload identity pool group.
7305 #
7306 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
7307 # All identities in a workload identity pool with a certain attribute.
7308 #
7309 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
7310 # All identities in a workload identity pool.
7311 #
7312 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
7313 # identifier) representing a user that has been recently deleted. For
7314 # example, `[email protected]?uid=123456789012345678901`. If the user is
7315 # recovered, this value reverts to `user:{emailid}` and the recovered user
7316 # retains the role in the binding.
7317 #
7318 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
7319 # unique identifier) representing a service account that has been recently
7320 # deleted. For example,
7321 # `[email protected]?uid=123456789012345678901`.
7322 # If the service account is undeleted, this value reverts to
7323 # `serviceAccount:{emailid}` and the undeleted service account retains the
7324 # role in the binding.
7325 #
7326 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
7327 # identifier) representing a Google group that has been recently
7328 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
7329 # the group is recovered, this value reverts to `group:{emailid}` and the
7330 # recovered group retains the role in the binding.
7331 #
7332 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
7333 # Deleted single identity in a workforce identity pool. For example,
7334 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
7335 &quot;A String&quot;,
7336 ],
7337 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
7338 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
7339 #
7340 # For an overview of the IAM roles and permissions, see the
7341 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
7342 # a list of the available pre-defined roles, see
7343 # [here](https://cloud.google.com/iam/docs/understanding-roles).
7344 },
7345 ],
7346 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
7347 # prevent simultaneous updates of a policy from overwriting each other.
7348 # It is strongly suggested that systems make use of the `etag` in the
7349 # read-modify-write cycle to perform policy updates in order to avoid race
7350 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
7351 # systems are expected to put that etag in the request to `setIamPolicy` to
7352 # ensure that their change will be applied to the same version of the policy.
7353 #
7354 # **Important:** If you use IAM Conditions, you must include the `etag` field
7355 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
7356 # you to overwrite a version `3` policy with a version `1` policy, and all of
7357 # the conditions in the version `3` policy are lost.
7358 &quot;version&quot;: 42, # Specifies the format of the policy.
7359 #
7360 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
7361 # are rejected.
7362 #
7363 # Any operation that affects conditional role bindings must specify version
7364 # `3`. This requirement applies to the following operations:
7365 #
7366 # * Getting a policy that includes a conditional role binding
7367 # * Adding a conditional role binding to a policy
7368 # * Changing a conditional role binding in a policy
7369 # * Removing any role binding, with or without a condition, from a policy
7370 # that includes conditions
7371 #
7372 # **Important:** If you use IAM Conditions, you must include the `etag` field
7373 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
7374 # you to overwrite a version `3` policy with a version `1` policy, and all of
7375 # the conditions in the version `3` policy are lost.
7376 #
7377 # If a policy does not include any conditions, operations on that policy may
7378 # specify any valid version or leave the field unset.
7379 #
7380 # To learn which resources support conditions in their IAM policies, see the
7381 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7382 }</pre>
7383 </div>
7384
7385 <div class="method">
7386 <code class="details" id="setLabels">setLabels(project, zone, resource, body=None, requestId=None, x__xgafv=None)</code>
7387 <pre>Sets the labels on a disk. To learn more about labels, read theLabeling
7388 Resources documentation.
7389
7390 Args:
7391 project: string, Project ID for this request. (required)
7392 zone: string, The name of the zone for this request. (required)
7393 resource: string, Name or id of the resource for this request. (required)
7394 body: object, The request body.
7395 The object takes the form of:
7396
7397 {
7398 &quot;labelFingerprint&quot;: &quot;A String&quot;, # The fingerprint of the previous set of labels for this resource,
7399 # used to detect conflicts. The fingerprint is initially generated by Compute
7400 # Engine and changes after every request to modify or update labels. You must
7401 # always provide an up-to-date fingerprint hash in order to update or change
7402 # labels. Make a get() request to the resource to get the latest
7403 # fingerprint.
7404 &quot;labels&quot;: { # The labels to set for this resource.
7405 &quot;a_key&quot;: &quot;A String&quot;,
7406 },
7407 }
7408
7409 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
7410 that if you must retry your request, the server will know to ignore the
7411 request if it has already been completed.
7412
7413 For example, consider a situation where you make an initial request and
7414 the request times out. If you make the request again with the same
7415 request ID, the server can check if original operation with the same
7416 request ID was received, and if so, will ignore the second request. This
7417 prevents clients from accidentally creating duplicate commitments.
7418
7419 The request ID must be
7420 a valid UUID with the exception that zero UUID is not supported
7421 (00000000-0000-0000-0000-000000000000).
7422 x__xgafv: string, V1 error format.
7423 Allowed values
7424 1 - v1 error format
7425 2 - v2 error format
7426
7427 Returns:
7428 An object of the form:
7429
7430 { # Represents an Operation resource.
7431 #
7432 # Google Compute Engine has three Operation resources:
7433 #
7434 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
7435 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
7436 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
7437 #
7438 # You can use an operation resource to manage asynchronous API requests.
7439 # For more information, readHandling
7440 # API responses.
7441 #
7442 # Operations can be global, regional or zonal.
7443 #
7444 # - For global operations, use the `globalOperations`
7445 # resource.
7446 # - For regional operations, use the
7447 # `regionOperations` resource.
7448 # - For zonal operations, use
7449 # the `zoneOperations` resource.
7450 #
7451 #
7452 #
7453 # For more information, read
7454 # Global, Regional, and Zonal Resources.
7455 #
7456 # Note that completed Operation resources have a limited
7457 # retention period.
7458 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
7459 # Not present otherwise.
7460 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
7461 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
7462 # set when the operation is created.
7463 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
7464 # text format.
7465 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
7466 # this field will be populated.
7467 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7468 # operation.
7469 {
7470 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7471 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7472 # details. There is a set of defined message types to use for providing
7473 # details.The syntax depends on the error code. For example,
7474 # QuotaExceededInfo will have details when the error code is
7475 # QUOTA_EXCEEDED.
7476 {
7477 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7478 #
7479 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7480 # is not enabled:
7481 #
7482 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7483 # &quot;domain&quot;: &quot;googleapis.com&quot;
7484 # &quot;metadata&quot;: {
7485 # &quot;resource&quot;: &quot;projects/123&quot;,
7486 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7487 # }
7488 # }
7489 #
7490 # This response indicates that the pubsub.googleapis.com API is not enabled.
7491 #
7492 # Example of an error that is returned when attempting to create a Spanner
7493 # instance in a region that is out of stock:
7494 #
7495 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7496 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7497 # &quot;metadata&quot;: {
7498 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7499 # }
7500 # }
7501 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7502 # is typically the registered service name of the tool or product that
7503 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7504 # generated by some common infrastructure, the error domain must be a
7505 # globally unique value that identifies the infrastructure. For Google API
7506 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7507 &quot;metadatas&quot;: { # Additional structured details about this error.
7508 #
7509 # Keys must match a regular expression of `a-z+` but should
7510 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7511 # length. When identifying the current value of an exceeded limit, the units
7512 # should be contained in the key, not the value. For example, rather than
7513 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7514 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7515 # instances that can be created in a single (batch) request.
7516 &quot;a_key&quot;: &quot;A String&quot;,
7517 },
7518 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7519 # proximate cause of the error. Error reasons are unique within a particular
7520 # domain of errors. This should be at most 63 characters and match a
7521 # regular expression of `A-Z+[A-Z0-9]`, which represents
7522 # UPPER_SNAKE_CASE.
7523 },
7524 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7525 #
7526 # For example, if a quota check failed with an error indicating the calling
7527 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7528 # directly to the right place in the developer console to flip the bit.
7529 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7530 { # Describes a URL link.
7531 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7532 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7533 },
7534 ],
7535 },
7536 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7537 # which can be attached to an RPC error.
7538 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7539 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7540 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7541 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7542 },
7543 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7544 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7545 &quot;a_key&quot;: &quot;A String&quot;,
7546 },
7547 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7548 # type or metric.
7549 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7550 # or metric.
7551 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7552 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7553 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7554 },
7555 },
7556 ],
7557 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7558 # This property is optional.
7559 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7560 },
7561 ],
7562 },
7563 &quot;getVersionOperationMetadata&quot;: {
7564 &quot;inlineSbomInfo&quot;: {
7565 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
7566 # appropriate identifiers.
7567 &quot;a_key&quot;: &quot;A String&quot;,
7568 },
7569 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
7570 # identifiers.
7571 &quot;a_key&quot;: &quot;A String&quot;,
7572 },
7573 },
7574 },
7575 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
7576 # message that was returned, such as `NOT FOUND`.
7577 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
7578 # status code that was returned. For example, a `404` means the
7579 # resource was not found.
7580 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
7581 # defined by the server.
7582 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
7583 # This value is inRFC3339
7584 # text format.
7585 &quot;instancesBulkInsertOperationMetadata&quot;: {
7586 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
7587 # Example key: zones/us-central1-a
7588 &quot;a_key&quot;: {
7589 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
7590 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
7591 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
7592 # error.
7593 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
7594 # if the flow is rolling forward or rolling back.
7595 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
7596 },
7597 },
7598 },
7599 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
7600 # Operation resources.
7601 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
7602 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
7603 # group of operations results from a `bulkInsert` API request.
7604 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
7605 # `update`, or `delete`, and so on.
7606 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
7607 # There is no requirement that this be linear or support any granularity of
7608 # operations. This should not be used to guess when the operation will be
7609 # complete. This number should monotonically increase as the operation
7610 # progresses.
7611 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
7612 # applicable when performing regional operations.
7613 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7614 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
7615 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
7616 # this field will contain information on all underlying zonal actions and
7617 # their state.
7618 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
7619 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
7620 # Example key: zones/us-central1-a
7621 &quot;a_key&quot;: {
7622 &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
7623 # populated.
7624 # different programming environments, including REST APIs and RPC APIs. It is
7625 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
7626 # three pieces of data: error code, error message, and error details.
7627 #
7628 # You can find out more about this error model and how to work with it in the
7629 # [API Design Guide](https://cloud.google.com/apis/design/errors).
7630 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
7631 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
7632 # message types for APIs to use.
7633 {
7634 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
7635 },
7636 ],
7637 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
7638 # user-facing error message should be localized and sent in the
7639 # google.rpc.Status.details field, or localized by the client.
7640 },
7641 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
7642 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
7643 },
7644 },
7645 },
7646 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
7647 # This value is inRFC3339
7648 # text format.
7649 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
7650 # following:
7651 # `PENDING`, `RUNNING`, or `DONE`.
7652 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
7653 # operation.
7654 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
7655 # of the target resource.
7656 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
7657 # operations related to creating a snapshot, this points to the disk
7658 # that the snapshot was created from.
7659 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
7660 # `[email protected]` or
7661 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
7662 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
7663 # operation, this field will be populated.
7664 {
7665 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
7666 # Engine returns NO_RESULTS_ON_PAGE if there
7667 # are no results in the response.
7668 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
7669 # value format. For example:
7670 #
7671 # &quot;data&quot;: [
7672 # {
7673 # &quot;key&quot;: &quot;scope&quot;,
7674 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
7675 # }
7676 {
7677 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
7678 # returned. For example, for warnings where there are no results in a list
7679 # request for a particular zone, this key might be scope and
7680 # the key value might be the zone name. Other examples might be a key
7681 # indicating a deprecated resource and a suggested replacement, or a
7682 # warning about invalid network settings (for example, if an instance
7683 # attempts to perform IP forwarding but is not enabled for IP forwarding).
7684 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
7685 },
7686 ],
7687 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
7688 },
7689 ],
7690 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
7691 # applicable when performing per-zone operations.
7692 }</pre>
7693 </div>
7694
7695 <div class="method">
7696 <code class="details" id="startAsyncReplication">startAsyncReplication(project, zone, disk, body=None, requestId=None, x__xgafv=None)</code>
7697 <pre>Starts asynchronous replication.
7698 Must be invoked on the primary disk.
7699
7700 Args:
7701 project: string, Project ID for this request. (required)
7702 zone: string, The name of the zone for this request. (required)
7703 disk: string, The name of the persistent disk. (required)
7704 body: object, The request body.
7705 The object takes the form of:
7706
7707 {
7708 &quot;asyncSecondaryDisk&quot;: &quot;A String&quot;, # The secondary disk to start asynchronous replication to.
7709 # You can provide this as a partial or full URL to the resource. For example,
7710 # the following are valid values:
7711 #
7712 #
7713 # -
7714 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
7715 #
7716 # -
7717 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
7718 #
7719 # -
7720 # projects/project/zones/zone/disks/disk
7721 #
7722 # -
7723 # projects/project/regions/region/disks/disk
7724 #
7725 # -
7726 # zones/zone/disks/disk
7727 #
7728 # -
7729 # regions/region/disks/disk
7730 }
7731
7732 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
7733 that if you must retry your request, the server will know to ignore the
7734 request if it has already been completed.
7735
7736 For example, consider a situation where you make an initial request and
7737 the request times out. If you make the request again with the same
7738 request ID, the server can check if original operation with the same
7739 request ID was received, and if so, will ignore the second request. This
7740 prevents clients from accidentally creating duplicate commitments.
7741
7742 The request ID must be
7743 a valid UUID with the exception that zero UUID is not supported
7744 (00000000-0000-0000-0000-000000000000).
7745 x__xgafv: string, V1 error format.
7746 Allowed values
7747 1 - v1 error format
7748 2 - v2 error format
7749
7750 Returns:
7751 An object of the form:
7752
7753 { # Represents an Operation resource.
7754 #
7755 # Google Compute Engine has three Operation resources:
7756 #
7757 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
7758 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
7759 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
7760 #
7761 # You can use an operation resource to manage asynchronous API requests.
7762 # For more information, readHandling
7763 # API responses.
7764 #
7765 # Operations can be global, regional or zonal.
7766 #
7767 # - For global operations, use the `globalOperations`
7768 # resource.
7769 # - For regional operations, use the
7770 # `regionOperations` resource.
7771 # - For zonal operations, use
7772 # the `zoneOperations` resource.
7773 #
7774 #
7775 #
7776 # For more information, read
7777 # Global, Regional, and Zonal Resources.
7778 #
7779 # Note that completed Operation resources have a limited
7780 # retention period.
7781 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
7782 # Not present otherwise.
7783 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
7784 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
7785 # set when the operation is created.
7786 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
7787 # text format.
7788 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
7789 # this field will be populated.
7790 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7791 # operation.
7792 {
7793 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7794 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7795 # details. There is a set of defined message types to use for providing
7796 # details.The syntax depends on the error code. For example,
7797 # QuotaExceededInfo will have details when the error code is
7798 # QUOTA_EXCEEDED.
7799 {
7800 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7801 #
7802 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7803 # is not enabled:
7804 #
7805 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7806 # &quot;domain&quot;: &quot;googleapis.com&quot;
7807 # &quot;metadata&quot;: {
7808 # &quot;resource&quot;: &quot;projects/123&quot;,
7809 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7810 # }
7811 # }
7812 #
7813 # This response indicates that the pubsub.googleapis.com API is not enabled.
7814 #
7815 # Example of an error that is returned when attempting to create a Spanner
7816 # instance in a region that is out of stock:
7817 #
7818 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7819 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7820 # &quot;metadata&quot;: {
7821 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7822 # }
7823 # }
7824 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7825 # is typically the registered service name of the tool or product that
7826 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7827 # generated by some common infrastructure, the error domain must be a
7828 # globally unique value that identifies the infrastructure. For Google API
7829 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7830 &quot;metadatas&quot;: { # Additional structured details about this error.
7831 #
7832 # Keys must match a regular expression of `a-z+` but should
7833 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7834 # length. When identifying the current value of an exceeded limit, the units
7835 # should be contained in the key, not the value. For example, rather than
7836 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7837 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7838 # instances that can be created in a single (batch) request.
7839 &quot;a_key&quot;: &quot;A String&quot;,
7840 },
7841 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7842 # proximate cause of the error. Error reasons are unique within a particular
7843 # domain of errors. This should be at most 63 characters and match a
7844 # regular expression of `A-Z+[A-Z0-9]`, which represents
7845 # UPPER_SNAKE_CASE.
7846 },
7847 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7848 #
7849 # For example, if a quota check failed with an error indicating the calling
7850 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7851 # directly to the right place in the developer console to flip the bit.
7852 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7853 { # Describes a URL link.
7854 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7855 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7856 },
7857 ],
7858 },
7859 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7860 # which can be attached to an RPC error.
7861 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7862 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7863 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7864 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7865 },
7866 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7867 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7868 &quot;a_key&quot;: &quot;A String&quot;,
7869 },
7870 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7871 # type or metric.
7872 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7873 # or metric.
7874 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7875 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7876 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7877 },
7878 },
7879 ],
7880 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7881 # This property is optional.
7882 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7883 },
7884 ],
7885 },
7886 &quot;getVersionOperationMetadata&quot;: {
7887 &quot;inlineSbomInfo&quot;: {
7888 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
7889 # appropriate identifiers.
7890 &quot;a_key&quot;: &quot;A String&quot;,
7891 },
7892 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
7893 # identifiers.
7894 &quot;a_key&quot;: &quot;A String&quot;,
7895 },
7896 },
7897 },
7898 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
7899 # message that was returned, such as `NOT FOUND`.
7900 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
7901 # status code that was returned. For example, a `404` means the
7902 # resource was not found.
7903 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
7904 # defined by the server.
7905 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
7906 # This value is inRFC3339
7907 # text format.
7908 &quot;instancesBulkInsertOperationMetadata&quot;: {
7909 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
7910 # Example key: zones/us-central1-a
7911 &quot;a_key&quot;: {
7912 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
7913 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
7914 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
7915 # error.
7916 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
7917 # if the flow is rolling forward or rolling back.
7918 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
7919 },
7920 },
7921 },
7922 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
7923 # Operation resources.
7924 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
7925 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
7926 # group of operations results from a `bulkInsert` API request.
7927 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
7928 # `update`, or `delete`, and so on.
7929 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
7930 # There is no requirement that this be linear or support any granularity of
7931 # operations. This should not be used to guess when the operation will be
7932 # complete. This number should monotonically increase as the operation
7933 # progresses.
7934 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
7935 # applicable when performing regional operations.
7936 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7937 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
7938 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
7939 # this field will contain information on all underlying zonal actions and
7940 # their state.
7941 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
7942 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
7943 # Example key: zones/us-central1-a
7944 &quot;a_key&quot;: {
7945 &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
7946 # populated.
7947 # different programming environments, including REST APIs and RPC APIs. It is
7948 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
7949 # three pieces of data: error code, error message, and error details.
7950 #
7951 # You can find out more about this error model and how to work with it in the
7952 # [API Design Guide](https://cloud.google.com/apis/design/errors).
7953 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
7954 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
7955 # message types for APIs to use.
7956 {
7957 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
7958 },
7959 ],
7960 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
7961 # user-facing error message should be localized and sent in the
7962 # google.rpc.Status.details field, or localized by the client.
7963 },
7964 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
7965 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
7966 },
7967 },
7968 },
7969 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
7970 # This value is inRFC3339
7971 # text format.
7972 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
7973 # following:
7974 # `PENDING`, `RUNNING`, or `DONE`.
7975 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
7976 # operation.
7977 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
7978 # of the target resource.
7979 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
7980 # operations related to creating a snapshot, this points to the disk
7981 # that the snapshot was created from.
7982 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
7983 # `[email protected]` or
7984 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
7985 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
7986 # operation, this field will be populated.
7987 {
7988 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
7989 # Engine returns NO_RESULTS_ON_PAGE if there
7990 # are no results in the response.
7991 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
7992 # value format. For example:
7993 #
7994 # &quot;data&quot;: [
7995 # {
7996 # &quot;key&quot;: &quot;scope&quot;,
7997 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
7998 # }
7999 {
8000 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8001 # returned. For example, for warnings where there are no results in a list
8002 # request for a particular zone, this key might be scope and
8003 # the key value might be the zone name. Other examples might be a key
8004 # indicating a deprecated resource and a suggested replacement, or a
8005 # warning about invalid network settings (for example, if an instance
8006 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8007 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8008 },
8009 ],
8010 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8011 },
8012 ],
8013 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8014 # applicable when performing per-zone operations.
8015 }</pre>
8016 </div>
8017
8018 <div class="method">
8019 <code class="details" id="stopAsyncReplication">stopAsyncReplication(project, zone, disk, requestId=None, x__xgafv=None)</code>
8020 <pre>Stops asynchronous replication.
8021 Can be invoked either on the primary or on the secondary disk.
8022
8023 Args:
8024 project: string, Project ID for this request. (required)
8025 zone: string, The name of the zone for this request. (required)
8026 disk: string, The name of the persistent disk. (required)
8027 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
8028 that if you must retry your request, the server will know to ignore the
8029 request if it has already been completed.
8030
8031 For example, consider a situation where you make an initial request and
8032 the request times out. If you make the request again with the same
8033 request ID, the server can check if original operation with the same
8034 request ID was received, and if so, will ignore the second request. This
8035 prevents clients from accidentally creating duplicate commitments.
8036
8037 The request ID must be
8038 a valid UUID with the exception that zero UUID is not supported
8039 (00000000-0000-0000-0000-000000000000).
8040 x__xgafv: string, V1 error format.
8041 Allowed values
8042 1 - v1 error format
8043 2 - v2 error format
8044
8045 Returns:
8046 An object of the form:
8047
8048 { # Represents an Operation resource.
8049 #
8050 # Google Compute Engine has three Operation resources:
8051 #
8052 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
8053 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
8054 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
8055 #
8056 # You can use an operation resource to manage asynchronous API requests.
8057 # For more information, readHandling
8058 # API responses.
8059 #
8060 # Operations can be global, regional or zonal.
8061 #
8062 # - For global operations, use the `globalOperations`
8063 # resource.
8064 # - For regional operations, use the
8065 # `regionOperations` resource.
8066 # - For zonal operations, use
8067 # the `zoneOperations` resource.
8068 #
8069 #
8070 #
8071 # For more information, read
8072 # Global, Regional, and Zonal Resources.
8073 #
8074 # Note that completed Operation resources have a limited
8075 # retention period.
8076 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
8077 # Not present otherwise.
8078 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
8079 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
8080 # set when the operation is created.
8081 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
8082 # text format.
8083 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
8084 # this field will be populated.
8085 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8086 # operation.
8087 {
8088 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8089 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8090 # details. There is a set of defined message types to use for providing
8091 # details.The syntax depends on the error code. For example,
8092 # QuotaExceededInfo will have details when the error code is
8093 # QUOTA_EXCEEDED.
8094 {
8095 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8096 #
8097 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8098 # is not enabled:
8099 #
8100 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8101 # &quot;domain&quot;: &quot;googleapis.com&quot;
8102 # &quot;metadata&quot;: {
8103 # &quot;resource&quot;: &quot;projects/123&quot;,
8104 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8105 # }
8106 # }
8107 #
8108 # This response indicates that the pubsub.googleapis.com API is not enabled.
8109 #
8110 # Example of an error that is returned when attempting to create a Spanner
8111 # instance in a region that is out of stock:
8112 #
8113 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8114 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8115 # &quot;metadata&quot;: {
8116 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8117 # }
8118 # }
8119 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8120 # is typically the registered service name of the tool or product that
8121 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8122 # generated by some common infrastructure, the error domain must be a
8123 # globally unique value that identifies the infrastructure. For Google API
8124 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8125 &quot;metadatas&quot;: { # Additional structured details about this error.
8126 #
8127 # Keys must match a regular expression of `a-z+` but should
8128 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8129 # length. When identifying the current value of an exceeded limit, the units
8130 # should be contained in the key, not the value. For example, rather than
8131 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8132 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8133 # instances that can be created in a single (batch) request.
8134 &quot;a_key&quot;: &quot;A String&quot;,
8135 },
8136 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8137 # proximate cause of the error. Error reasons are unique within a particular
8138 # domain of errors. This should be at most 63 characters and match a
8139 # regular expression of `A-Z+[A-Z0-9]`, which represents
8140 # UPPER_SNAKE_CASE.
8141 },
8142 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8143 #
8144 # For example, if a quota check failed with an error indicating the calling
8145 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8146 # directly to the right place in the developer console to flip the bit.
8147 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8148 { # Describes a URL link.
8149 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8150 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8151 },
8152 ],
8153 },
8154 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8155 # which can be attached to an RPC error.
8156 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8157 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8158 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8159 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8160 },
8161 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8162 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8163 &quot;a_key&quot;: &quot;A String&quot;,
8164 },
8165 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8166 # type or metric.
8167 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8168 # or metric.
8169 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8170 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8171 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8172 },
8173 },
8174 ],
8175 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8176 # This property is optional.
8177 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8178 },
8179 ],
8180 },
8181 &quot;getVersionOperationMetadata&quot;: {
8182 &quot;inlineSbomInfo&quot;: {
8183 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
8184 # appropriate identifiers.
8185 &quot;a_key&quot;: &quot;A String&quot;,
8186 },
8187 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8188 # identifiers.
8189 &quot;a_key&quot;: &quot;A String&quot;,
8190 },
8191 },
8192 },
8193 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8194 # message that was returned, such as `NOT FOUND`.
8195 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8196 # status code that was returned. For example, a `404` means the
8197 # resource was not found.
8198 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8199 # defined by the server.
8200 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8201 # This value is inRFC3339
8202 # text format.
8203 &quot;instancesBulkInsertOperationMetadata&quot;: {
8204 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8205 # Example key: zones/us-central1-a
8206 &quot;a_key&quot;: {
8207 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8208 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8209 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8210 # error.
8211 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8212 # if the flow is rolling forward or rolling back.
8213 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8214 },
8215 },
8216 },
8217 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8218 # Operation resources.
8219 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8220 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8221 # group of operations results from a `bulkInsert` API request.
8222 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8223 # `update`, or `delete`, and so on.
8224 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8225 # There is no requirement that this be linear or support any granularity of
8226 # operations. This should not be used to guess when the operation will be
8227 # complete. This number should monotonically increase as the operation
8228 # progresses.
8229 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8230 # applicable when performing regional operations.
8231 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8232 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
8233 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8234 # this field will contain information on all underlying zonal actions and
8235 # their state.
8236 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8237 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8238 # Example key: zones/us-central1-a
8239 &quot;a_key&quot;: {
8240 &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
8241 # populated.
8242 # different programming environments, including REST APIs and RPC APIs. It is
8243 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8244 # three pieces of data: error code, error message, and error details.
8245 #
8246 # You can find out more about this error model and how to work with it in the
8247 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8248 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8249 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8250 # message types for APIs to use.
8251 {
8252 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8253 },
8254 ],
8255 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8256 # user-facing error message should be localized and sent in the
8257 # google.rpc.Status.details field, or localized by the client.
8258 },
8259 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8260 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8261 },
8262 },
8263 },
8264 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8265 # This value is inRFC3339
8266 # text format.
8267 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8268 # following:
8269 # `PENDING`, `RUNNING`, or `DONE`.
8270 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8271 # operation.
8272 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8273 # of the target resource.
8274 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8275 # operations related to creating a snapshot, this points to the disk
8276 # that the snapshot was created from.
8277 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8278 # `[email protected]` or
8279 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8280 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8281 # operation, this field will be populated.
8282 {
8283 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8284 # Engine returns NO_RESULTS_ON_PAGE if there
8285 # are no results in the response.
8286 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8287 # value format. For example:
8288 #
8289 # &quot;data&quot;: [
8290 # {
8291 # &quot;key&quot;: &quot;scope&quot;,
8292 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8293 # }
8294 {
8295 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8296 # returned. For example, for warnings where there are no results in a list
8297 # request for a particular zone, this key might be scope and
8298 # the key value might be the zone name. Other examples might be a key
8299 # indicating a deprecated resource and a suggested replacement, or a
8300 # warning about invalid network settings (for example, if an instance
8301 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8302 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8303 },
8304 ],
8305 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8306 },
8307 ],
8308 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8309 # applicable when performing per-zone operations.
8310 }</pre>
8311 </div>
8312
8313 <div class="method">
8314 <code class="details" id="stopGroupAsyncReplication">stopGroupAsyncReplication(project, zone, body=None, requestId=None, x__xgafv=None)</code>
8315 <pre>Stops asynchronous replication for a consistency group of disks.
8316 Can be invoked either in the primary or secondary scope.
8317
8318 Args:
8319 project: string, Project ID for this request. (required)
8320 zone: string, The name of the zone for this request. This must be the zone of the primary
8321 or secondary disks in the consistency group. (required)
8322 body: object, The request body.
8323 The object takes the form of:
8324
8325 { # A transient resource used in compute.disks.stopGroupAsyncReplication and
8326 # compute.regionDisks.stopGroupAsyncReplication. It is only used to process
8327 # requests and is not persisted.
8328 &quot;resourcePolicy&quot;: &quot;A String&quot;, # The URL of the DiskConsistencyGroupPolicy for the group of disks to stop.
8329 # This may be a full or partial URL, such as:
8330 #
8331 #
8332 # -
8333 # https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
8334 #
8335 # -
8336 # projects/project/regions/region/resourcePolicies/resourcePolicy
8337 #
8338 # -
8339 # regions/region/resourcePolicies/resourcePolicy
8340 }
8341
8342 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
8343 that if you must retry your request, the server will know to ignore the
8344 request if it has already been completed.
8345
8346 For example, consider a situation where you make an initial request and
8347 the request times out. If you make the request again with the same
8348 request ID, the server can check if original operation with the same
8349 request ID was received, and if so, will ignore the second request. This
8350 prevents clients from accidentally creating duplicate commitments.
8351
8352 The request ID must be
8353 a valid UUID with the exception that zero UUID is not supported
8354 (00000000-0000-0000-0000-000000000000).
8355 x__xgafv: string, V1 error format.
8356 Allowed values
8357 1 - v1 error format
8358 2 - v2 error format
8359
8360 Returns:
8361 An object of the form:
8362
8363 { # Represents an Operation resource.
8364 #
8365 # Google Compute Engine has three Operation resources:
8366 #
8367 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
8368 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
8369 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
8370 #
8371 # You can use an operation resource to manage asynchronous API requests.
8372 # For more information, readHandling
8373 # API responses.
8374 #
8375 # Operations can be global, regional or zonal.
8376 #
8377 # - For global operations, use the `globalOperations`
8378 # resource.
8379 # - For regional operations, use the
8380 # `regionOperations` resource.
8381 # - For zonal operations, use
8382 # the `zoneOperations` resource.
8383 #
8384 #
8385 #
8386 # For more information, read
8387 # Global, Regional, and Zonal Resources.
8388 #
8389 # Note that completed Operation resources have a limited
8390 # retention period.
8391 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
8392 # Not present otherwise.
8393 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
8394 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
8395 # set when the operation is created.
8396 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
8397 # text format.
8398 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
8399 # this field will be populated.
8400 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8401 # operation.
8402 {
8403 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8404 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8405 # details. There is a set of defined message types to use for providing
8406 # details.The syntax depends on the error code. For example,
8407 # QuotaExceededInfo will have details when the error code is
8408 # QUOTA_EXCEEDED.
8409 {
8410 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8411 #
8412 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8413 # is not enabled:
8414 #
8415 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8416 # &quot;domain&quot;: &quot;googleapis.com&quot;
8417 # &quot;metadata&quot;: {
8418 # &quot;resource&quot;: &quot;projects/123&quot;,
8419 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8420 # }
8421 # }
8422 #
8423 # This response indicates that the pubsub.googleapis.com API is not enabled.
8424 #
8425 # Example of an error that is returned when attempting to create a Spanner
8426 # instance in a region that is out of stock:
8427 #
8428 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8429 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8430 # &quot;metadata&quot;: {
8431 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8432 # }
8433 # }
8434 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8435 # is typically the registered service name of the tool or product that
8436 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8437 # generated by some common infrastructure, the error domain must be a
8438 # globally unique value that identifies the infrastructure. For Google API
8439 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8440 &quot;metadatas&quot;: { # Additional structured details about this error.
8441 #
8442 # Keys must match a regular expression of `a-z+` but should
8443 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8444 # length. When identifying the current value of an exceeded limit, the units
8445 # should be contained in the key, not the value. For example, rather than
8446 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8447 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8448 # instances that can be created in a single (batch) request.
8449 &quot;a_key&quot;: &quot;A String&quot;,
8450 },
8451 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8452 # proximate cause of the error. Error reasons are unique within a particular
8453 # domain of errors. This should be at most 63 characters and match a
8454 # regular expression of `A-Z+[A-Z0-9]`, which represents
8455 # UPPER_SNAKE_CASE.
8456 },
8457 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8458 #
8459 # For example, if a quota check failed with an error indicating the calling
8460 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8461 # directly to the right place in the developer console to flip the bit.
8462 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8463 { # Describes a URL link.
8464 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8465 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8466 },
8467 ],
8468 },
8469 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8470 # which can be attached to an RPC error.
8471 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8472 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8473 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8474 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8475 },
8476 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8477 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8478 &quot;a_key&quot;: &quot;A String&quot;,
8479 },
8480 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8481 # type or metric.
8482 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8483 # or metric.
8484 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8485 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8486 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8487 },
8488 },
8489 ],
8490 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8491 # This property is optional.
8492 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8493 },
8494 ],
8495 },
8496 &quot;getVersionOperationMetadata&quot;: {
8497 &quot;inlineSbomInfo&quot;: {
8498 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
8499 # appropriate identifiers.
8500 &quot;a_key&quot;: &quot;A String&quot;,
8501 },
8502 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
8503 # identifiers.
8504 &quot;a_key&quot;: &quot;A String&quot;,
8505 },
8506 },
8507 },
8508 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
8509 # message that was returned, such as `NOT FOUND`.
8510 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
8511 # status code that was returned. For example, a `404` means the
8512 # resource was not found.
8513 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
8514 # defined by the server.
8515 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
8516 # This value is inRFC3339
8517 # text format.
8518 &quot;instancesBulkInsertOperationMetadata&quot;: {
8519 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
8520 # Example key: zones/us-central1-a
8521 &quot;a_key&quot;: {
8522 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
8523 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
8524 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
8525 # error.
8526 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
8527 # if the flow is rolling forward or rolling back.
8528 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
8529 },
8530 },
8531 },
8532 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
8533 # Operation resources.
8534 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
8535 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
8536 # group of operations results from a `bulkInsert` API request.
8537 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
8538 # `update`, or `delete`, and so on.
8539 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
8540 # There is no requirement that this be linear or support any granularity of
8541 # operations. This should not be used to guess when the operation will be
8542 # complete. This number should monotonically increase as the operation
8543 # progresses.
8544 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
8545 # applicable when performing regional operations.
8546 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
8547 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
8548 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
8549 # this field will contain information on all underlying zonal actions and
8550 # their state.
8551 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
8552 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
8553 # Example key: zones/us-central1-a
8554 &quot;a_key&quot;: {
8555 &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
8556 # populated.
8557 # different programming environments, including REST APIs and RPC APIs. It is
8558 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
8559 # three pieces of data: error code, error message, and error details.
8560 #
8561 # You can find out more about this error model and how to work with it in the
8562 # [API Design Guide](https://cloud.google.com/apis/design/errors).
8563 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
8564 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
8565 # message types for APIs to use.
8566 {
8567 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
8568 },
8569 ],
8570 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
8571 # user-facing error message should be localized and sent in the
8572 # google.rpc.Status.details field, or localized by the client.
8573 },
8574 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
8575 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
8576 },
8577 },
8578 },
8579 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
8580 # This value is inRFC3339
8581 # text format.
8582 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
8583 # following:
8584 # `PENDING`, `RUNNING`, or `DONE`.
8585 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8586 # operation.
8587 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8588 # of the target resource.
8589 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8590 # operations related to creating a snapshot, this points to the disk
8591 # that the snapshot was created from.
8592 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8593 # `[email protected]` or
8594 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8595 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8596 # operation, this field will be populated.
8597 {
8598 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8599 # Engine returns NO_RESULTS_ON_PAGE if there
8600 # are no results in the response.
8601 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8602 # value format. For example:
8603 #
8604 # &quot;data&quot;: [
8605 # {
8606 # &quot;key&quot;: &quot;scope&quot;,
8607 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8608 # }
8609 {
8610 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8611 # returned. For example, for warnings where there are no results in a list
8612 # request for a particular zone, this key might be scope and
8613 # the key value might be the zone name. Other examples might be a key
8614 # indicating a deprecated resource and a suggested replacement, or a
8615 # warning about invalid network settings (for example, if an instance
8616 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8617 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8618 },
8619 ],
8620 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8621 },
8622 ],
8623 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8624 # applicable when performing per-zone operations.
8625 }</pre>
8626 </div>
8627
8628 <div class="method">
8629 <code class="details" id="testIamPermissions">testIamPermissions(project, zone, resource, body=None, x__xgafv=None)</code>
8630 <pre>Returns permissions that a caller has on the specified resource.
8631
8632 Args:
8633 project: string, Project ID for this request. (required)
8634 zone: string, The name of the zone for this request. (required)
8635 resource: string, Name or id of the resource for this request. (required)
8636 body: object, The request body.
8637 The object takes the form of:
8638
8639 {
8640 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
8641 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
8642 &quot;A String&quot;,
8643 ],
8644 }
8645
8646 x__xgafv: string, V1 error format.
8647 Allowed values
8648 1 - v1 error format
8649 2 - v2 error format
8650
8651 Returns:
8652 An object of the form:
8653
8654 {
8655 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
8656 # allowed.
8657 &quot;A String&quot;,
8658 ],
8659 }</pre>
8660 </div>
8661
8662 <div class="method">
8663 <code class="details" id="update">update(project, zone, disk, body=None, paths=None, requestId=None, updateMask=None, x__xgafv=None)</code>
8664 <pre>Updates the specified disk with the data included in the request.
8665 The update is performed only on selected fields included as part
8666 of update-mask.
8667
8668 Args:
8669 project: string, Project ID for this request. (required)
8670 zone: string, The name of the zone for this request. (required)
8671 disk: string, The disk name for this request. (required)
8672 body: object, The request body.
8673 The object takes the form of:
8674
8675 { # Represents a Persistent Disk resource.
8676 #
8677 # Google Compute Engine has two Disk resources:
8678 #
8679 # * [Zonal](/compute/docs/reference/rest/alpha/disks)
8680 # * [Regional](/compute/docs/reference/rest/alpha/regionDisks)
8681 #
8682 # Persistent disks are required for running your VM instances.
8683 # Create both boot and non-boot (data) persistent disks. For more information,
8684 # read Persistent Disks. For more
8685 # storage options, read Storage options.
8686 #
8687 # The disks resource represents a zonal persistent disk.
8688 # For more information, readZonal persistent disks.
8689 #
8690 # The regionDisks resource represents a
8691 # regional persistent disk. For more information, read
8692 # Regional resources.
8693 &quot;accessMode&quot;: &quot;A String&quot;, # The access mode of the disk.
8694 #
8695 #
8696 # - READ_WRITE_SINGLE: The default AccessMode, means the
8697 # disk can be attached to single instance in RW mode.
8698 # - READ_WRITE_MANY: The AccessMode means the disk can be
8699 # attached to multiple instances in RW mode.
8700 # - READ_ONLY_MANY: The AccessMode means the disk can be
8701 # attached to multiple instances in RO mode.
8702 #
8703 #
8704 # The AccessMode is only valid for Hyperdisk disk types.
8705 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the disk. Valid values are
8706 # ARM64 or X86_64.
8707 &quot;asyncPrimaryDisk&quot;: { # Disk asynchronously replicated into this disk.
8708 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
8709 # started on the disk as a member of a group.
8710 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
8711 # started on the disk as a member of a group.
8712 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
8713 # You can provide this as a partial or full URL to the resource.
8714 # For example, the following are valid values:
8715 #
8716 #
8717 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
8718 # - projects/project/zones/zone/disks/disk
8719 # - zones/zone/disks/disk
8720 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
8721 # to or from the current disk. This value identifies the exact disk that
8722 # was used to create this replication. For example, if you started
8723 # replicating the persistent disk from a disk that was later deleted and
8724 # recreated under the same name, the disk ID would identify the exact
8725 # version of the disk that was used.
8726 },
8727 &quot;asyncSecondaryDisks&quot;: { # Output only. [Output Only] A list of disks this disk is asynchronously replicated to.
8728 &quot;a_key&quot;: {
8729 &quot;asyncReplicationDisk&quot;: {
8730 &quot;consistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy if replication was
8731 # started on the disk as a member of a group.
8732 &quot;consistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy if replication was
8733 # started on the disk as a member of a group.
8734 &quot;disk&quot;: &quot;A String&quot;, # The other disk asynchronously replicated to or from the current disk.
8735 # You can provide this as a partial or full URL to the resource.
8736 # For example, the following are valid values:
8737 #
8738 #
8739 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
8740 # - projects/project/zones/zone/disks/disk
8741 # - zones/zone/disks/disk
8742 &quot;diskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the other disk asynchronously replicated
8743 # to or from the current disk. This value identifies the exact disk that
8744 # was used to create this replication. For example, if you started
8745 # replicating the persistent disk from a disk that was later deleted and
8746 # recreated under the same name, the disk ID would identify the exact
8747 # version of the disk that was used.
8748 },
8749 },
8750 },
8751 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
8752 # text format.
8753 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
8754 # create the resource.
8755 &quot;diskEncryptionKey&quot;: { # Encrypts the disk using a
8756 # customer-supplied encryption key or a
8757 # customer-managed encryption key.
8758 #
8759 # Encryption keys do not protect access to metadata of the disk.
8760 #
8761 # After you encrypt a disk with a customer-supplied key, you must provide the
8762 # same key if you use the disk later. For example, to create a disk snapshot,
8763 # to create a disk image, to create a machine image, or to attach the disk to
8764 # a virtual machine.
8765 #
8766 # After you encrypt a disk with a customer-managed key, thediskEncryptionKey.kmsKeyName is set to a key *version*
8767 # name once the disk is created. The disk is encrypted with this version of
8768 # the key. In the response, diskEncryptionKey.kmsKeyName appears
8769 # in the following format:
8770 #
8771 # &quot;diskEncryptionKey.kmsKeyName&quot;:
8772 # &quot;projects/kms_project_id/locations/region/keyRings/
8773 # key_region/cryptoKeys/key
8774 # /cryptoKeysVersions/version
8775 #
8776 # If you do not provide an encryption key when creating the disk, then the
8777 # disk is encrypted using an automatically generated key and you don&#x27;t need
8778 # to provide a key to use the disk later.
8779 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
8780 # For example:
8781 #
8782 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8783 # key_region/cryptoKeys/key
8784 #
8785 # The fully-qualifed key name may be returned for resource GET requests. For
8786 # example:
8787 #
8788 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8789 # key_region/cryptoKeys/key
8790 # /cryptoKeyVersions/1
8791 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
8792 # key. If absent, the Compute Engine default service account is used.
8793 # For example:
8794 #
8795 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
8796 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
8797 # encryption key, encoded in RFC
8798 # 4648 base64 to either encrypt or decrypt this resource. You can
8799 # provide either the rawKey or thersaEncryptedKey.
8800 # For example:
8801 #
8802 # &quot;rawKey&quot;:
8803 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
8804 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
8805 # customer-supplied encryption key to either encrypt or decrypt this
8806 # resource. You can provide either the rawKey or thersaEncryptedKey.
8807 # For example:
8808 #
8809 # &quot;rsaEncryptedKey&quot;:
8810 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
8811 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
8812 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
8813 #
8814 # The key must meet the following requirements before you can provide it to
8815 # Compute Engine:
8816 #
8817 # 1. The key is wrapped using a RSA public key certificate provided by
8818 # Google.
8819 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
8820 # encoding.
8821 #
8822 # Gets the RSA public key certificate provided by Google at:
8823 #
8824 #
8825 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
8826 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
8827 # 4648 base64 encoded SHA-256 hash of the customer-supplied
8828 # encryption key that protects this resource.
8829 },
8830 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
8831 &quot;eraseWindowsVssSignature&quot;: True or False, # Specifies whether the disk restored from a source snapshot should erase
8832 # Windows specific VSS signature.
8833 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
8834 # only for bootable images. Read
8835 # Enabling guest operating system features to see a list of available
8836 # options.
8837 { # Guest OS features.
8838 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
8839 # separate values. Set to one or more of the following values:
8840 #
8841 # - VIRTIO_SCSI_MULTIQUEUE
8842 # - WINDOWS
8843 # - MULTI_IP_SUBNET
8844 # - UEFI_COMPATIBLE
8845 # - GVNIC
8846 # - SEV_CAPABLE
8847 # - SUSPEND_RESUME_COMPATIBLE
8848 # - SEV_LIVE_MIGRATABLE_V2
8849 # - SEV_SNP_CAPABLE
8850 # - TDX_CAPABLE
8851 # - IDPF
8852 # - SNP_SVSM_CAPABLE
8853 # - CCA_CAPABLE
8854 #
8855 #
8856 # For more information, see
8857 # Enabling guest operating system features.
8858 },
8859 ],
8860 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
8861 # defined by the server.
8862 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
8863 # which is either SCSI or NVME. The default isSCSI.
8864 &quot;kind&quot;: &quot;compute#disk&quot;, # Output only. [Output Only] Type of the resource. Always compute#disk for
8865 # disks.
8866 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this disk, which is
8867 # essentially a hash of the labels set used for optimistic locking. The
8868 # fingerprint is initially generated by Compute Engine and changes after
8869 # every request to modify or update labels. You must always provide an
8870 # up-to-date fingerprint hash in order to update or change labels,
8871 # otherwise the request will fail with error412 conditionNotMet.
8872 #
8873 # To see the latest fingerprint, make a get() request to
8874 # retrieve a disk.
8875 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by
8876 # the setLabels method.
8877 &quot;a_key&quot;: &quot;A String&quot;,
8878 },
8879 &quot;lastAttachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last attach timestamp inRFC3339
8880 # text format.
8881 &quot;lastDetachTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Last detach timestamp inRFC3339
8882 # text format.
8883 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this disk.
8884 &quot;A String&quot;,
8885 ],
8886 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
8887 &quot;A String&quot;,
8888 ],
8889 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the disk close to other resources.
8890 # This field is for use by internal tools that use the public API.
8891 &quot;locked&quot;: True or False, # Output only. [Output Only] The field indicates if the disk is created from a locked
8892 # source image. Attachment of a disk created from a locked source image will
8893 # cause the following operations to become irreversibly prohibited:
8894 #
8895 # - R/W or R/O disk attachment to any other instance
8896 # - Disk detachment. And the disk can only be deleted when the instance
8897 # is deleted
8898 # - Creation of images or snapshots
8899 # - Disk cloning
8900 #
8901 #
8902 #
8903 # Furthermore, the instance with at least one disk with locked flag set to
8904 # true will be prohibited from performing the operations below:
8905 #
8906 # - Further attachment of secondary disks.
8907 # - Detachment of any disks
8908 # - Create machine images
8909 # - Create instance template
8910 # - Delete the instance with --keep-disk parameter set to true for locked
8911 # disks
8912 # - Attach a locked disk with --auto-delete parameter set to false
8913 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
8914 # more than one instance.
8915 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
8916 # The name must be 1-63 characters long, and comply withRFC1035.
8917 # Specifically, the name must be 1-63 characters long and match the regular
8918 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`
8919 # which means the first character must be a lowercase letter, and all
8920 # following characters must be a dash, lowercase letter, or digit, except
8921 # the last character, which cannot be a dash.
8922 &quot;options&quot;: &quot;A String&quot;, # Internal use only.
8923 &quot;params&quot;: { # Additional disk params. # Input only. [Input Only] Additional params passed with the request, but not persisted
8924 # as part of resource payload.
8925 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
8926 # have the same definition as resource
8927 # manager tags. Keys and values can be either in numeric format,
8928 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
8929 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
8930 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
8931 # PATCH) when empty.
8932 &quot;a_key&quot;: &quot;A String&quot;,
8933 },
8934 },
8935 &quot;physicalBlockSizeBytes&quot;: &quot;A String&quot;, # Physical block size of the persistent disk, in bytes.
8936 # If not present in a request, a default value is used.
8937 # The currently supported size is 4096, other sizes may be added in
8938 # the future.
8939 # If an unsupported value is requested, the error message will list
8940 # the supported values for the caller&#x27;s project.
8941 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
8942 # of I/O operations per second that the disk can handle. Values must be
8943 # between 10,000 and 120,000. For more details, see theExtreme persistent
8944 # disk documentation.
8945 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
8946 # number of throughput mb per second that the disk can handle. Values must be
8947 # greater than or equal to 1.
8948 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the disk resides. Only applicable for
8949 # regional resources.
8950 # You must specify this field as part of the HTTP request URL. It is
8951 # not settable as a field in the request body.
8952 &quot;replicaZones&quot;: [ # URLs of the zones where the disk should be replicated to. Only applicable
8953 # for regional resources.
8954 &quot;A String&quot;,
8955 ],
8956 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
8957 &quot;A String&quot;,
8958 ],
8959 &quot;resourceStatus&quot;: { # Output only. [Output Only] Status information for the disk resource.
8960 &quot;asyncPrimaryDisk&quot;: {
8961 &quot;state&quot;: &quot;A String&quot;,
8962 },
8963 &quot;asyncSecondaryDisks&quot;: { # Key: disk, value: AsyncReplicationStatus message
8964 &quot;a_key&quot;: {
8965 &quot;state&quot;: &quot;A String&quot;,
8966 },
8967 },
8968 &quot;usedBytes&quot;: &quot;A String&quot;, # [Output Only] Space used by data stored in the disk (in bytes). Note that
8969 # this field is set only when the disk is in a storage pool.
8970 },
8971 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
8972 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
8973 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
8974 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource&#x27;s resource id.
8975 &quot;sizeGb&quot;: &quot;A String&quot;, # Size, in GB, of the persistent disk. You can specify
8976 # this field when creating a persistent disk using thesourceImage, sourceSnapshot, orsourceDisk parameter, or specify it alone to create an empty
8977 # persistent disk.
8978 #
8979 # If you specify this field along with a source, the value ofsizeGb must not be less than the size of the
8980 # source.
8981 # Acceptable values are greater than 0.
8982 &quot;sourceConsistencyGroupPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the DiskConsistencyGroupPolicy for a secondary disk
8983 # that was created using a consistency group.
8984 &quot;sourceConsistencyGroupPolicyId&quot;: &quot;A String&quot;, # Output only. [Output Only] ID of the DiskConsistencyGroupPolicy for a secondary disk
8985 # that was created using a consistency group.
8986 &quot;sourceDisk&quot;: &quot;A String&quot;, # The source disk used to create this disk. You can provide this as a
8987 # partial or full URL to the resource. For example, the following are valid
8988 # values:
8989 #
8990 #
8991 # -
8992 # https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
8993 #
8994 # -
8995 # https://www.googleapis.com/compute/v1/projects/project/regions/region/disks/disk
8996 #
8997 # -
8998 # projects/project/zones/zone/disks/disk
8999 #
9000 # -
9001 # projects/project/regions/region/disks/disk
9002 #
9003 # -
9004 # zones/zone/disks/disk
9005 #
9006 # -
9007 # regions/region/disks/disk
9008 &quot;sourceDiskId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the disk used to create this disk. This
9009 # value identifies the exact disk that was used to create this persistent
9010 # disk. For example, if you created the persistent disk from a disk that
9011 # was later deleted and recreated under the same name, the source disk ID
9012 # would identify the exact version of the disk that was used.
9013 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image used to create this disk. If the source image is
9014 # deleted, this field will not be set.
9015 #
9016 # To create a disk with one of the public operating system images, specify
9017 # the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
9018 #
9019 # projects/debian-cloud/global/images/family/debian-9
9020 #
9021 #
9022 # Alternatively, use a specific version of a public operating system image:
9023 #
9024 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
9025 #
9026 #
9027 # To create a disk with a custom image that you created, specify the
9028 # image name in the following format:
9029 #
9030 # global/images/my-custom-image
9031 #
9032 #
9033 # You can also specify a custom image by its image family, which returns
9034 # the latest version of the image in that family. Replace the image name
9035 # with family/family-name:
9036 #
9037 # global/images/family/my-image-family
9038 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
9039 # encryption key of the source image. Required if the source image is
9040 # protected by a customer-supplied encryption key.
9041 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9042 # For example:
9043 #
9044 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9045 # key_region/cryptoKeys/key
9046 #
9047 # The fully-qualifed key name may be returned for resource GET requests. For
9048 # example:
9049 #
9050 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9051 # key_region/cryptoKeys/key
9052 # /cryptoKeyVersions/1
9053 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9054 # key. If absent, the Compute Engine default service account is used.
9055 # For example:
9056 #
9057 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9058 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9059 # encryption key, encoded in RFC
9060 # 4648 base64 to either encrypt or decrypt this resource. You can
9061 # provide either the rawKey or thersaEncryptedKey.
9062 # For example:
9063 #
9064 # &quot;rawKey&quot;:
9065 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9066 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9067 # customer-supplied encryption key to either encrypt or decrypt this
9068 # resource. You can provide either the rawKey or thersaEncryptedKey.
9069 # For example:
9070 #
9071 # &quot;rsaEncryptedKey&quot;:
9072 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9073 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9074 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9075 #
9076 # The key must meet the following requirements before you can provide it to
9077 # Compute Engine:
9078 #
9079 # 1. The key is wrapped using a RSA public key certificate provided by
9080 # Google.
9081 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9082 # encoding.
9083 #
9084 # Gets the RSA public key certificate provided by Google at:
9085 #
9086 #
9087 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9088 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9089 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9090 # encryption key that protects this resource.
9091 },
9092 &quot;sourceImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The ID value of the image used to create this disk. This
9093 # value identifies the exact image that was used to create this persistent
9094 # disk. For example, if you created the persistent disk from an image that
9095 # was later deleted and recreated under the same name, the source image ID
9096 # would identify the exact version of the image that was used.
9097 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant snapshot used to create this disk. You can provide
9098 # this as a partial or full URL to the resource. For example, the following
9099 # are valid values:
9100 #
9101 #
9102 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instantSnapshots/instantSnapshot
9103 # - projects/project/zones/zone/instantSnapshots/instantSnapshot
9104 # - zones/zone/instantSnapshots/instantSnapshot
9105 &quot;sourceInstantSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the instant snapshot used to create this
9106 # disk. This value identifies the exact instant snapshot that was used to
9107 # create this persistent disk. For example, if you created the persistent
9108 # disk from an instant snapshot that was later deleted and recreated under
9109 # the same name, the source instant snapshot ID would identify the exact
9110 # version of the instant snapshot that was used.
9111 &quot;sourceMachineImage&quot;: &quot;A String&quot;, # The machine image to create the disk from. You can provide this as a
9112 # partial or full URL to the resource. For example, the following are valid
9113 # values:
9114 #
9115 #
9116 # - https://www.googleapis.com/compute/v1/projects/project/global/machineImages/machineImage
9117 # - projects/project/global/machineImages/machineImage
9118 # - global/machineImages/machineImage
9119 &quot;sourceMachineImageDiskDeviceName&quot;: &quot;A String&quot;, # The device name of a disk within a given machine image. The
9120 # source_machine_image must be specified.
9121 &quot;sourceMachineImageEncryptionKey&quot;: { # Thecustomer-supplied
9122 # encryption key of the source machine image. Required if the source
9123 # machine image is protected by a customer-supplied encryption key.
9124 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9125 # For example:
9126 #
9127 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9128 # key_region/cryptoKeys/key
9129 #
9130 # The fully-qualifed key name may be returned for resource GET requests. For
9131 # example:
9132 #
9133 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9134 # key_region/cryptoKeys/key
9135 # /cryptoKeyVersions/1
9136 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9137 # key. If absent, the Compute Engine default service account is used.
9138 # For example:
9139 #
9140 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9141 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9142 # encryption key, encoded in RFC
9143 # 4648 base64 to either encrypt or decrypt this resource. You can
9144 # provide either the rawKey or thersaEncryptedKey.
9145 # For example:
9146 #
9147 # &quot;rawKey&quot;:
9148 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9149 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9150 # customer-supplied encryption key to either encrypt or decrypt this
9151 # resource. You can provide either the rawKey or thersaEncryptedKey.
9152 # For example:
9153 #
9154 # &quot;rsaEncryptedKey&quot;:
9155 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9156 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9157 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9158 #
9159 # The key must meet the following requirements before you can provide it to
9160 # Compute Engine:
9161 #
9162 # 1. The key is wrapped using a RSA public key certificate provided by
9163 # Google.
9164 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9165 # encoding.
9166 #
9167 # Gets the RSA public key certificate provided by Google at:
9168 #
9169 #
9170 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9171 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9172 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9173 # encryption key that protects this resource.
9174 },
9175 &quot;sourceMachineImageId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the machine image used to create this disk.
9176 # This value identifies the exact machine image that was used to create this
9177 # persistent disk. For example, if you created the persistent disk from a
9178 # machine image that was later deleted and recreated under the same name, the
9179 # source machine image ID would identify the exact version of the machine
9180 # image that was used.
9181 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot used to create this disk. You can provide this as a
9182 # partial or full URL to the resource. For example, the following are valid
9183 # values:
9184 #
9185 #
9186 # - https://www.googleapis.com/compute/v1/projects/project/global/snapshots/snapshot
9187 # - projects/project/global/snapshots/snapshot
9188 # - global/snapshots/snapshot
9189 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
9190 # encryption key of the source snapshot. Required if the source snapshot
9191 # is protected by a customer-supplied encryption key.
9192 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9193 # For example:
9194 #
9195 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9196 # key_region/cryptoKeys/key
9197 #
9198 # The fully-qualifed key name may be returned for resource GET requests. For
9199 # example:
9200 #
9201 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9202 # key_region/cryptoKeys/key
9203 # /cryptoKeyVersions/1
9204 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9205 # key. If absent, the Compute Engine default service account is used.
9206 # For example:
9207 #
9208 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9209 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9210 # encryption key, encoded in RFC
9211 # 4648 base64 to either encrypt or decrypt this resource. You can
9212 # provide either the rawKey or thersaEncryptedKey.
9213 # For example:
9214 #
9215 # &quot;rawKey&quot;:
9216 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9217 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9218 # customer-supplied encryption key to either encrypt or decrypt this
9219 # resource. You can provide either the rawKey or thersaEncryptedKey.
9220 # For example:
9221 #
9222 # &quot;rsaEncryptedKey&quot;:
9223 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9224 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9225 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9226 #
9227 # The key must meet the following requirements before you can provide it to
9228 # Compute Engine:
9229 #
9230 # 1. The key is wrapped using a RSA public key certificate provided by
9231 # Google.
9232 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9233 # encoding.
9234 #
9235 # Gets the RSA public key certificate provided by Google at:
9236 #
9237 #
9238 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9239 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9240 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9241 # encryption key that protects this resource.
9242 },
9243 &quot;sourceSnapshotId&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique ID of the snapshot used to create this disk. This
9244 # value identifies the exact snapshot that was used to create this persistent
9245 # disk. For example, if you created the persistent disk from a snapshot that
9246 # was later deleted and recreated under the same name, the source snapshot ID
9247 # would identify the exact version of the snapshot that was used.
9248 &quot;sourceStorageObject&quot;: &quot;A String&quot;, # The full Google Cloud Storage URI where the disk image is stored. This file
9249 # must be a gzip-compressed tarball whose name ends in .tar.gz or virtual
9250 # machine disk whose name ends in vmdk. Valid URIs may start with gs:// or
9251 # https://storage.googleapis.com/. This flag is not optimized for creating
9252 # multiple disks from a source storage object. To create many disks from a
9253 # source storage object, use gcloud compute images
9254 # import instead.
9255 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of disk creation.
9256 #
9257 #
9258 # - CREATING: Disk is provisioning.
9259 # - RESTORING: Source data is being copied into the
9260 # disk.
9261 # - FAILED: Disk creation failed.
9262 # - READY: Disk is ready for use.
9263 # - DELETING: Disk is deleting.
9264 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
9265 # this as a partial or full URL to the resource. For example, the following
9266 # are valid values:
9267 #
9268 #
9269 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
9270 # - projects/project/zones/zone/storagePools/storagePool
9271 # - zones/zone/storagePools/storagePool
9272 &quot;storageType&quot;: &quot;A String&quot;, # [Deprecated] Storage type of the persistent disk.
9273 &quot;type&quot;: &quot;A String&quot;, # URL of the disk type resource describing which disk type to use to create
9274 # the disk. Provide this when creating the disk. For example:projects/project/zones/zone/diskTypes/pd-ssd. See Persistent disk
9275 # types.
9276 &quot;users&quot;: [ # Output only. [Output Only] Links to the users of the disk (attached instances)
9277 # in form:projects/project/zones/zone/instances/instance
9278 &quot;A String&quot;,
9279 ],
9280 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the disk resides.
9281 # You must specify this field as part of the HTTP request URL. It is
9282 # not settable as a field in the request body.
9283 }
9284
9285 paths: string, A parameter (repeated)
9286 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
9287 that if you must retry your request, the server will know to ignore the
9288 request if it has already been completed.
9289
9290 For example, consider a situation where you make an initial request and
9291 the request times out. If you make the request again with the same
9292 request ID, the server can check if original operation with the same
9293 request ID was received, and if so, will ignore the second request. This
9294 prevents clients from accidentally creating duplicate commitments.
9295
9296 The request ID must be
9297 a valid UUID with the exception that zero UUID is not supported
9298 (00000000-0000-0000-0000-000000000000).
9299 updateMask: string, update_mask indicates fields to be updated as part of this request.
9300 x__xgafv: string, V1 error format.
9301 Allowed values
9302 1 - v1 error format
9303 2 - v2 error format
9304
9305 Returns:
9306 An object of the form:
9307
9308 { # Represents an Operation resource.
9309 #
9310 # Google Compute Engine has three Operation resources:
9311 #
9312 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
9313 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
9314 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
9315 #
9316 # You can use an operation resource to manage asynchronous API requests.
9317 # For more information, readHandling
9318 # API responses.
9319 #
9320 # Operations can be global, regional or zonal.
9321 #
9322 # - For global operations, use the `globalOperations`
9323 # resource.
9324 # - For regional operations, use the
9325 # `regionOperations` resource.
9326 # - For zonal operations, use
9327 # the `zoneOperations` resource.
9328 #
9329 #
9330 #
9331 # For more information, read
9332 # Global, Regional, and Zonal Resources.
9333 #
9334 # Note that completed Operation resources have a limited
9335 # retention period.
9336 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
9337 # Not present otherwise.
9338 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
9339 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
9340 # set when the operation is created.
9341 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
9342 # text format.
9343 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
9344 # this field will be populated.
9345 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
9346 # operation.
9347 {
9348 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
9349 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
9350 # details. There is a set of defined message types to use for providing
9351 # details.The syntax depends on the error code. For example,
9352 # QuotaExceededInfo will have details when the error code is
9353 # QUOTA_EXCEEDED.
9354 {
9355 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
9356 #
9357 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
9358 # is not enabled:
9359 #
9360 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
9361 # &quot;domain&quot;: &quot;googleapis.com&quot;
9362 # &quot;metadata&quot;: {
9363 # &quot;resource&quot;: &quot;projects/123&quot;,
9364 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
9365 # }
9366 # }
9367 #
9368 # This response indicates that the pubsub.googleapis.com API is not enabled.
9369 #
9370 # Example of an error that is returned when attempting to create a Spanner
9371 # instance in a region that is out of stock:
9372 #
9373 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
9374 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
9375 # &quot;metadata&quot;: {
9376 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
9377 # }
9378 # }
9379 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
9380 # is typically the registered service name of the tool or product that
9381 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
9382 # generated by some common infrastructure, the error domain must be a
9383 # globally unique value that identifies the infrastructure. For Google API
9384 # infrastructure, the error domain is &quot;googleapis.com&quot;.
9385 &quot;metadatas&quot;: { # Additional structured details about this error.
9386 #
9387 # Keys must match a regular expression of `a-z+` but should
9388 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
9389 # length. When identifying the current value of an exceeded limit, the units
9390 # should be contained in the key, not the value. For example, rather than
9391 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
9392 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
9393 # instances that can be created in a single (batch) request.
9394 &quot;a_key&quot;: &quot;A String&quot;,
9395 },
9396 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
9397 # proximate cause of the error. Error reasons are unique within a particular
9398 # domain of errors. This should be at most 63 characters and match a
9399 # regular expression of `A-Z+[A-Z0-9]`, which represents
9400 # UPPER_SNAKE_CASE.
9401 },
9402 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
9403 #
9404 # For example, if a quota check failed with an error indicating the calling
9405 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
9406 # directly to the right place in the developer console to flip the bit.
9407 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
9408 { # Describes a URL link.
9409 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
9410 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
9411 },
9412 ],
9413 },
9414 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
9415 # which can be attached to an RPC error.
9416 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
9417 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
9418 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
9419 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
9420 },
9421 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
9422 &quot;dimensions&quot;: { # The map holding related quota dimensions.
9423 &quot;a_key&quot;: &quot;A String&quot;,
9424 },
9425 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
9426 # type or metric.
9427 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
9428 # or metric.
9429 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
9430 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
9431 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
9432 },
9433 },
9434 ],
9435 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
9436 # This property is optional.
9437 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
9438 },
9439 ],
9440 },
9441 &quot;getVersionOperationMetadata&quot;: {
9442 &quot;inlineSbomInfo&quot;: {
9443 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
9444 # appropriate identifiers.
9445 &quot;a_key&quot;: &quot;A String&quot;,
9446 },
9447 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
9448 # identifiers.
9449 &quot;a_key&quot;: &quot;A String&quot;,
9450 },
9451 },
9452 },
9453 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
9454 # message that was returned, such as `NOT FOUND`.
9455 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
9456 # status code that was returned. For example, a `404` means the
9457 # resource was not found.
9458 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
9459 # defined by the server.
9460 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
9461 # This value is inRFC3339
9462 # text format.
9463 &quot;instancesBulkInsertOperationMetadata&quot;: {
9464 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
9465 # Example key: zones/us-central1-a
9466 &quot;a_key&quot;: {
9467 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
9468 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
9469 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
9470 # error.
9471 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
9472 # if the flow is rolling forward or rolling back.
9473 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
9474 },
9475 },
9476 },
9477 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
9478 # Operation resources.
9479 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
9480 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
9481 # group of operations results from a `bulkInsert` API request.
9482 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
9483 # `update`, or `delete`, and so on.
9484 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
9485 # There is no requirement that this be linear or support any granularity of
9486 # operations. This should not be used to guess when the operation will be
9487 # complete. This number should monotonically increase as the operation
9488 # progresses.
9489 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
9490 # applicable when performing regional operations.
9491 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
9492 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
9493 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
9494 # this field will contain information on all underlying zonal actions and
9495 # their state.
9496 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
9497 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
9498 # Example key: zones/us-central1-a
9499 &quot;a_key&quot;: {
9500 &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
9501 # populated.
9502 # different programming environments, including REST APIs and RPC APIs. It is
9503 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
9504 # three pieces of data: error code, error message, and error details.
9505 #
9506 # You can find out more about this error model and how to work with it in the
9507 # [API Design Guide](https://cloud.google.com/apis/design/errors).
9508 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
9509 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
9510 # message types for APIs to use.
9511 {
9512 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
9513 },
9514 ],
9515 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
9516 # user-facing error message should be localized and sent in the
9517 # google.rpc.Status.details field, or localized by the client.
9518 },
9519 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
9520 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
9521 },
9522 },
9523 },
9524 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
9525 # This value is inRFC3339
9526 # text format.
9527 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
9528 # following:
9529 # `PENDING`, `RUNNING`, or `DONE`.
9530 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
9531 # operation.
9532 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
9533 # of the target resource.
9534 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
9535 # operations related to creating a snapshot, this points to the disk
9536 # that the snapshot was created from.
9537 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
9538 # `[email protected]` or
9539 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
9540 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
9541 # operation, this field will be populated.
9542 {
9543 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
9544 # Engine returns NO_RESULTS_ON_PAGE if there
9545 # are no results in the response.
9546 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
9547 # value format. For example:
9548 #
9549 # &quot;data&quot;: [
9550 # {
9551 # &quot;key&quot;: &quot;scope&quot;,
9552 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
9553 # }
9554 {
9555 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
9556 # returned. For example, for warnings where there are no results in a list
9557 # request for a particular zone, this key might be scope and
9558 # the key value might be the zone name. Other examples might be a key
9559 # indicating a deprecated resource and a suggested replacement, or a
9560 # warning about invalid network settings (for example, if an instance
9561 # attempts to perform IP forwarding but is not enabled for IP forwarding).
9562 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
9563 },
9564 ],
9565 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
9566 },
9567 ],
9568 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
9569 # applicable when performing per-zone operations.
9570 }</pre>
9571 </div>
9572
9573 <div class="method">
9574 <code class="details" id="updateKmsKey">updateKmsKey(project, zone, disk, body=None, requestId=None, x__xgafv=None)</code>
9575 <pre>Rotates the customer-managed
9576 encryption key to the latest version for the specified persistent disk.
9577
9578 Args:
9579 project: string, Project ID for this request. (required)
9580 zone: string, The name of the zone for this request. (required)
9581 disk: string, Name of the Disk resource, should conform to RFC1035. (required)
9582 body: object, The request body.
9583 The object takes the form of:
9584
9585 {
9586 &quot;kmsKeyName&quot;: &quot;A String&quot;, # Optional. The new KMS key to replace the current one on the disk. If empty, the disk
9587 # will be re-encrypted using the primary version of the disk&#x27;s current KMS
9588 # key.
9589 #
9590 # The KMS key can be provided in the following formats:
9591 #
9592 #
9593 # - projects/project_id/locations/location/keyRings/key_ring/cryptoKeys/key
9594 #
9595 #
9596 # Where project is the project ID or
9597 # project number.
9598 }
9599
9600 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
9601 that if you must retry your request, the server will know to ignore the
9602 request if it has already been completed.
9603
9604 For example, consider a situation where you make an initial request and
9605 the request times out. If you make the request again with the same
9606 request ID, the server can check if original operation with the same
9607 request ID was received, and if so, will ignore the second request. This
9608 prevents clients from accidentally creating duplicate commitments.
9609
9610 The request ID must be
9611 a valid UUID with the exception that zero UUID is not supported
9612 (00000000-0000-0000-0000-000000000000).
9613 x__xgafv: string, V1 error format.
9614 Allowed values
9615 1 - v1 error format
9616 2 - v2 error format
9617
9618 Returns:
9619 An object of the form:
9620
9621 { # Represents an Operation resource.
9622 #
9623 # Google Compute Engine has three Operation resources:
9624 #
9625 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
9626 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
9627 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
9628 #
9629 # You can use an operation resource to manage asynchronous API requests.
9630 # For more information, readHandling
9631 # API responses.
9632 #
9633 # Operations can be global, regional or zonal.
9634 #
9635 # - For global operations, use the `globalOperations`
9636 # resource.
9637 # - For regional operations, use the
9638 # `regionOperations` resource.
9639 # - For zonal operations, use
9640 # the `zoneOperations` resource.
9641 #
9642 #
9643 #
9644 # For more information, read
9645 # Global, Regional, and Zonal Resources.
9646 #
9647 # Note that completed Operation resources have a limited
9648 # retention period.
9649 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
9650 # Not present otherwise.
9651 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
9652 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
9653 # set when the operation is created.
9654 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
9655 # text format.
9656 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
9657 # this field will be populated.
9658 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
9659 # operation.
9660 {
9661 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
9662 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
9663 # details. There is a set of defined message types to use for providing
9664 # details.The syntax depends on the error code. For example,
9665 # QuotaExceededInfo will have details when the error code is
9666 # QUOTA_EXCEEDED.
9667 {
9668 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
9669 #
9670 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
9671 # is not enabled:
9672 #
9673 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
9674 # &quot;domain&quot;: &quot;googleapis.com&quot;
9675 # &quot;metadata&quot;: {
9676 # &quot;resource&quot;: &quot;projects/123&quot;,
9677 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
9678 # }
9679 # }
9680 #
9681 # This response indicates that the pubsub.googleapis.com API is not enabled.
9682 #
9683 # Example of an error that is returned when attempting to create a Spanner
9684 # instance in a region that is out of stock:
9685 #
9686 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
9687 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
9688 # &quot;metadata&quot;: {
9689 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
9690 # }
9691 # }
9692 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
9693 # is typically the registered service name of the tool or product that
9694 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
9695 # generated by some common infrastructure, the error domain must be a
9696 # globally unique value that identifies the infrastructure. For Google API
9697 # infrastructure, the error domain is &quot;googleapis.com&quot;.
9698 &quot;metadatas&quot;: { # Additional structured details about this error.
9699 #
9700 # Keys must match a regular expression of `a-z+` but should
9701 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
9702 # length. When identifying the current value of an exceeded limit, the units
9703 # should be contained in the key, not the value. For example, rather than
9704 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
9705 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
9706 # instances that can be created in a single (batch) request.
9707 &quot;a_key&quot;: &quot;A String&quot;,
9708 },
9709 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
9710 # proximate cause of the error. Error reasons are unique within a particular
9711 # domain of errors. This should be at most 63 characters and match a
9712 # regular expression of `A-Z+[A-Z0-9]`, which represents
9713 # UPPER_SNAKE_CASE.
9714 },
9715 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
9716 #
9717 # For example, if a quota check failed with an error indicating the calling
9718 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
9719 # directly to the right place in the developer console to flip the bit.
9720 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
9721 { # Describes a URL link.
9722 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
9723 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
9724 },
9725 ],
9726 },
9727 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
9728 # which can be attached to an RPC error.
9729 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
9730 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
9731 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
9732 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
9733 },
9734 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
9735 &quot;dimensions&quot;: { # The map holding related quota dimensions.
9736 &quot;a_key&quot;: &quot;A String&quot;,
9737 },
9738 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
9739 # type or metric.
9740 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
9741 # or metric.
9742 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
9743 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
9744 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
9745 },
9746 },
9747 ],
9748 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
9749 # This property is optional.
9750 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
9751 },
9752 ],
9753 },
9754 &quot;getVersionOperationMetadata&quot;: {
9755 &quot;inlineSbomInfo&quot;: {
9756 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
9757 # appropriate identifiers.
9758 &quot;a_key&quot;: &quot;A String&quot;,
9759 },
9760 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
9761 # identifiers.
9762 &quot;a_key&quot;: &quot;A String&quot;,
9763 },
9764 },
9765 },
9766 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
9767 # message that was returned, such as `NOT FOUND`.
9768 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
9769 # status code that was returned. For example, a `404` means the
9770 # resource was not found.
9771 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
9772 # defined by the server.
9773 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
9774 # This value is inRFC3339
9775 # text format.
9776 &quot;instancesBulkInsertOperationMetadata&quot;: {
9777 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
9778 # Example key: zones/us-central1-a
9779 &quot;a_key&quot;: {
9780 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
9781 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
9782 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
9783 # error.
9784 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
9785 # if the flow is rolling forward or rolling back.
9786 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
9787 },
9788 },
9789 },
9790 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
9791 # Operation resources.
9792 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
9793 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
9794 # group of operations results from a `bulkInsert` API request.
9795 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
9796 # `update`, or `delete`, and so on.
9797 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
9798 # There is no requirement that this be linear or support any granularity of
9799 # operations. This should not be used to guess when the operation will be
9800 # complete. This number should monotonically increase as the operation
9801 # progresses.
9802 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
9803 # applicable when performing regional operations.
9804 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
9805 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
9806 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
9807 # this field will contain information on all underlying zonal actions and
9808 # their state.
9809 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
9810 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
9811 # Example key: zones/us-central1-a
9812 &quot;a_key&quot;: {
9813 &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
9814 # populated.
9815 # different programming environments, including REST APIs and RPC APIs. It is
9816 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
9817 # three pieces of data: error code, error message, and error details.
9818 #
9819 # You can find out more about this error model and how to work with it in the
9820 # [API Design Guide](https://cloud.google.com/apis/design/errors).
9821 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
9822 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
9823 # message types for APIs to use.
9824 {
9825 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
9826 },
9827 ],
9828 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
9829 # user-facing error message should be localized and sent in the
9830 # google.rpc.Status.details field, or localized by the client.
9831 },
9832 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
9833 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
9834 },
9835 },
9836 },
9837 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
9838 # This value is inRFC3339
9839 # text format.
9840 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
9841 # following:
9842 # `PENDING`, `RUNNING`, or `DONE`.
9843 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
9844 # operation.
9845 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
9846 # of the target resource.
9847 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
9848 # operations related to creating a snapshot, this points to the disk
9849 # that the snapshot was created from.
9850 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
9851 # `[email protected]` or
9852 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
9853 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
9854 # operation, this field will be populated.
9855 {
9856 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
9857 # Engine returns NO_RESULTS_ON_PAGE if there
9858 # are no results in the response.
9859 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
9860 # value format. For example:
9861 #
9862 # &quot;data&quot;: [
9863 # {
9864 # &quot;key&quot;: &quot;scope&quot;,
9865 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
9866 # }
9867 {
9868 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
9869 # returned. For example, for warnings where there are no results in a list
9870 # request for a particular zone, this key might be scope and
9871 # the key value might be the zone name. Other examples might be a key
9872 # indicating a deprecated resource and a suggested replacement, or a
9873 # warning about invalid network settings (for example, if an instance
9874 # attempts to perform IP forwarding but is not enabled for IP forwarding).
9875 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
9876 },
9877 ],
9878 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
9879 },
9880 ],
9881 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
9882 # applicable when performing per-zone operations.
9883 }</pre>
9884 </div>
9885
9886 <div class="method">
9887 <code class="details" id="waitForReplicationCatchUp">waitForReplicationCatchUp(project, zone, disk, body=None, requestId=None, x__xgafv=None)</code>
9888 <pre>Wait for replication to catch up on the secondary disk.
9889
9890 Args:
9891 project: string, Project ID for this request. (required)
9892 zone: string, The name of the zone for this request. (required)
9893 disk: string, The name of the persistent disk.
9894 Name should conform to RFC1035 or be an unsigned long integer. (required)
9895 body: object, The request body.
9896 The object takes the form of:
9897
9898 {
9899 &quot;maxWaitDuration&quot;: &quot;A String&quot;,
9900 }
9901
9902 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
9903 that if you must retry your request, the server will know to ignore the
9904 request if it has already been completed.
9905
9906 For example, consider a situation where you make an initial request and
9907 the request times out. If you make the request again with the same
9908 request ID, the server can check if original operation with the same
9909 request ID was received, and if so, will ignore the second request. This
9910 prevents clients from accidentally creating duplicate commitments.
9911
9912 The request ID must be
9913 a valid UUID with the exception that zero UUID is not supported
9914 (00000000-0000-0000-0000-000000000000).
9915 x__xgafv: string, V1 error format.
9916 Allowed values
9917 1 - v1 error format
9918 2 - v2 error format
9919
9920 Returns:
9921 An object of the form:
9922
9923 { # Represents an Operation resource.
9924 #
9925 # Google Compute Engine has three Operation resources:
9926 #
9927 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
9928 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
9929 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
9930 #
9931 # You can use an operation resource to manage asynchronous API requests.
9932 # For more information, readHandling
9933 # API responses.
9934 #
9935 # Operations can be global, regional or zonal.
9936 #
9937 # - For global operations, use the `globalOperations`
9938 # resource.
9939 # - For regional operations, use the
9940 # `regionOperations` resource.
9941 # - For zonal operations, use
9942 # the `zoneOperations` resource.
9943 #
9944 #
9945 #
9946 # For more information, read
9947 # Global, Regional, and Zonal Resources.
9948 #
9949 # Note that completed Operation resources have a limited
9950 # retention period.
9951 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
9952 # Not present otherwise.
9953 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
9954 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
9955 # set when the operation is created.
9956 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
9957 # text format.
9958 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
9959 # this field will be populated.
9960 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
9961 # operation.
9962 {
9963 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
9964 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
9965 # details. There is a set of defined message types to use for providing
9966 # details.The syntax depends on the error code. For example,
9967 # QuotaExceededInfo will have details when the error code is
9968 # QUOTA_EXCEEDED.
9969 {
9970 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
9971 #
9972 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
9973 # is not enabled:
9974 #
9975 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
9976 # &quot;domain&quot;: &quot;googleapis.com&quot;
9977 # &quot;metadata&quot;: {
9978 # &quot;resource&quot;: &quot;projects/123&quot;,
9979 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
9980 # }
9981 # }
9982 #
9983 # This response indicates that the pubsub.googleapis.com API is not enabled.
9984 #
9985 # Example of an error that is returned when attempting to create a Spanner
9986 # instance in a region that is out of stock:
9987 #
9988 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
9989 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
9990 # &quot;metadata&quot;: {
9991 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
9992 # }
9993 # }
9994 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
9995 # is typically the registered service name of the tool or product that
9996 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
9997 # generated by some common infrastructure, the error domain must be a
9998 # globally unique value that identifies the infrastructure. For Google API
9999 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10000 &quot;metadatas&quot;: { # Additional structured details about this error.
10001 #
10002 # Keys must match a regular expression of `a-z+` but should
10003 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10004 # length. When identifying the current value of an exceeded limit, the units
10005 # should be contained in the key, not the value. For example, rather than
10006 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10007 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10008 # instances that can be created in a single (batch) request.
10009 &quot;a_key&quot;: &quot;A String&quot;,
10010 },
10011 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10012 # proximate cause of the error. Error reasons are unique within a particular
10013 # domain of errors. This should be at most 63 characters and match a
10014 # regular expression of `A-Z+[A-Z0-9]`, which represents
10015 # UPPER_SNAKE_CASE.
10016 },
10017 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10018 #
10019 # For example, if a quota check failed with an error indicating the calling
10020 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10021 # directly to the right place in the developer console to flip the bit.
10022 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10023 { # Describes a URL link.
10024 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10025 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
10026 },
10027 ],
10028 },
10029 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
10030 # which can be attached to an RPC error.
10031 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
10032 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
10033 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
10034 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
10035 },
10036 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
10037 &quot;dimensions&quot;: { # The map holding related quota dimensions.
10038 &quot;a_key&quot;: &quot;A String&quot;,
10039 },
10040 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
10041 # type or metric.
10042 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
10043 # or metric.
10044 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
10045 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
10046 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
10047 },
10048 },
10049 ],
10050 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
10051 # This property is optional.
10052 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
10053 },
10054 ],
10055 },
10056 &quot;getVersionOperationMetadata&quot;: {
10057 &quot;inlineSbomInfo&quot;: {
10058 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
10059 # appropriate identifiers.
10060 &quot;a_key&quot;: &quot;A String&quot;,
10061 },
10062 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
10063 # identifiers.
10064 &quot;a_key&quot;: &quot;A String&quot;,
10065 },
10066 },
10067 },
10068 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
10069 # message that was returned, such as `NOT FOUND`.
10070 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
10071 # status code that was returned. For example, a `404` means the
10072 # resource was not found.
10073 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
10074 # defined by the server.
10075 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
10076 # This value is inRFC3339
10077 # text format.
10078 &quot;instancesBulkInsertOperationMetadata&quot;: {
10079 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
10080 # Example key: zones/us-central1-a
10081 &quot;a_key&quot;: {
10082 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
10083 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
10084 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
10085 # error.
10086 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
10087 # if the flow is rolling forward or rolling back.
10088 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
10089 },
10090 },
10091 },
10092 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
10093 # Operation resources.
10094 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
10095 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
10096 # group of operations results from a `bulkInsert` API request.
10097 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
10098 # `update`, or `delete`, and so on.
10099 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
10100 # There is no requirement that this be linear or support any granularity of
10101 # operations. This should not be used to guess when the operation will be
10102 # complete. This number should monotonically increase as the operation
10103 # progresses.
10104 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
10105 # applicable when performing regional operations.
10106 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
10107 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
10108 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
10109 # this field will contain information on all underlying zonal actions and
10110 # their state.
10111 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
10112 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
10113 # Example key: zones/us-central1-a
10114 &quot;a_key&quot;: {
10115 &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
10116 # populated.
10117 # different programming environments, including REST APIs and RPC APIs. It is
10118 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
10119 # three pieces of data: error code, error message, and error details.
10120 #
10121 # You can find out more about this error model and how to work with it in the
10122 # [API Design Guide](https://cloud.google.com/apis/design/errors).
10123 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
10124 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
10125 # message types for APIs to use.
10126 {
10127 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
10128 },
10129 ],
10130 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
10131 # user-facing error message should be localized and sent in the
10132 # google.rpc.Status.details field, or localized by the client.
10133 },
10134 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
10135 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
10136 },
10137 },
10138 },
10139 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
10140 # This value is inRFC3339
10141 # text format.
10142 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
10143 # following:
10144 # `PENDING`, `RUNNING`, or `DONE`.
10145 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
10146 # operation.
10147 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
10148 # of the target resource.
10149 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
10150 # operations related to creating a snapshot, this points to the disk
10151 # that the snapshot was created from.
10152 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
10153 # `[email protected]` or
10154 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
10155 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
10156 # operation, this field will be populated.
10157 {
10158 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
10159 # Engine returns NO_RESULTS_ON_PAGE if there
10160 # are no results in the response.
10161 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
10162 # value format. For example:
10163 #
10164 # &quot;data&quot;: [
10165 # {
10166 # &quot;key&quot;: &quot;scope&quot;,
10167 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
10168 # }
10169 {
10170 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
10171 # returned. For example, for warnings where there are no results in a list
10172 # request for a particular zone, this key might be scope and
10173 # the key value might be the zone name. Other examples might be a key
10174 # indicating a deprecated resource and a suggested replacement, or a
10175 # warning about invalid network settings (for example, if an instance
10176 # attempts to perform IP forwarding but is not enabled for IP forwarding).
10177 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
10178 },
10179 ],
10180 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
10181 },
10182 ],
10183 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
10184 # applicable when performing per-zone operations.
10185 }</pre>
10186 </div>
10187
10188 </body></html>