Debian Codegraph @

docs/dyn/compute_alpha.zoneQueuedResources.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.zoneQueuedResources.html">zoneQueuedResources</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <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>
79 <p class="firstline">Retrieves an aggregated list of all of the queued resources in a project</p>
80 <p class="toc_element">
81 <code><a href="#aggregatedList_next">aggregatedList_next()</a></code></p>
82 <p class="firstline">Retrieves the next page of results.</p>
83 <p class="toc_element">
84 <code><a href="#cancel">cancel(project, zone, queuedResource, requestId=None, x__xgafv=None)</a></code></p>
85 <p class="firstline">Cancels a QueuedResource. Only a resource in ACCEPTED state may be</p>
86 <p class="toc_element">
87 <code><a href="#close">close()</a></code></p>
88 <p class="firstline">Close httplib2 connections.</p>
89 <p class="toc_element">
90 <code><a href="#delete">delete(project, zone, queuedResource, requestId=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Deletes a QueuedResource. For a QueuedResource in ACCEPTED state, call</p>
92 <p class="toc_element">
93 <code><a href="#get">get(project, zone, queuedResource, x__xgafv=None)</a></code></p>
94 <p class="firstline">Returns the specified QueuedResource resource.</p>
95 <p class="toc_element">
96 <code><a href="#insert">insert(project, zone, body=None, requestId=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Creates a QueuedResource.</p>
98 <p class="toc_element">
99 <code><a href="#list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Retrieves the list of QueuedResource resources.</p>
101 <p class="toc_element">
102 <code><a href="#list_next">list_next()</a></code></p>
103 <p class="firstline">Retrieves the next page of results.</p>
104 <h3>Method Details</h3>
105 <div class="method">
106 <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>
107 <pre>Retrieves an aggregated list of all of the queued resources in a project
108 across all zones.
109
110 To prevent failure, Google recommends that you set the
111 `returnPartialSuccess` parameter to `true`.
112
113 Args:
114 project: string, Project ID for this request. (required)
115 filter: string, A filter expression that filters resources listed in the response. Most
116 Compute resources support two types of filter expressions:
117 expressions that support regular expressions and expressions that follow
118 API improvement proposal AIP-160.
119 These two types of filter expressions cannot be mixed in one request.
120
121 If you want to use AIP-160, your expression must specify the field name, an
122 operator, and the value that you want to use for filtering. The value
123 must be a string, a number, or a boolean. The operator
124 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
125
126 For example, if you are filtering Compute Engine instances, you can
127 exclude instances named `example-instance` by specifying
128 `name != example-instance`.
129
130 The `:*` comparison can be used to test whether a key has been defined.
131 For example, to find all objects with `owner` label use:
132 ```
133 labels.owner:*
134 ```
135
136 You can also filter nested fields. For example, you could specify
137 `scheduling.automaticRestart = false` to include instances only
138 if they are not scheduled for automatic restarts. You can use filtering
139 on nested fields to filter based onresource labels.
140
141 To filter on multiple expressions, provide each separate expression within
142 parentheses. For example:
143 ```
144 (scheduling.automaticRestart = true)
145 (cpuPlatform = &quot;Intel Skylake&quot;)
146 ```
147 By default, each expression is an `AND` expression. However, you
148 can include `AND` and `OR` expressions explicitly.
149 For example:
150 ```
151 (cpuPlatform = &quot;Intel Skylake&quot;) OR
152 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
153 (scheduling.automaticRestart = true)
154 ```
155
156 If you want to use a regular expression, use the `eq` (equal) or `ne`
157 (not equal) operator against a single un-parenthesized expression with or
158 without quotes or against multiple parenthesized expressions. Examples:
159
160 `fieldname eq unquoted literal`
161 `fieldname eq &#x27;single quoted literal&#x27;`
162 `fieldname eq &quot;double quoted literal&quot;`
163 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
164
165 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
166 The literal value must match the entire field.
167
168 For example, to filter for instances that do not end with name &quot;instance&quot;,
169 you would use `name ne .*instance`.
170
171 You cannot combine constraints on multiple fields using regular
172 expressions.
173 includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region,
174 global) should be included in the response. For new resource types added
175 after this field, the flag has no effect as new resource types will always
176 include every visible scope for each scope type in response. For resource
177 types which predate this field, if this flag is omitted or false, only
178 scopes of the scope types where the resource type is expected to be found
179 will be included.
180 maxResults: integer, The maximum number of results per page that should be returned.
181 If the number of available results is larger than `maxResults`,
182 Compute Engine returns a `nextPageToken` that can be used to get
183 the next page of results in subsequent list requests. Acceptable values are
184 `0` to `500`, inclusive. (Default: `500`)
185 orderBy: string, Sorts list results by a certain order. By default, results
186 are returned in alphanumerical order based on the resource name.
187
188 You can also sort results in descending order based on the creation
189 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
190 results based on the `creationTimestamp` field in
191 reverse chronological order (newest result first). Use this to sort
192 resources like operations so that the newest operation is returned first.
193
194 Currently, only sorting by `name` or
195 `creationTimestamp desc` is supported.
196 pageToken: string, Specifies a page token to use. Set `pageToken` to the
197 `nextPageToken` returned by a previous list request to get
198 the next page of results.
199 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
200 of failure. The default value is false.
201
202 For example, when partial success behavior is enabled, aggregatedList for a
203 single zone scope either returns all resources in the zone or no resources,
204 with an error code.
205 serviceProjectNumber: string, The Shared VPC service project id or service project number for which
206 aggregated list request is invoked for subnetworks list-usable api.
207 x__xgafv: string, V1 error format.
208 Allowed values
209 1 - v1 error format
210 2 - v2 error format
211
212 Returns:
213 An object of the form:
214
215 {
216 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
217 &quot;items&quot;: { # A list of QueuedResourcesScopedList resources.
218 &quot;a_key&quot;: { # Name of the scope containing this set of queued resources.
219 &quot;queuedResources&quot;: [ # List of QueuedResources contained in this scope.
220 { # QueuedResource represents a request for future capacity. The capacity is
221 # delivered in the form of other GCE resources, either Instances or
222 # Reservations.
223 &quot;bulkInsertInstanceResource&quot;: { # A transient resource used in compute.instances.bulkInsert and # Specification of VM instances to create.
224 # compute.regionInstances.bulkInsert . This resource is not persisted
225 # anywhere, it is used only for processing the requests.
226 &quot;count&quot;: &quot;A String&quot;, # The maximum number of instances to create.
227 &quot;instanceFlexibilityPolicy&quot;: { # A flexible specification of machine types for instances to create. # A flexible specification of machine type of instances to create.
228 &quot;instanceSelections&quot;: { # Specification of alternative, flexible instance subsets.
229 # One of them will be selected to create the instances
230 # based on various criteria, like:
231 # - ranks,
232 # - location policy,
233 # - current capacity,
234 # - available reservations (you can specify affinity in
235 # InstanceProperties),
236 # - SWAN/GOOSE limitations.
237 # Key is an arbitrary, unique RFC1035 string that identifies the instance
238 # selection.
239 &quot;a_key&quot;: { # Specification of machine type to use. Every position inside this message
240 # is an alternative.
241 # The count specified in the shape flexibility must not exceed the number
242 # of entries in per_instance_properties or the capacity of the
243 # name_pattern, if used.
244 &quot;disks&quot;: [ # Disks to be attached to the instances created from in this selection.
245 # They override the disks specified in the instance properties.
246 { # An instance-attached disk resource.
247 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
248 # or X86_64.
249 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
250 # deleted (but not when the disk is detached from the instance).
251 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
252 # partition of the disk for its root filesystem.
253 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
254 # running within the instance. This name can be used to reference the device
255 # for mounting, resizing, and so on, from within the instance.
256 #
257 # If not specified, the server chooses a default device name to apply to this
258 # disk, in the form persistent-disk-x, where x is a number
259 # assigned by Google Compute Engine. This field is only applicable for
260 # persistent disks.
261 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
262 # encryption key.
263 #
264 # If you are creating a new disk, this field encrypts the new disk using
265 # an encryption key that you provide. If you are attaching an existing
266 # disk that is already encrypted, this field decrypts the disk using
267 # the customer-supplied encryption key.
268 #
269 # If you encrypt a disk using a customer-supplied key, you must provide the
270 # same key again when you attempt to use this resource at a later time. For
271 # example, you must provide the key when you create a snapshot or an image
272 # from the disk or when you attach the disk to a virtual machine instance.
273 #
274 # If you do not provide an encryption key, then the disk will be encrypted
275 # using an automatically generated key and you do not need to provide a key
276 # to use the disk later.
277 #
278 # Note:
279 #
280 # Instance templates do not storecustomer-supplied
281 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
282 #
283 # You cannot create VMs that have disks with customer-supplied keys using
284 # the bulk
285 # insert method.
286 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
287 # For example:
288 #
289 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
290 # key_region/cryptoKeys/key
291 #
292 # The fully-qualifed key name may be returned for resource GET requests. For
293 # example:
294 #
295 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
296 # key_region/cryptoKeys/key
297 # /cryptoKeyVersions/1
298 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
299 # key. If absent, the Compute Engine default service account is used.
300 # For example:
301 #
302 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
303 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
304 # encryption key, encoded in RFC
305 # 4648 base64 to either encrypt or decrypt this resource. You can
306 # provide either the rawKey or thersaEncryptedKey.
307 # For example:
308 #
309 # &quot;rawKey&quot;:
310 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
311 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
312 # customer-supplied encryption key to either encrypt or decrypt this
313 # resource. You can provide either the rawKey or thersaEncryptedKey.
314 # For example:
315 #
316 # &quot;rsaEncryptedKey&quot;:
317 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
318 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
319 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
320 #
321 # The key must meet the following requirements before you can provide it to
322 # Compute Engine:
323 #
324 # 1. The key is wrapped using a RSA public key certificate provided by
325 # Google.
326 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
327 # encoding.
328 #
329 # Gets the RSA public key certificate provided by Google at:
330 #
331 #
332 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
333 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
334 # 4648 base64 encoded SHA-256 hash of the customer-supplied
335 # encryption key that protects this resource.
336 },
337 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
338 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
339 # currently attached to another instance. If you try to force attach a zonal
340 # disk to an instance, you will receive an error.
341 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
342 # only for bootable images. Read
343 # Enabling guest operating system features to see a list of available
344 # options.
345 { # Guest OS features.
346 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
347 # separate values. Set to one or more of the following values:
348 #
349 # - VIRTIO_SCSI_MULTIQUEUE
350 # - WINDOWS
351 # - MULTI_IP_SUBNET
352 # - UEFI_COMPATIBLE
353 # - GVNIC
354 # - SEV_CAPABLE
355 # - SUSPEND_RESUME_COMPATIBLE
356 # - SEV_LIVE_MIGRATABLE_V2
357 # - SEV_SNP_CAPABLE
358 # - TDX_CAPABLE
359 # - IDPF
360 # - SNP_SVSM_CAPABLE
361 # - CCA_CAPABLE
362 #
363 #
364 # For more information, see
365 # Enabling guest operating system features.
366 },
367 ],
368 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
369 # boot disk. If you have many disks attached to an instance, each
370 # disk would have a unique index number.
371 &quot;initializeParams&quot;: { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
372 # alongside the new instance. Use initialization parameters to create boot
373 # disks or local SSDs attached to the new instance.
374 #
375 # This property is mutually exclusive with the source property;
376 # you can only define one or the other, but not both.
377 # alongside the new instance. Use initialization parameters to create boot
378 # disks or local SSDs attached to the new instance.
379 #
380 # This field is persisted and returned for instanceTemplate and not returned
381 # in the context of instance.
382 #
383 # This property is mutually exclusive with the source property;
384 # you can only define one or the other, but not both.
385 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
386 # arm64 or x86_64.
387 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
388 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
389 # of the instance. If a disk with the same name already exists in the given
390 # region, the existing disk is attached to the new instance and the
391 # new disk is not created.
392 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
393 # 10 GB. If you specify a sourceImage, which is required for
394 # boot disks, the default size is the size of the sourceImage.
395 # If you do not specify a sourceImage, the default disk size
396 # is 500 GB.
397 &quot;diskType&quot;: &quot;A String&quot;,
398 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
399 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
400 # only for bootable images. Read
401 # Enabling guest operating system features to see a list of available
402 # options.
403 #
404 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
405 { # Guest OS features.
406 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
407 # separate values. Set to one or more of the following values:
408 #
409 # - VIRTIO_SCSI_MULTIQUEUE
410 # - WINDOWS
411 # - MULTI_IP_SUBNET
412 # - UEFI_COMPATIBLE
413 # - GVNIC
414 # - SEV_CAPABLE
415 # - SUSPEND_RESUME_COMPATIBLE
416 # - SEV_LIVE_MIGRATABLE_V2
417 # - SEV_SNP_CAPABLE
418 # - TDX_CAPABLE
419 # - IDPF
420 # - SNP_SVSM_CAPABLE
421 # - CCA_CAPABLE
422 #
423 #
424 # For more information, see
425 # Enabling guest operating system features.
426 },
427 ],
428 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
429 # which is either SCSI or NVME. The default isSCSI.
430 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
431 # persistent disks.
432 &quot;a_key&quot;: &quot;A String&quot;,
433 },
434 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
435 # disk.
436 &quot;A String&quot;,
437 ],
438 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
439 &quot;A String&quot;,
440 ],
441 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
442 # more than one instance.
443 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
444 # is to use the existing disk.
445 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
446 # of I/O operations per second that the disk can handle. Values must be
447 # between 10,000 and 120,000. For more details, see theExtreme persistent
448 # disk documentation.
449 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
450 # number of throughput mb per second that the disk can handle. Values must
451 # greater than or equal to 1.
452 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
453 # the URLs of the zones where the disk should be replicated to.
454 # You must provide exactly two replica zones, and one zone must be the same
455 # as the instance zone.
456 &quot;A String&quot;,
457 ],
458 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
459 # have the same definition as resource
460 # manager tags. Keys and values can be either in numeric format,
461 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
462 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
463 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
464 # empty.
465 &quot;a_key&quot;: &quot;A String&quot;,
466 },
467 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
468 # Specified using the full or partial URL. For instance template, specify
469 # only the resource policy name.
470 &quot;A String&quot;,
471 ],
472 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
473 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
474 # is required.
475 #
476 # To create a disk with one of the public operating system
477 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
478 #
479 # projects/debian-cloud/global/images/family/debian-9
480 #
481 #
482 # Alternatively, use a specific version of a public operating system image:
483 #
484 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
485 #
486 #
487 # To create a disk with a custom image that you created, specify the
488 # image name in the following format:
489 #
490 # global/images/my-custom-image
491 #
492 #
493 # You can also specify a custom image by its image family, which returns
494 # the latest version of the image in that family. Replace the image name
495 # with family/family-name:
496 #
497 # global/images/family/my-image-family
498 #
499 #
500 # If the source image is deleted later, this field will not be set.
501 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
502 # encryption key of the source image. Required if the source image is
503 # protected by a customer-supplied encryption key.
504 #
505 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
506 # encryption keys, so you cannot create disks for instances in a managed instance group if the
507 # source images are encrypted with your own keys.
508 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
509 # For example:
510 #
511 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
512 # key_region/cryptoKeys/key
513 #
514 # The fully-qualifed key name may be returned for resource GET requests. For
515 # example:
516 #
517 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
518 # key_region/cryptoKeys/key
519 # /cryptoKeyVersions/1
520 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
521 # key. If absent, the Compute Engine default service account is used.
522 # For example:
523 #
524 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
525 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
526 # encryption key, encoded in RFC
527 # 4648 base64 to either encrypt or decrypt this resource. You can
528 # provide either the rawKey or thersaEncryptedKey.
529 # For example:
530 #
531 # &quot;rawKey&quot;:
532 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
533 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
534 # customer-supplied encryption key to either encrypt or decrypt this
535 # resource. You can provide either the rawKey or thersaEncryptedKey.
536 # For example:
537 #
538 # &quot;rsaEncryptedKey&quot;:
539 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
540 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
541 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
542 #
543 # The key must meet the following requirements before you can provide it to
544 # Compute Engine:
545 #
546 # 1. The key is wrapped using a RSA public key certificate provided by
547 # Google.
548 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
549 # encoding.
550 #
551 # Gets the RSA public key certificate provided by Google at:
552 #
553 #
554 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
555 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
556 # 4648 base64 encoded SHA-256 hash of the customer-supplied
557 # encryption key that protects this resource.
558 },
559 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
560 # instance boot disk, one of initializeParams.sourceSnapshot
561 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
562 # is required.
563 #
564 # To create a disk with a snapshot that you created, specify the
565 # snapshot name in the following format:
566 #
567 # us-central1-a/instantSnapshots/my-backup
568 #
569 #
570 # If the source instant-snapshot is deleted later, this field will not be
571 # set.
572 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
573 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
574 # is required.
575 #
576 # To create a disk with a snapshot that you created, specify the
577 # snapshot name in the following format:
578 #
579 # global/snapshots/my-backup
580 #
581 #
582 # If the source snapshot is deleted later, this field will not be set.
583 #
584 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
585 # an image instead when you create VMs using
586 # the bulk
587 # insert method.
588 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
589 # encryption key of the source snapshot.
590 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
591 # For example:
592 #
593 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
594 # key_region/cryptoKeys/key
595 #
596 # The fully-qualifed key name may be returned for resource GET requests. For
597 # example:
598 #
599 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
600 # key_region/cryptoKeys/key
601 # /cryptoKeyVersions/1
602 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
603 # key. If absent, the Compute Engine default service account is used.
604 # For example:
605 #
606 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
607 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
608 # encryption key, encoded in RFC
609 # 4648 base64 to either encrypt or decrypt this resource. You can
610 # provide either the rawKey or thersaEncryptedKey.
611 # For example:
612 #
613 # &quot;rawKey&quot;:
614 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
615 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
616 # customer-supplied encryption key to either encrypt or decrypt this
617 # resource. You can provide either the rawKey or thersaEncryptedKey.
618 # For example:
619 #
620 # &quot;rsaEncryptedKey&quot;:
621 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
622 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
623 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
624 #
625 # The key must meet the following requirements before you can provide it to
626 # Compute Engine:
627 #
628 # 1. The key is wrapped using a RSA public key certificate provided by
629 # Google.
630 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
631 # encoding.
632 #
633 # Gets the RSA public key certificate provided by Google at:
634 #
635 #
636 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
637 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
638 # 4648 base64 encoded SHA-256 hash of the customer-supplied
639 # encryption key that protects this resource.
640 },
641 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
642 # this as a partial or full URL to the resource. For example, the following
643 # are valid values:
644 #
645 #
646 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
647 # - projects/project/zones/zone/storagePools/storagePool
648 # - zones/zone/storagePools/storagePool
649 },
650 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
651 # either SCSI or NVME. For most machine types, the
652 # default is SCSI. Local SSDs can use either NVME or SCSI.
653 # In certain configurations, persistent disks can use NVMe. For more
654 # information, seeAbout
655 # persistent disks.
656 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
657 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
658 &quot;A String&quot;,
659 ],
660 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
661 # disk is not allowed to be detached from the instance, or to be used as the
662 # source of the snapshot creation, and the image creation. The instance with
663 # at least one locked attached disk is not allow to be used as source of
664 # machine image creation, instant snapshot creation, and not allowed to be
665 # deleted with --keep-disk parameter set to true for locked disks.
666 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
667 # in READ_WRITE mode.
668 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
669 # field is set to PRESERVED if the LocalSSD data has been saved
670 # to a persistent location by customer request. (see the
671 # discard_local_ssd option on Stop/Suspend).
672 # Read-only in the api.
673 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
674 # these are public keys which are safe to store in public
675 &quot;dbs&quot;: [ # The Key Database (db).
676 {
677 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
678 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
679 },
680 ],
681 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
682 {
683 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
684 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
685 },
686 ],
687 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
688 {
689 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
690 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
691 },
692 ],
693 &quot;pk&quot;: { # The Platform Key (PK).
694 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
695 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
696 },
697 },
698 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
699 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
700 # is required.
701 #
702 # If desired, you can also attach existing non-root persistent disks using
703 # this property. This field is only applicable for persistent disks.
704 #
705 # Note that for InstanceTemplate, specify the disk name for zonal disk,
706 # and the URL for regional disk.
707 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
708 },
709 ],
710 &quot;machineTypes&quot;: [ # Alternative machine types to use for instances that are created from
711 # these properties. This field only accepts a machine type names, for
712 # example `n2-standard-4` and not URLs or partial URLs.
713 &quot;A String&quot;,
714 ],
715 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
716 # e.g. &#x27;Intel Ice Lake&#x27;.
717 &quot;rank&quot;: &quot;A String&quot;, # Rank when prioritizing the shape flexibilities.
718 # The instance selections with rank are considered
719 # first, in the ascending order of the rank.
720 # If not set, defaults to 0.
721 },
722 },
723 },
724 &quot;instanceProperties&quot;: { # The instance properties defining the VM instances to be created. Required
725 # if sourceInstanceTemplate is not provided.
726 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
727 # Note that for MachineImage, this is not supported yet.
728 # Options that would traditionally be configured in a BIOS belong
729 # here. Features that require operating system support may have
730 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
731 # disabled).
732 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
733 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
734 &quot;enableWatchdogTimer&quot;: True or False, # Whether to enable the watchdog timer.
735 &quot;numaNodeCount&quot;: 42, # The number of vNUMA nodes.
736 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
737 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
738 # multithreading (SMT) set this to 1. If unset, the maximum number
739 # of threads supported per core by the underlying processor is
740 # assumed.
741 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
742 # Supported modes include:
743 # * ALL_CORE_MAX
744 #
745 # Using empty string or not setting this field will use the platform-specific
746 # default turbo mode.
747 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
748 # the number of threads per core to compute the total number of virtual
749 # CPUs to expose to the instance. If unset, the number of cores is
750 # inferred from the instance&#x27;s nominal CPU count and the underlying
751 # platform&#x27;s SMT width.
752 },
753 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
754 # source IP addresses other than their own and receive packets with
755 # destination IP addresses other than their own. If these instances will be
756 # used as an IP gateway or it will be set as the next-hop in a Route
757 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
758 # documentation for more information.
759 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
760 # Note that for MachineImage, this is not supported yet.
761 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
762 &quot;confidentialParavisorConfig&quot;: { # A set of Confidential Paravisor (SVSM) options. # Defines a set of Confidential Paravisor (SVSM) options.
763 &quot;confidentialTpmType&quot;: &quot;A String&quot;,
764 &quot;sevSnpIrqMode&quot;: &quot;A String&quot;,
765 },
766 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
767 },
768 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
769 # properties.
770 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
771 # from these properties.
772 { # An instance-attached disk resource.
773 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
774 # or X86_64.
775 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
776 # deleted (but not when the disk is detached from the instance).
777 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
778 # partition of the disk for its root filesystem.
779 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
780 # running within the instance. This name can be used to reference the device
781 # for mounting, resizing, and so on, from within the instance.
782 #
783 # If not specified, the server chooses a default device name to apply to this
784 # disk, in the form persistent-disk-x, where x is a number
785 # assigned by Google Compute Engine. This field is only applicable for
786 # persistent disks.
787 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
788 # encryption key.
789 #
790 # If you are creating a new disk, this field encrypts the new disk using
791 # an encryption key that you provide. If you are attaching an existing
792 # disk that is already encrypted, this field decrypts the disk using
793 # the customer-supplied encryption key.
794 #
795 # If you encrypt a disk using a customer-supplied key, you must provide the
796 # same key again when you attempt to use this resource at a later time. For
797 # example, you must provide the key when you create a snapshot or an image
798 # from the disk or when you attach the disk to a virtual machine instance.
799 #
800 # If you do not provide an encryption key, then the disk will be encrypted
801 # using an automatically generated key and you do not need to provide a key
802 # to use the disk later.
803 #
804 # Note:
805 #
806 # Instance templates do not storecustomer-supplied
807 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
808 #
809 # You cannot create VMs that have disks with customer-supplied keys using
810 # the bulk
811 # insert method.
812 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
813 # For example:
814 #
815 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
816 # key_region/cryptoKeys/key
817 #
818 # The fully-qualifed key name may be returned for resource GET requests. For
819 # example:
820 #
821 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
822 # key_region/cryptoKeys/key
823 # /cryptoKeyVersions/1
824 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
825 # key. If absent, the Compute Engine default service account is used.
826 # For example:
827 #
828 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
829 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
830 # encryption key, encoded in RFC
831 # 4648 base64 to either encrypt or decrypt this resource. You can
832 # provide either the rawKey or thersaEncryptedKey.
833 # For example:
834 #
835 # &quot;rawKey&quot;:
836 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
837 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
838 # customer-supplied encryption key to either encrypt or decrypt this
839 # resource. You can provide either the rawKey or thersaEncryptedKey.
840 # For example:
841 #
842 # &quot;rsaEncryptedKey&quot;:
843 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
844 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
845 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
846 #
847 # The key must meet the following requirements before you can provide it to
848 # Compute Engine:
849 #
850 # 1. The key is wrapped using a RSA public key certificate provided by
851 # Google.
852 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
853 # encoding.
854 #
855 # Gets the RSA public key certificate provided by Google at:
856 #
857 #
858 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
859 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
860 # 4648 base64 encoded SHA-256 hash of the customer-supplied
861 # encryption key that protects this resource.
862 },
863 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
864 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
865 # currently attached to another instance. If you try to force attach a zonal
866 # disk to an instance, you will receive an error.
867 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
868 # only for bootable images. Read
869 # Enabling guest operating system features to see a list of available
870 # options.
871 { # Guest OS features.
872 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
873 # separate values. Set to one or more of the following values:
874 #
875 # - VIRTIO_SCSI_MULTIQUEUE
876 # - WINDOWS
877 # - MULTI_IP_SUBNET
878 # - UEFI_COMPATIBLE
879 # - GVNIC
880 # - SEV_CAPABLE
881 # - SUSPEND_RESUME_COMPATIBLE
882 # - SEV_LIVE_MIGRATABLE_V2
883 # - SEV_SNP_CAPABLE
884 # - TDX_CAPABLE
885 # - IDPF
886 # - SNP_SVSM_CAPABLE
887 # - CCA_CAPABLE
888 #
889 #
890 # For more information, see
891 # Enabling guest operating system features.
892 },
893 ],
894 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
895 # boot disk. If you have many disks attached to an instance, each
896 # disk would have a unique index number.
897 &quot;initializeParams&quot;: { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
898 # alongside the new instance. Use initialization parameters to create boot
899 # disks or local SSDs attached to the new instance.
900 #
901 # This property is mutually exclusive with the source property;
902 # you can only define one or the other, but not both.
903 # alongside the new instance. Use initialization parameters to create boot
904 # disks or local SSDs attached to the new instance.
905 #
906 # This field is persisted and returned for instanceTemplate and not returned
907 # in the context of instance.
908 #
909 # This property is mutually exclusive with the source property;
910 # you can only define one or the other, but not both.
911 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
912 # arm64 or x86_64.
913 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
914 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
915 # of the instance. If a disk with the same name already exists in the given
916 # region, the existing disk is attached to the new instance and the
917 # new disk is not created.
918 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
919 # 10 GB. If you specify a sourceImage, which is required for
920 # boot disks, the default size is the size of the sourceImage.
921 # If you do not specify a sourceImage, the default disk size
922 # is 500 GB.
923 &quot;diskType&quot;: &quot;A String&quot;,
924 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
925 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
926 # only for bootable images. Read
927 # Enabling guest operating system features to see a list of available
928 # options.
929 #
930 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
931 { # Guest OS features.
932 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
933 # separate values. Set to one or more of the following values:
934 #
935 # - VIRTIO_SCSI_MULTIQUEUE
936 # - WINDOWS
937 # - MULTI_IP_SUBNET
938 # - UEFI_COMPATIBLE
939 # - GVNIC
940 # - SEV_CAPABLE
941 # - SUSPEND_RESUME_COMPATIBLE
942 # - SEV_LIVE_MIGRATABLE_V2
943 # - SEV_SNP_CAPABLE
944 # - TDX_CAPABLE
945 # - IDPF
946 # - SNP_SVSM_CAPABLE
947 # - CCA_CAPABLE
948 #
949 #
950 # For more information, see
951 # Enabling guest operating system features.
952 },
953 ],
954 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
955 # which is either SCSI or NVME. The default isSCSI.
956 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
957 # persistent disks.
958 &quot;a_key&quot;: &quot;A String&quot;,
959 },
960 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
961 # disk.
962 &quot;A String&quot;,
963 ],
964 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
965 &quot;A String&quot;,
966 ],
967 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
968 # more than one instance.
969 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
970 # is to use the existing disk.
971 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
972 # of I/O operations per second that the disk can handle. Values must be
973 # between 10,000 and 120,000. For more details, see theExtreme persistent
974 # disk documentation.
975 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
976 # number of throughput mb per second that the disk can handle. Values must
977 # greater than or equal to 1.
978 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
979 # the URLs of the zones where the disk should be replicated to.
980 # You must provide exactly two replica zones, and one zone must be the same
981 # as the instance zone.
982 &quot;A String&quot;,
983 ],
984 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
985 # have the same definition as resource
986 # manager tags. Keys and values can be either in numeric format,
987 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
988 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
989 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
990 # empty.
991 &quot;a_key&quot;: &quot;A String&quot;,
992 },
993 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
994 # Specified using the full or partial URL. For instance template, specify
995 # only the resource policy name.
996 &quot;A String&quot;,
997 ],
998 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
999 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1000 # is required.
1001 #
1002 # To create a disk with one of the public operating system
1003 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
1004 #
1005 # projects/debian-cloud/global/images/family/debian-9
1006 #
1007 #
1008 # Alternatively, use a specific version of a public operating system image:
1009 #
1010 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
1011 #
1012 #
1013 # To create a disk with a custom image that you created, specify the
1014 # image name in the following format:
1015 #
1016 # global/images/my-custom-image
1017 #
1018 #
1019 # You can also specify a custom image by its image family, which returns
1020 # the latest version of the image in that family. Replace the image name
1021 # with family/family-name:
1022 #
1023 # global/images/family/my-image-family
1024 #
1025 #
1026 # If the source image is deleted later, this field will not be set.
1027 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
1028 # encryption key of the source image. Required if the source image is
1029 # protected by a customer-supplied encryption key.
1030 #
1031 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
1032 # encryption keys, so you cannot create disks for instances in a managed instance group if the
1033 # source images are encrypted with your own keys.
1034 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1035 # For example:
1036 #
1037 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1038 # key_region/cryptoKeys/key
1039 #
1040 # The fully-qualifed key name may be returned for resource GET requests. For
1041 # example:
1042 #
1043 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1044 # key_region/cryptoKeys/key
1045 # /cryptoKeyVersions/1
1046 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1047 # key. If absent, the Compute Engine default service account is used.
1048 # For example:
1049 #
1050 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1051 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1052 # encryption key, encoded in RFC
1053 # 4648 base64 to either encrypt or decrypt this resource. You can
1054 # provide either the rawKey or thersaEncryptedKey.
1055 # For example:
1056 #
1057 # &quot;rawKey&quot;:
1058 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1059 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1060 # customer-supplied encryption key to either encrypt or decrypt this
1061 # resource. You can provide either the rawKey or thersaEncryptedKey.
1062 # For example:
1063 #
1064 # &quot;rsaEncryptedKey&quot;:
1065 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1066 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1067 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1068 #
1069 # The key must meet the following requirements before you can provide it to
1070 # Compute Engine:
1071 #
1072 # 1. The key is wrapped using a RSA public key certificate provided by
1073 # Google.
1074 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1075 # encoding.
1076 #
1077 # Gets the RSA public key certificate provided by Google at:
1078 #
1079 #
1080 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1081 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1082 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1083 # encryption key that protects this resource.
1084 },
1085 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
1086 # instance boot disk, one of initializeParams.sourceSnapshot
1087 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
1088 # is required.
1089 #
1090 # To create a disk with a snapshot that you created, specify the
1091 # snapshot name in the following format:
1092 #
1093 # us-central1-a/instantSnapshots/my-backup
1094 #
1095 #
1096 # If the source instant-snapshot is deleted later, this field will not be
1097 # set.
1098 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
1099 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
1100 # is required.
1101 #
1102 # To create a disk with a snapshot that you created, specify the
1103 # snapshot name in the following format:
1104 #
1105 # global/snapshots/my-backup
1106 #
1107 #
1108 # If the source snapshot is deleted later, this field will not be set.
1109 #
1110 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
1111 # an image instead when you create VMs using
1112 # the bulk
1113 # insert method.
1114 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
1115 # encryption key of the source snapshot.
1116 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1117 # For example:
1118 #
1119 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1120 # key_region/cryptoKeys/key
1121 #
1122 # The fully-qualifed key name may be returned for resource GET requests. For
1123 # example:
1124 #
1125 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1126 # key_region/cryptoKeys/key
1127 # /cryptoKeyVersions/1
1128 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1129 # key. If absent, the Compute Engine default service account is used.
1130 # For example:
1131 #
1132 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1133 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1134 # encryption key, encoded in RFC
1135 # 4648 base64 to either encrypt or decrypt this resource. You can
1136 # provide either the rawKey or thersaEncryptedKey.
1137 # For example:
1138 #
1139 # &quot;rawKey&quot;:
1140 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1141 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1142 # customer-supplied encryption key to either encrypt or decrypt this
1143 # resource. You can provide either the rawKey or thersaEncryptedKey.
1144 # For example:
1145 #
1146 # &quot;rsaEncryptedKey&quot;:
1147 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1148 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1149 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1150 #
1151 # The key must meet the following requirements before you can provide it to
1152 # Compute Engine:
1153 #
1154 # 1. The key is wrapped using a RSA public key certificate provided by
1155 # Google.
1156 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1157 # encoding.
1158 #
1159 # Gets the RSA public key certificate provided by Google at:
1160 #
1161 #
1162 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1163 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1164 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1165 # encryption key that protects this resource.
1166 },
1167 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
1168 # this as a partial or full URL to the resource. For example, the following
1169 # are valid values:
1170 #
1171 #
1172 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
1173 # - projects/project/zones/zone/storagePools/storagePool
1174 # - zones/zone/storagePools/storagePool
1175 },
1176 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
1177 # either SCSI or NVME. For most machine types, the
1178 # default is SCSI. Local SSDs can use either NVME or SCSI.
1179 # In certain configurations, persistent disks can use NVMe. For more
1180 # information, seeAbout
1181 # persistent disks.
1182 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
1183 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
1184 &quot;A String&quot;,
1185 ],
1186 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
1187 # disk is not allowed to be detached from the instance, or to be used as the
1188 # source of the snapshot creation, and the image creation. The instance with
1189 # at least one locked attached disk is not allow to be used as source of
1190 # machine image creation, instant snapshot creation, and not allowed to be
1191 # deleted with --keep-disk parameter set to true for locked disks.
1192 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
1193 # in READ_WRITE mode.
1194 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
1195 # field is set to PRESERVED if the LocalSSD data has been saved
1196 # to a persistent location by customer request. (see the
1197 # discard_local_ssd option on Stop/Suspend).
1198 # Read-only in the api.
1199 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
1200 # these are public keys which are safe to store in public
1201 &quot;dbs&quot;: [ # The Key Database (db).
1202 {
1203 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1204 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1205 },
1206 ],
1207 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
1208 {
1209 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1210 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1211 },
1212 ],
1213 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
1214 {
1215 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1216 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1217 },
1218 ],
1219 &quot;pk&quot;: { # The Platform Key (PK).
1220 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1221 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1222 },
1223 },
1224 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
1225 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1226 # is required.
1227 #
1228 # If desired, you can also attach existing non-root persistent disks using
1229 # this property. This field is only applicable for persistent disks.
1230 #
1231 # Note that for InstanceTemplate, specify the disk name for zonal disk,
1232 # and the URL for regional disk.
1233 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
1234 },
1235 ],
1236 &quot;displayDevice&quot;: { # A set of Display Device options # Display Device properties to enable support
1237 # for remote display products like: Teradici,
1238 # VNC and TeamViewer
1239 # Note that for MachineImage, this is not supported yet.
1240 &quot;enableDisplay&quot;: True or False, # Defines whether the instance has Display enabled.
1241 },
1242 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
1243 # created from these properties.
1244 { # A specification of the type and number of accelerator cards attached to the
1245 # instance.
1246 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
1247 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
1248 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
1249 # If you are creating an instance template, specify only the
1250 # accelerator name.
1251 # See GPUs on Compute Engine
1252 # for a full list of accelerator types.
1253 },
1254 ],
1255 &quot;identity&quot;: &quot;A String&quot;,
1256 &quot;identityCertificate&quot;: True or False,
1257 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
1258 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
1259 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
1260 &quot;a_key&quot;: &quot;A String&quot;,
1261 },
1262 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
1263 # properties.
1264 # This field only accepts a machine type name, for example `n2-standard-4`.
1265 # If you use the machine type full or partial URL, for example
1266 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
1267 # the request will result in an `INTERNAL_ERROR`.
1268 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
1269 # these properties. These pairs can consist of custom metadata or predefined
1270 # keys. SeeProject and
1271 # instance metadata for more information.
1272 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
1273 # the metadata&#x27;s contents and used for optimistic locking. The
1274 # fingerprint is initially generated by Compute Engine and changes after
1275 # every request to modify or update metadata. You must always provide an
1276 # up-to-date fingerprint hash in order to update or change metadata,
1277 # otherwise the request will fail with error412 conditionNotMet.
1278 #
1279 # To see the latest fingerprint, make a get() request to
1280 # retrieve the resource.
1281 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
1282 # less than 512 KB.
1283 { # Metadata
1284 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
1285 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
1286 # This is reflected as part of a URL in the metadata server. Additionally, to
1287 # avoid ambiguity, keys must not conflict with any other metadata keys
1288 # for the project.
1289 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
1290 # have meaning as interpreted by the image running in the instance. The
1291 # only restriction placed on values is that their size must be less than
1292 # or equal to 262144 bytes (256 KiB).
1293 },
1294 ],
1295 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
1296 # for metadata.
1297 },
1298 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
1299 # scheduled on the specified or newer cpu/platform. Applicable values are the
1300 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
1301 # information, read Specifying a
1302 # Minimum CPU Platform.
1303 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
1304 { # A network interface resource attached to an instance.
1305 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
1306 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
1307 # no external internet access.
1308 { # An access configuration attached to an instance&#x27;s network interface.
1309 # Only one access config per instance is supported.
1310 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1311 # The first IPv6 address of the external IPv6 range associated
1312 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1313 # use a static external IP address, it must be unused and in the same region
1314 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1315 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1316 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1317 # external IPv6 range.
1318 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1319 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1320 # (IPv4), the default and recommended name is External NAT, but
1321 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1322 # recommend name is External IPv6.
1323 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1324 # address associated with this instance. Specify an unused static
1325 # external IP address available to the project or leave this field undefined
1326 # to use an IP from a shared ephemeral IP address pool. If you specify a
1327 # static external IP address, it must live in the same region as the zone of
1328 # the instance.
1329 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1330 # configuration and can only take the following values: PREMIUM,STANDARD.
1331 #
1332 # If an AccessConfig is specified without a valid external IP address, an
1333 # ephemeral IP will be created with this networkTier.
1334 #
1335 # If an AccessConfig with a valid external IP address is specified, it must
1336 # match that of the networkTier associated with the Address resource owning
1337 # that IP.
1338 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
1339 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
1340 #
1341 # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
1342 # first IP in associated external IPv6 range.
1343 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
1344 # config.
1345 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
1346 # external IP address of this access configuration.
1347 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
1348 # external IP address of the instance to a DNS domain name.
1349 #
1350 # This field is not used in ipv6AccessConfig. A default PTR
1351 # record will be created if the VM has external IPv6 range associated.
1352 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
1353 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
1354 },
1355 ],
1356 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
1357 # You can only specify this field for network interfaces in VPC networks.
1358 { # An alias IP range attached to an instance&#x27;s network interface.
1359 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1360 # must belong to the specified subnetwork and cannot contain IP addresses
1361 # reserved by system or used by other network interfaces. This range may be
1362 # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
1363 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1364 # alias range. If not specified, the primary range of the subnetwork is used.
1365 },
1366 ],
1367 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
1368 # You can only specify this field for network interfaces in VPC networks.
1369 { # An alias IP range attached to an instance&#x27;s network interface.
1370 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1371 # must belong to the specified subnetwork and cannot contain IP addresses
1372 # reserved by system or used by other network interfaces. This range may be
1373 # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
1374 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1375 # alias range. If not specified, the primary range of the subnetwork is used.
1376 },
1377 ],
1378 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
1379 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
1380 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
1381 # with network_attachment.
1382 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
1383 # This field will be ignored when inserting an Instance or
1384 # adding a NetworkInterface. An up-to-date
1385 # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
1386 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
1387 # or not. If enabled, also indicates the version of IGMP supported.
1388 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
1389 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
1390 # one IPv6 access config, DIRECT_IPV6, is supported. If there
1391 # is no ipv6AccessConfig specified, then this instance will
1392 # have no external IPv6 Internet access.
1393 { # An access configuration attached to an instance&#x27;s network interface.
1394 # Only one access config per instance is supported.
1395 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1396 # The first IPv6 address of the external IPv6 range associated
1397 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1398 # use a static external IP address, it must be unused and in the same region
1399 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1400 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1401 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1402 # external IPv6 range.
1403 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1404 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1405 # (IPv4), the default and recommended name is External NAT, but
1406 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1407 # recommend name is External IPv6.
1408 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1409 # address associated with this instance. Specify an unused static
1410 # external IP address available to the project or leave this field undefined
1411 # to use an IP from a shared ephemeral IP address pool. If you specify a
1412 # static external IP address, it must live in the same region as the zone of
1413 # the instance.
1414 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1415 # configuration and can only take the following values: PREMIUM,STANDARD.
1416 #
1417 # If an AccessConfig is specified without a valid external IP address, an
1418 # ephemeral IP will be created with this networkTier.
1419 #
1420 # If an AccessConfig with a valid external IP address is specified, it must
1421 # match that of the networkTier associated with the Address resource owning
1422 # that IP.
1423 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
1424 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
1425 #
1426 # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
1427 # first IP in associated external IPv6 range.
1428 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
1429 # config.
1430 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
1431 # external IP address of this access configuration.
1432 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
1433 # external IP address of the instance to a DNS domain name.
1434 #
1435 # This field is not used in ipv6AccessConfig. A default PTR
1436 # record will be created if the VM has external IPv6 range associated.
1437 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
1438 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
1439 },
1440 ],
1441 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
1442 # accessed from the Internet. This field is always inherited from its
1443 # subnetwork.
1444 #
1445 # Valid only if stackType is IPV4_IPV6.
1446 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
1447 # use a static internal IP address, it must be unused and in the same region
1448 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1449 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
1450 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
1451 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
1452 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
1453 # server. For a VM, the network interface uses the nicN naming
1454 # format. Where N is a value between 0 and7. The default interface value is nic0.
1455 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
1456 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
1457 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
1458 # instance, if neither the network nor the subnetwork is specified, the
1459 # default network global/networks/default is used. If the
1460 # selected project doesn&#x27;t have the default network, you must specify a
1461 # network or subnet. If the network is not specified but the subnetwork is
1462 # specified, the network is inferred.
1463 #
1464 # If you specify this property, you can specify the network as
1465 # a full or partial URL. For example, the following are all valid URLs:
1466 #
1467 #
1468 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
1469 # - projects/project/global/networks/network
1470 # - global/networks/default
1471 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
1472 # to in the following format:
1473 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
1474 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
1475 # interface. If not specified by the user, an unused internal IP is
1476 # assigned by the system.
1477 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
1478 # VirtioNet.
1479 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
1480 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
1481 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
1482 # if not specified by the users.
1483 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
1484 # interface. Can only be used with network_attachment. It is not possible to
1485 # use on its own however, network_attachment can be used without
1486 # service_class_id.
1487 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
1488 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
1489 #
1490 # This field can be both set at instance creation and update network
1491 # interface operations.
1492 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
1493 # subnetworks that support L2. Every network interface will get a default
1494 # untagged (vlan not specified) subinterface. Users can specify additional
1495 # tagged subinterfaces which are sub-fields to the Network Interface.
1496 {
1497 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
1498 # subinterface. If specified, ip_allocation_mode should be set to
1499 # ALLOCATE_IP.
1500 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
1501 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
1502 # as that of the network interface.
1503 # If not specified the subnet of network interface will be used.
1504 # If you specify this property, you can specify the subnetwork as a full
1505 # or partial URL. For example, the following are all valid URLs:
1506 #
1507 #
1508 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
1509 # - regions/region/subnetworks/subnetwork
1510 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
1511 # this subinterface is connecting.
1512 },
1513 ],
1514 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
1515 # resource is inlegacy
1516 # mode, do not specify this field. If the network is in auto subnet
1517 # mode, specifying the subnetwork is optional. If the network is in custom
1518 # subnet mode, specifying the subnetwork is required. If you specify this
1519 # field, you can specify the subnetwork as a full or partial URL. For
1520 # example, the following are all valid URLs:
1521 #
1522 #
1523 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
1524 # - regions/region/subnetworks/subnetwork
1525 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
1526 # from 2 to 255 inclusively.
1527 },
1528 ],
1529 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
1530 &quot;externalIpEgressBandwidthTier&quot;: &quot;A String&quot;,
1531 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
1532 },
1533 &quot;partnerMetadata&quot;: { # Partner Metadata assigned to the instance properties. A map from a
1534 # subdomain (namespace) to entries map.
1535 &quot;a_key&quot;: {
1536 &quot;entries&quot;: { # Map of a partner metadata that belong to the same subdomain.
1537 # It accepts any value including google.protobuf.Struct.
1538 &quot;a_key&quot;: &quot;&quot;,
1539 },
1540 },
1541 },
1542 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
1543 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
1544 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
1545 # Note that for MachineImage, this is not supported yet.
1546 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
1547 # Note that for MachineImage, this is not supported yet.
1548 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
1549 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
1550 # Consuming reserved instances for examples.
1551 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
1552 # the name of your reservation as its value.
1553 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
1554 # either a name to a reservation in the same project or
1555 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
1556 # shared reservation in the same zone but in a different project.
1557 &quot;A String&quot;,
1558 ],
1559 },
1560 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
1561 # have the same definition as resource
1562 # manager tags. Keys and values can be either in numeric format,
1563 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1564 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1565 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
1566 # PATCH) when empty.
1567 &quot;a_key&quot;: &quot;A String&quot;,
1568 },
1569 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
1570 # these properties.
1571 # Note that for MachineImage, this is not supported yet.
1572 &quot;A String&quot;,
1573 ],
1574 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
1575 # these properties.
1576 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
1577 # terminated by Compute Engine (not terminated by a user). You can only set
1578 # the automatic restart option for standard instances.Preemptible instances
1579 # cannot be automatically restarted.
1580 #
1581 # By default, this is set to true so an instance is
1582 # automatically restarted if it is terminated by Compute Engine.
1583 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
1584 # must be a number between 1 and the number of availability domains
1585 # specified in the spread placement policy attached to the instance.
1586 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
1587 # 0 or unset means default vCPUs of the current machine type.
1588 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
1589 # 0 or unset means default amount of memory of the current machine type.
1590 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
1591 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
1592 &quot;maxDuration&quot;: { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
1593 # graceful shutdown isn&#x27;t complete after this time, then the instance
1594 # transitions to the STOPPING state.
1595 # as a count of seconds and fractions of seconds at nanosecond
1596 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1597 # or &quot;month&quot;. Range is approximately 10,000 years.
1598 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1599 # Durations less than one second are represented with a 0
1600 # `seconds` field and a positive `nanos` field. Must be from 0
1601 # to 999,999,999 inclusive.
1602 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1603 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1604 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1605 },
1606 },
1607 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
1608 # within the range of [90, 330] with the increment of 30, if unset, the
1609 # default behavior of host error recovery will be used.
1610 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
1611 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
1612 # only be set during instance creation, or when the instance is not currently
1613 # running. It must not be set if thepreemptible option is
1614 # also set.
1615 &quot;localSsdRecoveryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
1616 # recovery of the Local Ssd state is attempted. Its value should be in
1617 # between 0 and 168 hours with hour granularity and the default value being 1
1618 # hour.
1619 # as a count of seconds and fractions of seconds at nanosecond
1620 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1621 # or &quot;month&quot;. Range is approximately 10,000 years.
1622 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1623 # Durations less than one second are represented with a 0
1624 # `seconds` field and a positive `nanos` field. Must be from 0
1625 # to 999,999,999 inclusive.
1626 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1627 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1628 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1629 },
1630 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
1631 # resources.
1632 # This field is for use by internal tools that use the public API.
1633 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
1634 # be scheduled for maintenance.
1635 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
1636 # are: `PERIODIC`.
1637 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
1638 # the instance termination action will be performed at the end of the run
1639 # duration.
1640 # as a count of seconds and fractions of seconds at nanosecond
1641 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1642 # or &quot;month&quot;. Range is approximately 10,000 years.
1643 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1644 # Durations less than one second are represented with a 0
1645 # `seconds` field and a positive `nanos` field. Must be from 0
1646 # to 999,999,999 inclusive.
1647 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1648 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1649 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1650 },
1651 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
1652 # on a sole-tenant node.
1653 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
1654 # affinity for more information.
1655 # Overrides reservationAffinity.
1656 { # Node Affinity: the configuration of desired nodes onto which this Instance
1657 # could be scheduled.
1658 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
1659 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
1660 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
1661 &quot;A String&quot;,
1662 ],
1663 },
1664 ],
1665 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
1666 # the default behavior is MIGRATE. Forpreemptible instances,
1667 # the default and only possible behavior is TERMINATE. For more
1668 # information, see
1669 # Set
1670 # VM host maintenance policy.
1671 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
1672 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
1673 # else, the Local SSD data will be preserved when the instance is stopped
1674 # at the end of the run duration/termination time.
1675 },
1676 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
1677 # instance creation or while the instance isstopped and
1678 # therefore, in a `TERMINATED` state. SeeInstance Life
1679 # Cycle for more information on the possible instance states.
1680 &quot;preemptionNoticeDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2 Soft
1681 # Off signal is triggered for Spot
1682 # VMs only. If not specified, there will be no wait before the G2 Soft
1683 # Off signal is triggered.
1684 # as a count of seconds and fractions of seconds at nanosecond
1685 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1686 # or &quot;month&quot;. Range is approximately 10,000 years.
1687 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1688 # Durations less than one second are represented with a 0
1689 # `seconds` field and a positive `nanos` field. Must be from 0
1690 # to 999,999,999 inclusive.
1691 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1692 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1693 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1694 },
1695 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
1696 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
1697 # Timeout between GCE ACPI G2 Soft
1698 # Off and ACPI G3 Mechanical
1699 # Off during shutdown operation of VM.
1700 #
1701 # For Standard VMs values between 0s and 120s are allowed. For Spot and
1702 # Preemptible VMs supported values are between 0s and 30s.
1703 #
1704 # If no value is specified for shutdownDuration, default values are 90s for
1705 # Standard VMs and 30s for Spot/Preemptible VMs.
1706 # as a count of seconds and fractions of seconds at nanosecond
1707 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1708 # or &quot;month&quot;. Range is approximately 10,000 years.
1709 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1710 # Durations less than one second are represented with a 0
1711 # `seconds` field and a positive `nanos` field. Must be from 0
1712 # to 999,999,999 inclusive.
1713 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1714 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1715 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1716 },
1717 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
1718 # Off and ACPI G3 Mechanical
1719 # Off for Standard VMs and 30 seconds for Spot VMs.
1720 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
1721 # termination action will be performed at the termination time.
1722 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
1723 &quot;mode&quot;: &quot;A String&quot;,
1724 },
1725 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
1726 # unspecified, the default mode is `OFF`.
1727 },
1728 &quot;secureTags&quot;: [ # [Input Only] Secure tags to apply to this instance.
1729 # Maximum number of secure tags allowed is 50.
1730 # Note that for MachineImage, this is not supported yet.
1731 &quot;A String&quot;,
1732 ],
1733 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
1734 # service accounts are available to the instances that are created from
1735 # these properties. Use metadata queries to obtain the access tokens for
1736 # these instances.
1737 { # A service account.
1738 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
1739 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
1740 &quot;A String&quot;,
1741 ],
1742 },
1743 ],
1744 &quot;serviceIntegrationSpecs&quot;: { # Mapping of user defined keys to ServiceIntegrationSpec.
1745 &quot;a_key&quot;: { # Specifies the parameters to configure an integration with instances.
1746 &quot;backupDr&quot;: { # Specifies parameters to Backup and DR to attach a BackupPlan to a compute
1747 # instance for managed VM backup.
1748 &quot;plan&quot;: &quot;A String&quot;, # The BackupPlan resource to attach to the instance. Specified as a
1749 # resource reference in instances, and regional instance templates, and as
1750 # just the plan name in global instance templates
1751 },
1752 },
1753 },
1754 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
1755 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
1756 # default.
1757 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
1758 # default.
1759 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
1760 # default.
1761 },
1762 &quot;shieldedVmConfig&quot;: { # A set of Shielded VM options. # Specifies the Shielded VM options for the instances that are created from
1763 # these properties.
1764 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.
1765 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.
1766 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.
1767 },
1768 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
1769 # properties. The tags identify valid sources or targets for network
1770 # firewalls. The setTags method can modify this list of tags. Each tag within
1771 # the list must comply with RFC1035.
1772 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
1773 # the tags&#x27; contents and used for optimistic locking. The
1774 # fingerprint is initially generated by Compute Engine and changes after
1775 # every request to modify or update tags. You must always provide an
1776 # up-to-date fingerprint hash in order to update or change tags.
1777 #
1778 # To see the latest fingerprint, make get() request to the
1779 # instance.
1780 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
1781 # with RFC1035.
1782 &quot;A String&quot;,
1783 ],
1784 },
1785 &quot;workloadIdentityConfig&quot;: {
1786 &quot;identity&quot;: &quot;A String&quot;,
1787 &quot;identityCertificateEnabled&quot;: True or False,
1788 },
1789 },
1790 &quot;locationPolicy&quot;: { # Configuration for location policy among multiple possible locations # Policy for choosing target zone. For more information, seeCreate VMs in
1791 # bulk.
1792 # (e.g. preferences for zone selection among zones in a single region).
1793 &quot;locations&quot;: { # Location configurations mapped by location name.
1794 # Currently only zone names are supported and must be represented as valid
1795 # internal URLs, such as zones/us-central1-a.
1796 # The bulkInsert operation doesn&#x27;t create instances in an AI zone, even if
1797 # an AI zone is available in the specified region. For example, if you set a
1798 # DENY preference for us-central1-a, Compute Engine will consider
1799 # us-central1-b and us-central1-c for instance creation, but not
1800 # us-central1-ai1a. Also, you can&#x27;t use the locations[] configuration to
1801 # allow instance creation in an AI zone. To include an AI zone in bulkInsert
1802 # operations, use the locationPolicy.zones[] field.
1803 &quot;a_key&quot;: {
1804 &quot;constraints&quot;: { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution
1805 # in this zone.
1806 &quot;maxCount&quot;: 42, # Maximum number of items that are allowed to be placed in this zone.
1807 # The value must be non-negative.
1808 },
1809 &quot;names&quot;: [ # Names of resources to be put in the location.
1810 # Must contain unique, correct resource names.
1811 # If used, targetShape must be left unset.
1812 &quot;A String&quot;,
1813 ],
1814 &quot;preference&quot;: &quot;A String&quot;, # Preference for a given location. Set to either ALLOW orDENY.
1815 },
1816 },
1817 &quot;targetShape&quot;: &quot;A String&quot;, # Strategy for distributing VMs across zones in a region.
1818 &quot;zones&quot;: [ # The bulkInsert operation applies any preferences set in the locations
1819 # field to the specific zones listed in the zones field if the same zones
1820 # are specified in both fields.
1821 {
1822 &quot;zone&quot;: &quot;A String&quot;, # The URL of the zone.
1823 # The zone must exist in the region where the request is called.
1824 # Zones must be represented as valid partial URLs,
1825 # such as zones/us-central1-a.
1826 },
1827 ],
1828 },
1829 &quot;minCount&quot;: &quot;A String&quot;, # The minimum number of instances to create. If no min_count is
1830 # specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will
1831 # be created and instances already created will be deleted.
1832 &quot;namePattern&quot;: &quot;A String&quot;, # The string pattern used for the names of the VMs.
1833 # Either name_pattern or per_instance_properties
1834 # must be set. The pattern must contain one continuous sequence of
1835 # placeholder hash characters (#) with each character corresponding to one
1836 # digit of the generated instance name. Example: a name_pattern
1837 # of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances
1838 # in the same project and zone have names that match the name pattern
1839 # then the generated instance numbers start after the biggest
1840 # existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern
1841 # placeholder #...# can contain up to 18 characters.
1842 &quot;perInstanceProperties&quot;: { # Per-instance properties to be set on individual instances.
1843 # Keys of this map specify requested instance names.
1844 # Can be empty if name_pattern is used.
1845 &quot;a_key&quot;: { # Per-instance properties to be set on individual instances.
1846 # To be extended in the future.
1847 &quot;hostname&quot;: &quot;A String&quot;, # Specifies the hostname of the instance. More details in:
1848 # https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention
1849 &quot;name&quot;: &quot;A String&quot;, # Output only. This field is only temporary. It will be removed. Do not use it.
1850 },
1851 },
1852 &quot;sourceInstanceTemplate&quot;: &quot;A String&quot;, # Specifies the instance template from which to create instances. You may
1853 # combine sourceInstanceTemplate withinstanceProperties to override specific values from an
1854 # existing instance template. Bulk API follows the semantics of JSON Merge
1855 # Patch described by RFC
1856 # 7396.
1857 #
1858 # It can be a full or partial URL. For example, the following are
1859 # all valid URLs to an instance template:
1860 #
1861 #
1862 # - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
1863 # - projects/project/global/instanceTemplates/instanceTemplate
1864 # - global/instanceTemplates/instanceTemplate
1865 #
1866 #
1867 #
1868 # This field is optional.
1869 },
1870 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp in RFC3339
1871 # text format.
1872 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1873 # create the resource.
1874 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
1875 # defined by the server.
1876 &quot;kind&quot;: &quot;compute#queuedResource&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#queuedResource for QueuedResources.
1877 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1878 # The name must be 1-63 characters long, and comply withRFC1035.
1879 # Specifically, the name must be 1-63 characters long and match the regular
1880 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character
1881 # must be a lowercase letter, and all following characters must be a dash,
1882 # lowercase letter, or digit, except the last character, which cannot be a
1883 # dash.
1884 &quot;queuingPolicy&quot;: { # Queuing parameters for the requested deferred capacity. # Queuing parameters for the requested capacity.
1885 &quot;validUntilDuration&quot;: { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity.
1886 # as a count of seconds and fractions of seconds at nanosecond
1887 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1888 # or &quot;month&quot;. Range is approximately 10,000 years.
1889 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1890 # Durations less than one second are represented with a 0
1891 # `seconds` field and a positive `nanos` field. Must be from 0
1892 # to 999,999,999 inclusive.
1893 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1894 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1895 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1896 },
1897 &quot;validUntilTime&quot;: &quot;A String&quot;, # Absolute deadline for waiting for capacity inRFC3339
1898 # text format.
1899 },
1900 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output only] Server-defined URL for the resource.
1901 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1902 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output only] High-level status of the request.
1903 &quot;status&quot;: { # [Output only] Result of queuing and provisioning based on deferred # Output only. [Output only] Result of queuing and provisioning based on deferred
1904 # capacity.
1905 # capacity.
1906 &quot;failedData&quot;: { # Additional status detail for the FAILED state. # Output only. Additional status detail for the FAILED state.
1907 &quot;error&quot;: { # The error(s) that caused the QueuedResource to enter the FAILED state.
1908 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1909 # operation.
1910 {
1911 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1912 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1913 # details. There is a set of defined message types to use for providing
1914 # details.The syntax depends on the error code. For example,
1915 # QuotaExceededInfo will have details when the error code is
1916 # QUOTA_EXCEEDED.
1917 {
1918 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1919 #
1920 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1921 # is not enabled:
1922 #
1923 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1924 # &quot;domain&quot;: &quot;googleapis.com&quot;
1925 # &quot;metadata&quot;: {
1926 # &quot;resource&quot;: &quot;projects/123&quot;,
1927 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1928 # }
1929 # }
1930 #
1931 # This response indicates that the pubsub.googleapis.com API is not enabled.
1932 #
1933 # Example of an error that is returned when attempting to create a Spanner
1934 # instance in a region that is out of stock:
1935 #
1936 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1937 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1938 # &quot;metadata&quot;: {
1939 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1940 # }
1941 # }
1942 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1943 # is typically the registered service name of the tool or product that
1944 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1945 # generated by some common infrastructure, the error domain must be a
1946 # globally unique value that identifies the infrastructure. For Google API
1947 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1948 &quot;metadatas&quot;: { # Additional structured details about this error.
1949 #
1950 # Keys must match a regular expression of `a-z+` but should
1951 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1952 # length. When identifying the current value of an exceeded limit, the units
1953 # should be contained in the key, not the value. For example, rather than
1954 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1955 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1956 # instances that can be created in a single (batch) request.
1957 &quot;a_key&quot;: &quot;A String&quot;,
1958 },
1959 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1960 # proximate cause of the error. Error reasons are unique within a particular
1961 # domain of errors. This should be at most 63 characters and match a
1962 # regular expression of `A-Z+[A-Z0-9]`, which represents
1963 # UPPER_SNAKE_CASE.
1964 },
1965 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1966 #
1967 # For example, if a quota check failed with an error indicating the calling
1968 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1969 # directly to the right place in the developer console to flip the bit.
1970 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1971 { # Describes a URL link.
1972 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1973 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1974 },
1975 ],
1976 },
1977 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1978 # which can be attached to an RPC error.
1979 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1980 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1981 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1982 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1983 },
1984 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1985 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1986 &quot;a_key&quot;: &quot;A String&quot;,
1987 },
1988 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1989 # type or metric.
1990 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1991 # or metric.
1992 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1993 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1994 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1995 },
1996 },
1997 ],
1998 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1999 # This property is optional.
2000 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2001 },
2002 ],
2003 },
2004 },
2005 &quot;provisioningOperations&quot;: [ # Output only. [Output only] Fully qualified URL of the provisioning GCE operation to
2006 # track the provisioning along with provisioning errors. The referenced
2007 # operation may not exist after having been deleted or expired.
2008 &quot;A String&quot;,
2009 ],
2010 &quot;queuingPolicy&quot;: { # Queuing parameters for the requested deferred capacity. # Output only. Constraints for the time when the resource(s) start provisioning. Always
2011 # exposed as absolute times.
2012 &quot;validUntilDuration&quot;: { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity.
2013 # as a count of seconds and fractions of seconds at nanosecond
2014 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2015 # or &quot;month&quot;. Range is approximately 10,000 years.
2016 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2017 # Durations less than one second are represented with a 0
2018 # `seconds` field and a positive `nanos` field. Must be from 0
2019 # to 999,999,999 inclusive.
2020 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2021 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2022 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2023 },
2024 &quot;validUntilTime&quot;: &quot;A String&quot;, # Absolute deadline for waiting for capacity inRFC3339
2025 # text format.
2026 },
2027 },
2028 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the resource resides. Only applicable
2029 # for zonal resources. You must specify this field as part of the HTTP
2030 # request URL. It is not settable as a field in the request body.
2031 },
2032 ],
2033 &quot;warning&quot;: { # Informational warning which replaces the list of
2034 # backend services when the list is empty.
2035 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2036 # Engine returns NO_RESULTS_ON_PAGE if there
2037 # are no results in the response.
2038 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2039 # value format. For example:
2040 #
2041 # &quot;data&quot;: [
2042 # {
2043 # &quot;key&quot;: &quot;scope&quot;,
2044 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2045 # }
2046 {
2047 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2048 # returned. For example, for warnings where there are no results in a list
2049 # request for a particular zone, this key might be scope and
2050 # the key value might be the zone name. Other examples might be a key
2051 # indicating a deprecated resource and a suggested replacement, or a
2052 # warning about invalid network settings (for example, if an instance
2053 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2054 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2055 },
2056 ],
2057 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2058 },
2059 },
2060 },
2061 &quot;kind&quot;: &quot;compute#queuedResources&quot;, # Output only. [Output Only] Type of resource. Alwayscompute#queuedResourcesAggregatedList for lists of
2062 # QueuedResource.
2063 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
2064 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
2065 # the query parameter pageToken in the next list request.
2066 # Subsequent list requests will have their own nextPageToken to
2067 # continue paging through the results.
2068 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
2069 &quot;unreachables&quot;: [ # Output only. [Output Only] Unreachable resources.
2070 &quot;A String&quot;,
2071 ],
2072 &quot;warning&quot;: { # [Output Only] Informational warning message.
2073 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2074 # Engine returns NO_RESULTS_ON_PAGE if there
2075 # are no results in the response.
2076 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2077 # value format. For example:
2078 #
2079 # &quot;data&quot;: [
2080 # {
2081 # &quot;key&quot;: &quot;scope&quot;,
2082 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2083 # }
2084 {
2085 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2086 # returned. For example, for warnings where there are no results in a list
2087 # request for a particular zone, this key might be scope and
2088 # the key value might be the zone name. Other examples might be a key
2089 # indicating a deprecated resource and a suggested replacement, or a
2090 # warning about invalid network settings (for example, if an instance
2091 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2092 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2093 },
2094 ],
2095 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2096 },
2097 }</pre>
2098 </div>
2099
2100 <div class="method">
2101 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
2102 <pre>Retrieves the next page of results.
2103
2104 Args:
2105 previous_request: The request for the previous page. (required)
2106 previous_response: The response from the request for the previous page. (required)
2107
2108 Returns:
2109 A request object that you can call &#x27;execute()&#x27; on to request the next
2110 page. Returns None if there are no more items in the collection.
2111 </pre>
2112 </div>
2113
2114 <div class="method">
2115 <code class="details" id="cancel">cancel(project, zone, queuedResource, requestId=None, x__xgafv=None)</code>
2116 <pre>Cancels a QueuedResource. Only a resource in ACCEPTED state may be
2117 cancelled.
2118
2119 Args:
2120 project: string, Project ID for this request. (required)
2121 zone: string, Name of the zone for this request. (required)
2122 queuedResource: string, Name of the QueuedResource to cancel. (required)
2123 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2124 that if you must retry your request, the server will know to ignore the
2125 request if it has already been completed.
2126
2127 For example, consider a situation where you make an initial request and
2128 the request times out. If you make the request again with the same
2129 request ID, the server can check if original operation with the same
2130 request ID was received, and if so, will ignore the second request. This
2131 prevents clients from accidentally creating duplicate commitments.
2132
2133 The request ID must be a valid UUID with
2134 the exception that zero UUID is not supported
2135 (00000000-0000-0000-0000-000000000000).
2136 x__xgafv: string, V1 error format.
2137 Allowed values
2138 1 - v1 error format
2139 2 - v2 error format
2140
2141 Returns:
2142 An object of the form:
2143
2144 { # Represents an Operation resource.
2145 #
2146 # Google Compute Engine has three Operation resources:
2147 #
2148 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
2149 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
2150 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
2151 #
2152 # You can use an operation resource to manage asynchronous API requests.
2153 # For more information, readHandling
2154 # API responses.
2155 #
2156 # Operations can be global, regional or zonal.
2157 #
2158 # - For global operations, use the `globalOperations`
2159 # resource.
2160 # - For regional operations, use the
2161 # `regionOperations` resource.
2162 # - For zonal operations, use
2163 # the `zoneOperations` resource.
2164 #
2165 #
2166 #
2167 # For more information, read
2168 # Global, Regional, and Zonal Resources.
2169 #
2170 # Note that completed Operation resources have a limited
2171 # retention period.
2172 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2173 # Not present otherwise.
2174 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2175 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2176 # set when the operation is created.
2177 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2178 # text format.
2179 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2180 # this field will be populated.
2181 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2182 # operation.
2183 {
2184 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2185 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2186 # details. There is a set of defined message types to use for providing
2187 # details.The syntax depends on the error code. For example,
2188 # QuotaExceededInfo will have details when the error code is
2189 # QUOTA_EXCEEDED.
2190 {
2191 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2192 #
2193 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2194 # is not enabled:
2195 #
2196 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2197 # &quot;domain&quot;: &quot;googleapis.com&quot;
2198 # &quot;metadata&quot;: {
2199 # &quot;resource&quot;: &quot;projects/123&quot;,
2200 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2201 # }
2202 # }
2203 #
2204 # This response indicates that the pubsub.googleapis.com API is not enabled.
2205 #
2206 # Example of an error that is returned when attempting to create a Spanner
2207 # instance in a region that is out of stock:
2208 #
2209 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2210 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2211 # &quot;metadata&quot;: {
2212 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2213 # }
2214 # }
2215 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2216 # is typically the registered service name of the tool or product that
2217 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2218 # generated by some common infrastructure, the error domain must be a
2219 # globally unique value that identifies the infrastructure. For Google API
2220 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2221 &quot;metadatas&quot;: { # Additional structured details about this error.
2222 #
2223 # Keys must match a regular expression of `a-z+` but should
2224 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2225 # length. When identifying the current value of an exceeded limit, the units
2226 # should be contained in the key, not the value. For example, rather than
2227 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2228 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2229 # instances that can be created in a single (batch) request.
2230 &quot;a_key&quot;: &quot;A String&quot;,
2231 },
2232 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2233 # proximate cause of the error. Error reasons are unique within a particular
2234 # domain of errors. This should be at most 63 characters and match a
2235 # regular expression of `A-Z+[A-Z0-9]`, which represents
2236 # UPPER_SNAKE_CASE.
2237 },
2238 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2239 #
2240 # For example, if a quota check failed with an error indicating the calling
2241 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2242 # directly to the right place in the developer console to flip the bit.
2243 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2244 { # Describes a URL link.
2245 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2246 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2247 },
2248 ],
2249 },
2250 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2251 # which can be attached to an RPC error.
2252 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2253 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2254 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2255 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2256 },
2257 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2258 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2259 &quot;a_key&quot;: &quot;A String&quot;,
2260 },
2261 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2262 # type or metric.
2263 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2264 # or metric.
2265 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2266 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2267 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2268 },
2269 },
2270 ],
2271 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2272 # This property is optional.
2273 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2274 },
2275 ],
2276 },
2277 &quot;getVersionOperationMetadata&quot;: {
2278 &quot;inlineSbomInfo&quot;: {
2279 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2280 # appropriate identifiers.
2281 &quot;a_key&quot;: &quot;A String&quot;,
2282 },
2283 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2284 # identifiers.
2285 &quot;a_key&quot;: &quot;A String&quot;,
2286 },
2287 },
2288 },
2289 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2290 # message that was returned, such as `NOT FOUND`.
2291 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2292 # status code that was returned. For example, a `404` means the
2293 # resource was not found.
2294 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2295 # defined by the server.
2296 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2297 # This value is inRFC3339
2298 # text format.
2299 &quot;instancesBulkInsertOperationMetadata&quot;: {
2300 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2301 # Example key: zones/us-central1-a
2302 &quot;a_key&quot;: {
2303 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2304 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2305 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2306 # error.
2307 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2308 # if the flow is rolling forward or rolling back.
2309 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2310 },
2311 },
2312 },
2313 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2314 # Operation resources.
2315 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2316 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2317 # group of operations results from a `bulkInsert` API request.
2318 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2319 # `update`, or `delete`, and so on.
2320 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2321 # There is no requirement that this be linear or support any granularity of
2322 # operations. This should not be used to guess when the operation will be
2323 # complete. This number should monotonically increase as the operation
2324 # progresses.
2325 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2326 # applicable when performing regional operations.
2327 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2328 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
2329 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2330 # this field will contain information on all underlying zonal actions and
2331 # their state.
2332 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2333 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2334 # Example key: zones/us-central1-a
2335 &quot;a_key&quot;: {
2336 &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
2337 # populated.
2338 # different programming environments, including REST APIs and RPC APIs. It is
2339 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2340 # three pieces of data: error code, error message, and error details.
2341 #
2342 # You can find out more about this error model and how to work with it in the
2343 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2344 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2345 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2346 # message types for APIs to use.
2347 {
2348 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2349 },
2350 ],
2351 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2352 # user-facing error message should be localized and sent in the
2353 # google.rpc.Status.details field, or localized by the client.
2354 },
2355 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2356 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2357 },
2358 },
2359 },
2360 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2361 # This value is inRFC3339
2362 # text format.
2363 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2364 # following:
2365 # `PENDING`, `RUNNING`, or `DONE`.
2366 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2367 # operation.
2368 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2369 # of the target resource.
2370 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2371 # operations related to creating a snapshot, this points to the disk
2372 # that the snapshot was created from.
2373 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2374 # `[email protected]` or
2375 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2376 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2377 # operation, this field will be populated.
2378 {
2379 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2380 # Engine returns NO_RESULTS_ON_PAGE if there
2381 # are no results in the response.
2382 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2383 # value format. For example:
2384 #
2385 # &quot;data&quot;: [
2386 # {
2387 # &quot;key&quot;: &quot;scope&quot;,
2388 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2389 # }
2390 {
2391 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2392 # returned. For example, for warnings where there are no results in a list
2393 # request for a particular zone, this key might be scope and
2394 # the key value might be the zone name. Other examples might be a key
2395 # indicating a deprecated resource and a suggested replacement, or a
2396 # warning about invalid network settings (for example, if an instance
2397 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2398 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2399 },
2400 ],
2401 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2402 },
2403 ],
2404 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2405 # applicable when performing per-zone operations.
2406 }</pre>
2407 </div>
2408
2409 <div class="method">
2410 <code class="details" id="close">close()</code>
2411 <pre>Close httplib2 connections.</pre>
2412 </div>
2413
2414 <div class="method">
2415 <code class="details" id="delete">delete(project, zone, queuedResource, requestId=None, x__xgafv=None)</code>
2416 <pre>Deletes a QueuedResource. For a QueuedResource in ACCEPTED state, call
2417 cancel on the resource before deleting, to make sure no VMs have been
2418 provisioned and may require cleaning up. For a QueuedResource in
2419 PROVISIONING state the request to delete is registered for execution
2420 following the provisioning.
2421
2422 Args:
2423 project: string, Project ID for this request. (required)
2424 zone: string, Name of the zone for this request. (required)
2425 queuedResource: string, Name of the QueuedResource to delete. (required)
2426 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2427 that if you must retry your request, the server will know to ignore the
2428 request if it has already been completed.
2429
2430 For example, consider a situation where you make an initial request and
2431 the request times out. If you make the request again with the same
2432 request ID, the server can check if original operation with the same
2433 request ID was received, and if so, will ignore the second request. This
2434 prevents clients from accidentally creating duplicate commitments.
2435
2436 The request ID must be a valid UUID with
2437 the exception that zero UUID is not supported
2438 (00000000-0000-0000-0000-000000000000).
2439 x__xgafv: string, V1 error format.
2440 Allowed values
2441 1 - v1 error format
2442 2 - v2 error format
2443
2444 Returns:
2445 An object of the form:
2446
2447 { # Represents an Operation resource.
2448 #
2449 # Google Compute Engine has three Operation resources:
2450 #
2451 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
2452 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
2453 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
2454 #
2455 # You can use an operation resource to manage asynchronous API requests.
2456 # For more information, readHandling
2457 # API responses.
2458 #
2459 # Operations can be global, regional or zonal.
2460 #
2461 # - For global operations, use the `globalOperations`
2462 # resource.
2463 # - For regional operations, use the
2464 # `regionOperations` resource.
2465 # - For zonal operations, use
2466 # the `zoneOperations` resource.
2467 #
2468 #
2469 #
2470 # For more information, read
2471 # Global, Regional, and Zonal Resources.
2472 #
2473 # Note that completed Operation resources have a limited
2474 # retention period.
2475 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2476 # Not present otherwise.
2477 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2478 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2479 # set when the operation is created.
2480 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2481 # text format.
2482 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2483 # this field will be populated.
2484 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2485 # operation.
2486 {
2487 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2488 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2489 # details. There is a set of defined message types to use for providing
2490 # details.The syntax depends on the error code. For example,
2491 # QuotaExceededInfo will have details when the error code is
2492 # QUOTA_EXCEEDED.
2493 {
2494 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2495 #
2496 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2497 # is not enabled:
2498 #
2499 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2500 # &quot;domain&quot;: &quot;googleapis.com&quot;
2501 # &quot;metadata&quot;: {
2502 # &quot;resource&quot;: &quot;projects/123&quot;,
2503 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2504 # }
2505 # }
2506 #
2507 # This response indicates that the pubsub.googleapis.com API is not enabled.
2508 #
2509 # Example of an error that is returned when attempting to create a Spanner
2510 # instance in a region that is out of stock:
2511 #
2512 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2513 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2514 # &quot;metadata&quot;: {
2515 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2516 # }
2517 # }
2518 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2519 # is typically the registered service name of the tool or product that
2520 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2521 # generated by some common infrastructure, the error domain must be a
2522 # globally unique value that identifies the infrastructure. For Google API
2523 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2524 &quot;metadatas&quot;: { # Additional structured details about this error.
2525 #
2526 # Keys must match a regular expression of `a-z+` but should
2527 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2528 # length. When identifying the current value of an exceeded limit, the units
2529 # should be contained in the key, not the value. For example, rather than
2530 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2531 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2532 # instances that can be created in a single (batch) request.
2533 &quot;a_key&quot;: &quot;A String&quot;,
2534 },
2535 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2536 # proximate cause of the error. Error reasons are unique within a particular
2537 # domain of errors. This should be at most 63 characters and match a
2538 # regular expression of `A-Z+[A-Z0-9]`, which represents
2539 # UPPER_SNAKE_CASE.
2540 },
2541 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2542 #
2543 # For example, if a quota check failed with an error indicating the calling
2544 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2545 # directly to the right place in the developer console to flip the bit.
2546 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2547 { # Describes a URL link.
2548 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2549 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2550 },
2551 ],
2552 },
2553 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2554 # which can be attached to an RPC error.
2555 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2556 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2557 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2558 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2559 },
2560 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2561 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2562 &quot;a_key&quot;: &quot;A String&quot;,
2563 },
2564 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2565 # type or metric.
2566 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2567 # or metric.
2568 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2569 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2570 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2571 },
2572 },
2573 ],
2574 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2575 # This property is optional.
2576 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2577 },
2578 ],
2579 },
2580 &quot;getVersionOperationMetadata&quot;: {
2581 &quot;inlineSbomInfo&quot;: {
2582 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2583 # appropriate identifiers.
2584 &quot;a_key&quot;: &quot;A String&quot;,
2585 },
2586 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2587 # identifiers.
2588 &quot;a_key&quot;: &quot;A String&quot;,
2589 },
2590 },
2591 },
2592 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2593 # message that was returned, such as `NOT FOUND`.
2594 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2595 # status code that was returned. For example, a `404` means the
2596 # resource was not found.
2597 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2598 # defined by the server.
2599 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2600 # This value is inRFC3339
2601 # text format.
2602 &quot;instancesBulkInsertOperationMetadata&quot;: {
2603 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2604 # Example key: zones/us-central1-a
2605 &quot;a_key&quot;: {
2606 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2607 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2608 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2609 # error.
2610 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2611 # if the flow is rolling forward or rolling back.
2612 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2613 },
2614 },
2615 },
2616 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2617 # Operation resources.
2618 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2619 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2620 # group of operations results from a `bulkInsert` API request.
2621 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2622 # `update`, or `delete`, and so on.
2623 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2624 # There is no requirement that this be linear or support any granularity of
2625 # operations. This should not be used to guess when the operation will be
2626 # complete. This number should monotonically increase as the operation
2627 # progresses.
2628 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2629 # applicable when performing regional operations.
2630 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2631 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
2632 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2633 # this field will contain information on all underlying zonal actions and
2634 # their state.
2635 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2636 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2637 # Example key: zones/us-central1-a
2638 &quot;a_key&quot;: {
2639 &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
2640 # populated.
2641 # different programming environments, including REST APIs and RPC APIs. It is
2642 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2643 # three pieces of data: error code, error message, and error details.
2644 #
2645 # You can find out more about this error model and how to work with it in the
2646 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2647 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2648 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2649 # message types for APIs to use.
2650 {
2651 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2652 },
2653 ],
2654 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2655 # user-facing error message should be localized and sent in the
2656 # google.rpc.Status.details field, or localized by the client.
2657 },
2658 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2659 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2660 },
2661 },
2662 },
2663 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2664 # This value is inRFC3339
2665 # text format.
2666 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2667 # following:
2668 # `PENDING`, `RUNNING`, or `DONE`.
2669 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2670 # operation.
2671 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2672 # of the target resource.
2673 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2674 # operations related to creating a snapshot, this points to the disk
2675 # that the snapshot was created from.
2676 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2677 # `[email protected]` or
2678 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2679 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2680 # operation, this field will be populated.
2681 {
2682 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2683 # Engine returns NO_RESULTS_ON_PAGE if there
2684 # are no results in the response.
2685 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2686 # value format. For example:
2687 #
2688 # &quot;data&quot;: [
2689 # {
2690 # &quot;key&quot;: &quot;scope&quot;,
2691 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2692 # }
2693 {
2694 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2695 # returned. For example, for warnings where there are no results in a list
2696 # request for a particular zone, this key might be scope and
2697 # the key value might be the zone name. Other examples might be a key
2698 # indicating a deprecated resource and a suggested replacement, or a
2699 # warning about invalid network settings (for example, if an instance
2700 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2701 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2702 },
2703 ],
2704 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2705 },
2706 ],
2707 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2708 # applicable when performing per-zone operations.
2709 }</pre>
2710 </div>
2711
2712 <div class="method">
2713 <code class="details" id="get">get(project, zone, queuedResource, x__xgafv=None)</code>
2714 <pre>Returns the specified QueuedResource resource.
2715
2716 Args:
2717 project: string, Project ID for this request. (required)
2718 zone: string, Name of the zone for this request. (required)
2719 queuedResource: string, Name of the QueuedResource resource to return. (required)
2720 x__xgafv: string, V1 error format.
2721 Allowed values
2722 1 - v1 error format
2723 2 - v2 error format
2724
2725 Returns:
2726 An object of the form:
2727
2728 { # QueuedResource represents a request for future capacity. The capacity is
2729 # delivered in the form of other GCE resources, either Instances or
2730 # Reservations.
2731 &quot;bulkInsertInstanceResource&quot;: { # A transient resource used in compute.instances.bulkInsert and # Specification of VM instances to create.
2732 # compute.regionInstances.bulkInsert . This resource is not persisted
2733 # anywhere, it is used only for processing the requests.
2734 &quot;count&quot;: &quot;A String&quot;, # The maximum number of instances to create.
2735 &quot;instanceFlexibilityPolicy&quot;: { # A flexible specification of machine types for instances to create. # A flexible specification of machine type of instances to create.
2736 &quot;instanceSelections&quot;: { # Specification of alternative, flexible instance subsets.
2737 # One of them will be selected to create the instances
2738 # based on various criteria, like:
2739 # - ranks,
2740 # - location policy,
2741 # - current capacity,
2742 # - available reservations (you can specify affinity in
2743 # InstanceProperties),
2744 # - SWAN/GOOSE limitations.
2745 # Key is an arbitrary, unique RFC1035 string that identifies the instance
2746 # selection.
2747 &quot;a_key&quot;: { # Specification of machine type to use. Every position inside this message
2748 # is an alternative.
2749 # The count specified in the shape flexibility must not exceed the number
2750 # of entries in per_instance_properties or the capacity of the
2751 # name_pattern, if used.
2752 &quot;disks&quot;: [ # Disks to be attached to the instances created from in this selection.
2753 # They override the disks specified in the instance properties.
2754 { # An instance-attached disk resource.
2755 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
2756 # or X86_64.
2757 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
2758 # deleted (but not when the disk is detached from the instance).
2759 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
2760 # partition of the disk for its root filesystem.
2761 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
2762 # running within the instance. This name can be used to reference the device
2763 # for mounting, resizing, and so on, from within the instance.
2764 #
2765 # If not specified, the server chooses a default device name to apply to this
2766 # disk, in the form persistent-disk-x, where x is a number
2767 # assigned by Google Compute Engine. This field is only applicable for
2768 # persistent disks.
2769 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
2770 # encryption key.
2771 #
2772 # If you are creating a new disk, this field encrypts the new disk using
2773 # an encryption key that you provide. If you are attaching an existing
2774 # disk that is already encrypted, this field decrypts the disk using
2775 # the customer-supplied encryption key.
2776 #
2777 # If you encrypt a disk using a customer-supplied key, you must provide the
2778 # same key again when you attempt to use this resource at a later time. For
2779 # example, you must provide the key when you create a snapshot or an image
2780 # from the disk or when you attach the disk to a virtual machine instance.
2781 #
2782 # If you do not provide an encryption key, then the disk will be encrypted
2783 # using an automatically generated key and you do not need to provide a key
2784 # to use the disk later.
2785 #
2786 # Note:
2787 #
2788 # Instance templates do not storecustomer-supplied
2789 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
2790 #
2791 # You cannot create VMs that have disks with customer-supplied keys using
2792 # the bulk
2793 # insert method.
2794 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2795 # For example:
2796 #
2797 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2798 # key_region/cryptoKeys/key
2799 #
2800 # The fully-qualifed key name may be returned for resource GET requests. For
2801 # example:
2802 #
2803 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2804 # key_region/cryptoKeys/key
2805 # /cryptoKeyVersions/1
2806 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2807 # key. If absent, the Compute Engine default service account is used.
2808 # For example:
2809 #
2810 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2811 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2812 # encryption key, encoded in RFC
2813 # 4648 base64 to either encrypt or decrypt this resource. You can
2814 # provide either the rawKey or thersaEncryptedKey.
2815 # For example:
2816 #
2817 # &quot;rawKey&quot;:
2818 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2819 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2820 # customer-supplied encryption key to either encrypt or decrypt this
2821 # resource. You can provide either the rawKey or thersaEncryptedKey.
2822 # For example:
2823 #
2824 # &quot;rsaEncryptedKey&quot;:
2825 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2826 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2827 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2828 #
2829 # The key must meet the following requirements before you can provide it to
2830 # Compute Engine:
2831 #
2832 # 1. The key is wrapped using a RSA public key certificate provided by
2833 # Google.
2834 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2835 # encoding.
2836 #
2837 # Gets the RSA public key certificate provided by Google at:
2838 #
2839 #
2840 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2841 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2842 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2843 # encryption key that protects this resource.
2844 },
2845 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
2846 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
2847 # currently attached to another instance. If you try to force attach a zonal
2848 # disk to an instance, you will receive an error.
2849 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2850 # only for bootable images. Read
2851 # Enabling guest operating system features to see a list of available
2852 # options.
2853 { # Guest OS features.
2854 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2855 # separate values. Set to one or more of the following values:
2856 #
2857 # - VIRTIO_SCSI_MULTIQUEUE
2858 # - WINDOWS
2859 # - MULTI_IP_SUBNET
2860 # - UEFI_COMPATIBLE
2861 # - GVNIC
2862 # - SEV_CAPABLE
2863 # - SUSPEND_RESUME_COMPATIBLE
2864 # - SEV_LIVE_MIGRATABLE_V2
2865 # - SEV_SNP_CAPABLE
2866 # - TDX_CAPABLE
2867 # - IDPF
2868 # - SNP_SVSM_CAPABLE
2869 # - CCA_CAPABLE
2870 #
2871 #
2872 # For more information, see
2873 # Enabling guest operating system features.
2874 },
2875 ],
2876 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
2877 # boot disk. If you have many disks attached to an instance, each
2878 # disk would have a unique index number.
2879 &quot;initializeParams&quot;: { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
2880 # alongside the new instance. Use initialization parameters to create boot
2881 # disks or local SSDs attached to the new instance.
2882 #
2883 # This property is mutually exclusive with the source property;
2884 # you can only define one or the other, but not both.
2885 # alongside the new instance. Use initialization parameters to create boot
2886 # disks or local SSDs attached to the new instance.
2887 #
2888 # This field is persisted and returned for instanceTemplate and not returned
2889 # in the context of instance.
2890 #
2891 # This property is mutually exclusive with the source property;
2892 # you can only define one or the other, but not both.
2893 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
2894 # arm64 or x86_64.
2895 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
2896 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
2897 # of the instance. If a disk with the same name already exists in the given
2898 # region, the existing disk is attached to the new instance and the
2899 # new disk is not created.
2900 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
2901 # 10 GB. If you specify a sourceImage, which is required for
2902 # boot disks, the default size is the size of the sourceImage.
2903 # If you do not specify a sourceImage, the default disk size
2904 # is 500 GB.
2905 &quot;diskType&quot;: &quot;A String&quot;,
2906 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
2907 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2908 # only for bootable images. Read
2909 # Enabling guest operating system features to see a list of available
2910 # options.
2911 #
2912 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
2913 { # Guest OS features.
2914 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2915 # separate values. Set to one or more of the following values:
2916 #
2917 # - VIRTIO_SCSI_MULTIQUEUE
2918 # - WINDOWS
2919 # - MULTI_IP_SUBNET
2920 # - UEFI_COMPATIBLE
2921 # - GVNIC
2922 # - SEV_CAPABLE
2923 # - SUSPEND_RESUME_COMPATIBLE
2924 # - SEV_LIVE_MIGRATABLE_V2
2925 # - SEV_SNP_CAPABLE
2926 # - TDX_CAPABLE
2927 # - IDPF
2928 # - SNP_SVSM_CAPABLE
2929 # - CCA_CAPABLE
2930 #
2931 #
2932 # For more information, see
2933 # Enabling guest operating system features.
2934 },
2935 ],
2936 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
2937 # which is either SCSI or NVME. The default isSCSI.
2938 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
2939 # persistent disks.
2940 &quot;a_key&quot;: &quot;A String&quot;,
2941 },
2942 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
2943 # disk.
2944 &quot;A String&quot;,
2945 ],
2946 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
2947 &quot;A String&quot;,
2948 ],
2949 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
2950 # more than one instance.
2951 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
2952 # is to use the existing disk.
2953 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
2954 # of I/O operations per second that the disk can handle. Values must be
2955 # between 10,000 and 120,000. For more details, see theExtreme persistent
2956 # disk documentation.
2957 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
2958 # number of throughput mb per second that the disk can handle. Values must
2959 # greater than or equal to 1.
2960 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
2961 # the URLs of the zones where the disk should be replicated to.
2962 # You must provide exactly two replica zones, and one zone must be the same
2963 # as the instance zone.
2964 &quot;A String&quot;,
2965 ],
2966 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
2967 # have the same definition as resource
2968 # manager tags. Keys and values can be either in numeric format,
2969 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
2970 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
2971 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
2972 # empty.
2973 &quot;a_key&quot;: &quot;A String&quot;,
2974 },
2975 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
2976 # Specified using the full or partial URL. For instance template, specify
2977 # only the resource policy name.
2978 &quot;A String&quot;,
2979 ],
2980 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
2981 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
2982 # is required.
2983 #
2984 # To create a disk with one of the public operating system
2985 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
2986 #
2987 # projects/debian-cloud/global/images/family/debian-9
2988 #
2989 #
2990 # Alternatively, use a specific version of a public operating system image:
2991 #
2992 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
2993 #
2994 #
2995 # To create a disk with a custom image that you created, specify the
2996 # image name in the following format:
2997 #
2998 # global/images/my-custom-image
2999 #
3000 #
3001 # You can also specify a custom image by its image family, which returns
3002 # the latest version of the image in that family. Replace the image name
3003 # with family/family-name:
3004 #
3005 # global/images/family/my-image-family
3006 #
3007 #
3008 # If the source image is deleted later, this field will not be set.
3009 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
3010 # encryption key of the source image. Required if the source image is
3011 # protected by a customer-supplied encryption key.
3012 #
3013 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
3014 # encryption keys, so you cannot create disks for instances in a managed instance group if the
3015 # source images are encrypted with your own keys.
3016 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3017 # For example:
3018 #
3019 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3020 # key_region/cryptoKeys/key
3021 #
3022 # The fully-qualifed key name may be returned for resource GET requests. For
3023 # example:
3024 #
3025 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3026 # key_region/cryptoKeys/key
3027 # /cryptoKeyVersions/1
3028 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3029 # key. If absent, the Compute Engine default service account is used.
3030 # For example:
3031 #
3032 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3033 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3034 # encryption key, encoded in RFC
3035 # 4648 base64 to either encrypt or decrypt this resource. You can
3036 # provide either the rawKey or thersaEncryptedKey.
3037 # For example:
3038 #
3039 # &quot;rawKey&quot;:
3040 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3041 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3042 # customer-supplied encryption key to either encrypt or decrypt this
3043 # resource. You can provide either the rawKey or thersaEncryptedKey.
3044 # For example:
3045 #
3046 # &quot;rsaEncryptedKey&quot;:
3047 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3048 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3049 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3050 #
3051 # The key must meet the following requirements before you can provide it to
3052 # Compute Engine:
3053 #
3054 # 1. The key is wrapped using a RSA public key certificate provided by
3055 # Google.
3056 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3057 # encoding.
3058 #
3059 # Gets the RSA public key certificate provided by Google at:
3060 #
3061 #
3062 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3063 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3064 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3065 # encryption key that protects this resource.
3066 },
3067 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
3068 # instance boot disk, one of initializeParams.sourceSnapshot
3069 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
3070 # is required.
3071 #
3072 # To create a disk with a snapshot that you created, specify the
3073 # snapshot name in the following format:
3074 #
3075 # us-central1-a/instantSnapshots/my-backup
3076 #
3077 #
3078 # If the source instant-snapshot is deleted later, this field will not be
3079 # set.
3080 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
3081 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
3082 # is required.
3083 #
3084 # To create a disk with a snapshot that you created, specify the
3085 # snapshot name in the following format:
3086 #
3087 # global/snapshots/my-backup
3088 #
3089 #
3090 # If the source snapshot is deleted later, this field will not be set.
3091 #
3092 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
3093 # an image instead when you create VMs using
3094 # the bulk
3095 # insert method.
3096 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3097 # encryption key of the source snapshot.
3098 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3099 # For example:
3100 #
3101 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3102 # key_region/cryptoKeys/key
3103 #
3104 # The fully-qualifed key name may be returned for resource GET requests. For
3105 # example:
3106 #
3107 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3108 # key_region/cryptoKeys/key
3109 # /cryptoKeyVersions/1
3110 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3111 # key. If absent, the Compute Engine default service account is used.
3112 # For example:
3113 #
3114 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3115 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3116 # encryption key, encoded in RFC
3117 # 4648 base64 to either encrypt or decrypt this resource. You can
3118 # provide either the rawKey or thersaEncryptedKey.
3119 # For example:
3120 #
3121 # &quot;rawKey&quot;:
3122 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3123 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3124 # customer-supplied encryption key to either encrypt or decrypt this
3125 # resource. You can provide either the rawKey or thersaEncryptedKey.
3126 # For example:
3127 #
3128 # &quot;rsaEncryptedKey&quot;:
3129 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3130 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3131 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3132 #
3133 # The key must meet the following requirements before you can provide it to
3134 # Compute Engine:
3135 #
3136 # 1. The key is wrapped using a RSA public key certificate provided by
3137 # Google.
3138 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3139 # encoding.
3140 #
3141 # Gets the RSA public key certificate provided by Google at:
3142 #
3143 #
3144 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3145 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3146 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3147 # encryption key that protects this resource.
3148 },
3149 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3150 # this as a partial or full URL to the resource. For example, the following
3151 # are valid values:
3152 #
3153 #
3154 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3155 # - projects/project/zones/zone/storagePools/storagePool
3156 # - zones/zone/storagePools/storagePool
3157 },
3158 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
3159 # either SCSI or NVME. For most machine types, the
3160 # default is SCSI. Local SSDs can use either NVME or SCSI.
3161 # In certain configurations, persistent disks can use NVMe. For more
3162 # information, seeAbout
3163 # persistent disks.
3164 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
3165 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
3166 &quot;A String&quot;,
3167 ],
3168 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
3169 # disk is not allowed to be detached from the instance, or to be used as the
3170 # source of the snapshot creation, and the image creation. The instance with
3171 # at least one locked attached disk is not allow to be used as source of
3172 # machine image creation, instant snapshot creation, and not allowed to be
3173 # deleted with --keep-disk parameter set to true for locked disks.
3174 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
3175 # in READ_WRITE mode.
3176 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
3177 # field is set to PRESERVED if the LocalSSD data has been saved
3178 # to a persistent location by customer request. (see the
3179 # discard_local_ssd option on Stop/Suspend).
3180 # Read-only in the api.
3181 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
3182 # these are public keys which are safe to store in public
3183 &quot;dbs&quot;: [ # The Key Database (db).
3184 {
3185 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3186 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3187 },
3188 ],
3189 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
3190 {
3191 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3192 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3193 },
3194 ],
3195 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
3196 {
3197 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3198 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3199 },
3200 ],
3201 &quot;pk&quot;: { # The Platform Key (PK).
3202 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3203 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3204 },
3205 },
3206 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
3207 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3208 # is required.
3209 #
3210 # If desired, you can also attach existing non-root persistent disks using
3211 # this property. This field is only applicable for persistent disks.
3212 #
3213 # Note that for InstanceTemplate, specify the disk name for zonal disk,
3214 # and the URL for regional disk.
3215 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
3216 },
3217 ],
3218 &quot;machineTypes&quot;: [ # Alternative machine types to use for instances that are created from
3219 # these properties. This field only accepts a machine type names, for
3220 # example `n2-standard-4` and not URLs or partial URLs.
3221 &quot;A String&quot;,
3222 ],
3223 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
3224 # e.g. &#x27;Intel Ice Lake&#x27;.
3225 &quot;rank&quot;: &quot;A String&quot;, # Rank when prioritizing the shape flexibilities.
3226 # The instance selections with rank are considered
3227 # first, in the ascending order of the rank.
3228 # If not set, defaults to 0.
3229 },
3230 },
3231 },
3232 &quot;instanceProperties&quot;: { # The instance properties defining the VM instances to be created. Required
3233 # if sourceInstanceTemplate is not provided.
3234 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
3235 # Note that for MachineImage, this is not supported yet.
3236 # Options that would traditionally be configured in a BIOS belong
3237 # here. Features that require operating system support may have
3238 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
3239 # disabled).
3240 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
3241 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
3242 &quot;enableWatchdogTimer&quot;: True or False, # Whether to enable the watchdog timer.
3243 &quot;numaNodeCount&quot;: 42, # The number of vNUMA nodes.
3244 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
3245 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
3246 # multithreading (SMT) set this to 1. If unset, the maximum number
3247 # of threads supported per core by the underlying processor is
3248 # assumed.
3249 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
3250 # Supported modes include:
3251 # * ALL_CORE_MAX
3252 #
3253 # Using empty string or not setting this field will use the platform-specific
3254 # default turbo mode.
3255 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
3256 # the number of threads per core to compute the total number of virtual
3257 # CPUs to expose to the instance. If unset, the number of cores is
3258 # inferred from the instance&#x27;s nominal CPU count and the underlying
3259 # platform&#x27;s SMT width.
3260 },
3261 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
3262 # source IP addresses other than their own and receive packets with
3263 # destination IP addresses other than their own. If these instances will be
3264 # used as an IP gateway or it will be set as the next-hop in a Route
3265 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
3266 # documentation for more information.
3267 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
3268 # Note that for MachineImage, this is not supported yet.
3269 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
3270 &quot;confidentialParavisorConfig&quot;: { # A set of Confidential Paravisor (SVSM) options. # Defines a set of Confidential Paravisor (SVSM) options.
3271 &quot;confidentialTpmType&quot;: &quot;A String&quot;,
3272 &quot;sevSnpIrqMode&quot;: &quot;A String&quot;,
3273 },
3274 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
3275 },
3276 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
3277 # properties.
3278 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
3279 # from these properties.
3280 { # An instance-attached disk resource.
3281 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
3282 # or X86_64.
3283 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
3284 # deleted (but not when the disk is detached from the instance).
3285 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
3286 # partition of the disk for its root filesystem.
3287 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
3288 # running within the instance. This name can be used to reference the device
3289 # for mounting, resizing, and so on, from within the instance.
3290 #
3291 # If not specified, the server chooses a default device name to apply to this
3292 # disk, in the form persistent-disk-x, where x is a number
3293 # assigned by Google Compute Engine. This field is only applicable for
3294 # persistent disks.
3295 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
3296 # encryption key.
3297 #
3298 # If you are creating a new disk, this field encrypts the new disk using
3299 # an encryption key that you provide. If you are attaching an existing
3300 # disk that is already encrypted, this field decrypts the disk using
3301 # the customer-supplied encryption key.
3302 #
3303 # If you encrypt a disk using a customer-supplied key, you must provide the
3304 # same key again when you attempt to use this resource at a later time. For
3305 # example, you must provide the key when you create a snapshot or an image
3306 # from the disk or when you attach the disk to a virtual machine instance.
3307 #
3308 # If you do not provide an encryption key, then the disk will be encrypted
3309 # using an automatically generated key and you do not need to provide a key
3310 # to use the disk later.
3311 #
3312 # Note:
3313 #
3314 # Instance templates do not storecustomer-supplied
3315 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
3316 #
3317 # You cannot create VMs that have disks with customer-supplied keys using
3318 # the bulk
3319 # insert method.
3320 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3321 # For example:
3322 #
3323 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3324 # key_region/cryptoKeys/key
3325 #
3326 # The fully-qualifed key name may be returned for resource GET requests. For
3327 # example:
3328 #
3329 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3330 # key_region/cryptoKeys/key
3331 # /cryptoKeyVersions/1
3332 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3333 # key. If absent, the Compute Engine default service account is used.
3334 # For example:
3335 #
3336 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3337 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3338 # encryption key, encoded in RFC
3339 # 4648 base64 to either encrypt or decrypt this resource. You can
3340 # provide either the rawKey or thersaEncryptedKey.
3341 # For example:
3342 #
3343 # &quot;rawKey&quot;:
3344 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3345 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3346 # customer-supplied encryption key to either encrypt or decrypt this
3347 # resource. You can provide either the rawKey or thersaEncryptedKey.
3348 # For example:
3349 #
3350 # &quot;rsaEncryptedKey&quot;:
3351 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3352 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3353 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3354 #
3355 # The key must meet the following requirements before you can provide it to
3356 # Compute Engine:
3357 #
3358 # 1. The key is wrapped using a RSA public key certificate provided by
3359 # Google.
3360 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3361 # encoding.
3362 #
3363 # Gets the RSA public key certificate provided by Google at:
3364 #
3365 #
3366 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3367 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3368 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3369 # encryption key that protects this resource.
3370 },
3371 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
3372 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
3373 # currently attached to another instance. If you try to force attach a zonal
3374 # disk to an instance, you will receive an error.
3375 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
3376 # only for bootable images. Read
3377 # Enabling guest operating system features to see a list of available
3378 # options.
3379 { # Guest OS features.
3380 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
3381 # separate values. Set to one or more of the following values:
3382 #
3383 # - VIRTIO_SCSI_MULTIQUEUE
3384 # - WINDOWS
3385 # - MULTI_IP_SUBNET
3386 # - UEFI_COMPATIBLE
3387 # - GVNIC
3388 # - SEV_CAPABLE
3389 # - SUSPEND_RESUME_COMPATIBLE
3390 # - SEV_LIVE_MIGRATABLE_V2
3391 # - SEV_SNP_CAPABLE
3392 # - TDX_CAPABLE
3393 # - IDPF
3394 # - SNP_SVSM_CAPABLE
3395 # - CCA_CAPABLE
3396 #
3397 #
3398 # For more information, see
3399 # Enabling guest operating system features.
3400 },
3401 ],
3402 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
3403 # boot disk. If you have many disks attached to an instance, each
3404 # disk would have a unique index number.
3405 &quot;initializeParams&quot;: { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
3406 # alongside the new instance. Use initialization parameters to create boot
3407 # disks or local SSDs attached to the new instance.
3408 #
3409 # This property is mutually exclusive with the source property;
3410 # you can only define one or the other, but not both.
3411 # alongside the new instance. Use initialization parameters to create boot
3412 # disks or local SSDs attached to the new instance.
3413 #
3414 # This field is persisted and returned for instanceTemplate and not returned
3415 # in the context of instance.
3416 #
3417 # This property is mutually exclusive with the source property;
3418 # you can only define one or the other, but not both.
3419 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
3420 # arm64 or x86_64.
3421 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
3422 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
3423 # of the instance. If a disk with the same name already exists in the given
3424 # region, the existing disk is attached to the new instance and the
3425 # new disk is not created.
3426 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
3427 # 10 GB. If you specify a sourceImage, which is required for
3428 # boot disks, the default size is the size of the sourceImage.
3429 # If you do not specify a sourceImage, the default disk size
3430 # is 500 GB.
3431 &quot;diskType&quot;: &quot;A String&quot;,
3432 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
3433 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
3434 # only for bootable images. Read
3435 # Enabling guest operating system features to see a list of available
3436 # options.
3437 #
3438 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
3439 { # Guest OS features.
3440 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
3441 # separate values. Set to one or more of the following values:
3442 #
3443 # - VIRTIO_SCSI_MULTIQUEUE
3444 # - WINDOWS
3445 # - MULTI_IP_SUBNET
3446 # - UEFI_COMPATIBLE
3447 # - GVNIC
3448 # - SEV_CAPABLE
3449 # - SUSPEND_RESUME_COMPATIBLE
3450 # - SEV_LIVE_MIGRATABLE_V2
3451 # - SEV_SNP_CAPABLE
3452 # - TDX_CAPABLE
3453 # - IDPF
3454 # - SNP_SVSM_CAPABLE
3455 # - CCA_CAPABLE
3456 #
3457 #
3458 # For more information, see
3459 # Enabling guest operating system features.
3460 },
3461 ],
3462 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
3463 # which is either SCSI or NVME. The default isSCSI.
3464 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
3465 # persistent disks.
3466 &quot;a_key&quot;: &quot;A String&quot;,
3467 },
3468 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
3469 # disk.
3470 &quot;A String&quot;,
3471 ],
3472 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
3473 &quot;A String&quot;,
3474 ],
3475 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
3476 # more than one instance.
3477 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
3478 # is to use the existing disk.
3479 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
3480 # of I/O operations per second that the disk can handle. Values must be
3481 # between 10,000 and 120,000. For more details, see theExtreme persistent
3482 # disk documentation.
3483 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
3484 # number of throughput mb per second that the disk can handle. Values must
3485 # greater than or equal to 1.
3486 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
3487 # the URLs of the zones where the disk should be replicated to.
3488 # You must provide exactly two replica zones, and one zone must be the same
3489 # as the instance zone.
3490 &quot;A String&quot;,
3491 ],
3492 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
3493 # have the same definition as resource
3494 # manager tags. Keys and values can be either in numeric format,
3495 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3496 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3497 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
3498 # empty.
3499 &quot;a_key&quot;: &quot;A String&quot;,
3500 },
3501 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
3502 # Specified using the full or partial URL. For instance template, specify
3503 # only the resource policy name.
3504 &quot;A String&quot;,
3505 ],
3506 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
3507 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3508 # is required.
3509 #
3510 # To create a disk with one of the public operating system
3511 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
3512 #
3513 # projects/debian-cloud/global/images/family/debian-9
3514 #
3515 #
3516 # Alternatively, use a specific version of a public operating system image:
3517 #
3518 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
3519 #
3520 #
3521 # To create a disk with a custom image that you created, specify the
3522 # image name in the following format:
3523 #
3524 # global/images/my-custom-image
3525 #
3526 #
3527 # You can also specify a custom image by its image family, which returns
3528 # the latest version of the image in that family. Replace the image name
3529 # with family/family-name:
3530 #
3531 # global/images/family/my-image-family
3532 #
3533 #
3534 # If the source image is deleted later, this field will not be set.
3535 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
3536 # encryption key of the source image. Required if the source image is
3537 # protected by a customer-supplied encryption key.
3538 #
3539 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
3540 # encryption keys, so you cannot create disks for instances in a managed instance group if the
3541 # source images are encrypted with your own keys.
3542 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3543 # For example:
3544 #
3545 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3546 # key_region/cryptoKeys/key
3547 #
3548 # The fully-qualifed key name may be returned for resource GET requests. For
3549 # example:
3550 #
3551 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3552 # key_region/cryptoKeys/key
3553 # /cryptoKeyVersions/1
3554 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3555 # key. If absent, the Compute Engine default service account is used.
3556 # For example:
3557 #
3558 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3559 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3560 # encryption key, encoded in RFC
3561 # 4648 base64 to either encrypt or decrypt this resource. You can
3562 # provide either the rawKey or thersaEncryptedKey.
3563 # For example:
3564 #
3565 # &quot;rawKey&quot;:
3566 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3567 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3568 # customer-supplied encryption key to either encrypt or decrypt this
3569 # resource. You can provide either the rawKey or thersaEncryptedKey.
3570 # For example:
3571 #
3572 # &quot;rsaEncryptedKey&quot;:
3573 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3574 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3575 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3576 #
3577 # The key must meet the following requirements before you can provide it to
3578 # Compute Engine:
3579 #
3580 # 1. The key is wrapped using a RSA public key certificate provided by
3581 # Google.
3582 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3583 # encoding.
3584 #
3585 # Gets the RSA public key certificate provided by Google at:
3586 #
3587 #
3588 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3589 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3590 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3591 # encryption key that protects this resource.
3592 },
3593 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
3594 # instance boot disk, one of initializeParams.sourceSnapshot
3595 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
3596 # is required.
3597 #
3598 # To create a disk with a snapshot that you created, specify the
3599 # snapshot name in the following format:
3600 #
3601 # us-central1-a/instantSnapshots/my-backup
3602 #
3603 #
3604 # If the source instant-snapshot is deleted later, this field will not be
3605 # set.
3606 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
3607 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
3608 # is required.
3609 #
3610 # To create a disk with a snapshot that you created, specify the
3611 # snapshot name in the following format:
3612 #
3613 # global/snapshots/my-backup
3614 #
3615 #
3616 # If the source snapshot is deleted later, this field will not be set.
3617 #
3618 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
3619 # an image instead when you create VMs using
3620 # the bulk
3621 # insert method.
3622 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3623 # encryption key of the source snapshot.
3624 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3625 # For example:
3626 #
3627 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3628 # key_region/cryptoKeys/key
3629 #
3630 # The fully-qualifed key name may be returned for resource GET requests. For
3631 # example:
3632 #
3633 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3634 # key_region/cryptoKeys/key
3635 # /cryptoKeyVersions/1
3636 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3637 # key. If absent, the Compute Engine default service account is used.
3638 # For example:
3639 #
3640 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3641 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3642 # encryption key, encoded in RFC
3643 # 4648 base64 to either encrypt or decrypt this resource. You can
3644 # provide either the rawKey or thersaEncryptedKey.
3645 # For example:
3646 #
3647 # &quot;rawKey&quot;:
3648 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3649 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3650 # customer-supplied encryption key to either encrypt or decrypt this
3651 # resource. You can provide either the rawKey or thersaEncryptedKey.
3652 # For example:
3653 #
3654 # &quot;rsaEncryptedKey&quot;:
3655 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3656 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3657 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3658 #
3659 # The key must meet the following requirements before you can provide it to
3660 # Compute Engine:
3661 #
3662 # 1. The key is wrapped using a RSA public key certificate provided by
3663 # Google.
3664 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3665 # encoding.
3666 #
3667 # Gets the RSA public key certificate provided by Google at:
3668 #
3669 #
3670 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3671 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3672 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3673 # encryption key that protects this resource.
3674 },
3675 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3676 # this as a partial or full URL to the resource. For example, the following
3677 # are valid values:
3678 #
3679 #
3680 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3681 # - projects/project/zones/zone/storagePools/storagePool
3682 # - zones/zone/storagePools/storagePool
3683 },
3684 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
3685 # either SCSI or NVME. For most machine types, the
3686 # default is SCSI. Local SSDs can use either NVME or SCSI.
3687 # In certain configurations, persistent disks can use NVMe. For more
3688 # information, seeAbout
3689 # persistent disks.
3690 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
3691 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
3692 &quot;A String&quot;,
3693 ],
3694 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
3695 # disk is not allowed to be detached from the instance, or to be used as the
3696 # source of the snapshot creation, and the image creation. The instance with
3697 # at least one locked attached disk is not allow to be used as source of
3698 # machine image creation, instant snapshot creation, and not allowed to be
3699 # deleted with --keep-disk parameter set to true for locked disks.
3700 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
3701 # in READ_WRITE mode.
3702 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
3703 # field is set to PRESERVED if the LocalSSD data has been saved
3704 # to a persistent location by customer request. (see the
3705 # discard_local_ssd option on Stop/Suspend).
3706 # Read-only in the api.
3707 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
3708 # these are public keys which are safe to store in public
3709 &quot;dbs&quot;: [ # The Key Database (db).
3710 {
3711 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3712 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3713 },
3714 ],
3715 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
3716 {
3717 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3718 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3719 },
3720 ],
3721 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
3722 {
3723 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3724 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3725 },
3726 ],
3727 &quot;pk&quot;: { # The Platform Key (PK).
3728 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3729 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3730 },
3731 },
3732 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
3733 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3734 # is required.
3735 #
3736 # If desired, you can also attach existing non-root persistent disks using
3737 # this property. This field is only applicable for persistent disks.
3738 #
3739 # Note that for InstanceTemplate, specify the disk name for zonal disk,
3740 # and the URL for regional disk.
3741 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
3742 },
3743 ],
3744 &quot;displayDevice&quot;: { # A set of Display Device options # Display Device properties to enable support
3745 # for remote display products like: Teradici,
3746 # VNC and TeamViewer
3747 # Note that for MachineImage, this is not supported yet.
3748 &quot;enableDisplay&quot;: True or False, # Defines whether the instance has Display enabled.
3749 },
3750 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
3751 # created from these properties.
3752 { # A specification of the type and number of accelerator cards attached to the
3753 # instance.
3754 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
3755 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
3756 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
3757 # If you are creating an instance template, specify only the
3758 # accelerator name.
3759 # See GPUs on Compute Engine
3760 # for a full list of accelerator types.
3761 },
3762 ],
3763 &quot;identity&quot;: &quot;A String&quot;,
3764 &quot;identityCertificate&quot;: True or False,
3765 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
3766 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
3767 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
3768 &quot;a_key&quot;: &quot;A String&quot;,
3769 },
3770 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
3771 # properties.
3772 # This field only accepts a machine type name, for example `n2-standard-4`.
3773 # If you use the machine type full or partial URL, for example
3774 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
3775 # the request will result in an `INTERNAL_ERROR`.
3776 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
3777 # these properties. These pairs can consist of custom metadata or predefined
3778 # keys. SeeProject and
3779 # instance metadata for more information.
3780 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
3781 # the metadata&#x27;s contents and used for optimistic locking. The
3782 # fingerprint is initially generated by Compute Engine and changes after
3783 # every request to modify or update metadata. You must always provide an
3784 # up-to-date fingerprint hash in order to update or change metadata,
3785 # otherwise the request will fail with error412 conditionNotMet.
3786 #
3787 # To see the latest fingerprint, make a get() request to
3788 # retrieve the resource.
3789 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
3790 # less than 512 KB.
3791 { # Metadata
3792 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
3793 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
3794 # This is reflected as part of a URL in the metadata server. Additionally, to
3795 # avoid ambiguity, keys must not conflict with any other metadata keys
3796 # for the project.
3797 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
3798 # have meaning as interpreted by the image running in the instance. The
3799 # only restriction placed on values is that their size must be less than
3800 # or equal to 262144 bytes (256 KiB).
3801 },
3802 ],
3803 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
3804 # for metadata.
3805 },
3806 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
3807 # scheduled on the specified or newer cpu/platform. Applicable values are the
3808 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
3809 # information, read Specifying a
3810 # Minimum CPU Platform.
3811 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
3812 { # A network interface resource attached to an instance.
3813 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
3814 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
3815 # no external internet access.
3816 { # An access configuration attached to an instance&#x27;s network interface.
3817 # Only one access config per instance is supported.
3818 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
3819 # The first IPv6 address of the external IPv6 range associated
3820 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
3821 # use a static external IP address, it must be unused and in the same region
3822 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3823 # assign an external IPv6 address from the instance&#x27;s subnetwork.
3824 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
3825 # external IPv6 range.
3826 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
3827 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
3828 # (IPv4), the default and recommended name is External NAT, but
3829 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
3830 # recommend name is External IPv6.
3831 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
3832 # address associated with this instance. Specify an unused static
3833 # external IP address available to the project or leave this field undefined
3834 # to use an IP from a shared ephemeral IP address pool. If you specify a
3835 # static external IP address, it must live in the same region as the zone of
3836 # the instance.
3837 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
3838 # configuration and can only take the following values: PREMIUM,STANDARD.
3839 #
3840 # If an AccessConfig is specified without a valid external IP address, an
3841 # ephemeral IP will be created with this networkTier.
3842 #
3843 # If an AccessConfig with a valid external IP address is specified, it must
3844 # match that of the networkTier associated with the Address resource owning
3845 # that IP.
3846 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
3847 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
3848 #
3849 # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
3850 # first IP in associated external IPv6 range.
3851 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
3852 # config.
3853 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
3854 # external IP address of this access configuration.
3855 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
3856 # external IP address of the instance to a DNS domain name.
3857 #
3858 # This field is not used in ipv6AccessConfig. A default PTR
3859 # record will be created if the VM has external IPv6 range associated.
3860 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
3861 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
3862 },
3863 ],
3864 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
3865 # You can only specify this field for network interfaces in VPC networks.
3866 { # An alias IP range attached to an instance&#x27;s network interface.
3867 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
3868 # must belong to the specified subnetwork and cannot contain IP addresses
3869 # reserved by system or used by other network interfaces. This range may be
3870 # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
3871 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
3872 # alias range. If not specified, the primary range of the subnetwork is used.
3873 },
3874 ],
3875 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
3876 # You can only specify this field for network interfaces in VPC networks.
3877 { # An alias IP range attached to an instance&#x27;s network interface.
3878 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
3879 # must belong to the specified subnetwork and cannot contain IP addresses
3880 # reserved by system or used by other network interfaces. This range may be
3881 # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
3882 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
3883 # alias range. If not specified, the primary range of the subnetwork is used.
3884 },
3885 ],
3886 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
3887 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
3888 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
3889 # with network_attachment.
3890 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
3891 # This field will be ignored when inserting an Instance or
3892 # adding a NetworkInterface. An up-to-date
3893 # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
3894 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
3895 # or not. If enabled, also indicates the version of IGMP supported.
3896 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
3897 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
3898 # one IPv6 access config, DIRECT_IPV6, is supported. If there
3899 # is no ipv6AccessConfig specified, then this instance will
3900 # have no external IPv6 Internet access.
3901 { # An access configuration attached to an instance&#x27;s network interface.
3902 # Only one access config per instance is supported.
3903 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
3904 # The first IPv6 address of the external IPv6 range associated
3905 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
3906 # use a static external IP address, it must be unused and in the same region
3907 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3908 # assign an external IPv6 address from the instance&#x27;s subnetwork.
3909 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
3910 # external IPv6 range.
3911 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
3912 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
3913 # (IPv4), the default and recommended name is External NAT, but
3914 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
3915 # recommend name is External IPv6.
3916 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
3917 # address associated with this instance. Specify an unused static
3918 # external IP address available to the project or leave this field undefined
3919 # to use an IP from a shared ephemeral IP address pool. If you specify a
3920 # static external IP address, it must live in the same region as the zone of
3921 # the instance.
3922 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
3923 # configuration and can only take the following values: PREMIUM,STANDARD.
3924 #
3925 # If an AccessConfig is specified without a valid external IP address, an
3926 # ephemeral IP will be created with this networkTier.
3927 #
3928 # If an AccessConfig with a valid external IP address is specified, it must
3929 # match that of the networkTier associated with the Address resource owning
3930 # that IP.
3931 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
3932 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
3933 #
3934 # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
3935 # first IP in associated external IPv6 range.
3936 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
3937 # config.
3938 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
3939 # external IP address of this access configuration.
3940 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
3941 # external IP address of the instance to a DNS domain name.
3942 #
3943 # This field is not used in ipv6AccessConfig. A default PTR
3944 # record will be created if the VM has external IPv6 range associated.
3945 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
3946 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
3947 },
3948 ],
3949 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
3950 # accessed from the Internet. This field is always inherited from its
3951 # subnetwork.
3952 #
3953 # Valid only if stackType is IPV4_IPV6.
3954 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
3955 # use a static internal IP address, it must be unused and in the same region
3956 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3957 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
3958 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
3959 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
3960 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
3961 # server. For a VM, the network interface uses the nicN naming
3962 # format. Where N is a value between 0 and7. The default interface value is nic0.
3963 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
3964 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
3965 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
3966 # instance, if neither the network nor the subnetwork is specified, the
3967 # default network global/networks/default is used. If the
3968 # selected project doesn&#x27;t have the default network, you must specify a
3969 # network or subnet. If the network is not specified but the subnetwork is
3970 # specified, the network is inferred.
3971 #
3972 # If you specify this property, you can specify the network as
3973 # a full or partial URL. For example, the following are all valid URLs:
3974 #
3975 #
3976 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
3977 # - projects/project/global/networks/network
3978 # - global/networks/default
3979 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
3980 # to in the following format:
3981 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
3982 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
3983 # interface. If not specified by the user, an unused internal IP is
3984 # assigned by the system.
3985 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
3986 # VirtioNet.
3987 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
3988 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
3989 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
3990 # if not specified by the users.
3991 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
3992 # interface. Can only be used with network_attachment. It is not possible to
3993 # use on its own however, network_attachment can be used without
3994 # service_class_id.
3995 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
3996 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
3997 #
3998 # This field can be both set at instance creation and update network
3999 # interface operations.
4000 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
4001 # subnetworks that support L2. Every network interface will get a default
4002 # untagged (vlan not specified) subinterface. Users can specify additional
4003 # tagged subinterfaces which are sub-fields to the Network Interface.
4004 {
4005 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
4006 # subinterface. If specified, ip_allocation_mode should be set to
4007 # ALLOCATE_IP.
4008 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
4009 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
4010 # as that of the network interface.
4011 # If not specified the subnet of network interface will be used.
4012 # If you specify this property, you can specify the subnetwork as a full
4013 # or partial URL. For example, the following are all valid URLs:
4014 #
4015 #
4016 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
4017 # - regions/region/subnetworks/subnetwork
4018 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
4019 # this subinterface is connecting.
4020 },
4021 ],
4022 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
4023 # resource is inlegacy
4024 # mode, do not specify this field. If the network is in auto subnet
4025 # mode, specifying the subnetwork is optional. If the network is in custom
4026 # subnet mode, specifying the subnetwork is required. If you specify this
4027 # field, you can specify the subnetwork as a full or partial URL. For
4028 # example, the following are all valid URLs:
4029 #
4030 #
4031 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
4032 # - regions/region/subnetworks/subnetwork
4033 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
4034 # from 2 to 255 inclusively.
4035 },
4036 ],
4037 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
4038 &quot;externalIpEgressBandwidthTier&quot;: &quot;A String&quot;,
4039 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
4040 },
4041 &quot;partnerMetadata&quot;: { # Partner Metadata assigned to the instance properties. A map from a
4042 # subdomain (namespace) to entries map.
4043 &quot;a_key&quot;: {
4044 &quot;entries&quot;: { # Map of a partner metadata that belong to the same subdomain.
4045 # It accepts any value including google.protobuf.Struct.
4046 &quot;a_key&quot;: &quot;&quot;,
4047 },
4048 },
4049 },
4050 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
4051 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
4052 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
4053 # Note that for MachineImage, this is not supported yet.
4054 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
4055 # Note that for MachineImage, this is not supported yet.
4056 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
4057 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
4058 # Consuming reserved instances for examples.
4059 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
4060 # the name of your reservation as its value.
4061 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
4062 # either a name to a reservation in the same project or
4063 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
4064 # shared reservation in the same zone but in a different project.
4065 &quot;A String&quot;,
4066 ],
4067 },
4068 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
4069 # have the same definition as resource
4070 # manager tags. Keys and values can be either in numeric format,
4071 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4072 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4073 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
4074 # PATCH) when empty.
4075 &quot;a_key&quot;: &quot;A String&quot;,
4076 },
4077 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
4078 # these properties.
4079 # Note that for MachineImage, this is not supported yet.
4080 &quot;A String&quot;,
4081 ],
4082 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
4083 # these properties.
4084 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
4085 # terminated by Compute Engine (not terminated by a user). You can only set
4086 # the automatic restart option for standard instances.Preemptible instances
4087 # cannot be automatically restarted.
4088 #
4089 # By default, this is set to true so an instance is
4090 # automatically restarted if it is terminated by Compute Engine.
4091 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
4092 # must be a number between 1 and the number of availability domains
4093 # specified in the spread placement policy attached to the instance.
4094 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
4095 # 0 or unset means default vCPUs of the current machine type.
4096 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
4097 # 0 or unset means default amount of memory of the current machine type.
4098 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
4099 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
4100 &quot;maxDuration&quot;: { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
4101 # graceful shutdown isn&#x27;t complete after this time, then the instance
4102 # transitions to the STOPPING state.
4103 # as a count of seconds and fractions of seconds at nanosecond
4104 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4105 # or &quot;month&quot;. Range is approximately 10,000 years.
4106 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4107 # Durations less than one second are represented with a 0
4108 # `seconds` field and a positive `nanos` field. Must be from 0
4109 # to 999,999,999 inclusive.
4110 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4111 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4112 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4113 },
4114 },
4115 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
4116 # within the range of [90, 330] with the increment of 30, if unset, the
4117 # default behavior of host error recovery will be used.
4118 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
4119 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
4120 # only be set during instance creation, or when the instance is not currently
4121 # running. It must not be set if thepreemptible option is
4122 # also set.
4123 &quot;localSsdRecoveryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
4124 # recovery of the Local Ssd state is attempted. Its value should be in
4125 # between 0 and 168 hours with hour granularity and the default value being 1
4126 # hour.
4127 # as a count of seconds and fractions of seconds at nanosecond
4128 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4129 # or &quot;month&quot;. Range is approximately 10,000 years.
4130 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4131 # Durations less than one second are represented with a 0
4132 # `seconds` field and a positive `nanos` field. Must be from 0
4133 # to 999,999,999 inclusive.
4134 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4135 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4136 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4137 },
4138 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
4139 # resources.
4140 # This field is for use by internal tools that use the public API.
4141 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
4142 # be scheduled for maintenance.
4143 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
4144 # are: `PERIODIC`.
4145 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
4146 # the instance termination action will be performed at the end of the run
4147 # duration.
4148 # as a count of seconds and fractions of seconds at nanosecond
4149 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4150 # or &quot;month&quot;. Range is approximately 10,000 years.
4151 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4152 # Durations less than one second are represented with a 0
4153 # `seconds` field and a positive `nanos` field. Must be from 0
4154 # to 999,999,999 inclusive.
4155 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4156 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4157 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4158 },
4159 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
4160 # on a sole-tenant node.
4161 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
4162 # affinity for more information.
4163 # Overrides reservationAffinity.
4164 { # Node Affinity: the configuration of desired nodes onto which this Instance
4165 # could be scheduled.
4166 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
4167 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
4168 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
4169 &quot;A String&quot;,
4170 ],
4171 },
4172 ],
4173 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
4174 # the default behavior is MIGRATE. Forpreemptible instances,
4175 # the default and only possible behavior is TERMINATE. For more
4176 # information, see
4177 # Set
4178 # VM host maintenance policy.
4179 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
4180 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
4181 # else, the Local SSD data will be preserved when the instance is stopped
4182 # at the end of the run duration/termination time.
4183 },
4184 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
4185 # instance creation or while the instance isstopped and
4186 # therefore, in a `TERMINATED` state. SeeInstance Life
4187 # Cycle for more information on the possible instance states.
4188 &quot;preemptionNoticeDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2 Soft
4189 # Off signal is triggered for Spot
4190 # VMs only. If not specified, there will be no wait before the G2 Soft
4191 # Off signal is triggered.
4192 # as a count of seconds and fractions of seconds at nanosecond
4193 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4194 # or &quot;month&quot;. Range is approximately 10,000 years.
4195 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4196 # Durations less than one second are represented with a 0
4197 # `seconds` field and a positive `nanos` field. Must be from 0
4198 # to 999,999,999 inclusive.
4199 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4200 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4201 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4202 },
4203 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
4204 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
4205 # Timeout between GCE ACPI G2 Soft
4206 # Off and ACPI G3 Mechanical
4207 # Off during shutdown operation of VM.
4208 #
4209 # For Standard VMs values between 0s and 120s are allowed. For Spot and
4210 # Preemptible VMs supported values are between 0s and 30s.
4211 #
4212 # If no value is specified for shutdownDuration, default values are 90s for
4213 # Standard VMs and 30s for Spot/Preemptible VMs.
4214 # as a count of seconds and fractions of seconds at nanosecond
4215 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4216 # or &quot;month&quot;. Range is approximately 10,000 years.
4217 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4218 # Durations less than one second are represented with a 0
4219 # `seconds` field and a positive `nanos` field. Must be from 0
4220 # to 999,999,999 inclusive.
4221 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4222 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4223 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4224 },
4225 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
4226 # Off and ACPI G3 Mechanical
4227 # Off for Standard VMs and 30 seconds for Spot VMs.
4228 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
4229 # termination action will be performed at the termination time.
4230 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
4231 &quot;mode&quot;: &quot;A String&quot;,
4232 },
4233 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
4234 # unspecified, the default mode is `OFF`.
4235 },
4236 &quot;secureTags&quot;: [ # [Input Only] Secure tags to apply to this instance.
4237 # Maximum number of secure tags allowed is 50.
4238 # Note that for MachineImage, this is not supported yet.
4239 &quot;A String&quot;,
4240 ],
4241 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
4242 # service accounts are available to the instances that are created from
4243 # these properties. Use metadata queries to obtain the access tokens for
4244 # these instances.
4245 { # A service account.
4246 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
4247 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
4248 &quot;A String&quot;,
4249 ],
4250 },
4251 ],
4252 &quot;serviceIntegrationSpecs&quot;: { # Mapping of user defined keys to ServiceIntegrationSpec.
4253 &quot;a_key&quot;: { # Specifies the parameters to configure an integration with instances.
4254 &quot;backupDr&quot;: { # Specifies parameters to Backup and DR to attach a BackupPlan to a compute
4255 # instance for managed VM backup.
4256 &quot;plan&quot;: &quot;A String&quot;, # The BackupPlan resource to attach to the instance. Specified as a
4257 # resource reference in instances, and regional instance templates, and as
4258 # just the plan name in global instance templates
4259 },
4260 },
4261 },
4262 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
4263 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
4264 # default.
4265 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
4266 # default.
4267 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
4268 # default.
4269 },
4270 &quot;shieldedVmConfig&quot;: { # A set of Shielded VM options. # Specifies the Shielded VM options for the instances that are created from
4271 # these properties.
4272 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.
4273 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.
4274 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.
4275 },
4276 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
4277 # properties. The tags identify valid sources or targets for network
4278 # firewalls. The setTags method can modify this list of tags. Each tag within
4279 # the list must comply with RFC1035.
4280 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
4281 # the tags&#x27; contents and used for optimistic locking. The
4282 # fingerprint is initially generated by Compute Engine and changes after
4283 # every request to modify or update tags. You must always provide an
4284 # up-to-date fingerprint hash in order to update or change tags.
4285 #
4286 # To see the latest fingerprint, make get() request to the
4287 # instance.
4288 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
4289 # with RFC1035.
4290 &quot;A String&quot;,
4291 ],
4292 },
4293 &quot;workloadIdentityConfig&quot;: {
4294 &quot;identity&quot;: &quot;A String&quot;,
4295 &quot;identityCertificateEnabled&quot;: True or False,
4296 },
4297 },
4298 &quot;locationPolicy&quot;: { # Configuration for location policy among multiple possible locations # Policy for choosing target zone. For more information, seeCreate VMs in
4299 # bulk.
4300 # (e.g. preferences for zone selection among zones in a single region).
4301 &quot;locations&quot;: { # Location configurations mapped by location name.
4302 # Currently only zone names are supported and must be represented as valid
4303 # internal URLs, such as zones/us-central1-a.
4304 # The bulkInsert operation doesn&#x27;t create instances in an AI zone, even if
4305 # an AI zone is available in the specified region. For example, if you set a
4306 # DENY preference for us-central1-a, Compute Engine will consider
4307 # us-central1-b and us-central1-c for instance creation, but not
4308 # us-central1-ai1a. Also, you can&#x27;t use the locations[] configuration to
4309 # allow instance creation in an AI zone. To include an AI zone in bulkInsert
4310 # operations, use the locationPolicy.zones[] field.
4311 &quot;a_key&quot;: {
4312 &quot;constraints&quot;: { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution
4313 # in this zone.
4314 &quot;maxCount&quot;: 42, # Maximum number of items that are allowed to be placed in this zone.
4315 # The value must be non-negative.
4316 },
4317 &quot;names&quot;: [ # Names of resources to be put in the location.
4318 # Must contain unique, correct resource names.
4319 # If used, targetShape must be left unset.
4320 &quot;A String&quot;,
4321 ],
4322 &quot;preference&quot;: &quot;A String&quot;, # Preference for a given location. Set to either ALLOW orDENY.
4323 },
4324 },
4325 &quot;targetShape&quot;: &quot;A String&quot;, # Strategy for distributing VMs across zones in a region.
4326 &quot;zones&quot;: [ # The bulkInsert operation applies any preferences set in the locations
4327 # field to the specific zones listed in the zones field if the same zones
4328 # are specified in both fields.
4329 {
4330 &quot;zone&quot;: &quot;A String&quot;, # The URL of the zone.
4331 # The zone must exist in the region where the request is called.
4332 # Zones must be represented as valid partial URLs,
4333 # such as zones/us-central1-a.
4334 },
4335 ],
4336 },
4337 &quot;minCount&quot;: &quot;A String&quot;, # The minimum number of instances to create. If no min_count is
4338 # specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will
4339 # be created and instances already created will be deleted.
4340 &quot;namePattern&quot;: &quot;A String&quot;, # The string pattern used for the names of the VMs.
4341 # Either name_pattern or per_instance_properties
4342 # must be set. The pattern must contain one continuous sequence of
4343 # placeholder hash characters (#) with each character corresponding to one
4344 # digit of the generated instance name. Example: a name_pattern
4345 # of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances
4346 # in the same project and zone have names that match the name pattern
4347 # then the generated instance numbers start after the biggest
4348 # existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern
4349 # placeholder #...# can contain up to 18 characters.
4350 &quot;perInstanceProperties&quot;: { # Per-instance properties to be set on individual instances.
4351 # Keys of this map specify requested instance names.
4352 # Can be empty if name_pattern is used.
4353 &quot;a_key&quot;: { # Per-instance properties to be set on individual instances.
4354 # To be extended in the future.
4355 &quot;hostname&quot;: &quot;A String&quot;, # Specifies the hostname of the instance. More details in:
4356 # https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention
4357 &quot;name&quot;: &quot;A String&quot;, # Output only. This field is only temporary. It will be removed. Do not use it.
4358 },
4359 },
4360 &quot;sourceInstanceTemplate&quot;: &quot;A String&quot;, # Specifies the instance template from which to create instances. You may
4361 # combine sourceInstanceTemplate withinstanceProperties to override specific values from an
4362 # existing instance template. Bulk API follows the semantics of JSON Merge
4363 # Patch described by RFC
4364 # 7396.
4365 #
4366 # It can be a full or partial URL. For example, the following are
4367 # all valid URLs to an instance template:
4368 #
4369 #
4370 # - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
4371 # - projects/project/global/instanceTemplates/instanceTemplate
4372 # - global/instanceTemplates/instanceTemplate
4373 #
4374 #
4375 #
4376 # This field is optional.
4377 },
4378 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp in RFC3339
4379 # text format.
4380 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
4381 # create the resource.
4382 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
4383 # defined by the server.
4384 &quot;kind&quot;: &quot;compute#queuedResource&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#queuedResource for QueuedResources.
4385 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
4386 # The name must be 1-63 characters long, and comply withRFC1035.
4387 # Specifically, the name must be 1-63 characters long and match the regular
4388 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character
4389 # must be a lowercase letter, and all following characters must be a dash,
4390 # lowercase letter, or digit, except the last character, which cannot be a
4391 # dash.
4392 &quot;queuingPolicy&quot;: { # Queuing parameters for the requested deferred capacity. # Queuing parameters for the requested capacity.
4393 &quot;validUntilDuration&quot;: { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity.
4394 # as a count of seconds and fractions of seconds at nanosecond
4395 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4396 # or &quot;month&quot;. Range is approximately 10,000 years.
4397 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4398 # Durations less than one second are represented with a 0
4399 # `seconds` field and a positive `nanos` field. Must be from 0
4400 # to 999,999,999 inclusive.
4401 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4402 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4403 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4404 },
4405 &quot;validUntilTime&quot;: &quot;A String&quot;, # Absolute deadline for waiting for capacity inRFC3339
4406 # text format.
4407 },
4408 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output only] Server-defined URL for the resource.
4409 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
4410 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output only] High-level status of the request.
4411 &quot;status&quot;: { # [Output only] Result of queuing and provisioning based on deferred # Output only. [Output only] Result of queuing and provisioning based on deferred
4412 # capacity.
4413 # capacity.
4414 &quot;failedData&quot;: { # Additional status detail for the FAILED state. # Output only. Additional status detail for the FAILED state.
4415 &quot;error&quot;: { # The error(s) that caused the QueuedResource to enter the FAILED state.
4416 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4417 # operation.
4418 {
4419 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4420 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4421 # details. There is a set of defined message types to use for providing
4422 # details.The syntax depends on the error code. For example,
4423 # QuotaExceededInfo will have details when the error code is
4424 # QUOTA_EXCEEDED.
4425 {
4426 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4427 #
4428 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4429 # is not enabled:
4430 #
4431 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4432 # &quot;domain&quot;: &quot;googleapis.com&quot;
4433 # &quot;metadata&quot;: {
4434 # &quot;resource&quot;: &quot;projects/123&quot;,
4435 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4436 # }
4437 # }
4438 #
4439 # This response indicates that the pubsub.googleapis.com API is not enabled.
4440 #
4441 # Example of an error that is returned when attempting to create a Spanner
4442 # instance in a region that is out of stock:
4443 #
4444 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4445 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4446 # &quot;metadata&quot;: {
4447 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4448 # }
4449 # }
4450 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4451 # is typically the registered service name of the tool or product that
4452 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4453 # generated by some common infrastructure, the error domain must be a
4454 # globally unique value that identifies the infrastructure. For Google API
4455 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4456 &quot;metadatas&quot;: { # Additional structured details about this error.
4457 #
4458 # Keys must match a regular expression of `a-z+` but should
4459 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4460 # length. When identifying the current value of an exceeded limit, the units
4461 # should be contained in the key, not the value. For example, rather than
4462 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4463 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4464 # instances that can be created in a single (batch) request.
4465 &quot;a_key&quot;: &quot;A String&quot;,
4466 },
4467 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4468 # proximate cause of the error. Error reasons are unique within a particular
4469 # domain of errors. This should be at most 63 characters and match a
4470 # regular expression of `A-Z+[A-Z0-9]`, which represents
4471 # UPPER_SNAKE_CASE.
4472 },
4473 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4474 #
4475 # For example, if a quota check failed with an error indicating the calling
4476 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4477 # directly to the right place in the developer console to flip the bit.
4478 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4479 { # Describes a URL link.
4480 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4481 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4482 },
4483 ],
4484 },
4485 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4486 # which can be attached to an RPC error.
4487 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4488 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4489 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4490 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4491 },
4492 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4493 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4494 &quot;a_key&quot;: &quot;A String&quot;,
4495 },
4496 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4497 # type or metric.
4498 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4499 # or metric.
4500 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4501 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4502 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4503 },
4504 },
4505 ],
4506 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4507 # This property is optional.
4508 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4509 },
4510 ],
4511 },
4512 },
4513 &quot;provisioningOperations&quot;: [ # Output only. [Output only] Fully qualified URL of the provisioning GCE operation to
4514 # track the provisioning along with provisioning errors. The referenced
4515 # operation may not exist after having been deleted or expired.
4516 &quot;A String&quot;,
4517 ],
4518 &quot;queuingPolicy&quot;: { # Queuing parameters for the requested deferred capacity. # Output only. Constraints for the time when the resource(s) start provisioning. Always
4519 # exposed as absolute times.
4520 &quot;validUntilDuration&quot;: { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity.
4521 # as a count of seconds and fractions of seconds at nanosecond
4522 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4523 # or &quot;month&quot;. Range is approximately 10,000 years.
4524 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4525 # Durations less than one second are represented with a 0
4526 # `seconds` field and a positive `nanos` field. Must be from 0
4527 # to 999,999,999 inclusive.
4528 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4529 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4530 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4531 },
4532 &quot;validUntilTime&quot;: &quot;A String&quot;, # Absolute deadline for waiting for capacity inRFC3339
4533 # text format.
4534 },
4535 },
4536 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the resource resides. Only applicable
4537 # for zonal resources. You must specify this field as part of the HTTP
4538 # request URL. It is not settable as a field in the request body.
4539 }</pre>
4540 </div>
4541
4542 <div class="method">
4543 <code class="details" id="insert">insert(project, zone, body=None, requestId=None, x__xgafv=None)</code>
4544 <pre>Creates a QueuedResource.
4545
4546 Args:
4547 project: string, Project ID for this request. (required)
4548 zone: string, Name of the zone for this request. (required)
4549 body: object, The request body.
4550 The object takes the form of:
4551
4552 { # QueuedResource represents a request for future capacity. The capacity is
4553 # delivered in the form of other GCE resources, either Instances or
4554 # Reservations.
4555 &quot;bulkInsertInstanceResource&quot;: { # A transient resource used in compute.instances.bulkInsert and # Specification of VM instances to create.
4556 # compute.regionInstances.bulkInsert . This resource is not persisted
4557 # anywhere, it is used only for processing the requests.
4558 &quot;count&quot;: &quot;A String&quot;, # The maximum number of instances to create.
4559 &quot;instanceFlexibilityPolicy&quot;: { # A flexible specification of machine types for instances to create. # A flexible specification of machine type of instances to create.
4560 &quot;instanceSelections&quot;: { # Specification of alternative, flexible instance subsets.
4561 # One of them will be selected to create the instances
4562 # based on various criteria, like:
4563 # - ranks,
4564 # - location policy,
4565 # - current capacity,
4566 # - available reservations (you can specify affinity in
4567 # InstanceProperties),
4568 # - SWAN/GOOSE limitations.
4569 # Key is an arbitrary, unique RFC1035 string that identifies the instance
4570 # selection.
4571 &quot;a_key&quot;: { # Specification of machine type to use. Every position inside this message
4572 # is an alternative.
4573 # The count specified in the shape flexibility must not exceed the number
4574 # of entries in per_instance_properties or the capacity of the
4575 # name_pattern, if used.
4576 &quot;disks&quot;: [ # Disks to be attached to the instances created from in this selection.
4577 # They override the disks specified in the instance properties.
4578 { # An instance-attached disk resource.
4579 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
4580 # or X86_64.
4581 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
4582 # deleted (but not when the disk is detached from the instance).
4583 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
4584 # partition of the disk for its root filesystem.
4585 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
4586 # running within the instance. This name can be used to reference the device
4587 # for mounting, resizing, and so on, from within the instance.
4588 #
4589 # If not specified, the server chooses a default device name to apply to this
4590 # disk, in the form persistent-disk-x, where x is a number
4591 # assigned by Google Compute Engine. This field is only applicable for
4592 # persistent disks.
4593 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
4594 # encryption key.
4595 #
4596 # If you are creating a new disk, this field encrypts the new disk using
4597 # an encryption key that you provide. If you are attaching an existing
4598 # disk that is already encrypted, this field decrypts the disk using
4599 # the customer-supplied encryption key.
4600 #
4601 # If you encrypt a disk using a customer-supplied key, you must provide the
4602 # same key again when you attempt to use this resource at a later time. For
4603 # example, you must provide the key when you create a snapshot or an image
4604 # from the disk or when you attach the disk to a virtual machine instance.
4605 #
4606 # If you do not provide an encryption key, then the disk will be encrypted
4607 # using an automatically generated key and you do not need to provide a key
4608 # to use the disk later.
4609 #
4610 # Note:
4611 #
4612 # Instance templates do not storecustomer-supplied
4613 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
4614 #
4615 # You cannot create VMs that have disks with customer-supplied keys using
4616 # the bulk
4617 # insert method.
4618 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4619 # For example:
4620 #
4621 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4622 # key_region/cryptoKeys/key
4623 #
4624 # The fully-qualifed key name may be returned for resource GET requests. For
4625 # example:
4626 #
4627 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4628 # key_region/cryptoKeys/key
4629 # /cryptoKeyVersions/1
4630 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4631 # key. If absent, the Compute Engine default service account is used.
4632 # For example:
4633 #
4634 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4635 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4636 # encryption key, encoded in RFC
4637 # 4648 base64 to either encrypt or decrypt this resource. You can
4638 # provide either the rawKey or thersaEncryptedKey.
4639 # For example:
4640 #
4641 # &quot;rawKey&quot;:
4642 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4643 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4644 # customer-supplied encryption key to either encrypt or decrypt this
4645 # resource. You can provide either the rawKey or thersaEncryptedKey.
4646 # For example:
4647 #
4648 # &quot;rsaEncryptedKey&quot;:
4649 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4650 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4651 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4652 #
4653 # The key must meet the following requirements before you can provide it to
4654 # Compute Engine:
4655 #
4656 # 1. The key is wrapped using a RSA public key certificate provided by
4657 # Google.
4658 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4659 # encoding.
4660 #
4661 # Gets the RSA public key certificate provided by Google at:
4662 #
4663 #
4664 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4665 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4666 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4667 # encryption key that protects this resource.
4668 },
4669 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
4670 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
4671 # currently attached to another instance. If you try to force attach a zonal
4672 # disk to an instance, you will receive an error.
4673 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4674 # only for bootable images. Read
4675 # Enabling guest operating system features to see a list of available
4676 # options.
4677 { # Guest OS features.
4678 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4679 # separate values. Set to one or more of the following values:
4680 #
4681 # - VIRTIO_SCSI_MULTIQUEUE
4682 # - WINDOWS
4683 # - MULTI_IP_SUBNET
4684 # - UEFI_COMPATIBLE
4685 # - GVNIC
4686 # - SEV_CAPABLE
4687 # - SUSPEND_RESUME_COMPATIBLE
4688 # - SEV_LIVE_MIGRATABLE_V2
4689 # - SEV_SNP_CAPABLE
4690 # - TDX_CAPABLE
4691 # - IDPF
4692 # - SNP_SVSM_CAPABLE
4693 # - CCA_CAPABLE
4694 #
4695 #
4696 # For more information, see
4697 # Enabling guest operating system features.
4698 },
4699 ],
4700 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
4701 # boot disk. If you have many disks attached to an instance, each
4702 # disk would have a unique index number.
4703 &quot;initializeParams&quot;: { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
4704 # alongside the new instance. Use initialization parameters to create boot
4705 # disks or local SSDs attached to the new instance.
4706 #
4707 # This property is mutually exclusive with the source property;
4708 # you can only define one or the other, but not both.
4709 # alongside the new instance. Use initialization parameters to create boot
4710 # disks or local SSDs attached to the new instance.
4711 #
4712 # This field is persisted and returned for instanceTemplate and not returned
4713 # in the context of instance.
4714 #
4715 # This property is mutually exclusive with the source property;
4716 # you can only define one or the other, but not both.
4717 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
4718 # arm64 or x86_64.
4719 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
4720 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
4721 # of the instance. If a disk with the same name already exists in the given
4722 # region, the existing disk is attached to the new instance and the
4723 # new disk is not created.
4724 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
4725 # 10 GB. If you specify a sourceImage, which is required for
4726 # boot disks, the default size is the size of the sourceImage.
4727 # If you do not specify a sourceImage, the default disk size
4728 # is 500 GB.
4729 &quot;diskType&quot;: &quot;A String&quot;,
4730 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
4731 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4732 # only for bootable images. Read
4733 # Enabling guest operating system features to see a list of available
4734 # options.
4735 #
4736 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
4737 { # Guest OS features.
4738 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4739 # separate values. Set to one or more of the following values:
4740 #
4741 # - VIRTIO_SCSI_MULTIQUEUE
4742 # - WINDOWS
4743 # - MULTI_IP_SUBNET
4744 # - UEFI_COMPATIBLE
4745 # - GVNIC
4746 # - SEV_CAPABLE
4747 # - SUSPEND_RESUME_COMPATIBLE
4748 # - SEV_LIVE_MIGRATABLE_V2
4749 # - SEV_SNP_CAPABLE
4750 # - TDX_CAPABLE
4751 # - IDPF
4752 # - SNP_SVSM_CAPABLE
4753 # - CCA_CAPABLE
4754 #
4755 #
4756 # For more information, see
4757 # Enabling guest operating system features.
4758 },
4759 ],
4760 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
4761 # which is either SCSI or NVME. The default isSCSI.
4762 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
4763 # persistent disks.
4764 &quot;a_key&quot;: &quot;A String&quot;,
4765 },
4766 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
4767 # disk.
4768 &quot;A String&quot;,
4769 ],
4770 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
4771 &quot;A String&quot;,
4772 ],
4773 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
4774 # more than one instance.
4775 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
4776 # is to use the existing disk.
4777 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
4778 # of I/O operations per second that the disk can handle. Values must be
4779 # between 10,000 and 120,000. For more details, see theExtreme persistent
4780 # disk documentation.
4781 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
4782 # number of throughput mb per second that the disk can handle. Values must
4783 # greater than or equal to 1.
4784 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
4785 # the URLs of the zones where the disk should be replicated to.
4786 # You must provide exactly two replica zones, and one zone must be the same
4787 # as the instance zone.
4788 &quot;A String&quot;,
4789 ],
4790 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
4791 # have the same definition as resource
4792 # manager tags. Keys and values can be either in numeric format,
4793 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4794 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4795 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
4796 # empty.
4797 &quot;a_key&quot;: &quot;A String&quot;,
4798 },
4799 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
4800 # Specified using the full or partial URL. For instance template, specify
4801 # only the resource policy name.
4802 &quot;A String&quot;,
4803 ],
4804 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
4805 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4806 # is required.
4807 #
4808 # To create a disk with one of the public operating system
4809 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
4810 #
4811 # projects/debian-cloud/global/images/family/debian-9
4812 #
4813 #
4814 # Alternatively, use a specific version of a public operating system image:
4815 #
4816 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
4817 #
4818 #
4819 # To create a disk with a custom image that you created, specify the
4820 # image name in the following format:
4821 #
4822 # global/images/my-custom-image
4823 #
4824 #
4825 # You can also specify a custom image by its image family, which returns
4826 # the latest version of the image in that family. Replace the image name
4827 # with family/family-name:
4828 #
4829 # global/images/family/my-image-family
4830 #
4831 #
4832 # If the source image is deleted later, this field will not be set.
4833 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
4834 # encryption key of the source image. Required if the source image is
4835 # protected by a customer-supplied encryption key.
4836 #
4837 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
4838 # encryption keys, so you cannot create disks for instances in a managed instance group if the
4839 # source images are encrypted with your own keys.
4840 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4841 # For example:
4842 #
4843 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4844 # key_region/cryptoKeys/key
4845 #
4846 # The fully-qualifed key name may be returned for resource GET requests. For
4847 # example:
4848 #
4849 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4850 # key_region/cryptoKeys/key
4851 # /cryptoKeyVersions/1
4852 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4853 # key. If absent, the Compute Engine default service account is used.
4854 # For example:
4855 #
4856 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4857 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4858 # encryption key, encoded in RFC
4859 # 4648 base64 to either encrypt or decrypt this resource. You can
4860 # provide either the rawKey or thersaEncryptedKey.
4861 # For example:
4862 #
4863 # &quot;rawKey&quot;:
4864 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4865 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4866 # customer-supplied encryption key to either encrypt or decrypt this
4867 # resource. You can provide either the rawKey or thersaEncryptedKey.
4868 # For example:
4869 #
4870 # &quot;rsaEncryptedKey&quot;:
4871 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4872 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4873 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4874 #
4875 # The key must meet the following requirements before you can provide it to
4876 # Compute Engine:
4877 #
4878 # 1. The key is wrapped using a RSA public key certificate provided by
4879 # Google.
4880 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4881 # encoding.
4882 #
4883 # Gets the RSA public key certificate provided by Google at:
4884 #
4885 #
4886 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4887 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4888 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4889 # encryption key that protects this resource.
4890 },
4891 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
4892 # instance boot disk, one of initializeParams.sourceSnapshot
4893 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
4894 # is required.
4895 #
4896 # To create a disk with a snapshot that you created, specify the
4897 # snapshot name in the following format:
4898 #
4899 # us-central1-a/instantSnapshots/my-backup
4900 #
4901 #
4902 # If the source instant-snapshot is deleted later, this field will not be
4903 # set.
4904 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
4905 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
4906 # is required.
4907 #
4908 # To create a disk with a snapshot that you created, specify the
4909 # snapshot name in the following format:
4910 #
4911 # global/snapshots/my-backup
4912 #
4913 #
4914 # If the source snapshot is deleted later, this field will not be set.
4915 #
4916 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
4917 # an image instead when you create VMs using
4918 # the bulk
4919 # insert method.
4920 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
4921 # encryption key of the source snapshot.
4922 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4923 # For example:
4924 #
4925 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4926 # key_region/cryptoKeys/key
4927 #
4928 # The fully-qualifed key name may be returned for resource GET requests. For
4929 # example:
4930 #
4931 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4932 # key_region/cryptoKeys/key
4933 # /cryptoKeyVersions/1
4934 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4935 # key. If absent, the Compute Engine default service account is used.
4936 # For example:
4937 #
4938 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4939 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4940 # encryption key, encoded in RFC
4941 # 4648 base64 to either encrypt or decrypt this resource. You can
4942 # provide either the rawKey or thersaEncryptedKey.
4943 # For example:
4944 #
4945 # &quot;rawKey&quot;:
4946 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4947 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4948 # customer-supplied encryption key to either encrypt or decrypt this
4949 # resource. You can provide either the rawKey or thersaEncryptedKey.
4950 # For example:
4951 #
4952 # &quot;rsaEncryptedKey&quot;:
4953 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4954 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4955 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4956 #
4957 # The key must meet the following requirements before you can provide it to
4958 # Compute Engine:
4959 #
4960 # 1. The key is wrapped using a RSA public key certificate provided by
4961 # Google.
4962 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4963 # encoding.
4964 #
4965 # Gets the RSA public key certificate provided by Google at:
4966 #
4967 #
4968 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4969 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4970 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4971 # encryption key that protects this resource.
4972 },
4973 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
4974 # this as a partial or full URL to the resource. For example, the following
4975 # are valid values:
4976 #
4977 #
4978 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
4979 # - projects/project/zones/zone/storagePools/storagePool
4980 # - zones/zone/storagePools/storagePool
4981 },
4982 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
4983 # either SCSI or NVME. For most machine types, the
4984 # default is SCSI. Local SSDs can use either NVME or SCSI.
4985 # In certain configurations, persistent disks can use NVMe. For more
4986 # information, seeAbout
4987 # persistent disks.
4988 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
4989 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
4990 &quot;A String&quot;,
4991 ],
4992 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
4993 # disk is not allowed to be detached from the instance, or to be used as the
4994 # source of the snapshot creation, and the image creation. The instance with
4995 # at least one locked attached disk is not allow to be used as source of
4996 # machine image creation, instant snapshot creation, and not allowed to be
4997 # deleted with --keep-disk parameter set to true for locked disks.
4998 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
4999 # in READ_WRITE mode.
5000 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
5001 # field is set to PRESERVED if the LocalSSD data has been saved
5002 # to a persistent location by customer request. (see the
5003 # discard_local_ssd option on Stop/Suspend).
5004 # Read-only in the api.
5005 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
5006 # these are public keys which are safe to store in public
5007 &quot;dbs&quot;: [ # The Key Database (db).
5008 {
5009 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5010 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5011 },
5012 ],
5013 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
5014 {
5015 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5016 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5017 },
5018 ],
5019 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
5020 {
5021 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5022 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5023 },
5024 ],
5025 &quot;pk&quot;: { # The Platform Key (PK).
5026 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5027 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5028 },
5029 },
5030 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
5031 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5032 # is required.
5033 #
5034 # If desired, you can also attach existing non-root persistent disks using
5035 # this property. This field is only applicable for persistent disks.
5036 #
5037 # Note that for InstanceTemplate, specify the disk name for zonal disk,
5038 # and the URL for regional disk.
5039 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
5040 },
5041 ],
5042 &quot;machineTypes&quot;: [ # Alternative machine types to use for instances that are created from
5043 # these properties. This field only accepts a machine type names, for
5044 # example `n2-standard-4` and not URLs or partial URLs.
5045 &quot;A String&quot;,
5046 ],
5047 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
5048 # e.g. &#x27;Intel Ice Lake&#x27;.
5049 &quot;rank&quot;: &quot;A String&quot;, # Rank when prioritizing the shape flexibilities.
5050 # The instance selections with rank are considered
5051 # first, in the ascending order of the rank.
5052 # If not set, defaults to 0.
5053 },
5054 },
5055 },
5056 &quot;instanceProperties&quot;: { # The instance properties defining the VM instances to be created. Required
5057 # if sourceInstanceTemplate is not provided.
5058 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
5059 # Note that for MachineImage, this is not supported yet.
5060 # Options that would traditionally be configured in a BIOS belong
5061 # here. Features that require operating system support may have
5062 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
5063 # disabled).
5064 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
5065 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
5066 &quot;enableWatchdogTimer&quot;: True or False, # Whether to enable the watchdog timer.
5067 &quot;numaNodeCount&quot;: 42, # The number of vNUMA nodes.
5068 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
5069 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
5070 # multithreading (SMT) set this to 1. If unset, the maximum number
5071 # of threads supported per core by the underlying processor is
5072 # assumed.
5073 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
5074 # Supported modes include:
5075 # * ALL_CORE_MAX
5076 #
5077 # Using empty string or not setting this field will use the platform-specific
5078 # default turbo mode.
5079 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
5080 # the number of threads per core to compute the total number of virtual
5081 # CPUs to expose to the instance. If unset, the number of cores is
5082 # inferred from the instance&#x27;s nominal CPU count and the underlying
5083 # platform&#x27;s SMT width.
5084 },
5085 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
5086 # source IP addresses other than their own and receive packets with
5087 # destination IP addresses other than their own. If these instances will be
5088 # used as an IP gateway or it will be set as the next-hop in a Route
5089 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
5090 # documentation for more information.
5091 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
5092 # Note that for MachineImage, this is not supported yet.
5093 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
5094 &quot;confidentialParavisorConfig&quot;: { # A set of Confidential Paravisor (SVSM) options. # Defines a set of Confidential Paravisor (SVSM) options.
5095 &quot;confidentialTpmType&quot;: &quot;A String&quot;,
5096 &quot;sevSnpIrqMode&quot;: &quot;A String&quot;,
5097 },
5098 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
5099 },
5100 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
5101 # properties.
5102 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
5103 # from these properties.
5104 { # An instance-attached disk resource.
5105 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
5106 # or X86_64.
5107 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
5108 # deleted (but not when the disk is detached from the instance).
5109 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
5110 # partition of the disk for its root filesystem.
5111 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
5112 # running within the instance. This name can be used to reference the device
5113 # for mounting, resizing, and so on, from within the instance.
5114 #
5115 # If not specified, the server chooses a default device name to apply to this
5116 # disk, in the form persistent-disk-x, where x is a number
5117 # assigned by Google Compute Engine. This field is only applicable for
5118 # persistent disks.
5119 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
5120 # encryption key.
5121 #
5122 # If you are creating a new disk, this field encrypts the new disk using
5123 # an encryption key that you provide. If you are attaching an existing
5124 # disk that is already encrypted, this field decrypts the disk using
5125 # the customer-supplied encryption key.
5126 #
5127 # If you encrypt a disk using a customer-supplied key, you must provide the
5128 # same key again when you attempt to use this resource at a later time. For
5129 # example, you must provide the key when you create a snapshot or an image
5130 # from the disk or when you attach the disk to a virtual machine instance.
5131 #
5132 # If you do not provide an encryption key, then the disk will be encrypted
5133 # using an automatically generated key and you do not need to provide a key
5134 # to use the disk later.
5135 #
5136 # Note:
5137 #
5138 # Instance templates do not storecustomer-supplied
5139 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
5140 #
5141 # You cannot create VMs that have disks with customer-supplied keys using
5142 # the bulk
5143 # insert method.
5144 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5145 # For example:
5146 #
5147 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5148 # key_region/cryptoKeys/key
5149 #
5150 # The fully-qualifed key name may be returned for resource GET requests. For
5151 # example:
5152 #
5153 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5154 # key_region/cryptoKeys/key
5155 # /cryptoKeyVersions/1
5156 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5157 # key. If absent, the Compute Engine default service account is used.
5158 # For example:
5159 #
5160 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5161 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5162 # encryption key, encoded in RFC
5163 # 4648 base64 to either encrypt or decrypt this resource. You can
5164 # provide either the rawKey or thersaEncryptedKey.
5165 # For example:
5166 #
5167 # &quot;rawKey&quot;:
5168 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5169 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5170 # customer-supplied encryption key to either encrypt or decrypt this
5171 # resource. You can provide either the rawKey or thersaEncryptedKey.
5172 # For example:
5173 #
5174 # &quot;rsaEncryptedKey&quot;:
5175 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5176 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5177 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5178 #
5179 # The key must meet the following requirements before you can provide it to
5180 # Compute Engine:
5181 #
5182 # 1. The key is wrapped using a RSA public key certificate provided by
5183 # Google.
5184 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5185 # encoding.
5186 #
5187 # Gets the RSA public key certificate provided by Google at:
5188 #
5189 #
5190 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5191 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5192 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5193 # encryption key that protects this resource.
5194 },
5195 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
5196 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
5197 # currently attached to another instance. If you try to force attach a zonal
5198 # disk to an instance, you will receive an error.
5199 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5200 # only for bootable images. Read
5201 # Enabling guest operating system features to see a list of available
5202 # options.
5203 { # Guest OS features.
5204 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5205 # separate values. Set to one or more of the following values:
5206 #
5207 # - VIRTIO_SCSI_MULTIQUEUE
5208 # - WINDOWS
5209 # - MULTI_IP_SUBNET
5210 # - UEFI_COMPATIBLE
5211 # - GVNIC
5212 # - SEV_CAPABLE
5213 # - SUSPEND_RESUME_COMPATIBLE
5214 # - SEV_LIVE_MIGRATABLE_V2
5215 # - SEV_SNP_CAPABLE
5216 # - TDX_CAPABLE
5217 # - IDPF
5218 # - SNP_SVSM_CAPABLE
5219 # - CCA_CAPABLE
5220 #
5221 #
5222 # For more information, see
5223 # Enabling guest operating system features.
5224 },
5225 ],
5226 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
5227 # boot disk. If you have many disks attached to an instance, each
5228 # disk would have a unique index number.
5229 &quot;initializeParams&quot;: { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
5230 # alongside the new instance. Use initialization parameters to create boot
5231 # disks or local SSDs attached to the new instance.
5232 #
5233 # This property is mutually exclusive with the source property;
5234 # you can only define one or the other, but not both.
5235 # alongside the new instance. Use initialization parameters to create boot
5236 # disks or local SSDs attached to the new instance.
5237 #
5238 # This field is persisted and returned for instanceTemplate and not returned
5239 # in the context of instance.
5240 #
5241 # This property is mutually exclusive with the source property;
5242 # you can only define one or the other, but not both.
5243 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
5244 # arm64 or x86_64.
5245 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
5246 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
5247 # of the instance. If a disk with the same name already exists in the given
5248 # region, the existing disk is attached to the new instance and the
5249 # new disk is not created.
5250 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
5251 # 10 GB. If you specify a sourceImage, which is required for
5252 # boot disks, the default size is the size of the sourceImage.
5253 # If you do not specify a sourceImage, the default disk size
5254 # is 500 GB.
5255 &quot;diskType&quot;: &quot;A String&quot;,
5256 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
5257 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5258 # only for bootable images. Read
5259 # Enabling guest operating system features to see a list of available
5260 # options.
5261 #
5262 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
5263 { # Guest OS features.
5264 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5265 # separate values. Set to one or more of the following values:
5266 #
5267 # - VIRTIO_SCSI_MULTIQUEUE
5268 # - WINDOWS
5269 # - MULTI_IP_SUBNET
5270 # - UEFI_COMPATIBLE
5271 # - GVNIC
5272 # - SEV_CAPABLE
5273 # - SUSPEND_RESUME_COMPATIBLE
5274 # - SEV_LIVE_MIGRATABLE_V2
5275 # - SEV_SNP_CAPABLE
5276 # - TDX_CAPABLE
5277 # - IDPF
5278 # - SNP_SVSM_CAPABLE
5279 # - CCA_CAPABLE
5280 #
5281 #
5282 # For more information, see
5283 # Enabling guest operating system features.
5284 },
5285 ],
5286 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
5287 # which is either SCSI or NVME. The default isSCSI.
5288 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
5289 # persistent disks.
5290 &quot;a_key&quot;: &quot;A String&quot;,
5291 },
5292 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
5293 # disk.
5294 &quot;A String&quot;,
5295 ],
5296 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
5297 &quot;A String&quot;,
5298 ],
5299 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
5300 # more than one instance.
5301 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
5302 # is to use the existing disk.
5303 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
5304 # of I/O operations per second that the disk can handle. Values must be
5305 # between 10,000 and 120,000. For more details, see theExtreme persistent
5306 # disk documentation.
5307 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
5308 # number of throughput mb per second that the disk can handle. Values must
5309 # greater than or equal to 1.
5310 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
5311 # the URLs of the zones where the disk should be replicated to.
5312 # You must provide exactly two replica zones, and one zone must be the same
5313 # as the instance zone.
5314 &quot;A String&quot;,
5315 ],
5316 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
5317 # have the same definition as resource
5318 # manager tags. Keys and values can be either in numeric format,
5319 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
5320 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
5321 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
5322 # empty.
5323 &quot;a_key&quot;: &quot;A String&quot;,
5324 },
5325 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
5326 # Specified using the full or partial URL. For instance template, specify
5327 # only the resource policy name.
5328 &quot;A String&quot;,
5329 ],
5330 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
5331 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5332 # is required.
5333 #
5334 # To create a disk with one of the public operating system
5335 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
5336 #
5337 # projects/debian-cloud/global/images/family/debian-9
5338 #
5339 #
5340 # Alternatively, use a specific version of a public operating system image:
5341 #
5342 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
5343 #
5344 #
5345 # To create a disk with a custom image that you created, specify the
5346 # image name in the following format:
5347 #
5348 # global/images/my-custom-image
5349 #
5350 #
5351 # You can also specify a custom image by its image family, which returns
5352 # the latest version of the image in that family. Replace the image name
5353 # with family/family-name:
5354 #
5355 # global/images/family/my-image-family
5356 #
5357 #
5358 # If the source image is deleted later, this field will not be set.
5359 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
5360 # encryption key of the source image. Required if the source image is
5361 # protected by a customer-supplied encryption key.
5362 #
5363 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
5364 # encryption keys, so you cannot create disks for instances in a managed instance group if the
5365 # source images are encrypted with your own keys.
5366 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5367 # For example:
5368 #
5369 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5370 # key_region/cryptoKeys/key
5371 #
5372 # The fully-qualifed key name may be returned for resource GET requests. For
5373 # example:
5374 #
5375 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5376 # key_region/cryptoKeys/key
5377 # /cryptoKeyVersions/1
5378 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5379 # key. If absent, the Compute Engine default service account is used.
5380 # For example:
5381 #
5382 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5383 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5384 # encryption key, encoded in RFC
5385 # 4648 base64 to either encrypt or decrypt this resource. You can
5386 # provide either the rawKey or thersaEncryptedKey.
5387 # For example:
5388 #
5389 # &quot;rawKey&quot;:
5390 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5391 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5392 # customer-supplied encryption key to either encrypt or decrypt this
5393 # resource. You can provide either the rawKey or thersaEncryptedKey.
5394 # For example:
5395 #
5396 # &quot;rsaEncryptedKey&quot;:
5397 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5398 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5399 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5400 #
5401 # The key must meet the following requirements before you can provide it to
5402 # Compute Engine:
5403 #
5404 # 1. The key is wrapped using a RSA public key certificate provided by
5405 # Google.
5406 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5407 # encoding.
5408 #
5409 # Gets the RSA public key certificate provided by Google at:
5410 #
5411 #
5412 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5413 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5414 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5415 # encryption key that protects this resource.
5416 },
5417 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
5418 # instance boot disk, one of initializeParams.sourceSnapshot
5419 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
5420 # is required.
5421 #
5422 # To create a disk with a snapshot that you created, specify the
5423 # snapshot name in the following format:
5424 #
5425 # us-central1-a/instantSnapshots/my-backup
5426 #
5427 #
5428 # If the source instant-snapshot is deleted later, this field will not be
5429 # set.
5430 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
5431 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
5432 # is required.
5433 #
5434 # To create a disk with a snapshot that you created, specify the
5435 # snapshot name in the following format:
5436 #
5437 # global/snapshots/my-backup
5438 #
5439 #
5440 # If the source snapshot is deleted later, this field will not be set.
5441 #
5442 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
5443 # an image instead when you create VMs using
5444 # the bulk
5445 # insert method.
5446 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
5447 # encryption key of the source snapshot.
5448 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5449 # For example:
5450 #
5451 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5452 # key_region/cryptoKeys/key
5453 #
5454 # The fully-qualifed key name may be returned for resource GET requests. For
5455 # example:
5456 #
5457 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5458 # key_region/cryptoKeys/key
5459 # /cryptoKeyVersions/1
5460 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5461 # key. If absent, the Compute Engine default service account is used.
5462 # For example:
5463 #
5464 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5465 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5466 # encryption key, encoded in RFC
5467 # 4648 base64 to either encrypt or decrypt this resource. You can
5468 # provide either the rawKey or thersaEncryptedKey.
5469 # For example:
5470 #
5471 # &quot;rawKey&quot;:
5472 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5473 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5474 # customer-supplied encryption key to either encrypt or decrypt this
5475 # resource. You can provide either the rawKey or thersaEncryptedKey.
5476 # For example:
5477 #
5478 # &quot;rsaEncryptedKey&quot;:
5479 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5480 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5481 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5482 #
5483 # The key must meet the following requirements before you can provide it to
5484 # Compute Engine:
5485 #
5486 # 1. The key is wrapped using a RSA public key certificate provided by
5487 # Google.
5488 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5489 # encoding.
5490 #
5491 # Gets the RSA public key certificate provided by Google at:
5492 #
5493 #
5494 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5495 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5496 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5497 # encryption key that protects this resource.
5498 },
5499 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
5500 # this as a partial or full URL to the resource. For example, the following
5501 # are valid values:
5502 #
5503 #
5504 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
5505 # - projects/project/zones/zone/storagePools/storagePool
5506 # - zones/zone/storagePools/storagePool
5507 },
5508 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
5509 # either SCSI or NVME. For most machine types, the
5510 # default is SCSI. Local SSDs can use either NVME or SCSI.
5511 # In certain configurations, persistent disks can use NVMe. For more
5512 # information, seeAbout
5513 # persistent disks.
5514 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
5515 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
5516 &quot;A String&quot;,
5517 ],
5518 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
5519 # disk is not allowed to be detached from the instance, or to be used as the
5520 # source of the snapshot creation, and the image creation. The instance with
5521 # at least one locked attached disk is not allow to be used as source of
5522 # machine image creation, instant snapshot creation, and not allowed to be
5523 # deleted with --keep-disk parameter set to true for locked disks.
5524 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
5525 # in READ_WRITE mode.
5526 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
5527 # field is set to PRESERVED if the LocalSSD data has been saved
5528 # to a persistent location by customer request. (see the
5529 # discard_local_ssd option on Stop/Suspend).
5530 # Read-only in the api.
5531 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
5532 # these are public keys which are safe to store in public
5533 &quot;dbs&quot;: [ # The Key Database (db).
5534 {
5535 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5536 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5537 },
5538 ],
5539 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
5540 {
5541 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5542 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5543 },
5544 ],
5545 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
5546 {
5547 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5548 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5549 },
5550 ],
5551 &quot;pk&quot;: { # The Platform Key (PK).
5552 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5553 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5554 },
5555 },
5556 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
5557 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5558 # is required.
5559 #
5560 # If desired, you can also attach existing non-root persistent disks using
5561 # this property. This field is only applicable for persistent disks.
5562 #
5563 # Note that for InstanceTemplate, specify the disk name for zonal disk,
5564 # and the URL for regional disk.
5565 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
5566 },
5567 ],
5568 &quot;displayDevice&quot;: { # A set of Display Device options # Display Device properties to enable support
5569 # for remote display products like: Teradici,
5570 # VNC and TeamViewer
5571 # Note that for MachineImage, this is not supported yet.
5572 &quot;enableDisplay&quot;: True or False, # Defines whether the instance has Display enabled.
5573 },
5574 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
5575 # created from these properties.
5576 { # A specification of the type and number of accelerator cards attached to the
5577 # instance.
5578 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
5579 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
5580 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
5581 # If you are creating an instance template, specify only the
5582 # accelerator name.
5583 # See GPUs on Compute Engine
5584 # for a full list of accelerator types.
5585 },
5586 ],
5587 &quot;identity&quot;: &quot;A String&quot;,
5588 &quot;identityCertificate&quot;: True or False,
5589 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
5590 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
5591 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
5592 &quot;a_key&quot;: &quot;A String&quot;,
5593 },
5594 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
5595 # properties.
5596 # This field only accepts a machine type name, for example `n2-standard-4`.
5597 # If you use the machine type full or partial URL, for example
5598 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
5599 # the request will result in an `INTERNAL_ERROR`.
5600 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
5601 # these properties. These pairs can consist of custom metadata or predefined
5602 # keys. SeeProject and
5603 # instance metadata for more information.
5604 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
5605 # the metadata&#x27;s contents and used for optimistic locking. The
5606 # fingerprint is initially generated by Compute Engine and changes after
5607 # every request to modify or update metadata. You must always provide an
5608 # up-to-date fingerprint hash in order to update or change metadata,
5609 # otherwise the request will fail with error412 conditionNotMet.
5610 #
5611 # To see the latest fingerprint, make a get() request to
5612 # retrieve the resource.
5613 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
5614 # less than 512 KB.
5615 { # Metadata
5616 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
5617 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
5618 # This is reflected as part of a URL in the metadata server. Additionally, to
5619 # avoid ambiguity, keys must not conflict with any other metadata keys
5620 # for the project.
5621 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
5622 # have meaning as interpreted by the image running in the instance. The
5623 # only restriction placed on values is that their size must be less than
5624 # or equal to 262144 bytes (256 KiB).
5625 },
5626 ],
5627 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
5628 # for metadata.
5629 },
5630 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
5631 # scheduled on the specified or newer cpu/platform. Applicable values are the
5632 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
5633 # information, read Specifying a
5634 # Minimum CPU Platform.
5635 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
5636 { # A network interface resource attached to an instance.
5637 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
5638 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
5639 # no external internet access.
5640 { # An access configuration attached to an instance&#x27;s network interface.
5641 # Only one access config per instance is supported.
5642 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
5643 # The first IPv6 address of the external IPv6 range associated
5644 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
5645 # use a static external IP address, it must be unused and in the same region
5646 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
5647 # assign an external IPv6 address from the instance&#x27;s subnetwork.
5648 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
5649 # external IPv6 range.
5650 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
5651 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
5652 # (IPv4), the default and recommended name is External NAT, but
5653 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
5654 # recommend name is External IPv6.
5655 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
5656 # address associated with this instance. Specify an unused static
5657 # external IP address available to the project or leave this field undefined
5658 # to use an IP from a shared ephemeral IP address pool. If you specify a
5659 # static external IP address, it must live in the same region as the zone of
5660 # the instance.
5661 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
5662 # configuration and can only take the following values: PREMIUM,STANDARD.
5663 #
5664 # If an AccessConfig is specified without a valid external IP address, an
5665 # ephemeral IP will be created with this networkTier.
5666 #
5667 # If an AccessConfig with a valid external IP address is specified, it must
5668 # match that of the networkTier associated with the Address resource owning
5669 # that IP.
5670 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
5671 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
5672 #
5673 # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
5674 # first IP in associated external IPv6 range.
5675 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
5676 # config.
5677 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
5678 # external IP address of this access configuration.
5679 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
5680 # external IP address of the instance to a DNS domain name.
5681 #
5682 # This field is not used in ipv6AccessConfig. A default PTR
5683 # record will be created if the VM has external IPv6 range associated.
5684 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
5685 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
5686 },
5687 ],
5688 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
5689 # You can only specify this field for network interfaces in VPC networks.
5690 { # An alias IP range attached to an instance&#x27;s network interface.
5691 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
5692 # must belong to the specified subnetwork and cannot contain IP addresses
5693 # reserved by system or used by other network interfaces. This range may be
5694 # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
5695 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
5696 # alias range. If not specified, the primary range of the subnetwork is used.
5697 },
5698 ],
5699 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
5700 # You can only specify this field for network interfaces in VPC networks.
5701 { # An alias IP range attached to an instance&#x27;s network interface.
5702 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
5703 # must belong to the specified subnetwork and cannot contain IP addresses
5704 # reserved by system or used by other network interfaces. This range may be
5705 # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
5706 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
5707 # alias range. If not specified, the primary range of the subnetwork is used.
5708 },
5709 ],
5710 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
5711 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
5712 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
5713 # with network_attachment.
5714 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
5715 # This field will be ignored when inserting an Instance or
5716 # adding a NetworkInterface. An up-to-date
5717 # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
5718 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
5719 # or not. If enabled, also indicates the version of IGMP supported.
5720 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
5721 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
5722 # one IPv6 access config, DIRECT_IPV6, is supported. If there
5723 # is no ipv6AccessConfig specified, then this instance will
5724 # have no external IPv6 Internet access.
5725 { # An access configuration attached to an instance&#x27;s network interface.
5726 # Only one access config per instance is supported.
5727 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
5728 # The first IPv6 address of the external IPv6 range associated
5729 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
5730 # use a static external IP address, it must be unused and in the same region
5731 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
5732 # assign an external IPv6 address from the instance&#x27;s subnetwork.
5733 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
5734 # external IPv6 range.
5735 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
5736 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
5737 # (IPv4), the default and recommended name is External NAT, but
5738 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
5739 # recommend name is External IPv6.
5740 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
5741 # address associated with this instance. Specify an unused static
5742 # external IP address available to the project or leave this field undefined
5743 # to use an IP from a shared ephemeral IP address pool. If you specify a
5744 # static external IP address, it must live in the same region as the zone of
5745 # the instance.
5746 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
5747 # configuration and can only take the following values: PREMIUM,STANDARD.
5748 #
5749 # If an AccessConfig is specified without a valid external IP address, an
5750 # ephemeral IP will be created with this networkTier.
5751 #
5752 # If an AccessConfig with a valid external IP address is specified, it must
5753 # match that of the networkTier associated with the Address resource owning
5754 # that IP.
5755 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
5756 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
5757 #
5758 # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
5759 # first IP in associated external IPv6 range.
5760 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
5761 # config.
5762 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
5763 # external IP address of this access configuration.
5764 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
5765 # external IP address of the instance to a DNS domain name.
5766 #
5767 # This field is not used in ipv6AccessConfig. A default PTR
5768 # record will be created if the VM has external IPv6 range associated.
5769 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
5770 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
5771 },
5772 ],
5773 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
5774 # accessed from the Internet. This field is always inherited from its
5775 # subnetwork.
5776 #
5777 # Valid only if stackType is IPV4_IPV6.
5778 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
5779 # use a static internal IP address, it must be unused and in the same region
5780 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
5781 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
5782 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
5783 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
5784 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
5785 # server. For a VM, the network interface uses the nicN naming
5786 # format. Where N is a value between 0 and7. The default interface value is nic0.
5787 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
5788 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
5789 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
5790 # instance, if neither the network nor the subnetwork is specified, the
5791 # default network global/networks/default is used. If the
5792 # selected project doesn&#x27;t have the default network, you must specify a
5793 # network or subnet. If the network is not specified but the subnetwork is
5794 # specified, the network is inferred.
5795 #
5796 # If you specify this property, you can specify the network as
5797 # a full or partial URL. For example, the following are all valid URLs:
5798 #
5799 #
5800 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
5801 # - projects/project/global/networks/network
5802 # - global/networks/default
5803 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
5804 # to in the following format:
5805 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
5806 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
5807 # interface. If not specified by the user, an unused internal IP is
5808 # assigned by the system.
5809 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
5810 # VirtioNet.
5811 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
5812 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
5813 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
5814 # if not specified by the users.
5815 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
5816 # interface. Can only be used with network_attachment. It is not possible to
5817 # use on its own however, network_attachment can be used without
5818 # service_class_id.
5819 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
5820 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
5821 #
5822 # This field can be both set at instance creation and update network
5823 # interface operations.
5824 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
5825 # subnetworks that support L2. Every network interface will get a default
5826 # untagged (vlan not specified) subinterface. Users can specify additional
5827 # tagged subinterfaces which are sub-fields to the Network Interface.
5828 {
5829 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
5830 # subinterface. If specified, ip_allocation_mode should be set to
5831 # ALLOCATE_IP.
5832 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
5833 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
5834 # as that of the network interface.
5835 # If not specified the subnet of network interface will be used.
5836 # If you specify this property, you can specify the subnetwork as a full
5837 # or partial URL. For example, the following are all valid URLs:
5838 #
5839 #
5840 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
5841 # - regions/region/subnetworks/subnetwork
5842 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
5843 # this subinterface is connecting.
5844 },
5845 ],
5846 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
5847 # resource is inlegacy
5848 # mode, do not specify this field. If the network is in auto subnet
5849 # mode, specifying the subnetwork is optional. If the network is in custom
5850 # subnet mode, specifying the subnetwork is required. If you specify this
5851 # field, you can specify the subnetwork as a full or partial URL. For
5852 # example, the following are all valid URLs:
5853 #
5854 #
5855 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
5856 # - regions/region/subnetworks/subnetwork
5857 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
5858 # from 2 to 255 inclusively.
5859 },
5860 ],
5861 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
5862 &quot;externalIpEgressBandwidthTier&quot;: &quot;A String&quot;,
5863 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
5864 },
5865 &quot;partnerMetadata&quot;: { # Partner Metadata assigned to the instance properties. A map from a
5866 # subdomain (namespace) to entries map.
5867 &quot;a_key&quot;: {
5868 &quot;entries&quot;: { # Map of a partner metadata that belong to the same subdomain.
5869 # It accepts any value including google.protobuf.Struct.
5870 &quot;a_key&quot;: &quot;&quot;,
5871 },
5872 },
5873 },
5874 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
5875 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
5876 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
5877 # Note that for MachineImage, this is not supported yet.
5878 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
5879 # Note that for MachineImage, this is not supported yet.
5880 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
5881 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
5882 # Consuming reserved instances for examples.
5883 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
5884 # the name of your reservation as its value.
5885 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
5886 # either a name to a reservation in the same project or
5887 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
5888 # shared reservation in the same zone but in a different project.
5889 &quot;A String&quot;,
5890 ],
5891 },
5892 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
5893 # have the same definition as resource
5894 # manager tags. Keys and values can be either in numeric format,
5895 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
5896 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
5897 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
5898 # PATCH) when empty.
5899 &quot;a_key&quot;: &quot;A String&quot;,
5900 },
5901 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
5902 # these properties.
5903 # Note that for MachineImage, this is not supported yet.
5904 &quot;A String&quot;,
5905 ],
5906 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
5907 # these properties.
5908 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
5909 # terminated by Compute Engine (not terminated by a user). You can only set
5910 # the automatic restart option for standard instances.Preemptible instances
5911 # cannot be automatically restarted.
5912 #
5913 # By default, this is set to true so an instance is
5914 # automatically restarted if it is terminated by Compute Engine.
5915 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
5916 # must be a number between 1 and the number of availability domains
5917 # specified in the spread placement policy attached to the instance.
5918 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
5919 # 0 or unset means default vCPUs of the current machine type.
5920 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
5921 # 0 or unset means default amount of memory of the current machine type.
5922 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
5923 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
5924 &quot;maxDuration&quot;: { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
5925 # graceful shutdown isn&#x27;t complete after this time, then the instance
5926 # transitions to the STOPPING state.
5927 # as a count of seconds and fractions of seconds at nanosecond
5928 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5929 # or &quot;month&quot;. Range is approximately 10,000 years.
5930 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5931 # Durations less than one second are represented with a 0
5932 # `seconds` field and a positive `nanos` field. Must be from 0
5933 # to 999,999,999 inclusive.
5934 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5935 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5936 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5937 },
5938 },
5939 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
5940 # within the range of [90, 330] with the increment of 30, if unset, the
5941 # default behavior of host error recovery will be used.
5942 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
5943 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
5944 # only be set during instance creation, or when the instance is not currently
5945 # running. It must not be set if thepreemptible option is
5946 # also set.
5947 &quot;localSsdRecoveryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
5948 # recovery of the Local Ssd state is attempted. Its value should be in
5949 # between 0 and 168 hours with hour granularity and the default value being 1
5950 # hour.
5951 # as a count of seconds and fractions of seconds at nanosecond
5952 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5953 # or &quot;month&quot;. Range is approximately 10,000 years.
5954 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5955 # Durations less than one second are represented with a 0
5956 # `seconds` field and a positive `nanos` field. Must be from 0
5957 # to 999,999,999 inclusive.
5958 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5959 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5960 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5961 },
5962 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
5963 # resources.
5964 # This field is for use by internal tools that use the public API.
5965 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
5966 # be scheduled for maintenance.
5967 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
5968 # are: `PERIODIC`.
5969 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
5970 # the instance termination action will be performed at the end of the run
5971 # duration.
5972 # as a count of seconds and fractions of seconds at nanosecond
5973 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5974 # or &quot;month&quot;. Range is approximately 10,000 years.
5975 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5976 # Durations less than one second are represented with a 0
5977 # `seconds` field and a positive `nanos` field. Must be from 0
5978 # to 999,999,999 inclusive.
5979 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5980 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5981 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5982 },
5983 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
5984 # on a sole-tenant node.
5985 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
5986 # affinity for more information.
5987 # Overrides reservationAffinity.
5988 { # Node Affinity: the configuration of desired nodes onto which this Instance
5989 # could be scheduled.
5990 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
5991 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
5992 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
5993 &quot;A String&quot;,
5994 ],
5995 },
5996 ],
5997 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
5998 # the default behavior is MIGRATE. Forpreemptible instances,
5999 # the default and only possible behavior is TERMINATE. For more
6000 # information, see
6001 # Set
6002 # VM host maintenance policy.
6003 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
6004 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
6005 # else, the Local SSD data will be preserved when the instance is stopped
6006 # at the end of the run duration/termination time.
6007 },
6008 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
6009 # instance creation or while the instance isstopped and
6010 # therefore, in a `TERMINATED` state. SeeInstance Life
6011 # Cycle for more information on the possible instance states.
6012 &quot;preemptionNoticeDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2 Soft
6013 # Off signal is triggered for Spot
6014 # VMs only. If not specified, there will be no wait before the G2 Soft
6015 # Off signal is triggered.
6016 # as a count of seconds and fractions of seconds at nanosecond
6017 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6018 # or &quot;month&quot;. Range is approximately 10,000 years.
6019 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6020 # Durations less than one second are represented with a 0
6021 # `seconds` field and a positive `nanos` field. Must be from 0
6022 # to 999,999,999 inclusive.
6023 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6024 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6025 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6026 },
6027 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
6028 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
6029 # Timeout between GCE ACPI G2 Soft
6030 # Off and ACPI G3 Mechanical
6031 # Off during shutdown operation of VM.
6032 #
6033 # For Standard VMs values between 0s and 120s are allowed. For Spot and
6034 # Preemptible VMs supported values are between 0s and 30s.
6035 #
6036 # If no value is specified for shutdownDuration, default values are 90s for
6037 # Standard VMs and 30s for Spot/Preemptible VMs.
6038 # as a count of seconds and fractions of seconds at nanosecond
6039 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6040 # or &quot;month&quot;. Range is approximately 10,000 years.
6041 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6042 # Durations less than one second are represented with a 0
6043 # `seconds` field and a positive `nanos` field. Must be from 0
6044 # to 999,999,999 inclusive.
6045 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6046 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6047 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6048 },
6049 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
6050 # Off and ACPI G3 Mechanical
6051 # Off for Standard VMs and 30 seconds for Spot VMs.
6052 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
6053 # termination action will be performed at the termination time.
6054 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
6055 &quot;mode&quot;: &quot;A String&quot;,
6056 },
6057 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
6058 # unspecified, the default mode is `OFF`.
6059 },
6060 &quot;secureTags&quot;: [ # [Input Only] Secure tags to apply to this instance.
6061 # Maximum number of secure tags allowed is 50.
6062 # Note that for MachineImage, this is not supported yet.
6063 &quot;A String&quot;,
6064 ],
6065 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
6066 # service accounts are available to the instances that are created from
6067 # these properties. Use metadata queries to obtain the access tokens for
6068 # these instances.
6069 { # A service account.
6070 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
6071 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
6072 &quot;A String&quot;,
6073 ],
6074 },
6075 ],
6076 &quot;serviceIntegrationSpecs&quot;: { # Mapping of user defined keys to ServiceIntegrationSpec.
6077 &quot;a_key&quot;: { # Specifies the parameters to configure an integration with instances.
6078 &quot;backupDr&quot;: { # Specifies parameters to Backup and DR to attach a BackupPlan to a compute
6079 # instance for managed VM backup.
6080 &quot;plan&quot;: &quot;A String&quot;, # The BackupPlan resource to attach to the instance. Specified as a
6081 # resource reference in instances, and regional instance templates, and as
6082 # just the plan name in global instance templates
6083 },
6084 },
6085 },
6086 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
6087 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
6088 # default.
6089 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
6090 # default.
6091 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
6092 # default.
6093 },
6094 &quot;shieldedVmConfig&quot;: { # A set of Shielded VM options. # Specifies the Shielded VM options for the instances that are created from
6095 # these properties.
6096 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.
6097 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.
6098 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.
6099 },
6100 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
6101 # properties. The tags identify valid sources or targets for network
6102 # firewalls. The setTags method can modify this list of tags. Each tag within
6103 # the list must comply with RFC1035.
6104 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
6105 # the tags&#x27; contents and used for optimistic locking. The
6106 # fingerprint is initially generated by Compute Engine and changes after
6107 # every request to modify or update tags. You must always provide an
6108 # up-to-date fingerprint hash in order to update or change tags.
6109 #
6110 # To see the latest fingerprint, make get() request to the
6111 # instance.
6112 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
6113 # with RFC1035.
6114 &quot;A String&quot;,
6115 ],
6116 },
6117 &quot;workloadIdentityConfig&quot;: {
6118 &quot;identity&quot;: &quot;A String&quot;,
6119 &quot;identityCertificateEnabled&quot;: True or False,
6120 },
6121 },
6122 &quot;locationPolicy&quot;: { # Configuration for location policy among multiple possible locations # Policy for choosing target zone. For more information, seeCreate VMs in
6123 # bulk.
6124 # (e.g. preferences for zone selection among zones in a single region).
6125 &quot;locations&quot;: { # Location configurations mapped by location name.
6126 # Currently only zone names are supported and must be represented as valid
6127 # internal URLs, such as zones/us-central1-a.
6128 # The bulkInsert operation doesn&#x27;t create instances in an AI zone, even if
6129 # an AI zone is available in the specified region. For example, if you set a
6130 # DENY preference for us-central1-a, Compute Engine will consider
6131 # us-central1-b and us-central1-c for instance creation, but not
6132 # us-central1-ai1a. Also, you can&#x27;t use the locations[] configuration to
6133 # allow instance creation in an AI zone. To include an AI zone in bulkInsert
6134 # operations, use the locationPolicy.zones[] field.
6135 &quot;a_key&quot;: {
6136 &quot;constraints&quot;: { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution
6137 # in this zone.
6138 &quot;maxCount&quot;: 42, # Maximum number of items that are allowed to be placed in this zone.
6139 # The value must be non-negative.
6140 },
6141 &quot;names&quot;: [ # Names of resources to be put in the location.
6142 # Must contain unique, correct resource names.
6143 # If used, targetShape must be left unset.
6144 &quot;A String&quot;,
6145 ],
6146 &quot;preference&quot;: &quot;A String&quot;, # Preference for a given location. Set to either ALLOW orDENY.
6147 },
6148 },
6149 &quot;targetShape&quot;: &quot;A String&quot;, # Strategy for distributing VMs across zones in a region.
6150 &quot;zones&quot;: [ # The bulkInsert operation applies any preferences set in the locations
6151 # field to the specific zones listed in the zones field if the same zones
6152 # are specified in both fields.
6153 {
6154 &quot;zone&quot;: &quot;A String&quot;, # The URL of the zone.
6155 # The zone must exist in the region where the request is called.
6156 # Zones must be represented as valid partial URLs,
6157 # such as zones/us-central1-a.
6158 },
6159 ],
6160 },
6161 &quot;minCount&quot;: &quot;A String&quot;, # The minimum number of instances to create. If no min_count is
6162 # specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will
6163 # be created and instances already created will be deleted.
6164 &quot;namePattern&quot;: &quot;A String&quot;, # The string pattern used for the names of the VMs.
6165 # Either name_pattern or per_instance_properties
6166 # must be set. The pattern must contain one continuous sequence of
6167 # placeholder hash characters (#) with each character corresponding to one
6168 # digit of the generated instance name. Example: a name_pattern
6169 # of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances
6170 # in the same project and zone have names that match the name pattern
6171 # then the generated instance numbers start after the biggest
6172 # existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern
6173 # placeholder #...# can contain up to 18 characters.
6174 &quot;perInstanceProperties&quot;: { # Per-instance properties to be set on individual instances.
6175 # Keys of this map specify requested instance names.
6176 # Can be empty if name_pattern is used.
6177 &quot;a_key&quot;: { # Per-instance properties to be set on individual instances.
6178 # To be extended in the future.
6179 &quot;hostname&quot;: &quot;A String&quot;, # Specifies the hostname of the instance. More details in:
6180 # https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention
6181 &quot;name&quot;: &quot;A String&quot;, # Output only. This field is only temporary. It will be removed. Do not use it.
6182 },
6183 },
6184 &quot;sourceInstanceTemplate&quot;: &quot;A String&quot;, # Specifies the instance template from which to create instances. You may
6185 # combine sourceInstanceTemplate withinstanceProperties to override specific values from an
6186 # existing instance template. Bulk API follows the semantics of JSON Merge
6187 # Patch described by RFC
6188 # 7396.
6189 #
6190 # It can be a full or partial URL. For example, the following are
6191 # all valid URLs to an instance template:
6192 #
6193 #
6194 # - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
6195 # - projects/project/global/instanceTemplates/instanceTemplate
6196 # - global/instanceTemplates/instanceTemplate
6197 #
6198 #
6199 #
6200 # This field is optional.
6201 },
6202 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp in RFC3339
6203 # text format.
6204 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
6205 # create the resource.
6206 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
6207 # defined by the server.
6208 &quot;kind&quot;: &quot;compute#queuedResource&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#queuedResource for QueuedResources.
6209 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
6210 # The name must be 1-63 characters long, and comply withRFC1035.
6211 # Specifically, the name must be 1-63 characters long and match the regular
6212 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character
6213 # must be a lowercase letter, and all following characters must be a dash,
6214 # lowercase letter, or digit, except the last character, which cannot be a
6215 # dash.
6216 &quot;queuingPolicy&quot;: { # Queuing parameters for the requested deferred capacity. # Queuing parameters for the requested capacity.
6217 &quot;validUntilDuration&quot;: { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity.
6218 # as a count of seconds and fractions of seconds at nanosecond
6219 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6220 # or &quot;month&quot;. Range is approximately 10,000 years.
6221 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6222 # Durations less than one second are represented with a 0
6223 # `seconds` field and a positive `nanos` field. Must be from 0
6224 # to 999,999,999 inclusive.
6225 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6226 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6227 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6228 },
6229 &quot;validUntilTime&quot;: &quot;A String&quot;, # Absolute deadline for waiting for capacity inRFC3339
6230 # text format.
6231 },
6232 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output only] Server-defined URL for the resource.
6233 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
6234 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output only] High-level status of the request.
6235 &quot;status&quot;: { # [Output only] Result of queuing and provisioning based on deferred # Output only. [Output only] Result of queuing and provisioning based on deferred
6236 # capacity.
6237 # capacity.
6238 &quot;failedData&quot;: { # Additional status detail for the FAILED state. # Output only. Additional status detail for the FAILED state.
6239 &quot;error&quot;: { # The error(s) that caused the QueuedResource to enter the FAILED state.
6240 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6241 # operation.
6242 {
6243 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6244 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6245 # details. There is a set of defined message types to use for providing
6246 # details.The syntax depends on the error code. For example,
6247 # QuotaExceededInfo will have details when the error code is
6248 # QUOTA_EXCEEDED.
6249 {
6250 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6251 #
6252 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6253 # is not enabled:
6254 #
6255 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6256 # &quot;domain&quot;: &quot;googleapis.com&quot;
6257 # &quot;metadata&quot;: {
6258 # &quot;resource&quot;: &quot;projects/123&quot;,
6259 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6260 # }
6261 # }
6262 #
6263 # This response indicates that the pubsub.googleapis.com API is not enabled.
6264 #
6265 # Example of an error that is returned when attempting to create a Spanner
6266 # instance in a region that is out of stock:
6267 #
6268 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6269 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6270 # &quot;metadata&quot;: {
6271 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6272 # }
6273 # }
6274 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6275 # is typically the registered service name of the tool or product that
6276 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6277 # generated by some common infrastructure, the error domain must be a
6278 # globally unique value that identifies the infrastructure. For Google API
6279 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6280 &quot;metadatas&quot;: { # Additional structured details about this error.
6281 #
6282 # Keys must match a regular expression of `a-z+` but should
6283 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6284 # length. When identifying the current value of an exceeded limit, the units
6285 # should be contained in the key, not the value. For example, rather than
6286 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6287 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6288 # instances that can be created in a single (batch) request.
6289 &quot;a_key&quot;: &quot;A String&quot;,
6290 },
6291 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6292 # proximate cause of the error. Error reasons are unique within a particular
6293 # domain of errors. This should be at most 63 characters and match a
6294 # regular expression of `A-Z+[A-Z0-9]`, which represents
6295 # UPPER_SNAKE_CASE.
6296 },
6297 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6298 #
6299 # For example, if a quota check failed with an error indicating the calling
6300 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6301 # directly to the right place in the developer console to flip the bit.
6302 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6303 { # Describes a URL link.
6304 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6305 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6306 },
6307 ],
6308 },
6309 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6310 # which can be attached to an RPC error.
6311 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6312 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6313 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6314 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6315 },
6316 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6317 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6318 &quot;a_key&quot;: &quot;A String&quot;,
6319 },
6320 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6321 # type or metric.
6322 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6323 # or metric.
6324 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6325 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6326 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6327 },
6328 },
6329 ],
6330 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6331 # This property is optional.
6332 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6333 },
6334 ],
6335 },
6336 },
6337 &quot;provisioningOperations&quot;: [ # Output only. [Output only] Fully qualified URL of the provisioning GCE operation to
6338 # track the provisioning along with provisioning errors. The referenced
6339 # operation may not exist after having been deleted or expired.
6340 &quot;A String&quot;,
6341 ],
6342 &quot;queuingPolicy&quot;: { # Queuing parameters for the requested deferred capacity. # Output only. Constraints for the time when the resource(s) start provisioning. Always
6343 # exposed as absolute times.
6344 &quot;validUntilDuration&quot;: { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity.
6345 # as a count of seconds and fractions of seconds at nanosecond
6346 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6347 # or &quot;month&quot;. Range is approximately 10,000 years.
6348 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6349 # Durations less than one second are represented with a 0
6350 # `seconds` field and a positive `nanos` field. Must be from 0
6351 # to 999,999,999 inclusive.
6352 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6353 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6354 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6355 },
6356 &quot;validUntilTime&quot;: &quot;A String&quot;, # Absolute deadline for waiting for capacity inRFC3339
6357 # text format.
6358 },
6359 },
6360 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the resource resides. Only applicable
6361 # for zonal resources. You must specify this field as part of the HTTP
6362 # request URL. It is not settable as a field in the request body.
6363 }
6364
6365 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6366 that if you must retry your request, the server will know to ignore the
6367 request if it has already been completed.
6368
6369 For example, consider a situation where you make an initial request and
6370 the request times out. If you make the request again with the same
6371 request ID, the server can check if original operation with the same
6372 request ID was received, and if so, will ignore the second request. This
6373 prevents clients from accidentally creating duplicate commitments.
6374
6375 The request ID must be a valid UUID with
6376 the exception that zero UUID is not supported
6377 (00000000-0000-0000-0000-000000000000).
6378 x__xgafv: string, V1 error format.
6379 Allowed values
6380 1 - v1 error format
6381 2 - v2 error format
6382
6383 Returns:
6384 An object of the form:
6385
6386 { # Represents an Operation resource.
6387 #
6388 # Google Compute Engine has three Operation resources:
6389 #
6390 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
6391 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
6392 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
6393 #
6394 # You can use an operation resource to manage asynchronous API requests.
6395 # For more information, readHandling
6396 # API responses.
6397 #
6398 # Operations can be global, regional or zonal.
6399 #
6400 # - For global operations, use the `globalOperations`
6401 # resource.
6402 # - For regional operations, use the
6403 # `regionOperations` resource.
6404 # - For zonal operations, use
6405 # the `zoneOperations` resource.
6406 #
6407 #
6408 #
6409 # For more information, read
6410 # Global, Regional, and Zonal Resources.
6411 #
6412 # Note that completed Operation resources have a limited
6413 # retention period.
6414 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6415 # Not present otherwise.
6416 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6417 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6418 # set when the operation is created.
6419 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6420 # text format.
6421 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6422 # this field will be populated.
6423 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6424 # operation.
6425 {
6426 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6427 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6428 # details. There is a set of defined message types to use for providing
6429 # details.The syntax depends on the error code. For example,
6430 # QuotaExceededInfo will have details when the error code is
6431 # QUOTA_EXCEEDED.
6432 {
6433 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6434 #
6435 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6436 # is not enabled:
6437 #
6438 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6439 # &quot;domain&quot;: &quot;googleapis.com&quot;
6440 # &quot;metadata&quot;: {
6441 # &quot;resource&quot;: &quot;projects/123&quot;,
6442 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6443 # }
6444 # }
6445 #
6446 # This response indicates that the pubsub.googleapis.com API is not enabled.
6447 #
6448 # Example of an error that is returned when attempting to create a Spanner
6449 # instance in a region that is out of stock:
6450 #
6451 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6452 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6453 # &quot;metadata&quot;: {
6454 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6455 # }
6456 # }
6457 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6458 # is typically the registered service name of the tool or product that
6459 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6460 # generated by some common infrastructure, the error domain must be a
6461 # globally unique value that identifies the infrastructure. For Google API
6462 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6463 &quot;metadatas&quot;: { # Additional structured details about this error.
6464 #
6465 # Keys must match a regular expression of `a-z+` but should
6466 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6467 # length. When identifying the current value of an exceeded limit, the units
6468 # should be contained in the key, not the value. For example, rather than
6469 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6470 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6471 # instances that can be created in a single (batch) request.
6472 &quot;a_key&quot;: &quot;A String&quot;,
6473 },
6474 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6475 # proximate cause of the error. Error reasons are unique within a particular
6476 # domain of errors. This should be at most 63 characters and match a
6477 # regular expression of `A-Z+[A-Z0-9]`, which represents
6478 # UPPER_SNAKE_CASE.
6479 },
6480 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6481 #
6482 # For example, if a quota check failed with an error indicating the calling
6483 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6484 # directly to the right place in the developer console to flip the bit.
6485 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6486 { # Describes a URL link.
6487 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6488 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6489 },
6490 ],
6491 },
6492 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6493 # which can be attached to an RPC error.
6494 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6495 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6496 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6497 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6498 },
6499 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6500 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6501 &quot;a_key&quot;: &quot;A String&quot;,
6502 },
6503 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6504 # type or metric.
6505 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6506 # or metric.
6507 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6508 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6509 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6510 },
6511 },
6512 ],
6513 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6514 # This property is optional.
6515 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6516 },
6517 ],
6518 },
6519 &quot;getVersionOperationMetadata&quot;: {
6520 &quot;inlineSbomInfo&quot;: {
6521 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6522 # appropriate identifiers.
6523 &quot;a_key&quot;: &quot;A String&quot;,
6524 },
6525 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6526 # identifiers.
6527 &quot;a_key&quot;: &quot;A String&quot;,
6528 },
6529 },
6530 },
6531 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6532 # message that was returned, such as `NOT FOUND`.
6533 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6534 # status code that was returned. For example, a `404` means the
6535 # resource was not found.
6536 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6537 # defined by the server.
6538 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6539 # This value is inRFC3339
6540 # text format.
6541 &quot;instancesBulkInsertOperationMetadata&quot;: {
6542 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6543 # Example key: zones/us-central1-a
6544 &quot;a_key&quot;: {
6545 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6546 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6547 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6548 # error.
6549 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6550 # if the flow is rolling forward or rolling back.
6551 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6552 },
6553 },
6554 },
6555 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6556 # Operation resources.
6557 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6558 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6559 # group of operations results from a `bulkInsert` API request.
6560 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6561 # `update`, or `delete`, and so on.
6562 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6563 # There is no requirement that this be linear or support any granularity of
6564 # operations. This should not be used to guess when the operation will be
6565 # complete. This number should monotonically increase as the operation
6566 # progresses.
6567 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6568 # applicable when performing regional operations.
6569 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6570 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
6571 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6572 # this field will contain information on all underlying zonal actions and
6573 # their state.
6574 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6575 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6576 # Example key: zones/us-central1-a
6577 &quot;a_key&quot;: {
6578 &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
6579 # populated.
6580 # different programming environments, including REST APIs and RPC APIs. It is
6581 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6582 # three pieces of data: error code, error message, and error details.
6583 #
6584 # You can find out more about this error model and how to work with it in the
6585 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6586 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6587 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6588 # message types for APIs to use.
6589 {
6590 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6591 },
6592 ],
6593 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6594 # user-facing error message should be localized and sent in the
6595 # google.rpc.Status.details field, or localized by the client.
6596 },
6597 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6598 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6599 },
6600 },
6601 },
6602 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6603 # This value is inRFC3339
6604 # text format.
6605 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6606 # following:
6607 # `PENDING`, `RUNNING`, or `DONE`.
6608 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6609 # operation.
6610 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6611 # of the target resource.
6612 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6613 # operations related to creating a snapshot, this points to the disk
6614 # that the snapshot was created from.
6615 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6616 # `[email protected]` or
6617 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6618 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6619 # operation, this field will be populated.
6620 {
6621 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6622 # Engine returns NO_RESULTS_ON_PAGE if there
6623 # are no results in the response.
6624 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6625 # value format. For example:
6626 #
6627 # &quot;data&quot;: [
6628 # {
6629 # &quot;key&quot;: &quot;scope&quot;,
6630 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6631 # }
6632 {
6633 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6634 # returned. For example, for warnings where there are no results in a list
6635 # request for a particular zone, this key might be scope and
6636 # the key value might be the zone name. Other examples might be a key
6637 # indicating a deprecated resource and a suggested replacement, or a
6638 # warning about invalid network settings (for example, if an instance
6639 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6640 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6641 },
6642 ],
6643 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6644 },
6645 ],
6646 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6647 # applicable when performing per-zone operations.
6648 }</pre>
6649 </div>
6650
6651 <div class="method">
6652 <code class="details" id="list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
6653 <pre>Retrieves the list of QueuedResource resources.
6654
6655 Args:
6656 project: string, Project ID for this request. (required)
6657 zone: string, Name of the zone for this request. (required)
6658 filter: string, A filter expression that filters resources listed in the response. Most
6659 Compute resources support two types of filter expressions:
6660 expressions that support regular expressions and expressions that follow
6661 API improvement proposal AIP-160.
6662 These two types of filter expressions cannot be mixed in one request.
6663
6664 If you want to use AIP-160, your expression must specify the field name, an
6665 operator, and the value that you want to use for filtering. The value
6666 must be a string, a number, or a boolean. The operator
6667 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
6668
6669 For example, if you are filtering Compute Engine instances, you can
6670 exclude instances named `example-instance` by specifying
6671 `name != example-instance`.
6672
6673 The `:*` comparison can be used to test whether a key has been defined.
6674 For example, to find all objects with `owner` label use:
6675 ```
6676 labels.owner:*
6677 ```
6678
6679 You can also filter nested fields. For example, you could specify
6680 `scheduling.automaticRestart = false` to include instances only
6681 if they are not scheduled for automatic restarts. You can use filtering
6682 on nested fields to filter based onresource labels.
6683
6684 To filter on multiple expressions, provide each separate expression within
6685 parentheses. For example:
6686 ```
6687 (scheduling.automaticRestart = true)
6688 (cpuPlatform = &quot;Intel Skylake&quot;)
6689 ```
6690 By default, each expression is an `AND` expression. However, you
6691 can include `AND` and `OR` expressions explicitly.
6692 For example:
6693 ```
6694 (cpuPlatform = &quot;Intel Skylake&quot;) OR
6695 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
6696 (scheduling.automaticRestart = true)
6697 ```
6698
6699 If you want to use a regular expression, use the `eq` (equal) or `ne`
6700 (not equal) operator against a single un-parenthesized expression with or
6701 without quotes or against multiple parenthesized expressions. Examples:
6702
6703 `fieldname eq unquoted literal`
6704 `fieldname eq &#x27;single quoted literal&#x27;`
6705 `fieldname eq &quot;double quoted literal&quot;`
6706 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
6707
6708 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
6709 The literal value must match the entire field.
6710
6711 For example, to filter for instances that do not end with name &quot;instance&quot;,
6712 you would use `name ne .*instance`.
6713
6714 You cannot combine constraints on multiple fields using regular
6715 expressions.
6716 maxResults: integer, The maximum number of results per page that should be returned.
6717 If the number of available results is larger than `maxResults`,
6718 Compute Engine returns a `nextPageToken` that can be used to get
6719 the next page of results in subsequent list requests. Acceptable values are
6720 `0` to `500`, inclusive. (Default: `500`)
6721 orderBy: string, Sorts list results by a certain order. By default, results
6722 are returned in alphanumerical order based on the resource name.
6723
6724 You can also sort results in descending order based on the creation
6725 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
6726 results based on the `creationTimestamp` field in
6727 reverse chronological order (newest result first). Use this to sort
6728 resources like operations so that the newest operation is returned first.
6729
6730 Currently, only sorting by `name` or
6731 `creationTimestamp desc` is supported.
6732 pageToken: string, Specifies a page token to use. Set `pageToken` to the
6733 `nextPageToken` returned by a previous list request to get
6734 the next page of results.
6735 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
6736 of failure. The default value is false.
6737
6738 For example, when partial success behavior is enabled, aggregatedList for a
6739 single zone scope either returns all resources in the zone or no resources,
6740 with an error code.
6741 x__xgafv: string, V1 error format.
6742 Allowed values
6743 1 - v1 error format
6744 2 - v2 error format
6745
6746 Returns:
6747 An object of the form:
6748
6749 {
6750 &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server.
6751 &quot;items&quot;: [ # A list of QueuedResource resources.
6752 { # QueuedResource represents a request for future capacity. The capacity is
6753 # delivered in the form of other GCE resources, either Instances or
6754 # Reservations.
6755 &quot;bulkInsertInstanceResource&quot;: { # A transient resource used in compute.instances.bulkInsert and # Specification of VM instances to create.
6756 # compute.regionInstances.bulkInsert . This resource is not persisted
6757 # anywhere, it is used only for processing the requests.
6758 &quot;count&quot;: &quot;A String&quot;, # The maximum number of instances to create.
6759 &quot;instanceFlexibilityPolicy&quot;: { # A flexible specification of machine types for instances to create. # A flexible specification of machine type of instances to create.
6760 &quot;instanceSelections&quot;: { # Specification of alternative, flexible instance subsets.
6761 # One of them will be selected to create the instances
6762 # based on various criteria, like:
6763 # - ranks,
6764 # - location policy,
6765 # - current capacity,
6766 # - available reservations (you can specify affinity in
6767 # InstanceProperties),
6768 # - SWAN/GOOSE limitations.
6769 # Key is an arbitrary, unique RFC1035 string that identifies the instance
6770 # selection.
6771 &quot;a_key&quot;: { # Specification of machine type to use. Every position inside this message
6772 # is an alternative.
6773 # The count specified in the shape flexibility must not exceed the number
6774 # of entries in per_instance_properties or the capacity of the
6775 # name_pattern, if used.
6776 &quot;disks&quot;: [ # Disks to be attached to the instances created from in this selection.
6777 # They override the disks specified in the instance properties.
6778 { # An instance-attached disk resource.
6779 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
6780 # or X86_64.
6781 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
6782 # deleted (but not when the disk is detached from the instance).
6783 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
6784 # partition of the disk for its root filesystem.
6785 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
6786 # running within the instance. This name can be used to reference the device
6787 # for mounting, resizing, and so on, from within the instance.
6788 #
6789 # If not specified, the server chooses a default device name to apply to this
6790 # disk, in the form persistent-disk-x, where x is a number
6791 # assigned by Google Compute Engine. This field is only applicable for
6792 # persistent disks.
6793 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
6794 # encryption key.
6795 #
6796 # If you are creating a new disk, this field encrypts the new disk using
6797 # an encryption key that you provide. If you are attaching an existing
6798 # disk that is already encrypted, this field decrypts the disk using
6799 # the customer-supplied encryption key.
6800 #
6801 # If you encrypt a disk using a customer-supplied key, you must provide the
6802 # same key again when you attempt to use this resource at a later time. For
6803 # example, you must provide the key when you create a snapshot or an image
6804 # from the disk or when you attach the disk to a virtual machine instance.
6805 #
6806 # If you do not provide an encryption key, then the disk will be encrypted
6807 # using an automatically generated key and you do not need to provide a key
6808 # to use the disk later.
6809 #
6810 # Note:
6811 #
6812 # Instance templates do not storecustomer-supplied
6813 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
6814 #
6815 # You cannot create VMs that have disks with customer-supplied keys using
6816 # the bulk
6817 # insert method.
6818 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
6819 # For example:
6820 #
6821 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6822 # key_region/cryptoKeys/key
6823 #
6824 # The fully-qualifed key name may be returned for resource GET requests. For
6825 # example:
6826 #
6827 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6828 # key_region/cryptoKeys/key
6829 # /cryptoKeyVersions/1
6830 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
6831 # key. If absent, the Compute Engine default service account is used.
6832 # For example:
6833 #
6834 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
6835 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
6836 # encryption key, encoded in RFC
6837 # 4648 base64 to either encrypt or decrypt this resource. You can
6838 # provide either the rawKey or thersaEncryptedKey.
6839 # For example:
6840 #
6841 # &quot;rawKey&quot;:
6842 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
6843 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
6844 # customer-supplied encryption key to either encrypt or decrypt this
6845 # resource. You can provide either the rawKey or thersaEncryptedKey.
6846 # For example:
6847 #
6848 # &quot;rsaEncryptedKey&quot;:
6849 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
6850 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
6851 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
6852 #
6853 # The key must meet the following requirements before you can provide it to
6854 # Compute Engine:
6855 #
6856 # 1. The key is wrapped using a RSA public key certificate provided by
6857 # Google.
6858 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
6859 # encoding.
6860 #
6861 # Gets the RSA public key certificate provided by Google at:
6862 #
6863 #
6864 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
6865 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
6866 # 4648 base64 encoded SHA-256 hash of the customer-supplied
6867 # encryption key that protects this resource.
6868 },
6869 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
6870 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
6871 # currently attached to another instance. If you try to force attach a zonal
6872 # disk to an instance, you will receive an error.
6873 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
6874 # only for bootable images. Read
6875 # Enabling guest operating system features to see a list of available
6876 # options.
6877 { # Guest OS features.
6878 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
6879 # separate values. Set to one or more of the following values:
6880 #
6881 # - VIRTIO_SCSI_MULTIQUEUE
6882 # - WINDOWS
6883 # - MULTI_IP_SUBNET
6884 # - UEFI_COMPATIBLE
6885 # - GVNIC
6886 # - SEV_CAPABLE
6887 # - SUSPEND_RESUME_COMPATIBLE
6888 # - SEV_LIVE_MIGRATABLE_V2
6889 # - SEV_SNP_CAPABLE
6890 # - TDX_CAPABLE
6891 # - IDPF
6892 # - SNP_SVSM_CAPABLE
6893 # - CCA_CAPABLE
6894 #
6895 #
6896 # For more information, see
6897 # Enabling guest operating system features.
6898 },
6899 ],
6900 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
6901 # boot disk. If you have many disks attached to an instance, each
6902 # disk would have a unique index number.
6903 &quot;initializeParams&quot;: { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
6904 # alongside the new instance. Use initialization parameters to create boot
6905 # disks or local SSDs attached to the new instance.
6906 #
6907 # This property is mutually exclusive with the source property;
6908 # you can only define one or the other, but not both.
6909 # alongside the new instance. Use initialization parameters to create boot
6910 # disks or local SSDs attached to the new instance.
6911 #
6912 # This field is persisted and returned for instanceTemplate and not returned
6913 # in the context of instance.
6914 #
6915 # This property is mutually exclusive with the source property;
6916 # you can only define one or the other, but not both.
6917 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
6918 # arm64 or x86_64.
6919 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
6920 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
6921 # of the instance. If a disk with the same name already exists in the given
6922 # region, the existing disk is attached to the new instance and the
6923 # new disk is not created.
6924 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
6925 # 10 GB. If you specify a sourceImage, which is required for
6926 # boot disks, the default size is the size of the sourceImage.
6927 # If you do not specify a sourceImage, the default disk size
6928 # is 500 GB.
6929 &quot;diskType&quot;: &quot;A String&quot;,
6930 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
6931 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
6932 # only for bootable images. Read
6933 # Enabling guest operating system features to see a list of available
6934 # options.
6935 #
6936 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
6937 { # Guest OS features.
6938 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
6939 # separate values. Set to one or more of the following values:
6940 #
6941 # - VIRTIO_SCSI_MULTIQUEUE
6942 # - WINDOWS
6943 # - MULTI_IP_SUBNET
6944 # - UEFI_COMPATIBLE
6945 # - GVNIC
6946 # - SEV_CAPABLE
6947 # - SUSPEND_RESUME_COMPATIBLE
6948 # - SEV_LIVE_MIGRATABLE_V2
6949 # - SEV_SNP_CAPABLE
6950 # - TDX_CAPABLE
6951 # - IDPF
6952 # - SNP_SVSM_CAPABLE
6953 # - CCA_CAPABLE
6954 #
6955 #
6956 # For more information, see
6957 # Enabling guest operating system features.
6958 },
6959 ],
6960 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
6961 # which is either SCSI or NVME. The default isSCSI.
6962 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
6963 # persistent disks.
6964 &quot;a_key&quot;: &quot;A String&quot;,
6965 },
6966 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
6967 # disk.
6968 &quot;A String&quot;,
6969 ],
6970 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
6971 &quot;A String&quot;,
6972 ],
6973 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
6974 # more than one instance.
6975 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
6976 # is to use the existing disk.
6977 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
6978 # of I/O operations per second that the disk can handle. Values must be
6979 # between 10,000 and 120,000. For more details, see theExtreme persistent
6980 # disk documentation.
6981 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
6982 # number of throughput mb per second that the disk can handle. Values must
6983 # greater than or equal to 1.
6984 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
6985 # the URLs of the zones where the disk should be replicated to.
6986 # You must provide exactly two replica zones, and one zone must be the same
6987 # as the instance zone.
6988 &quot;A String&quot;,
6989 ],
6990 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
6991 # have the same definition as resource
6992 # manager tags. Keys and values can be either in numeric format,
6993 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
6994 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
6995 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
6996 # empty.
6997 &quot;a_key&quot;: &quot;A String&quot;,
6998 },
6999 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
7000 # Specified using the full or partial URL. For instance template, specify
7001 # only the resource policy name.
7002 &quot;A String&quot;,
7003 ],
7004 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
7005 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7006 # is required.
7007 #
7008 # To create a disk with one of the public operating system
7009 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
7010 #
7011 # projects/debian-cloud/global/images/family/debian-9
7012 #
7013 #
7014 # Alternatively, use a specific version of a public operating system image:
7015 #
7016 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
7017 #
7018 #
7019 # To create a disk with a custom image that you created, specify the
7020 # image name in the following format:
7021 #
7022 # global/images/my-custom-image
7023 #
7024 #
7025 # You can also specify a custom image by its image family, which returns
7026 # the latest version of the image in that family. Replace the image name
7027 # with family/family-name:
7028 #
7029 # global/images/family/my-image-family
7030 #
7031 #
7032 # If the source image is deleted later, this field will not be set.
7033 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
7034 # encryption key of the source image. Required if the source image is
7035 # protected by a customer-supplied encryption key.
7036 #
7037 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
7038 # encryption keys, so you cannot create disks for instances in a managed instance group if the
7039 # source images are encrypted with your own keys.
7040 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7041 # For example:
7042 #
7043 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7044 # key_region/cryptoKeys/key
7045 #
7046 # The fully-qualifed key name may be returned for resource GET requests. For
7047 # example:
7048 #
7049 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7050 # key_region/cryptoKeys/key
7051 # /cryptoKeyVersions/1
7052 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7053 # key. If absent, the Compute Engine default service account is used.
7054 # For example:
7055 #
7056 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7057 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7058 # encryption key, encoded in RFC
7059 # 4648 base64 to either encrypt or decrypt this resource. You can
7060 # provide either the rawKey or thersaEncryptedKey.
7061 # For example:
7062 #
7063 # &quot;rawKey&quot;:
7064 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7065 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7066 # customer-supplied encryption key to either encrypt or decrypt this
7067 # resource. You can provide either the rawKey or thersaEncryptedKey.
7068 # For example:
7069 #
7070 # &quot;rsaEncryptedKey&quot;:
7071 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7072 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7073 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7074 #
7075 # The key must meet the following requirements before you can provide it to
7076 # Compute Engine:
7077 #
7078 # 1. The key is wrapped using a RSA public key certificate provided by
7079 # Google.
7080 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7081 # encoding.
7082 #
7083 # Gets the RSA public key certificate provided by Google at:
7084 #
7085 #
7086 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7087 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7088 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7089 # encryption key that protects this resource.
7090 },
7091 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
7092 # instance boot disk, one of initializeParams.sourceSnapshot
7093 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
7094 # is required.
7095 #
7096 # To create a disk with a snapshot that you created, specify the
7097 # snapshot name in the following format:
7098 #
7099 # us-central1-a/instantSnapshots/my-backup
7100 #
7101 #
7102 # If the source instant-snapshot is deleted later, this field will not be
7103 # set.
7104 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
7105 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
7106 # is required.
7107 #
7108 # To create a disk with a snapshot that you created, specify the
7109 # snapshot name in the following format:
7110 #
7111 # global/snapshots/my-backup
7112 #
7113 #
7114 # If the source snapshot is deleted later, this field will not be set.
7115 #
7116 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
7117 # an image instead when you create VMs using
7118 # the bulk
7119 # insert method.
7120 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
7121 # encryption key of the source snapshot.
7122 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7123 # For example:
7124 #
7125 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7126 # key_region/cryptoKeys/key
7127 #
7128 # The fully-qualifed key name may be returned for resource GET requests. For
7129 # example:
7130 #
7131 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7132 # key_region/cryptoKeys/key
7133 # /cryptoKeyVersions/1
7134 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7135 # key. If absent, the Compute Engine default service account is used.
7136 # For example:
7137 #
7138 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7139 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7140 # encryption key, encoded in RFC
7141 # 4648 base64 to either encrypt or decrypt this resource. You can
7142 # provide either the rawKey or thersaEncryptedKey.
7143 # For example:
7144 #
7145 # &quot;rawKey&quot;:
7146 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7147 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7148 # customer-supplied encryption key to either encrypt or decrypt this
7149 # resource. You can provide either the rawKey or thersaEncryptedKey.
7150 # For example:
7151 #
7152 # &quot;rsaEncryptedKey&quot;:
7153 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7154 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7155 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7156 #
7157 # The key must meet the following requirements before you can provide it to
7158 # Compute Engine:
7159 #
7160 # 1. The key is wrapped using a RSA public key certificate provided by
7161 # Google.
7162 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7163 # encoding.
7164 #
7165 # Gets the RSA public key certificate provided by Google at:
7166 #
7167 #
7168 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7169 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7170 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7171 # encryption key that protects this resource.
7172 },
7173 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7174 # this as a partial or full URL to the resource. For example, the following
7175 # are valid values:
7176 #
7177 #
7178 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7179 # - projects/project/zones/zone/storagePools/storagePool
7180 # - zones/zone/storagePools/storagePool
7181 },
7182 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
7183 # either SCSI or NVME. For most machine types, the
7184 # default is SCSI. Local SSDs can use either NVME or SCSI.
7185 # In certain configurations, persistent disks can use NVMe. For more
7186 # information, seeAbout
7187 # persistent disks.
7188 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
7189 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
7190 &quot;A String&quot;,
7191 ],
7192 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
7193 # disk is not allowed to be detached from the instance, or to be used as the
7194 # source of the snapshot creation, and the image creation. The instance with
7195 # at least one locked attached disk is not allow to be used as source of
7196 # machine image creation, instant snapshot creation, and not allowed to be
7197 # deleted with --keep-disk parameter set to true for locked disks.
7198 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
7199 # in READ_WRITE mode.
7200 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
7201 # field is set to PRESERVED if the LocalSSD data has been saved
7202 # to a persistent location by customer request. (see the
7203 # discard_local_ssd option on Stop/Suspend).
7204 # Read-only in the api.
7205 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
7206 # these are public keys which are safe to store in public
7207 &quot;dbs&quot;: [ # The Key Database (db).
7208 {
7209 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7210 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7211 },
7212 ],
7213 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
7214 {
7215 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7216 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7217 },
7218 ],
7219 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
7220 {
7221 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7222 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7223 },
7224 ],
7225 &quot;pk&quot;: { # The Platform Key (PK).
7226 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7227 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7228 },
7229 },
7230 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
7231 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7232 # is required.
7233 #
7234 # If desired, you can also attach existing non-root persistent disks using
7235 # this property. This field is only applicable for persistent disks.
7236 #
7237 # Note that for InstanceTemplate, specify the disk name for zonal disk,
7238 # and the URL for regional disk.
7239 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
7240 },
7241 ],
7242 &quot;machineTypes&quot;: [ # Alternative machine types to use for instances that are created from
7243 # these properties. This field only accepts a machine type names, for
7244 # example `n2-standard-4` and not URLs or partial URLs.
7245 &quot;A String&quot;,
7246 ],
7247 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
7248 # e.g. &#x27;Intel Ice Lake&#x27;.
7249 &quot;rank&quot;: &quot;A String&quot;, # Rank when prioritizing the shape flexibilities.
7250 # The instance selections with rank are considered
7251 # first, in the ascending order of the rank.
7252 # If not set, defaults to 0.
7253 },
7254 },
7255 },
7256 &quot;instanceProperties&quot;: { # The instance properties defining the VM instances to be created. Required
7257 # if sourceInstanceTemplate is not provided.
7258 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
7259 # Note that for MachineImage, this is not supported yet.
7260 # Options that would traditionally be configured in a BIOS belong
7261 # here. Features that require operating system support may have
7262 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
7263 # disabled).
7264 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
7265 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
7266 &quot;enableWatchdogTimer&quot;: True or False, # Whether to enable the watchdog timer.
7267 &quot;numaNodeCount&quot;: 42, # The number of vNUMA nodes.
7268 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
7269 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
7270 # multithreading (SMT) set this to 1. If unset, the maximum number
7271 # of threads supported per core by the underlying processor is
7272 # assumed.
7273 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
7274 # Supported modes include:
7275 # * ALL_CORE_MAX
7276 #
7277 # Using empty string or not setting this field will use the platform-specific
7278 # default turbo mode.
7279 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
7280 # the number of threads per core to compute the total number of virtual
7281 # CPUs to expose to the instance. If unset, the number of cores is
7282 # inferred from the instance&#x27;s nominal CPU count and the underlying
7283 # platform&#x27;s SMT width.
7284 },
7285 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
7286 # source IP addresses other than their own and receive packets with
7287 # destination IP addresses other than their own. If these instances will be
7288 # used as an IP gateway or it will be set as the next-hop in a Route
7289 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
7290 # documentation for more information.
7291 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
7292 # Note that for MachineImage, this is not supported yet.
7293 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
7294 &quot;confidentialParavisorConfig&quot;: { # A set of Confidential Paravisor (SVSM) options. # Defines a set of Confidential Paravisor (SVSM) options.
7295 &quot;confidentialTpmType&quot;: &quot;A String&quot;,
7296 &quot;sevSnpIrqMode&quot;: &quot;A String&quot;,
7297 },
7298 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
7299 },
7300 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
7301 # properties.
7302 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
7303 # from these properties.
7304 { # An instance-attached disk resource.
7305 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
7306 # or X86_64.
7307 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
7308 # deleted (but not when the disk is detached from the instance).
7309 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
7310 # partition of the disk for its root filesystem.
7311 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
7312 # running within the instance. This name can be used to reference the device
7313 # for mounting, resizing, and so on, from within the instance.
7314 #
7315 # If not specified, the server chooses a default device name to apply to this
7316 # disk, in the form persistent-disk-x, where x is a number
7317 # assigned by Google Compute Engine. This field is only applicable for
7318 # persistent disks.
7319 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
7320 # encryption key.
7321 #
7322 # If you are creating a new disk, this field encrypts the new disk using
7323 # an encryption key that you provide. If you are attaching an existing
7324 # disk that is already encrypted, this field decrypts the disk using
7325 # the customer-supplied encryption key.
7326 #
7327 # If you encrypt a disk using a customer-supplied key, you must provide the
7328 # same key again when you attempt to use this resource at a later time. For
7329 # example, you must provide the key when you create a snapshot or an image
7330 # from the disk or when you attach the disk to a virtual machine instance.
7331 #
7332 # If you do not provide an encryption key, then the disk will be encrypted
7333 # using an automatically generated key and you do not need to provide a key
7334 # to use the disk later.
7335 #
7336 # Note:
7337 #
7338 # Instance templates do not storecustomer-supplied
7339 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
7340 #
7341 # You cannot create VMs that have disks with customer-supplied keys using
7342 # the bulk
7343 # insert method.
7344 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7345 # For example:
7346 #
7347 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7348 # key_region/cryptoKeys/key
7349 #
7350 # The fully-qualifed key name may be returned for resource GET requests. For
7351 # example:
7352 #
7353 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7354 # key_region/cryptoKeys/key
7355 # /cryptoKeyVersions/1
7356 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7357 # key. If absent, the Compute Engine default service account is used.
7358 # For example:
7359 #
7360 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7361 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7362 # encryption key, encoded in RFC
7363 # 4648 base64 to either encrypt or decrypt this resource. You can
7364 # provide either the rawKey or thersaEncryptedKey.
7365 # For example:
7366 #
7367 # &quot;rawKey&quot;:
7368 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7369 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7370 # customer-supplied encryption key to either encrypt or decrypt this
7371 # resource. You can provide either the rawKey or thersaEncryptedKey.
7372 # For example:
7373 #
7374 # &quot;rsaEncryptedKey&quot;:
7375 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7376 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7377 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7378 #
7379 # The key must meet the following requirements before you can provide it to
7380 # Compute Engine:
7381 #
7382 # 1. The key is wrapped using a RSA public key certificate provided by
7383 # Google.
7384 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7385 # encoding.
7386 #
7387 # Gets the RSA public key certificate provided by Google at:
7388 #
7389 #
7390 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7391 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7392 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7393 # encryption key that protects this resource.
7394 },
7395 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
7396 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
7397 # currently attached to another instance. If you try to force attach a zonal
7398 # disk to an instance, you will receive an error.
7399 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7400 # only for bootable images. Read
7401 # Enabling guest operating system features to see a list of available
7402 # options.
7403 { # Guest OS features.
7404 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7405 # separate values. Set to one or more of the following values:
7406 #
7407 # - VIRTIO_SCSI_MULTIQUEUE
7408 # - WINDOWS
7409 # - MULTI_IP_SUBNET
7410 # - UEFI_COMPATIBLE
7411 # - GVNIC
7412 # - SEV_CAPABLE
7413 # - SUSPEND_RESUME_COMPATIBLE
7414 # - SEV_LIVE_MIGRATABLE_V2
7415 # - SEV_SNP_CAPABLE
7416 # - TDX_CAPABLE
7417 # - IDPF
7418 # - SNP_SVSM_CAPABLE
7419 # - CCA_CAPABLE
7420 #
7421 #
7422 # For more information, see
7423 # Enabling guest operating system features.
7424 },
7425 ],
7426 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
7427 # boot disk. If you have many disks attached to an instance, each
7428 # disk would have a unique index number.
7429 &quot;initializeParams&quot;: { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
7430 # alongside the new instance. Use initialization parameters to create boot
7431 # disks or local SSDs attached to the new instance.
7432 #
7433 # This property is mutually exclusive with the source property;
7434 # you can only define one or the other, but not both.
7435 # alongside the new instance. Use initialization parameters to create boot
7436 # disks or local SSDs attached to the new instance.
7437 #
7438 # This field is persisted and returned for instanceTemplate and not returned
7439 # in the context of instance.
7440 #
7441 # This property is mutually exclusive with the source property;
7442 # you can only define one or the other, but not both.
7443 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
7444 # arm64 or x86_64.
7445 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
7446 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
7447 # of the instance. If a disk with the same name already exists in the given
7448 # region, the existing disk is attached to the new instance and the
7449 # new disk is not created.
7450 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
7451 # 10 GB. If you specify a sourceImage, which is required for
7452 # boot disks, the default size is the size of the sourceImage.
7453 # If you do not specify a sourceImage, the default disk size
7454 # is 500 GB.
7455 &quot;diskType&quot;: &quot;A String&quot;,
7456 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
7457 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7458 # only for bootable images. Read
7459 # Enabling guest operating system features to see a list of available
7460 # options.
7461 #
7462 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
7463 { # Guest OS features.
7464 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7465 # separate values. Set to one or more of the following values:
7466 #
7467 # - VIRTIO_SCSI_MULTIQUEUE
7468 # - WINDOWS
7469 # - MULTI_IP_SUBNET
7470 # - UEFI_COMPATIBLE
7471 # - GVNIC
7472 # - SEV_CAPABLE
7473 # - SUSPEND_RESUME_COMPATIBLE
7474 # - SEV_LIVE_MIGRATABLE_V2
7475 # - SEV_SNP_CAPABLE
7476 # - TDX_CAPABLE
7477 # - IDPF
7478 # - SNP_SVSM_CAPABLE
7479 # - CCA_CAPABLE
7480 #
7481 #
7482 # For more information, see
7483 # Enabling guest operating system features.
7484 },
7485 ],
7486 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
7487 # which is either SCSI or NVME. The default isSCSI.
7488 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
7489 # persistent disks.
7490 &quot;a_key&quot;: &quot;A String&quot;,
7491 },
7492 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
7493 # disk.
7494 &quot;A String&quot;,
7495 ],
7496 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
7497 &quot;A String&quot;,
7498 ],
7499 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
7500 # more than one instance.
7501 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
7502 # is to use the existing disk.
7503 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
7504 # of I/O operations per second that the disk can handle. Values must be
7505 # between 10,000 and 120,000. For more details, see theExtreme persistent
7506 # disk documentation.
7507 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
7508 # number of throughput mb per second that the disk can handle. Values must
7509 # greater than or equal to 1.
7510 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
7511 # the URLs of the zones where the disk should be replicated to.
7512 # You must provide exactly two replica zones, and one zone must be the same
7513 # as the instance zone.
7514 &quot;A String&quot;,
7515 ],
7516 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
7517 # have the same definition as resource
7518 # manager tags. Keys and values can be either in numeric format,
7519 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
7520 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
7521 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
7522 # empty.
7523 &quot;a_key&quot;: &quot;A String&quot;,
7524 },
7525 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
7526 # Specified using the full or partial URL. For instance template, specify
7527 # only the resource policy name.
7528 &quot;A String&quot;,
7529 ],
7530 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
7531 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7532 # is required.
7533 #
7534 # To create a disk with one of the public operating system
7535 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
7536 #
7537 # projects/debian-cloud/global/images/family/debian-9
7538 #
7539 #
7540 # Alternatively, use a specific version of a public operating system image:
7541 #
7542 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
7543 #
7544 #
7545 # To create a disk with a custom image that you created, specify the
7546 # image name in the following format:
7547 #
7548 # global/images/my-custom-image
7549 #
7550 #
7551 # You can also specify a custom image by its image family, which returns
7552 # the latest version of the image in that family. Replace the image name
7553 # with family/family-name:
7554 #
7555 # global/images/family/my-image-family
7556 #
7557 #
7558 # If the source image is deleted later, this field will not be set.
7559 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
7560 # encryption key of the source image. Required if the source image is
7561 # protected by a customer-supplied encryption key.
7562 #
7563 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
7564 # encryption keys, so you cannot create disks for instances in a managed instance group if the
7565 # source images are encrypted with your own keys.
7566 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7567 # For example:
7568 #
7569 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7570 # key_region/cryptoKeys/key
7571 #
7572 # The fully-qualifed key name may be returned for resource GET requests. For
7573 # example:
7574 #
7575 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7576 # key_region/cryptoKeys/key
7577 # /cryptoKeyVersions/1
7578 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7579 # key. If absent, the Compute Engine default service account is used.
7580 # For example:
7581 #
7582 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7583 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7584 # encryption key, encoded in RFC
7585 # 4648 base64 to either encrypt or decrypt this resource. You can
7586 # provide either the rawKey or thersaEncryptedKey.
7587 # For example:
7588 #
7589 # &quot;rawKey&quot;:
7590 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7591 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7592 # customer-supplied encryption key to either encrypt or decrypt this
7593 # resource. You can provide either the rawKey or thersaEncryptedKey.
7594 # For example:
7595 #
7596 # &quot;rsaEncryptedKey&quot;:
7597 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7598 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7599 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7600 #
7601 # The key must meet the following requirements before you can provide it to
7602 # Compute Engine:
7603 #
7604 # 1. The key is wrapped using a RSA public key certificate provided by
7605 # Google.
7606 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7607 # encoding.
7608 #
7609 # Gets the RSA public key certificate provided by Google at:
7610 #
7611 #
7612 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7613 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7614 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7615 # encryption key that protects this resource.
7616 },
7617 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
7618 # instance boot disk, one of initializeParams.sourceSnapshot
7619 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
7620 # is required.
7621 #
7622 # To create a disk with a snapshot that you created, specify the
7623 # snapshot name in the following format:
7624 #
7625 # us-central1-a/instantSnapshots/my-backup
7626 #
7627 #
7628 # If the source instant-snapshot is deleted later, this field will not be
7629 # set.
7630 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
7631 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
7632 # is required.
7633 #
7634 # To create a disk with a snapshot that you created, specify the
7635 # snapshot name in the following format:
7636 #
7637 # global/snapshots/my-backup
7638 #
7639 #
7640 # If the source snapshot is deleted later, this field will not be set.
7641 #
7642 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
7643 # an image instead when you create VMs using
7644 # the bulk
7645 # insert method.
7646 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
7647 # encryption key of the source snapshot.
7648 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7649 # For example:
7650 #
7651 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7652 # key_region/cryptoKeys/key
7653 #
7654 # The fully-qualifed key name may be returned for resource GET requests. For
7655 # example:
7656 #
7657 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7658 # key_region/cryptoKeys/key
7659 # /cryptoKeyVersions/1
7660 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7661 # key. If absent, the Compute Engine default service account is used.
7662 # For example:
7663 #
7664 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7665 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7666 # encryption key, encoded in RFC
7667 # 4648 base64 to either encrypt or decrypt this resource. You can
7668 # provide either the rawKey or thersaEncryptedKey.
7669 # For example:
7670 #
7671 # &quot;rawKey&quot;:
7672 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7673 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7674 # customer-supplied encryption key to either encrypt or decrypt this
7675 # resource. You can provide either the rawKey or thersaEncryptedKey.
7676 # For example:
7677 #
7678 # &quot;rsaEncryptedKey&quot;:
7679 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7680 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7681 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7682 #
7683 # The key must meet the following requirements before you can provide it to
7684 # Compute Engine:
7685 #
7686 # 1. The key is wrapped using a RSA public key certificate provided by
7687 # Google.
7688 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7689 # encoding.
7690 #
7691 # Gets the RSA public key certificate provided by Google at:
7692 #
7693 #
7694 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7695 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7696 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7697 # encryption key that protects this resource.
7698 },
7699 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7700 # this as a partial or full URL to the resource. For example, the following
7701 # are valid values:
7702 #
7703 #
7704 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7705 # - projects/project/zones/zone/storagePools/storagePool
7706 # - zones/zone/storagePools/storagePool
7707 },
7708 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
7709 # either SCSI or NVME. For most machine types, the
7710 # default is SCSI. Local SSDs can use either NVME or SCSI.
7711 # In certain configurations, persistent disks can use NVMe. For more
7712 # information, seeAbout
7713 # persistent disks.
7714 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
7715 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
7716 &quot;A String&quot;,
7717 ],
7718 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
7719 # disk is not allowed to be detached from the instance, or to be used as the
7720 # source of the snapshot creation, and the image creation. The instance with
7721 # at least one locked attached disk is not allow to be used as source of
7722 # machine image creation, instant snapshot creation, and not allowed to be
7723 # deleted with --keep-disk parameter set to true for locked disks.
7724 &quot;mode&quot;: &quot;A String&quot;, # The mode in which to attach this disk, either READ_WRITE orREAD_ONLY. If not specified, the default is to attach the disk
7725 # in READ_WRITE mode.
7726 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
7727 # field is set to PRESERVED if the LocalSSD data has been saved
7728 # to a persistent location by customer request. (see the
7729 # discard_local_ssd option on Stop/Suspend).
7730 # Read-only in the api.
7731 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
7732 # these are public keys which are safe to store in public
7733 &quot;dbs&quot;: [ # The Key Database (db).
7734 {
7735 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7736 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7737 },
7738 ],
7739 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
7740 {
7741 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7742 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7743 },
7744 ],
7745 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
7746 {
7747 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7748 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7749 },
7750 ],
7751 &quot;pk&quot;: { # The Platform Key (PK).
7752 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7753 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7754 },
7755 },
7756 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
7757 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7758 # is required.
7759 #
7760 # If desired, you can also attach existing non-root persistent disks using
7761 # this property. This field is only applicable for persistent disks.
7762 #
7763 # Note that for InstanceTemplate, specify the disk name for zonal disk,
7764 # and the URL for regional disk.
7765 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
7766 },
7767 ],
7768 &quot;displayDevice&quot;: { # A set of Display Device options # Display Device properties to enable support
7769 # for remote display products like: Teradici,
7770 # VNC and TeamViewer
7771 # Note that for MachineImage, this is not supported yet.
7772 &quot;enableDisplay&quot;: True or False, # Defines whether the instance has Display enabled.
7773 },
7774 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
7775 # created from these properties.
7776 { # A specification of the type and number of accelerator cards attached to the
7777 # instance.
7778 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
7779 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
7780 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
7781 # If you are creating an instance template, specify only the
7782 # accelerator name.
7783 # See GPUs on Compute Engine
7784 # for a full list of accelerator types.
7785 },
7786 ],
7787 &quot;identity&quot;: &quot;A String&quot;,
7788 &quot;identityCertificate&quot;: True or False,
7789 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
7790 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
7791 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
7792 &quot;a_key&quot;: &quot;A String&quot;,
7793 },
7794 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
7795 # properties.
7796 # This field only accepts a machine type name, for example `n2-standard-4`.
7797 # If you use the machine type full or partial URL, for example
7798 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
7799 # the request will result in an `INTERNAL_ERROR`.
7800 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
7801 # these properties. These pairs can consist of custom metadata or predefined
7802 # keys. SeeProject and
7803 # instance metadata for more information.
7804 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
7805 # the metadata&#x27;s contents and used for optimistic locking. The
7806 # fingerprint is initially generated by Compute Engine and changes after
7807 # every request to modify or update metadata. You must always provide an
7808 # up-to-date fingerprint hash in order to update or change metadata,
7809 # otherwise the request will fail with error412 conditionNotMet.
7810 #
7811 # To see the latest fingerprint, make a get() request to
7812 # retrieve the resource.
7813 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
7814 # less than 512 KB.
7815 { # Metadata
7816 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
7817 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
7818 # This is reflected as part of a URL in the metadata server. Additionally, to
7819 # avoid ambiguity, keys must not conflict with any other metadata keys
7820 # for the project.
7821 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
7822 # have meaning as interpreted by the image running in the instance. The
7823 # only restriction placed on values is that their size must be less than
7824 # or equal to 262144 bytes (256 KiB).
7825 },
7826 ],
7827 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
7828 # for metadata.
7829 },
7830 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
7831 # scheduled on the specified or newer cpu/platform. Applicable values are the
7832 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
7833 # information, read Specifying a
7834 # Minimum CPU Platform.
7835 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
7836 { # A network interface resource attached to an instance.
7837 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
7838 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
7839 # no external internet access.
7840 { # An access configuration attached to an instance&#x27;s network interface.
7841 # Only one access config per instance is supported.
7842 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
7843 # The first IPv6 address of the external IPv6 range associated
7844 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
7845 # use a static external IP address, it must be unused and in the same region
7846 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
7847 # assign an external IPv6 address from the instance&#x27;s subnetwork.
7848 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
7849 # external IPv6 range.
7850 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
7851 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
7852 # (IPv4), the default and recommended name is External NAT, but
7853 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
7854 # recommend name is External IPv6.
7855 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
7856 # address associated with this instance. Specify an unused static
7857 # external IP address available to the project or leave this field undefined
7858 # to use an IP from a shared ephemeral IP address pool. If you specify a
7859 # static external IP address, it must live in the same region as the zone of
7860 # the instance.
7861 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
7862 # configuration and can only take the following values: PREMIUM,STANDARD.
7863 #
7864 # If an AccessConfig is specified without a valid external IP address, an
7865 # ephemeral IP will be created with this networkTier.
7866 #
7867 # If an AccessConfig with a valid external IP address is specified, it must
7868 # match that of the networkTier associated with the Address resource owning
7869 # that IP.
7870 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
7871 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
7872 #
7873 # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
7874 # first IP in associated external IPv6 range.
7875 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
7876 # config.
7877 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
7878 # external IP address of this access configuration.
7879 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
7880 # external IP address of the instance to a DNS domain name.
7881 #
7882 # This field is not used in ipv6AccessConfig. A default PTR
7883 # record will be created if the VM has external IPv6 range associated.
7884 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
7885 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
7886 },
7887 ],
7888 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
7889 # You can only specify this field for network interfaces in VPC networks.
7890 { # An alias IP range attached to an instance&#x27;s network interface.
7891 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
7892 # must belong to the specified subnetwork and cannot contain IP addresses
7893 # reserved by system or used by other network interfaces. This range may be
7894 # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
7895 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
7896 # alias range. If not specified, the primary range of the subnetwork is used.
7897 },
7898 ],
7899 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
7900 # You can only specify this field for network interfaces in VPC networks.
7901 { # An alias IP range attached to an instance&#x27;s network interface.
7902 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
7903 # must belong to the specified subnetwork and cannot contain IP addresses
7904 # reserved by system or used by other network interfaces. This range may be
7905 # a single IP address (such as 10.2.3.4), a netmask (such as/24) or a CIDR-formatted string (such as10.1.2.0/24).
7906 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
7907 # alias range. If not specified, the primary range of the subnetwork is used.
7908 },
7909 ],
7910 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
7911 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
7912 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
7913 # with network_attachment.
7914 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
7915 # This field will be ignored when inserting an Instance or
7916 # adding a NetworkInterface. An up-to-date
7917 # fingerprint must be provided in order to update theNetworkInterface. The request will fail with error400 Bad Request if the fingerprint is not provided, or412 Precondition Failed if the fingerprint is out of date.
7918 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
7919 # or not. If enabled, also indicates the version of IGMP supported.
7920 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
7921 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
7922 # one IPv6 access config, DIRECT_IPV6, is supported. If there
7923 # is no ipv6AccessConfig specified, then this instance will
7924 # have no external IPv6 Internet access.
7925 { # An access configuration attached to an instance&#x27;s network interface.
7926 # Only one access config per instance is supported.
7927 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
7928 # The first IPv6 address of the external IPv6 range associated
7929 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
7930 # use a static external IP address, it must be unused and in the same region
7931 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
7932 # assign an external IPv6 address from the instance&#x27;s subnetwork.
7933 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
7934 # external IPv6 range.
7935 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
7936 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
7937 # (IPv4), the default and recommended name is External NAT, but
7938 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
7939 # recommend name is External IPv6.
7940 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
7941 # address associated with this instance. Specify an unused static
7942 # external IP address available to the project or leave this field undefined
7943 # to use an IP from a shared ephemeral IP address pool. If you specify a
7944 # static external IP address, it must live in the same region as the zone of
7945 # the instance.
7946 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
7947 # configuration and can only take the following values: PREMIUM,STANDARD.
7948 #
7949 # If an AccessConfig is specified without a valid external IP address, an
7950 # ephemeral IP will be created with this networkTier.
7951 #
7952 # If an AccessConfig with a valid external IP address is specified, it must
7953 # match that of the networkTier associated with the Address resource owning
7954 # that IP.
7955 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
7956 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
7957 #
7958 # You can set this field only if the `setPublicPtr` field is enabled inaccessConfig. If this field is unspecified inipv6AccessConfig, a default PTR record will be created for
7959 # first IP in associated external IPv6 range.
7960 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
7961 # config.
7962 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
7963 # external IP address of this access configuration.
7964 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
7965 # external IP address of the instance to a DNS domain name.
7966 #
7967 # This field is not used in ipv6AccessConfig. A default PTR
7968 # record will be created if the VM has external IPv6 range associated.
7969 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
7970 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
7971 },
7972 ],
7973 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
7974 # accessed from the Internet. This field is always inherited from its
7975 # subnetwork.
7976 #
7977 # Valid only if stackType is IPV4_IPV6.
7978 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
7979 # use a static internal IP address, it must be unused and in the same region
7980 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
7981 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
7982 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
7983 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
7984 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
7985 # server. For a VM, the network interface uses the nicN naming
7986 # format. Where N is a value between 0 and7. The default interface value is nic0.
7987 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
7988 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
7989 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
7990 # instance, if neither the network nor the subnetwork is specified, the
7991 # default network global/networks/default is used. If the
7992 # selected project doesn&#x27;t have the default network, you must specify a
7993 # network or subnet. If the network is not specified but the subnetwork is
7994 # specified, the network is inferred.
7995 #
7996 # If you specify this property, you can specify the network as
7997 # a full or partial URL. For example, the following are all valid URLs:
7998 #
7999 #
8000 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
8001 # - projects/project/global/networks/network
8002 # - global/networks/default
8003 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
8004 # to in the following format:
8005 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
8006 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
8007 # interface. If not specified by the user, an unused internal IP is
8008 # assigned by the system.
8009 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
8010 # VirtioNet.
8011 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
8012 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
8013 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
8014 # if not specified by the users.
8015 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
8016 # interface. Can only be used with network_attachment. It is not possible to
8017 # use on its own however, network_attachment can be used without
8018 # service_class_id.
8019 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
8020 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
8021 #
8022 # This field can be both set at instance creation and update network
8023 # interface operations.
8024 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
8025 # subnetworks that support L2. Every network interface will get a default
8026 # untagged (vlan not specified) subinterface. Users can specify additional
8027 # tagged subinterfaces which are sub-fields to the Network Interface.
8028 {
8029 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
8030 # subinterface. If specified, ip_allocation_mode should be set to
8031 # ALLOCATE_IP.
8032 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
8033 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
8034 # as that of the network interface.
8035 # If not specified the subnet of network interface will be used.
8036 # If you specify this property, you can specify the subnetwork as a full
8037 # or partial URL. For example, the following are all valid URLs:
8038 #
8039 #
8040 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
8041 # - regions/region/subnetworks/subnetwork
8042 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
8043 # this subinterface is connecting.
8044 },
8045 ],
8046 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
8047 # resource is inlegacy
8048 # mode, do not specify this field. If the network is in auto subnet
8049 # mode, specifying the subnetwork is optional. If the network is in custom
8050 # subnet mode, specifying the subnetwork is required. If you specify this
8051 # field, you can specify the subnetwork as a full or partial URL. For
8052 # example, the following are all valid URLs:
8053 #
8054 #
8055 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
8056 # - regions/region/subnetworks/subnetwork
8057 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
8058 # from 2 to 255 inclusively.
8059 },
8060 ],
8061 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
8062 &quot;externalIpEgressBandwidthTier&quot;: &quot;A String&quot;,
8063 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
8064 },
8065 &quot;partnerMetadata&quot;: { # Partner Metadata assigned to the instance properties. A map from a
8066 # subdomain (namespace) to entries map.
8067 &quot;a_key&quot;: {
8068 &quot;entries&quot;: { # Map of a partner metadata that belong to the same subdomain.
8069 # It accepts any value including google.protobuf.Struct.
8070 &quot;a_key&quot;: &quot;&quot;,
8071 },
8072 },
8073 },
8074 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
8075 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
8076 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
8077 # Note that for MachineImage, this is not supported yet.
8078 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
8079 # Note that for MachineImage, this is not supported yet.
8080 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
8081 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
8082 # Consuming reserved instances for examples.
8083 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of a reservation resource. To target aSPECIFIC_RESERVATION by name, specifygoogleapis.com/reservation-name as the key and specify
8084 # the name of your reservation as its value.
8085 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
8086 # either a name to a reservation in the same project or
8087 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
8088 # shared reservation in the same zone but in a different project.
8089 &quot;A String&quot;,
8090 ],
8091 },
8092 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
8093 # have the same definition as resource
8094 # manager tags. Keys and values can be either in numeric format,
8095 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
8096 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
8097 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
8098 # PATCH) when empty.
8099 &quot;a_key&quot;: &quot;A String&quot;,
8100 },
8101 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
8102 # these properties.
8103 # Note that for MachineImage, this is not supported yet.
8104 &quot;A String&quot;,
8105 ],
8106 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
8107 # these properties.
8108 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
8109 # terminated by Compute Engine (not terminated by a user). You can only set
8110 # the automatic restart option for standard instances.Preemptible instances
8111 # cannot be automatically restarted.
8112 #
8113 # By default, this is set to true so an instance is
8114 # automatically restarted if it is terminated by Compute Engine.
8115 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
8116 # must be a number between 1 and the number of availability domains
8117 # specified in the spread placement policy attached to the instance.
8118 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
8119 # 0 or unset means default vCPUs of the current machine type.
8120 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
8121 # 0 or unset means default amount of memory of the current machine type.
8122 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
8123 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
8124 &quot;maxDuration&quot;: { # A Duration represents a fixed-length span of time represented # The time allotted for the instance to gracefully shut down. If the
8125 # graceful shutdown isn&#x27;t complete after this time, then the instance
8126 # transitions to the STOPPING state.
8127 # as a count of seconds and fractions of seconds at nanosecond
8128 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8129 # or &quot;month&quot;. Range is approximately 10,000 years.
8130 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8131 # Durations less than one second are represented with a 0
8132 # `seconds` field and a positive `nanos` field. Must be from 0
8133 # to 999,999,999 inclusive.
8134 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8135 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8136 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8137 },
8138 },
8139 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
8140 # within the range of [90, 330] with the increment of 30, if unset, the
8141 # default behavior of host error recovery will be used.
8142 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
8143 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
8144 # only be set during instance creation, or when the instance is not currently
8145 # running. It must not be set if thepreemptible option is
8146 # also set.
8147 &quot;localSsdRecoveryTimeout&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the maximum amount of time a Local Ssd Vm should wait while
8148 # recovery of the Local Ssd state is attempted. Its value should be in
8149 # between 0 and 168 hours with hour granularity and the default value being 1
8150 # hour.
8151 # as a count of seconds and fractions of seconds at nanosecond
8152 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8153 # or &quot;month&quot;. Range is approximately 10,000 years.
8154 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8155 # Durations less than one second are represented with a 0
8156 # `seconds` field and a positive `nanos` field. Must be from 0
8157 # to 999,999,999 inclusive.
8158 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8159 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8160 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8161 },
8162 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
8163 # resources.
8164 # This field is for use by internal tools that use the public API.
8165 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
8166 # be scheduled for maintenance.
8167 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
8168 # are: `PERIODIC`.
8169 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
8170 # the instance termination action will be performed at the end of the run
8171 # duration.
8172 # as a count of seconds and fractions of seconds at nanosecond
8173 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8174 # or &quot;month&quot;. Range is approximately 10,000 years.
8175 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8176 # Durations less than one second are represented with a 0
8177 # `seconds` field and a positive `nanos` field. Must be from 0
8178 # to 999,999,999 inclusive.
8179 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8180 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8181 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8182 },
8183 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
8184 # on a sole-tenant node.
8185 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
8186 # affinity for more information.
8187 # Overrides reservationAffinity.
8188 { # Node Affinity: the configuration of desired nodes onto which this Instance
8189 # could be scheduled.
8190 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
8191 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
8192 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
8193 &quot;A String&quot;,
8194 ],
8195 },
8196 ],
8197 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
8198 # the default behavior is MIGRATE. Forpreemptible instances,
8199 # the default and only possible behavior is TERMINATE. For more
8200 # information, see
8201 # Set
8202 # VM host maintenance policy.
8203 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
8204 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
8205 # else, the Local SSD data will be preserved when the instance is stopped
8206 # at the end of the run duration/termination time.
8207 },
8208 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
8209 # instance creation or while the instance isstopped and
8210 # therefore, in a `TERMINATED` state. SeeInstance Life
8211 # Cycle for more information on the possible instance states.
8212 &quot;preemptionNoticeDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the Metadata Service preemption notice duration before the GCE ACPI G2 Soft
8213 # Off signal is triggered for Spot
8214 # VMs only. If not specified, there will be no wait before the G2 Soft
8215 # Off signal is triggered.
8216 # as a count of seconds and fractions of seconds at nanosecond
8217 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8218 # or &quot;month&quot;. Range is approximately 10,000 years.
8219 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8220 # Durations less than one second are represented with a 0
8221 # `seconds` field and a positive `nanos` field. Must be from 0
8222 # to 999,999,999 inclusive.
8223 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8224 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8225 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8226 },
8227 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
8228 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
8229 # Timeout between GCE ACPI G2 Soft
8230 # Off and ACPI G3 Mechanical
8231 # Off during shutdown operation of VM.
8232 #
8233 # For Standard VMs values between 0s and 120s are allowed. For Spot and
8234 # Preemptible VMs supported values are between 0s and 30s.
8235 #
8236 # If no value is specified for shutdownDuration, default values are 90s for
8237 # Standard VMs and 30s for Spot/Preemptible VMs.
8238 # as a count of seconds and fractions of seconds at nanosecond
8239 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8240 # or &quot;month&quot;. Range is approximately 10,000 years.
8241 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8242 # Durations less than one second are represented with a 0
8243 # `seconds` field and a positive `nanos` field. Must be from 0
8244 # to 999,999,999 inclusive.
8245 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8246 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8247 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8248 },
8249 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
8250 # Off and ACPI G3 Mechanical
8251 # Off for Standard VMs and 30 seconds for Spot VMs.
8252 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
8253 # termination action will be performed at the termination time.
8254 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
8255 &quot;mode&quot;: &quot;A String&quot;,
8256 },
8257 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
8258 # unspecified, the default mode is `OFF`.
8259 },
8260 &quot;secureTags&quot;: [ # [Input Only] Secure tags to apply to this instance.
8261 # Maximum number of secure tags allowed is 50.
8262 # Note that for MachineImage, this is not supported yet.
8263 &quot;A String&quot;,
8264 ],
8265 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
8266 # service accounts are available to the instances that are created from
8267 # these properties. Use metadata queries to obtain the access tokens for
8268 # these instances.
8269 { # A service account.
8270 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
8271 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
8272 &quot;A String&quot;,
8273 ],
8274 },
8275 ],
8276 &quot;serviceIntegrationSpecs&quot;: { # Mapping of user defined keys to ServiceIntegrationSpec.
8277 &quot;a_key&quot;: { # Specifies the parameters to configure an integration with instances.
8278 &quot;backupDr&quot;: { # Specifies parameters to Backup and DR to attach a BackupPlan to a compute
8279 # instance for managed VM backup.
8280 &quot;plan&quot;: &quot;A String&quot;, # The BackupPlan resource to attach to the instance. Specified as a
8281 # resource reference in instances, and regional instance templates, and as
8282 # just the plan name in global instance templates
8283 },
8284 },
8285 },
8286 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
8287 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
8288 # default.
8289 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
8290 # default.
8291 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
8292 # default.
8293 },
8294 &quot;shieldedVmConfig&quot;: { # A set of Shielded VM options. # Specifies the Shielded VM options for the instances that are created from
8295 # these properties.
8296 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.
8297 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.
8298 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.
8299 },
8300 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
8301 # properties. The tags identify valid sources or targets for network
8302 # firewalls. The setTags method can modify this list of tags. Each tag within
8303 # the list must comply with RFC1035.
8304 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
8305 # the tags&#x27; contents and used for optimistic locking. The
8306 # fingerprint is initially generated by Compute Engine and changes after
8307 # every request to modify or update tags. You must always provide an
8308 # up-to-date fingerprint hash in order to update or change tags.
8309 #
8310 # To see the latest fingerprint, make get() request to the
8311 # instance.
8312 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
8313 # with RFC1035.
8314 &quot;A String&quot;,
8315 ],
8316 },
8317 &quot;workloadIdentityConfig&quot;: {
8318 &quot;identity&quot;: &quot;A String&quot;,
8319 &quot;identityCertificateEnabled&quot;: True or False,
8320 },
8321 },
8322 &quot;locationPolicy&quot;: { # Configuration for location policy among multiple possible locations # Policy for choosing target zone. For more information, seeCreate VMs in
8323 # bulk.
8324 # (e.g. preferences for zone selection among zones in a single region).
8325 &quot;locations&quot;: { # Location configurations mapped by location name.
8326 # Currently only zone names are supported and must be represented as valid
8327 # internal URLs, such as zones/us-central1-a.
8328 # The bulkInsert operation doesn&#x27;t create instances in an AI zone, even if
8329 # an AI zone is available in the specified region. For example, if you set a
8330 # DENY preference for us-central1-a, Compute Engine will consider
8331 # us-central1-b and us-central1-c for instance creation, but not
8332 # us-central1-ai1a. Also, you can&#x27;t use the locations[] configuration to
8333 # allow instance creation in an AI zone. To include an AI zone in bulkInsert
8334 # operations, use the locationPolicy.zones[] field.
8335 &quot;a_key&quot;: {
8336 &quot;constraints&quot;: { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution
8337 # in this zone.
8338 &quot;maxCount&quot;: 42, # Maximum number of items that are allowed to be placed in this zone.
8339 # The value must be non-negative.
8340 },
8341 &quot;names&quot;: [ # Names of resources to be put in the location.
8342 # Must contain unique, correct resource names.
8343 # If used, targetShape must be left unset.
8344 &quot;A String&quot;,
8345 ],
8346 &quot;preference&quot;: &quot;A String&quot;, # Preference for a given location. Set to either ALLOW orDENY.
8347 },
8348 },
8349 &quot;targetShape&quot;: &quot;A String&quot;, # Strategy for distributing VMs across zones in a region.
8350 &quot;zones&quot;: [ # The bulkInsert operation applies any preferences set in the locations
8351 # field to the specific zones listed in the zones field if the same zones
8352 # are specified in both fields.
8353 {
8354 &quot;zone&quot;: &quot;A String&quot;, # The URL of the zone.
8355 # The zone must exist in the region where the request is called.
8356 # Zones must be represented as valid partial URLs,
8357 # such as zones/us-central1-a.
8358 },
8359 ],
8360 },
8361 &quot;minCount&quot;: &quot;A String&quot;, # The minimum number of instances to create. If no min_count is
8362 # specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will
8363 # be created and instances already created will be deleted.
8364 &quot;namePattern&quot;: &quot;A String&quot;, # The string pattern used for the names of the VMs.
8365 # Either name_pattern or per_instance_properties
8366 # must be set. The pattern must contain one continuous sequence of
8367 # placeholder hash characters (#) with each character corresponding to one
8368 # digit of the generated instance name. Example: a name_pattern
8369 # of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances
8370 # in the same project and zone have names that match the name pattern
8371 # then the generated instance numbers start after the biggest
8372 # existing number. For example, if there exists an instance with nameinst-0050, then instance names generated using the patterninst-#### begin with inst-0051. The name pattern
8373 # placeholder #...# can contain up to 18 characters.
8374 &quot;perInstanceProperties&quot;: { # Per-instance properties to be set on individual instances.
8375 # Keys of this map specify requested instance names.
8376 # Can be empty if name_pattern is used.
8377 &quot;a_key&quot;: { # Per-instance properties to be set on individual instances.
8378 # To be extended in the future.
8379 &quot;hostname&quot;: &quot;A String&quot;, # Specifies the hostname of the instance. More details in:
8380 # https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention
8381 &quot;name&quot;: &quot;A String&quot;, # Output only. This field is only temporary. It will be removed. Do not use it.
8382 },
8383 },
8384 &quot;sourceInstanceTemplate&quot;: &quot;A String&quot;, # Specifies the instance template from which to create instances. You may
8385 # combine sourceInstanceTemplate withinstanceProperties to override specific values from an
8386 # existing instance template. Bulk API follows the semantics of JSON Merge
8387 # Patch described by RFC
8388 # 7396.
8389 #
8390 # It can be a full or partial URL. For example, the following are
8391 # all valid URLs to an instance template:
8392 #
8393 #
8394 # - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
8395 # - projects/project/global/instanceTemplates/instanceTemplate
8396 # - global/instanceTemplates/instanceTemplate
8397 #
8398 #
8399 #
8400 # This field is optional.
8401 },
8402 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp in RFC3339
8403 # text format.
8404 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
8405 # create the resource.
8406 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
8407 # defined by the server.
8408 &quot;kind&quot;: &quot;compute#queuedResource&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#queuedResource for QueuedResources.
8409 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
8410 # The name must be 1-63 characters long, and comply withRFC1035.
8411 # Specifically, the name must be 1-63 characters long and match the regular
8412 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character
8413 # must be a lowercase letter, and all following characters must be a dash,
8414 # lowercase letter, or digit, except the last character, which cannot be a
8415 # dash.
8416 &quot;queuingPolicy&quot;: { # Queuing parameters for the requested deferred capacity. # Queuing parameters for the requested capacity.
8417 &quot;validUntilDuration&quot;: { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity.
8418 # as a count of seconds and fractions of seconds at nanosecond
8419 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8420 # or &quot;month&quot;. Range is approximately 10,000 years.
8421 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8422 # Durations less than one second are represented with a 0
8423 # `seconds` field and a positive `nanos` field. Must be from 0
8424 # to 999,999,999 inclusive.
8425 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8426 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8427 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8428 },
8429 &quot;validUntilTime&quot;: &quot;A String&quot;, # Absolute deadline for waiting for capacity inRFC3339
8430 # text format.
8431 },
8432 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output only] Server-defined URL for the resource.
8433 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
8434 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output only] High-level status of the request.
8435 &quot;status&quot;: { # [Output only] Result of queuing and provisioning based on deferred # Output only. [Output only] Result of queuing and provisioning based on deferred
8436 # capacity.
8437 # capacity.
8438 &quot;failedData&quot;: { # Additional status detail for the FAILED state. # Output only. Additional status detail for the FAILED state.
8439 &quot;error&quot;: { # The error(s) that caused the QueuedResource to enter the FAILED state.
8440 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8441 # operation.
8442 {
8443 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8444 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8445 # details. There is a set of defined message types to use for providing
8446 # details.The syntax depends on the error code. For example,
8447 # QuotaExceededInfo will have details when the error code is
8448 # QUOTA_EXCEEDED.
8449 {
8450 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8451 #
8452 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8453 # is not enabled:
8454 #
8455 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8456 # &quot;domain&quot;: &quot;googleapis.com&quot;
8457 # &quot;metadata&quot;: {
8458 # &quot;resource&quot;: &quot;projects/123&quot;,
8459 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8460 # }
8461 # }
8462 #
8463 # This response indicates that the pubsub.googleapis.com API is not enabled.
8464 #
8465 # Example of an error that is returned when attempting to create a Spanner
8466 # instance in a region that is out of stock:
8467 #
8468 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8469 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8470 # &quot;metadata&quot;: {
8471 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8472 # }
8473 # }
8474 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8475 # is typically the registered service name of the tool or product that
8476 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8477 # generated by some common infrastructure, the error domain must be a
8478 # globally unique value that identifies the infrastructure. For Google API
8479 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8480 &quot;metadatas&quot;: { # Additional structured details about this error.
8481 #
8482 # Keys must match a regular expression of `a-z+` but should
8483 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8484 # length. When identifying the current value of an exceeded limit, the units
8485 # should be contained in the key, not the value. For example, rather than
8486 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8487 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8488 # instances that can be created in a single (batch) request.
8489 &quot;a_key&quot;: &quot;A String&quot;,
8490 },
8491 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8492 # proximate cause of the error. Error reasons are unique within a particular
8493 # domain of errors. This should be at most 63 characters and match a
8494 # regular expression of `A-Z+[A-Z0-9]`, which represents
8495 # UPPER_SNAKE_CASE.
8496 },
8497 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8498 #
8499 # For example, if a quota check failed with an error indicating the calling
8500 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8501 # directly to the right place in the developer console to flip the bit.
8502 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8503 { # Describes a URL link.
8504 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8505 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8506 },
8507 ],
8508 },
8509 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8510 # which can be attached to an RPC error.
8511 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8512 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8513 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8514 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8515 },
8516 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8517 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8518 &quot;a_key&quot;: &quot;A String&quot;,
8519 },
8520 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8521 # type or metric.
8522 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8523 # or metric.
8524 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8525 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8526 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8527 },
8528 },
8529 ],
8530 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8531 # This property is optional.
8532 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8533 },
8534 ],
8535 },
8536 },
8537 &quot;provisioningOperations&quot;: [ # Output only. [Output only] Fully qualified URL of the provisioning GCE operation to
8538 # track the provisioning along with provisioning errors. The referenced
8539 # operation may not exist after having been deleted or expired.
8540 &quot;A String&quot;,
8541 ],
8542 &quot;queuingPolicy&quot;: { # Queuing parameters for the requested deferred capacity. # Output only. Constraints for the time when the resource(s) start provisioning. Always
8543 # exposed as absolute times.
8544 &quot;validUntilDuration&quot;: { # A Duration represents a fixed-length span of time represented # Relative deadline for waiting for capacity.
8545 # as a count of seconds and fractions of seconds at nanosecond
8546 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
8547 # or &quot;month&quot;. Range is approximately 10,000 years.
8548 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
8549 # Durations less than one second are represented with a 0
8550 # `seconds` field and a positive `nanos` field. Must be from 0
8551 # to 999,999,999 inclusive.
8552 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
8553 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
8554 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
8555 },
8556 &quot;validUntilTime&quot;: &quot;A String&quot;, # Absolute deadline for waiting for capacity inRFC3339
8557 # text format.
8558 },
8559 },
8560 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the zone where the resource resides. Only applicable
8561 # for zonal resources. You must specify this field as part of the HTTP
8562 # request URL. It is not settable as a field in the request body.
8563 },
8564 ],
8565 &quot;kind&quot;: &quot;compute#queuedResourceList&quot;, # Output only. Type of resource.
8566 &quot;nextPageToken&quot;: &quot;A String&quot;, # This token allows you to get the next page of results formaxResults, use the nextPageToken as a value for
8567 # the query parameter pageToken in the next list request.
8568 # Subsequent list requests will have their own nextPageToken to
8569 # continue paging through the results.
8570 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output only] Server-defined URL for this resource.
8571 &quot;unreachables&quot;: [ # Output only. [Output only] Unreachable resources.
8572 &quot;A String&quot;,
8573 ],
8574 &quot;warning&quot;: { # Informational warning message.
8575 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8576 # Engine returns NO_RESULTS_ON_PAGE if there
8577 # are no results in the response.
8578 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8579 # value format. For example:
8580 #
8581 # &quot;data&quot;: [
8582 # {
8583 # &quot;key&quot;: &quot;scope&quot;,
8584 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8585 # }
8586 {
8587 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8588 # returned. For example, for warnings where there are no results in a list
8589 # request for a particular zone, this key might be scope and
8590 # the key value might be the zone name. Other examples might be a key
8591 # indicating a deprecated resource and a suggested replacement, or a
8592 # warning about invalid network settings (for example, if an instance
8593 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8594 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8595 },
8596 ],
8597 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8598 },
8599 }</pre>
8600 </div>
8601
8602 <div class="method">
8603 <code class="details" id="list_next">list_next()</code>
8604 <pre>Retrieves the next page of results.
8605
8606 Args:
8607 previous_request: The request for the previous page. (required)
8608 previous_response: The response from the request for the previous page. (required)
8609
8610 Returns:
8611 A request object that you can call &#x27;execute()&#x27; on to request the next
8612 page. Returns None if there are no more items in the collection.
8613 </pre>
8614 </div>
8615
8616 </body></html>