Debian Codegraph @

docs/dyn/compute_beta.regionInstances.html

raw
1 <html><body>
2 <style>
3
4 body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13 }
14
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51 }
52
53 .toc_element {
54 margin-top: 0.5em;
55 }
56
57 .firstline {
58 margin-left: 2 em;
59 }
60
61 .method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66 }
67
68 .details {
69 font-weight: bold;
70 font-size: 14px;
71 }
72
73 </style>
74
75 <h1><a href="compute_beta.html">Compute Engine API</a> . <a href="compute_beta.regionInstances.html">regionInstances</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#bulkInsert">bulkInsert(project, region, body=None, requestId=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Creates multiple instances in a given region. Count specifies the number of</p>
80 <p class="toc_element">
81 <code><a href="#close">close()</a></code></p>
82 <p class="firstline">Close httplib2 connections.</p>
83 <h3>Method Details</h3>
84 <div class="method">
85 <code class="details" id="bulkInsert">bulkInsert(project, region, body=None, requestId=None, x__xgafv=None)</code>
86 <pre>Creates multiple instances in a given region. Count specifies the number of
87 instances to create.
88
89 Args:
90 project: string, Project ID for this request. (required)
91 region: string, The name of the region for this request. (required)
92 body: object, The request body.
93 The object takes the form of:
94
95 { # A transient resource used in compute.instances.bulkInsert and
96 # compute.regionInstances.bulkInsert . This resource is not persisted
97 # anywhere, it is used only for processing the requests.
98 &quot;count&quot;: &quot;A String&quot;, # The maximum number of instances to create.
99 &quot;instanceFlexibilityPolicy&quot;: { # A flexible specification of machine types for instances to create. # A flexible specification of machine type of instances to create.
100 &quot;instanceSelections&quot;: { # Specification of alternative, flexible instance subsets.
101 # One of them will be selected to create the instances
102 # based on various criteria, like:
103 # - ranks,
104 # - location policy,
105 # - current capacity,
106 # - available reservations (you can specify affinity in
107 # InstanceProperties),
108 # - SWAN/GOOSE limitations.
109 # Key is an arbitrary, unique RFC1035 string that identifies the instance
110 # selection.
111 &quot;a_key&quot;: { # Specification of machine type to use. Every position inside this message
112 # is an alternative.
113 # The count specified in the shape flexibility must not exceed the number
114 # of entries in per_instance_properties or the capacity of the
115 # name_pattern, if used.
116 &quot;disks&quot;: [ # Disks to be attached to the instances created from in this selection.
117 # They override the disks specified in the instance properties.
118 { # An instance-attached disk resource.
119 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
120 # or X86_64.
121 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
122 # deleted (but not when the disk is detached from the instance).
123 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
124 # partition of the disk for its root filesystem.
125 &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
126 # running within the instance. This name can be used to reference the device
127 # for mounting, resizing, and so on, from within the instance.
128 #
129 # If not specified, the server chooses a default device name to apply to this
130 # disk, in the form persistent-disk-x, where x is a number
131 # assigned by Google Compute Engine. This field is only applicable for
132 # persistent disks.
133 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
134 # encryption key.
135 #
136 # If you are creating a new disk, this field encrypts the new disk using
137 # an encryption key that you provide. If you are attaching an existing
138 # disk that is already encrypted, this field decrypts the disk using
139 # the customer-supplied encryption key.
140 #
141 # If you encrypt a disk using a customer-supplied key, you must provide the
142 # same key again when you attempt to use this resource at a later time. For
143 # example, you must provide the key when you create a snapshot or an image
144 # from the disk or when you attach the disk to a virtual machine instance.
145 #
146 # If you do not provide an encryption key, then the disk will be encrypted
147 # using an automatically generated key and you do not need to provide a key
148 # to use the disk later.
149 #
150 # Note:
151 #
152 # Instance templates do not storecustomer-supplied
153 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
154 #
155 # You cannot create VMs that have disks with customer-supplied keys using
156 # the bulk
157 # insert method.
158 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
159 # For example:
160 #
161 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
162 # key_region/cryptoKeys/key
163 #
164 # The fully-qualifed key name may be returned for resource GET requests. For
165 # example:
166 #
167 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
168 # key_region/cryptoKeys/key
169 # /cryptoKeyVersions/1
170 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
171 # key. If absent, the Compute Engine default service account is used.
172 # For example:
173 #
174 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
175 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
176 # encryption key, encoded in RFC
177 # 4648 base64 to either encrypt or decrypt this resource. You can
178 # provide either the rawKey or thersaEncryptedKey.
179 # For example:
180 #
181 # &quot;rawKey&quot;:
182 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
183 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
184 # customer-supplied encryption key to either encrypt or decrypt this
185 # resource. You can provide either the rawKey or thersaEncryptedKey.
186 # For example:
187 #
188 # &quot;rsaEncryptedKey&quot;:
189 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
190 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
191 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
192 #
193 # The key must meet the following requirements before you can provide it to
194 # Compute Engine:
195 #
196 # 1. The key is wrapped using a RSA public key certificate provided by
197 # Google.
198 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
199 # encoding.
200 #
201 # Gets the RSA public key certificate provided by Google at:
202 #
203 #
204 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
205 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
206 # 4648 base64 encoded SHA-256 hash of the customer-supplied
207 # encryption key that protects this resource.
208 },
209 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
210 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
211 # currently attached to another instance. If you try to force attach a zonal
212 # disk to an instance, you will receive an error.
213 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
214 # only for bootable images. Read
215 # Enabling guest operating system features to see a list of available
216 # options.
217 { # Guest OS features.
218 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
219 # separate values. Set to one or more of the following values:
220 #
221 # - VIRTIO_SCSI_MULTIQUEUE
222 # - WINDOWS
223 # - MULTI_IP_SUBNET
224 # - UEFI_COMPATIBLE
225 # - GVNIC
226 # - SEV_CAPABLE
227 # - SUSPEND_RESUME_COMPATIBLE
228 # - SEV_LIVE_MIGRATABLE_V2
229 # - SEV_SNP_CAPABLE
230 # - TDX_CAPABLE
231 # - IDPF
232 # - SNP_SVSM_CAPABLE
233 # - CCA_CAPABLE
234 #
235 #
236 # For more information, see
237 # Enabling guest operating system features.
238 },
239 ],
240 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
241 # boot disk. If you have many disks attached to an instance, each
242 # disk would have a unique index number.
243 &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
244 # alongside the new instance. Use initialization parameters to create boot
245 # disks or local SSDs attached to the new instance.
246 #
247 # This property is mutually exclusive with the source property;
248 # you can only define one or the other, but not both.
249 # alongside the new instance. Use initialization parameters to create boot
250 # disks or local SSDs attached to the new instance.
251 #
252 # This field is persisted and returned for instanceTemplate and not returned
253 # in the context of instance.
254 #
255 # This property is mutually exclusive with the source property;
256 # you can only define one or the other, but not both.
257 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
258 # arm64 or x86_64.
259 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
260 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
261 # of the instance. If a disk with the same name already exists in the given
262 # region, the existing disk is attached to the new instance and the
263 # new disk is not created.
264 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
265 # 10 GB. If you specify a sourceImage, which is required for
266 # boot disks, the default size is the size of the sourceImage.
267 # If you do not specify a sourceImage, the default disk size
268 # is 500 GB.
269 &quot;diskType&quot;: &quot;A String&quot;,
270 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
271 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
272 # only for bootable images. Read
273 # Enabling guest operating system features to see a list of available
274 # options.
275 #
276 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
277 { # Guest OS features.
278 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
279 # separate values. Set to one or more of the following values:
280 #
281 # - VIRTIO_SCSI_MULTIQUEUE
282 # - WINDOWS
283 # - MULTI_IP_SUBNET
284 # - UEFI_COMPATIBLE
285 # - GVNIC
286 # - SEV_CAPABLE
287 # - SUSPEND_RESUME_COMPATIBLE
288 # - SEV_LIVE_MIGRATABLE_V2
289 # - SEV_SNP_CAPABLE
290 # - TDX_CAPABLE
291 # - IDPF
292 # - SNP_SVSM_CAPABLE
293 # - CCA_CAPABLE
294 #
295 #
296 # For more information, see
297 # Enabling guest operating system features.
298 },
299 ],
300 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
301 # persistent disks.
302 &quot;a_key&quot;: &quot;A String&quot;,
303 },
304 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
305 &quot;A String&quot;,
306 ],
307 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
308 # more than one instance.
309 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
310 # is to use the existing disk.
311 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
312 # of I/O operations per second that the disk can handle. Values must be
313 # between 10,000 and 120,000. For more details, see theExtreme persistent
314 # disk documentation.
315 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
316 # number of throughput mb per second that the disk can handle. Values must
317 # greater than or equal to 1.
318 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
319 # the URLs of the zones where the disk should be replicated to.
320 # You must provide exactly two replica zones, and one zone must be the same
321 # as the instance zone.
322 &quot;A String&quot;,
323 ],
324 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
325 # have the same definition as resource
326 # manager tags. Keys and values can be either in numeric format,
327 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
328 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
329 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
330 # empty.
331 &quot;a_key&quot;: &quot;A String&quot;,
332 },
333 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
334 # Specified using the full or partial URL. For instance template, specify
335 # only the resource policy name.
336 &quot;A String&quot;,
337 ],
338 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
339 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
340 # is required.
341 #
342 # To create a disk with one of the public operating system
343 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
344 #
345 # projects/debian-cloud/global/images/family/debian-9
346 #
347 #
348 # Alternatively, use a specific version of a public operating system image:
349 #
350 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
351 #
352 #
353 # To create a disk with a custom image that you created, specify the
354 # image name in the following format:
355 #
356 # global/images/my-custom-image
357 #
358 #
359 # You can also specify a custom image by its image family, which returns
360 # the latest version of the image in that family. Replace the image name
361 # with family/family-name:
362 #
363 # global/images/family/my-image-family
364 #
365 #
366 # If the source image is deleted later, this field will not be set.
367 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
368 # encryption key of the source image. Required if the source image is
369 # protected by a customer-supplied encryption key.
370 #
371 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
372 # encryption keys, so you cannot create disks for instances in a managed instance group if the
373 # source images are encrypted with your own keys.
374 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
375 # For example:
376 #
377 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
378 # key_region/cryptoKeys/key
379 #
380 # The fully-qualifed key name may be returned for resource GET requests. For
381 # example:
382 #
383 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
384 # key_region/cryptoKeys/key
385 # /cryptoKeyVersions/1
386 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
387 # key. If absent, the Compute Engine default service account is used.
388 # For example:
389 #
390 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
391 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
392 # encryption key, encoded in RFC
393 # 4648 base64 to either encrypt or decrypt this resource. You can
394 # provide either the rawKey or thersaEncryptedKey.
395 # For example:
396 #
397 # &quot;rawKey&quot;:
398 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
399 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
400 # customer-supplied encryption key to either encrypt or decrypt this
401 # resource. You can provide either the rawKey or thersaEncryptedKey.
402 # For example:
403 #
404 # &quot;rsaEncryptedKey&quot;:
405 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
406 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
407 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
408 #
409 # The key must meet the following requirements before you can provide it to
410 # Compute Engine:
411 #
412 # 1. The key is wrapped using a RSA public key certificate provided by
413 # Google.
414 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
415 # encoding.
416 #
417 # Gets the RSA public key certificate provided by Google at:
418 #
419 #
420 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
421 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
422 # 4648 base64 encoded SHA-256 hash of the customer-supplied
423 # encryption key that protects this resource.
424 },
425 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
426 # instance boot disk, one of initializeParams.sourceSnapshot
427 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
428 # is required.
429 #
430 # To create a disk with a snapshot that you created, specify the
431 # snapshot name in the following format:
432 #
433 # us-central1-a/instantSnapshots/my-backup
434 #
435 #
436 # If the source instant-snapshot is deleted later, this field will not be
437 # set.
438 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
439 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
440 # is required.
441 #
442 # To create a disk with a snapshot that you created, specify the
443 # snapshot name in the following format:
444 #
445 # global/snapshots/my-backup
446 #
447 #
448 # If the source snapshot is deleted later, this field will not be set.
449 #
450 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
451 # an image instead when you create VMs using
452 # the bulk
453 # insert method.
454 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
455 # encryption key of the source snapshot.
456 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
457 # For example:
458 #
459 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
460 # key_region/cryptoKeys/key
461 #
462 # The fully-qualifed key name may be returned for resource GET requests. For
463 # example:
464 #
465 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
466 # key_region/cryptoKeys/key
467 # /cryptoKeyVersions/1
468 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
469 # key. If absent, the Compute Engine default service account is used.
470 # For example:
471 #
472 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
473 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
474 # encryption key, encoded in RFC
475 # 4648 base64 to either encrypt or decrypt this resource. You can
476 # provide either the rawKey or thersaEncryptedKey.
477 # For example:
478 #
479 # &quot;rawKey&quot;:
480 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
481 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
482 # customer-supplied encryption key to either encrypt or decrypt this
483 # resource. You can provide either the rawKey or thersaEncryptedKey.
484 # For example:
485 #
486 # &quot;rsaEncryptedKey&quot;:
487 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
488 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
489 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
490 #
491 # The key must meet the following requirements before you can provide it to
492 # Compute Engine:
493 #
494 # 1. The key is wrapped using a RSA public key certificate provided by
495 # Google.
496 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
497 # encoding.
498 #
499 # Gets the RSA public key certificate provided by Google at:
500 #
501 #
502 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
503 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
504 # 4648 base64 encoded SHA-256 hash of the customer-supplied
505 # encryption key that protects this resource.
506 },
507 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
508 # this as a partial or full URL to the resource. For example, the following
509 # are valid values:
510 #
511 #
512 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
513 # - projects/project/zones/zone/storagePools/storagePool
514 # - zones/zone/storagePools/storagePool
515 },
516 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
517 # either SCSI or NVME. For most machine types, the
518 # default is SCSI. Local SSDs can use either NVME or SCSI.
519 # In certain configurations, persistent disks can use NVMe. For more
520 # information, seeAbout
521 # persistent disks.
522 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
523 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
524 &quot;A String&quot;,
525 ],
526 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
527 # disk is not allowed to be detached from the instance, or to be used as the
528 # source of the snapshot creation, and the image creation. The instance with
529 # at least one locked attached disk is not allow to be used as source of
530 # machine image creation, instant snapshot creation, and not allowed to be
531 # deleted with --keep-disk parameter set to true for locked disks.
532 &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
533 # in READ_WRITE mode.
534 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
535 # field is set to PRESERVED if the LocalSSD data has been saved
536 # to a persistent location by customer request. (see the
537 # discard_local_ssd option on Stop/Suspend).
538 # Read-only in the api.
539 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
540 # these are public keys which are safe to store in public
541 &quot;dbs&quot;: [ # The Key Database (db).
542 {
543 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
544 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
545 },
546 ],
547 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
548 {
549 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
550 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
551 },
552 ],
553 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
554 {
555 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
556 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
557 },
558 ],
559 &quot;pk&quot;: { # The Platform Key (PK).
560 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
561 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
562 },
563 },
564 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
565 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
566 # is required.
567 #
568 # If desired, you can also attach existing non-root persistent disks using
569 # this property. This field is only applicable for persistent disks.
570 #
571 # Note that for InstanceTemplate, specify the disk name for zonal disk,
572 # and the URL for regional disk.
573 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
574 },
575 ],
576 &quot;machineTypes&quot;: [ # Alternative machine types to use for instances that are created from
577 # these properties. This field only accepts a machine type names, for
578 # example `n2-standard-4` and not URLs or partial URLs.
579 &quot;A String&quot;,
580 ],
581 &quot;rank&quot;: &quot;A String&quot;, # Rank when prioritizing the shape flexibilities.
582 # The instance selections with rank are considered
583 # first, in the ascending order of the rank.
584 # If not set, defaults to 0.
585 },
586 },
587 },
588 &quot;instanceProperties&quot;: { # The instance properties defining the VM instances to be created. Required
589 # if sourceInstanceTemplate is not provided.
590 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
591 # Note that for MachineImage, this is not supported yet.
592 # Options that would traditionally be configured in a BIOS belong
593 # here. Features that require operating system support may have
594 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
595 # disabled).
596 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
597 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
598 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
599 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
600 # multithreading (SMT) set this to 1. If unset, the maximum number
601 # of threads supported per core by the underlying processor is
602 # assumed.
603 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
604 # Supported modes include:
605 # * ALL_CORE_MAX
606 #
607 # Using empty string or not setting this field will use the platform-specific
608 # default turbo mode.
609 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
610 # the number of threads per core to compute the total number of virtual
611 # CPUs to expose to the instance. If unset, the number of cores is
612 # inferred from the instance&#x27;s nominal CPU count and the underlying
613 # platform&#x27;s SMT width.
614 },
615 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
616 # source IP addresses other than their own and receive packets with
617 # destination IP addresses other than their own. If these instances will be
618 # used as an IP gateway or it will be set as the next-hop in a Route
619 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
620 # documentation for more information.
621 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
622 # Note that for MachineImage, this is not supported yet.
623 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
624 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
625 },
626 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
627 # properties.
628 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
629 # from these properties.
630 { # An instance-attached disk resource.
631 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
632 # or X86_64.
633 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
634 # deleted (but not when the disk is detached from the instance).
635 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
636 # partition of the disk for its root filesystem.
637 &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
638 # running within the instance. This name can be used to reference the device
639 # for mounting, resizing, and so on, from within the instance.
640 #
641 # If not specified, the server chooses a default device name to apply to this
642 # disk, in the form persistent-disk-x, where x is a number
643 # assigned by Google Compute Engine. This field is only applicable for
644 # persistent disks.
645 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
646 # encryption key.
647 #
648 # If you are creating a new disk, this field encrypts the new disk using
649 # an encryption key that you provide. If you are attaching an existing
650 # disk that is already encrypted, this field decrypts the disk using
651 # the customer-supplied encryption key.
652 #
653 # If you encrypt a disk using a customer-supplied key, you must provide the
654 # same key again when you attempt to use this resource at a later time. For
655 # example, you must provide the key when you create a snapshot or an image
656 # from the disk or when you attach the disk to a virtual machine instance.
657 #
658 # If you do not provide an encryption key, then the disk will be encrypted
659 # using an automatically generated key and you do not need to provide a key
660 # to use the disk later.
661 #
662 # Note:
663 #
664 # Instance templates do not storecustomer-supplied
665 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
666 #
667 # You cannot create VMs that have disks with customer-supplied keys using
668 # the bulk
669 # insert method.
670 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
671 # For example:
672 #
673 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
674 # key_region/cryptoKeys/key
675 #
676 # The fully-qualifed key name may be returned for resource GET requests. For
677 # example:
678 #
679 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
680 # key_region/cryptoKeys/key
681 # /cryptoKeyVersions/1
682 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
683 # key. If absent, the Compute Engine default service account is used.
684 # For example:
685 #
686 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
687 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
688 # encryption key, encoded in RFC
689 # 4648 base64 to either encrypt or decrypt this resource. You can
690 # provide either the rawKey or thersaEncryptedKey.
691 # For example:
692 #
693 # &quot;rawKey&quot;:
694 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
695 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
696 # customer-supplied encryption key to either encrypt or decrypt this
697 # resource. You can provide either the rawKey or thersaEncryptedKey.
698 # For example:
699 #
700 # &quot;rsaEncryptedKey&quot;:
701 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
702 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
703 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
704 #
705 # The key must meet the following requirements before you can provide it to
706 # Compute Engine:
707 #
708 # 1. The key is wrapped using a RSA public key certificate provided by
709 # Google.
710 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
711 # encoding.
712 #
713 # Gets the RSA public key certificate provided by Google at:
714 #
715 #
716 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
717 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
718 # 4648 base64 encoded SHA-256 hash of the customer-supplied
719 # encryption key that protects this resource.
720 },
721 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
722 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
723 # currently attached to another instance. If you try to force attach a zonal
724 # disk to an instance, you will receive an error.
725 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
726 # only for bootable images. Read
727 # Enabling guest operating system features to see a list of available
728 # options.
729 { # Guest OS features.
730 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
731 # separate values. Set to one or more of the following values:
732 #
733 # - VIRTIO_SCSI_MULTIQUEUE
734 # - WINDOWS
735 # - MULTI_IP_SUBNET
736 # - UEFI_COMPATIBLE
737 # - GVNIC
738 # - SEV_CAPABLE
739 # - SUSPEND_RESUME_COMPATIBLE
740 # - SEV_LIVE_MIGRATABLE_V2
741 # - SEV_SNP_CAPABLE
742 # - TDX_CAPABLE
743 # - IDPF
744 # - SNP_SVSM_CAPABLE
745 # - CCA_CAPABLE
746 #
747 #
748 # For more information, see
749 # Enabling guest operating system features.
750 },
751 ],
752 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
753 # boot disk. If you have many disks attached to an instance, each
754 # disk would have a unique index number.
755 &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
756 # alongside the new instance. Use initialization parameters to create boot
757 # disks or local SSDs attached to the new instance.
758 #
759 # This property is mutually exclusive with the source property;
760 # you can only define one or the other, but not both.
761 # alongside the new instance. Use initialization parameters to create boot
762 # disks or local SSDs attached to the new instance.
763 #
764 # This field is persisted and returned for instanceTemplate and not returned
765 # in the context of instance.
766 #
767 # This property is mutually exclusive with the source property;
768 # you can only define one or the other, but not both.
769 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
770 # arm64 or x86_64.
771 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
772 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
773 # of the instance. If a disk with the same name already exists in the given
774 # region, the existing disk is attached to the new instance and the
775 # new disk is not created.
776 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
777 # 10 GB. If you specify a sourceImage, which is required for
778 # boot disks, the default size is the size of the sourceImage.
779 # If you do not specify a sourceImage, the default disk size
780 # is 500 GB.
781 &quot;diskType&quot;: &quot;A String&quot;,
782 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
783 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
784 # only for bootable images. Read
785 # Enabling guest operating system features to see a list of available
786 # options.
787 #
788 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
789 { # Guest OS features.
790 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
791 # separate values. Set to one or more of the following values:
792 #
793 # - VIRTIO_SCSI_MULTIQUEUE
794 # - WINDOWS
795 # - MULTI_IP_SUBNET
796 # - UEFI_COMPATIBLE
797 # - GVNIC
798 # - SEV_CAPABLE
799 # - SUSPEND_RESUME_COMPATIBLE
800 # - SEV_LIVE_MIGRATABLE_V2
801 # - SEV_SNP_CAPABLE
802 # - TDX_CAPABLE
803 # - IDPF
804 # - SNP_SVSM_CAPABLE
805 # - CCA_CAPABLE
806 #
807 #
808 # For more information, see
809 # Enabling guest operating system features.
810 },
811 ],
812 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
813 # persistent disks.
814 &quot;a_key&quot;: &quot;A String&quot;,
815 },
816 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
817 &quot;A String&quot;,
818 ],
819 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
820 # more than one instance.
821 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
822 # is to use the existing disk.
823 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
824 # of I/O operations per second that the disk can handle. Values must be
825 # between 10,000 and 120,000. For more details, see theExtreme persistent
826 # disk documentation.
827 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
828 # number of throughput mb per second that the disk can handle. Values must
829 # greater than or equal to 1.
830 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
831 # the URLs of the zones where the disk should be replicated to.
832 # You must provide exactly two replica zones, and one zone must be the same
833 # as the instance zone.
834 &quot;A String&quot;,
835 ],
836 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
837 # have the same definition as resource
838 # manager tags. Keys and values can be either in numeric format,
839 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
840 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
841 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
842 # empty.
843 &quot;a_key&quot;: &quot;A String&quot;,
844 },
845 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
846 # Specified using the full or partial URL. For instance template, specify
847 # only the resource policy name.
848 &quot;A String&quot;,
849 ],
850 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
851 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
852 # is required.
853 #
854 # To create a disk with one of the public operating system
855 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
856 #
857 # projects/debian-cloud/global/images/family/debian-9
858 #
859 #
860 # Alternatively, use a specific version of a public operating system image:
861 #
862 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
863 #
864 #
865 # To create a disk with a custom image that you created, specify the
866 # image name in the following format:
867 #
868 # global/images/my-custom-image
869 #
870 #
871 # You can also specify a custom image by its image family, which returns
872 # the latest version of the image in that family. Replace the image name
873 # with family/family-name:
874 #
875 # global/images/family/my-image-family
876 #
877 #
878 # If the source image is deleted later, this field will not be set.
879 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
880 # encryption key of the source image. Required if the source image is
881 # protected by a customer-supplied encryption key.
882 #
883 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
884 # encryption keys, so you cannot create disks for instances in a managed instance group if the
885 # source images are encrypted with your own keys.
886 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
887 # For example:
888 #
889 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
890 # key_region/cryptoKeys/key
891 #
892 # The fully-qualifed key name may be returned for resource GET requests. For
893 # example:
894 #
895 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
896 # key_region/cryptoKeys/key
897 # /cryptoKeyVersions/1
898 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
899 # key. If absent, the Compute Engine default service account is used.
900 # For example:
901 #
902 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
903 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
904 # encryption key, encoded in RFC
905 # 4648 base64 to either encrypt or decrypt this resource. You can
906 # provide either the rawKey or thersaEncryptedKey.
907 # For example:
908 #
909 # &quot;rawKey&quot;:
910 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
911 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
912 # customer-supplied encryption key to either encrypt or decrypt this
913 # resource. You can provide either the rawKey or thersaEncryptedKey.
914 # For example:
915 #
916 # &quot;rsaEncryptedKey&quot;:
917 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
918 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
919 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
920 #
921 # The key must meet the following requirements before you can provide it to
922 # Compute Engine:
923 #
924 # 1. The key is wrapped using a RSA public key certificate provided by
925 # Google.
926 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
927 # encoding.
928 #
929 # Gets the RSA public key certificate provided by Google at:
930 #
931 #
932 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
933 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
934 # 4648 base64 encoded SHA-256 hash of the customer-supplied
935 # encryption key that protects this resource.
936 },
937 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
938 # instance boot disk, one of initializeParams.sourceSnapshot
939 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
940 # is required.
941 #
942 # To create a disk with a snapshot that you created, specify the
943 # snapshot name in the following format:
944 #
945 # us-central1-a/instantSnapshots/my-backup
946 #
947 #
948 # If the source instant-snapshot is deleted later, this field will not be
949 # set.
950 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
951 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
952 # is required.
953 #
954 # To create a disk with a snapshot that you created, specify the
955 # snapshot name in the following format:
956 #
957 # global/snapshots/my-backup
958 #
959 #
960 # If the source snapshot is deleted later, this field will not be set.
961 #
962 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
963 # an image instead when you create VMs using
964 # the bulk
965 # insert method.
966 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
967 # encryption key of the source snapshot.
968 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
969 # For example:
970 #
971 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
972 # key_region/cryptoKeys/key
973 #
974 # The fully-qualifed key name may be returned for resource GET requests. For
975 # example:
976 #
977 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
978 # key_region/cryptoKeys/key
979 # /cryptoKeyVersions/1
980 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
981 # key. If absent, the Compute Engine default service account is used.
982 # For example:
983 #
984 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
985 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
986 # encryption key, encoded in RFC
987 # 4648 base64 to either encrypt or decrypt this resource. You can
988 # provide either the rawKey or thersaEncryptedKey.
989 # For example:
990 #
991 # &quot;rawKey&quot;:
992 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
993 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
994 # customer-supplied encryption key to either encrypt or decrypt this
995 # resource. You can provide either the rawKey or thersaEncryptedKey.
996 # For example:
997 #
998 # &quot;rsaEncryptedKey&quot;:
999 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1000 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1001 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1002 #
1003 # The key must meet the following requirements before you can provide it to
1004 # Compute Engine:
1005 #
1006 # 1. The key is wrapped using a RSA public key certificate provided by
1007 # Google.
1008 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1009 # encoding.
1010 #
1011 # Gets the RSA public key certificate provided by Google at:
1012 #
1013 #
1014 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1015 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1016 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1017 # encryption key that protects this resource.
1018 },
1019 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
1020 # this as a partial or full URL to the resource. For example, the following
1021 # are valid values:
1022 #
1023 #
1024 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
1025 # - projects/project/zones/zone/storagePools/storagePool
1026 # - zones/zone/storagePools/storagePool
1027 },
1028 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
1029 # either SCSI or NVME. For most machine types, the
1030 # default is SCSI. Local SSDs can use either NVME or SCSI.
1031 # In certain configurations, persistent disks can use NVMe. For more
1032 # information, seeAbout
1033 # persistent disks.
1034 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
1035 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
1036 &quot;A String&quot;,
1037 ],
1038 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
1039 # disk is not allowed to be detached from the instance, or to be used as the
1040 # source of the snapshot creation, and the image creation. The instance with
1041 # at least one locked attached disk is not allow to be used as source of
1042 # machine image creation, instant snapshot creation, and not allowed to be
1043 # deleted with --keep-disk parameter set to true for locked disks.
1044 &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
1045 # in READ_WRITE mode.
1046 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
1047 # field is set to PRESERVED if the LocalSSD data has been saved
1048 # to a persistent location by customer request. (see the
1049 # discard_local_ssd option on Stop/Suspend).
1050 # Read-only in the api.
1051 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
1052 # these are public keys which are safe to store in public
1053 &quot;dbs&quot;: [ # The Key Database (db).
1054 {
1055 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1056 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1057 },
1058 ],
1059 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
1060 {
1061 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1062 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1063 },
1064 ],
1065 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
1066 {
1067 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1068 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1069 },
1070 ],
1071 &quot;pk&quot;: { # The Platform Key (PK).
1072 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1073 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1074 },
1075 },
1076 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
1077 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1078 # is required.
1079 #
1080 # If desired, you can also attach existing non-root persistent disks using
1081 # this property. This field is only applicable for persistent disks.
1082 #
1083 # Note that for InstanceTemplate, specify the disk name for zonal disk,
1084 # and the URL for regional disk.
1085 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
1086 },
1087 ],
1088 &quot;displayDevice&quot;: { # A set of Display Device options # Display Device properties to enable support
1089 # for remote display products like: Teradici,
1090 # VNC and TeamViewer
1091 # Note that for MachineImage, this is not supported yet.
1092 &quot;enableDisplay&quot;: True or False, # Defines whether the instance has Display enabled.
1093 },
1094 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
1095 # created from these properties.
1096 { # A specification of the type and number of accelerator cards attached to the
1097 # instance.
1098 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
1099 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
1100 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
1101 # If you are creating an instance template, specify only the
1102 # accelerator name.
1103 # See GPUs on Compute Engine
1104 # for a full list of accelerator types.
1105 },
1106 ],
1107 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
1108 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
1109 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
1110 &quot;a_key&quot;: &quot;A String&quot;,
1111 },
1112 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
1113 # properties.
1114 # This field only accepts a machine type name, for example `n2-standard-4`.
1115 # If you use the machine type full or partial URL, for example
1116 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
1117 # the request will result in an `INTERNAL_ERROR`.
1118 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
1119 # these properties. These pairs can consist of custom metadata or predefined
1120 # keys. SeeProject and
1121 # instance metadata for more information.
1122 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
1123 # the metadata&#x27;s contents and used for optimistic locking. The
1124 # fingerprint is initially generated by Compute Engine and changes after
1125 # every request to modify or update metadata. You must always provide an
1126 # up-to-date fingerprint hash in order to update or change metadata,
1127 # otherwise the request will fail with error412 conditionNotMet.
1128 #
1129 # To see the latest fingerprint, make a get() request to
1130 # retrieve the resource.
1131 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
1132 # less than 512 KB.
1133 { # Metadata
1134 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
1135 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
1136 # This is reflected as part of a URL in the metadata server. Additionally, to
1137 # avoid ambiguity, keys must not conflict with any other metadata keys
1138 # for the project.
1139 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
1140 # have meaning as interpreted by the image running in the instance. The
1141 # only restriction placed on values is that their size must be less than
1142 # or equal to 262144 bytes (256 KiB).
1143 },
1144 ],
1145 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
1146 # for metadata.
1147 },
1148 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
1149 # scheduled on the specified or newer cpu/platform. Applicable values are the
1150 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
1151 # information, read Specifying a
1152 # Minimum CPU Platform.
1153 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
1154 { # A network interface resource attached to an instance.
1155 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
1156 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
1157 # no external internet access.
1158 { # An access configuration attached to an instance&#x27;s network interface.
1159 # Only one access config per instance is supported.
1160 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1161 # The first IPv6 address of the external IPv6 range associated
1162 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1163 # use a static external IP address, it must be unused and in the same region
1164 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1165 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1166 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1167 # external IPv6 range.
1168 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1169 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1170 # (IPv4), the default and recommended name is External NAT, but
1171 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1172 # recommend name is External IPv6.
1173 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1174 # address associated with this instance. Specify an unused static
1175 # external IP address available to the project or leave this field undefined
1176 # to use an IP from a shared ephemeral IP address pool. If you specify a
1177 # static external IP address, it must live in the same region as the zone of
1178 # the instance.
1179 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1180 # configuration and can only take the following values: PREMIUM,STANDARD.
1181 #
1182 # If an AccessConfig is specified without a valid external IP address, an
1183 # ephemeral IP will be created with this networkTier.
1184 #
1185 # If an AccessConfig with a valid external IP address is specified, it must
1186 # match that of the networkTier associated with the Address resource owning
1187 # that IP.
1188 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
1189 #
1190 # 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
1191 # first IP in associated external IPv6 range.
1192 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
1193 # config.
1194 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
1195 # external IP address of the instance to a DNS domain name.
1196 #
1197 # This field is not used in ipv6AccessConfig. A default PTR
1198 # record will be created if the VM has external IPv6 range associated.
1199 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
1200 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
1201 },
1202 ],
1203 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
1204 # You can only specify this field for network interfaces in VPC networks.
1205 { # An alias IP range attached to an instance&#x27;s network interface.
1206 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1207 # must belong to the specified subnetwork and cannot contain IP addresses
1208 # reserved by system or used by other network interfaces. This range may be
1209 # 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).
1210 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1211 # alias range. If not specified, the primary range of the subnetwork is used.
1212 },
1213 ],
1214 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
1215 # You can only specify this field for network interfaces in VPC networks.
1216 { # An alias IP range attached to an instance&#x27;s network interface.
1217 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1218 # must belong to the specified subnetwork and cannot contain IP addresses
1219 # reserved by system or used by other network interfaces. This range may be
1220 # 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).
1221 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1222 # alias range. If not specified, the primary range of the subnetwork is used.
1223 },
1224 ],
1225 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
1226 # with network_attachment.
1227 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
1228 # This field will be ignored when inserting an Instance or
1229 # adding a NetworkInterface. An up-to-date
1230 # 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.
1231 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
1232 # or not. If enabled, also indicates the version of IGMP supported.
1233 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
1234 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
1235 # one IPv6 access config, DIRECT_IPV6, is supported. If there
1236 # is no ipv6AccessConfig specified, then this instance will
1237 # have no external IPv6 Internet access.
1238 { # An access configuration attached to an instance&#x27;s network interface.
1239 # Only one access config per instance is supported.
1240 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1241 # The first IPv6 address of the external IPv6 range associated
1242 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1243 # use a static external IP address, it must be unused and in the same region
1244 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1245 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1246 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1247 # external IPv6 range.
1248 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1249 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1250 # (IPv4), the default and recommended name is External NAT, but
1251 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1252 # recommend name is External IPv6.
1253 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1254 # address associated with this instance. Specify an unused static
1255 # external IP address available to the project or leave this field undefined
1256 # to use an IP from a shared ephemeral IP address pool. If you specify a
1257 # static external IP address, it must live in the same region as the zone of
1258 # the instance.
1259 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1260 # configuration and can only take the following values: PREMIUM,STANDARD.
1261 #
1262 # If an AccessConfig is specified without a valid external IP address, an
1263 # ephemeral IP will be created with this networkTier.
1264 #
1265 # If an AccessConfig with a valid external IP address is specified, it must
1266 # match that of the networkTier associated with the Address resource owning
1267 # that IP.
1268 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
1269 #
1270 # 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
1271 # first IP in associated external IPv6 range.
1272 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
1273 # config.
1274 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
1275 # external IP address of the instance to a DNS domain name.
1276 #
1277 # This field is not used in ipv6AccessConfig. A default PTR
1278 # record will be created if the VM has external IPv6 range associated.
1279 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
1280 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
1281 },
1282 ],
1283 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
1284 # accessed from the Internet. This field is always inherited from its
1285 # subnetwork.
1286 #
1287 # Valid only if stackType is IPV4_IPV6.
1288 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
1289 # use a static internal IP address, it must be unused and in the same region
1290 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1291 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
1292 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
1293 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
1294 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
1295 # server. For a VM, the network interface uses the nicN naming
1296 # format. Where N is a value between 0 and7. The default interface value is nic0.
1297 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
1298 # instance, if neither the network nor the subnetwork is specified, the
1299 # default network global/networks/default is used. If the
1300 # selected project doesn&#x27;t have the default network, you must specify a
1301 # network or subnet. If the network is not specified but the subnetwork is
1302 # specified, the network is inferred.
1303 #
1304 # If you specify this property, you can specify the network as
1305 # a full or partial URL. For example, the following are all valid URLs:
1306 #
1307 #
1308 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
1309 # - projects/project/global/networks/network
1310 # - global/networks/default
1311 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
1312 # to in the following format:
1313 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
1314 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
1315 # interface. If not specified by the user, an unused internal IP is
1316 # assigned by the system.
1317 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
1318 # VirtioNet.
1319 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
1320 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
1321 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
1322 # if not specified by the users.
1323 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
1324 # interface. Can only be used with network_attachment. It is not possible to
1325 # use on its own however, network_attachment can be used without
1326 # service_class_id.
1327 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
1328 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
1329 #
1330 # This field can be both set at instance creation and update network
1331 # interface operations.
1332 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
1333 # resource is inlegacy
1334 # mode, do not specify this field. If the network is in auto subnet
1335 # mode, specifying the subnetwork is optional. If the network is in custom
1336 # subnet mode, specifying the subnetwork is required. If you specify this
1337 # field, you can specify the subnetwork as a full or partial URL. For
1338 # example, the following are all valid URLs:
1339 #
1340 #
1341 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
1342 # - regions/region/subnetworks/subnetwork
1343 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
1344 # from 2 to 255 inclusively.
1345 },
1346 ],
1347 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
1348 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
1349 },
1350 &quot;partnerMetadata&quot;: { # Partner Metadata assigned to the instance properties. A map from a
1351 # subdomain (namespace) to entries map.
1352 &quot;a_key&quot;: {
1353 &quot;entries&quot;: { # Map of a partner metadata that belong to the same subdomain.
1354 # It accepts any value including google.protobuf.Struct.
1355 &quot;a_key&quot;: &quot;&quot;,
1356 },
1357 },
1358 },
1359 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
1360 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
1361 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
1362 # Note that for MachineImage, this is not supported yet.
1363 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
1364 # Note that for MachineImage, this is not supported yet.
1365 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
1366 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
1367 # Consuming reserved instances for examples.
1368 &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
1369 # the name of your reservation as its value.
1370 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
1371 # either a name to a reservation in the same project or
1372 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
1373 # shared reservation in the same zone but in a different project.
1374 &quot;A String&quot;,
1375 ],
1376 },
1377 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
1378 # have the same definition as resource
1379 # manager tags. Keys and values can be either in numeric format,
1380 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1381 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1382 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
1383 # PATCH) when empty.
1384 &quot;a_key&quot;: &quot;A String&quot;,
1385 },
1386 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
1387 # these properties.
1388 # Note that for MachineImage, this is not supported yet.
1389 &quot;A String&quot;,
1390 ],
1391 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
1392 # these properties.
1393 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
1394 # terminated by Compute Engine (not terminated by a user). You can only set
1395 # the automatic restart option for standard instances.Preemptible instances
1396 # cannot be automatically restarted.
1397 #
1398 # By default, this is set to true so an instance is
1399 # automatically restarted if it is terminated by Compute Engine.
1400 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
1401 # must be a number between 1 and the number of availability domains
1402 # specified in the spread placement policy attached to the instance.
1403 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
1404 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
1405 &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
1406 # graceful shutdown isn&#x27;t complete after this time, then the instance
1407 # transitions to the STOPPING state.
1408 # as a count of seconds and fractions of seconds at nanosecond
1409 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1410 # or &quot;month&quot;. Range is approximately 10,000 years.
1411 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1412 # Durations less than one second are represented with a 0
1413 # `seconds` field and a positive `nanos` field. Must be from 0
1414 # to 999,999,999 inclusive.
1415 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1416 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1417 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1418 },
1419 },
1420 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
1421 # within the range of [90, 330] with the increment of 30, if unset, the
1422 # default behavior of host error recovery will be used.
1423 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
1424 &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
1425 # recovery of the Local Ssd state is attempted. Its value should be in
1426 # between 0 and 168 hours with hour granularity and the default value being 1
1427 # hour.
1428 # as a count of seconds and fractions of seconds at nanosecond
1429 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1430 # or &quot;month&quot;. Range is approximately 10,000 years.
1431 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1432 # Durations less than one second are represented with a 0
1433 # `seconds` field and a positive `nanos` field. Must be from 0
1434 # to 999,999,999 inclusive.
1435 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1436 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1437 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1438 },
1439 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
1440 # resources.
1441 # This field is for use by internal tools that use the public API.
1442 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
1443 # be scheduled for maintenance.
1444 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
1445 # are: `PERIODIC`.
1446 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
1447 # the instance termination action will be performed at the end of the run
1448 # duration.
1449 # as a count of seconds and fractions of seconds at nanosecond
1450 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1451 # or &quot;month&quot;. Range is approximately 10,000 years.
1452 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1453 # Durations less than one second are represented with a 0
1454 # `seconds` field and a positive `nanos` field. Must be from 0
1455 # to 999,999,999 inclusive.
1456 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1457 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1458 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1459 },
1460 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
1461 # on a sole-tenant node.
1462 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
1463 # affinity for more information.
1464 # Overrides reservationAffinity.
1465 { # Node Affinity: the configuration of desired nodes onto which this Instance
1466 # could be scheduled.
1467 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
1468 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
1469 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
1470 &quot;A String&quot;,
1471 ],
1472 },
1473 ],
1474 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
1475 # the default behavior is MIGRATE. Forpreemptible instances,
1476 # the default and only possible behavior is TERMINATE. For more
1477 # information, see
1478 # Set
1479 # VM host maintenance policy.
1480 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
1481 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
1482 # else, the Local SSD data will be preserved when the instance is stopped
1483 # at the end of the run duration/termination time.
1484 },
1485 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
1486 # instance creation or while the instance isstopped and
1487 # therefore, in a `TERMINATED` state. SeeInstance Life
1488 # Cycle for more information on the possible instance states.
1489 &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
1490 # Off signal is triggered for Spot
1491 # VMs only. If not specified, there will be no wait before the G2 Soft
1492 # Off signal is triggered.
1493 # as a count of seconds and fractions of seconds at nanosecond
1494 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1495 # or &quot;month&quot;. Range is approximately 10,000 years.
1496 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1497 # Durations less than one second are represented with a 0
1498 # `seconds` field and a positive `nanos` field. Must be from 0
1499 # to 999,999,999 inclusive.
1500 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1501 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1502 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1503 },
1504 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
1505 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
1506 # Off and ACPI G3 Mechanical
1507 # Off for Standard VMs and 30 seconds for Spot VMs.
1508 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
1509 # termination action will be performed at the termination time.
1510 },
1511 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
1512 # service accounts are available to the instances that are created from
1513 # these properties. Use metadata queries to obtain the access tokens for
1514 # these instances.
1515 { # A service account.
1516 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
1517 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
1518 &quot;A String&quot;,
1519 ],
1520 },
1521 ],
1522 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
1523 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
1524 # default.
1525 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
1526 # default.
1527 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
1528 # default.
1529 },
1530 &quot;shieldedVmConfig&quot;: { # A set of Shielded VM options. # Specifies the Shielded VM options for the instances that are created from
1531 # these properties.
1532 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.
1533 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.
1534 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.
1535 },
1536 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
1537 # properties. The tags identify valid sources or targets for network
1538 # firewalls. The setTags method can modify this list of tags. Each tag within
1539 # the list must comply with RFC1035.
1540 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
1541 # the tags&#x27; contents and used for optimistic locking. The
1542 # fingerprint is initially generated by Compute Engine and changes after
1543 # every request to modify or update tags. You must always provide an
1544 # up-to-date fingerprint hash in order to update or change tags.
1545 #
1546 # To see the latest fingerprint, make get() request to the
1547 # instance.
1548 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
1549 # with RFC1035.
1550 &quot;A String&quot;,
1551 ],
1552 },
1553 &quot;workloadIdentityConfig&quot;: {
1554 &quot;identity&quot;: &quot;A String&quot;,
1555 &quot;identityCertificateEnabled&quot;: True or False,
1556 },
1557 },
1558 &quot;locationPolicy&quot;: { # Configuration for location policy among multiple possible locations # Policy for choosing target zone. For more information, seeCreate VMs in
1559 # bulk.
1560 # (e.g. preferences for zone selection among zones in a single region).
1561 &quot;locations&quot;: { # Location configurations mapped by location name.
1562 # Currently only zone names are supported and must be represented as valid
1563 # internal URLs, such as zones/us-central1-a.
1564 # The bulkInsert operation doesn&#x27;t create instances in an AI zone, even if
1565 # an AI zone is available in the specified region. For example, if you set a
1566 # DENY preference for us-central1-a, Compute Engine will consider
1567 # us-central1-b and us-central1-c for instance creation, but not
1568 # us-central1-ai1a. Also, you can&#x27;t use the locations[] configuration to
1569 # allow instance creation in an AI zone. To include an AI zone in bulkInsert
1570 # operations, use the locationPolicy.zones[] field.
1571 &quot;a_key&quot;: {
1572 &quot;constraints&quot;: { # Per-zone constraints on location policy for this zone. # Constraints that the caller requires on the result distribution
1573 # in this zone.
1574 &quot;maxCount&quot;: 42, # Maximum number of items that are allowed to be placed in this zone.
1575 # The value must be non-negative.
1576 },
1577 &quot;preference&quot;: &quot;A String&quot;, # Preference for a given location. Set to either ALLOW orDENY.
1578 },
1579 },
1580 &quot;targetShape&quot;: &quot;A String&quot;, # Strategy for distributing VMs across zones in a region.
1581 &quot;zones&quot;: [ # The bulkInsert operation applies any preferences set in the locations
1582 # field to the specific zones listed in the zones field if the same zones
1583 # are specified in both fields.
1584 {
1585 &quot;zone&quot;: &quot;A String&quot;, # The URL of the zone.
1586 # The zone must exist in the region where the request is called.
1587 # Zones must be represented as valid partial URLs,
1588 # such as zones/us-central1-a.
1589 },
1590 ],
1591 },
1592 &quot;minCount&quot;: &quot;A String&quot;, # The minimum number of instances to create. If no min_count is
1593 # specified then count is used as the default value. Ifmin_count instances cannot be created, then no instances will
1594 # be created and instances already created will be deleted.
1595 &quot;namePattern&quot;: &quot;A String&quot;, # The string pattern used for the names of the VMs.
1596 # Either name_pattern or per_instance_properties
1597 # must be set. The pattern must contain one continuous sequence of
1598 # placeholder hash characters (#) with each character corresponding to one
1599 # digit of the generated instance name. Example: a name_pattern
1600 # of inst-#### generates instance names such asinst-0001 and inst-0002. If existing instances
1601 # in the same project and zone have names that match the name pattern
1602 # then the generated instance numbers start after the biggest
1603 # 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
1604 # placeholder #...# can contain up to 18 characters.
1605 &quot;perInstanceProperties&quot;: { # Per-instance properties to be set on individual instances.
1606 # Keys of this map specify requested instance names.
1607 # Can be empty if name_pattern is used.
1608 &quot;a_key&quot;: { # Per-instance properties to be set on individual instances.
1609 # To be extended in the future.
1610 &quot;hostname&quot;: &quot;A String&quot;, # Specifies the hostname of the instance. More details in:
1611 # https://cloud.google.com/compute/docs/instances/custom-hostname-vm#naming_convention
1612 &quot;name&quot;: &quot;A String&quot;, # Output only. This field is only temporary. It will be removed. Do not use it.
1613 },
1614 },
1615 &quot;sourceInstanceTemplate&quot;: &quot;A String&quot;, # Specifies the instance template from which to create instances. You may
1616 # combine sourceInstanceTemplate withinstanceProperties to override specific values from an
1617 # existing instance template. Bulk API follows the semantics of JSON Merge
1618 # Patch described by RFC
1619 # 7396.
1620 #
1621 # It can be a full or partial URL. For example, the following are
1622 # all valid URLs to an instance template:
1623 #
1624 #
1625 # - https://www.googleapis.com/compute/v1/projects/project/global/instanceTemplates/instanceTemplate
1626 # - projects/project/global/instanceTemplates/instanceTemplate
1627 # - global/instanceTemplates/instanceTemplate
1628 #
1629 #
1630 #
1631 # This field is optional.
1632 }
1633
1634 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1635 that if you must retry your request, the server will know to ignore the
1636 request if it has already been completed.
1637
1638 For example, consider a situation where you make an initial request and
1639 the request times out. If you make the request again with the same
1640 request ID, the server can check if original operation with the same
1641 request ID was received, and if so, will ignore the second request. This
1642 prevents clients from accidentally creating duplicate commitments.
1643
1644 The request ID must be
1645 a valid UUID with the exception that zero UUID is not supported
1646 (00000000-0000-0000-0000-000000000000).
1647 x__xgafv: string, V1 error format.
1648 Allowed values
1649 1 - v1 error format
1650 2 - v2 error format
1651
1652 Returns:
1653 An object of the form:
1654
1655 { # Represents an Operation resource.
1656 #
1657 # Google Compute Engine has three Operation resources:
1658 #
1659 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
1660 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
1661 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
1662 #
1663 # You can use an operation resource to manage asynchronous API requests.
1664 # For more information, readHandling
1665 # API responses.
1666 #
1667 # Operations can be global, regional or zonal.
1668 #
1669 # - For global operations, use the `globalOperations`
1670 # resource.
1671 # - For regional operations, use the
1672 # `regionOperations` resource.
1673 # - For zonal operations, use
1674 # the `zoneOperations` resource.
1675 #
1676 #
1677 #
1678 # For more information, read
1679 # Global, Regional, and Zonal Resources.
1680 #
1681 # Note that completed Operation resources have a limited
1682 # retention period.
1683 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1684 # Not present otherwise.
1685 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1686 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1687 # set when the operation is created.
1688 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1689 # text format.
1690 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1691 # this field will be populated.
1692 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1693 # operation.
1694 {
1695 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1696 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1697 # details. There is a set of defined message types to use for providing
1698 # details.The syntax depends on the error code. For example,
1699 # QuotaExceededInfo will have details when the error code is
1700 # QUOTA_EXCEEDED.
1701 {
1702 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1703 #
1704 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1705 # is not enabled:
1706 #
1707 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1708 # &quot;domain&quot;: &quot;googleapis.com&quot;
1709 # &quot;metadata&quot;: {
1710 # &quot;resource&quot;: &quot;projects/123&quot;,
1711 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1712 # }
1713 # }
1714 #
1715 # This response indicates that the pubsub.googleapis.com API is not enabled.
1716 #
1717 # Example of an error that is returned when attempting to create a Spanner
1718 # instance in a region that is out of stock:
1719 #
1720 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1721 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1722 # &quot;metadata&quot;: {
1723 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1724 # }
1725 # }
1726 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1727 # is typically the registered service name of the tool or product that
1728 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1729 # generated by some common infrastructure, the error domain must be a
1730 # globally unique value that identifies the infrastructure. For Google API
1731 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1732 &quot;metadatas&quot;: { # Additional structured details about this error.
1733 #
1734 # Keys must match a regular expression of `a-z+` but should
1735 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1736 # length. When identifying the current value of an exceeded limit, the units
1737 # should be contained in the key, not the value. For example, rather than
1738 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1739 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1740 # instances that can be created in a single (batch) request.
1741 &quot;a_key&quot;: &quot;A String&quot;,
1742 },
1743 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1744 # proximate cause of the error. Error reasons are unique within a particular
1745 # domain of errors. This should be at most 63 characters and match a
1746 # regular expression of `A-Z+[A-Z0-9]`, which represents
1747 # UPPER_SNAKE_CASE.
1748 },
1749 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1750 #
1751 # For example, if a quota check failed with an error indicating the calling
1752 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1753 # directly to the right place in the developer console to flip the bit.
1754 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1755 { # Describes a URL link.
1756 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1757 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1758 },
1759 ],
1760 },
1761 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1762 # which can be attached to an RPC error.
1763 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1764 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1765 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1766 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1767 },
1768 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1769 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1770 &quot;a_key&quot;: &quot;A String&quot;,
1771 },
1772 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1773 # type or metric.
1774 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1775 # or metric.
1776 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1777 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1778 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1779 },
1780 },
1781 ],
1782 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1783 # This property is optional.
1784 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1785 },
1786 ],
1787 },
1788 &quot;getVersionOperationMetadata&quot;: {
1789 &quot;inlineSbomInfo&quot;: {
1790 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1791 # appropriate identifiers.
1792 &quot;a_key&quot;: &quot;A String&quot;,
1793 },
1794 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1795 # identifiers.
1796 &quot;a_key&quot;: &quot;A String&quot;,
1797 },
1798 },
1799 },
1800 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1801 # message that was returned, such as `NOT FOUND`.
1802 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1803 # status code that was returned. For example, a `404` means the
1804 # resource was not found.
1805 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1806 # defined by the server.
1807 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1808 # This value is inRFC3339
1809 # text format.
1810 &quot;instancesBulkInsertOperationMetadata&quot;: {
1811 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1812 # Example key: zones/us-central1-a
1813 &quot;a_key&quot;: {
1814 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1815 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1816 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1817 # error.
1818 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1819 # if the flow is rolling forward or rolling back.
1820 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1821 },
1822 },
1823 },
1824 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1825 # Operation resources.
1826 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1827 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1828 # group of operations results from a `bulkInsert` API request.
1829 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1830 # `update`, or `delete`, and so on.
1831 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1832 # There is no requirement that this be linear or support any granularity of
1833 # operations. This should not be used to guess when the operation will be
1834 # complete. This number should monotonically increase as the operation
1835 # progresses.
1836 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1837 # applicable when performing regional operations.
1838 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1839 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1840 # this field will contain information on all underlying zonal actions and
1841 # their state.
1842 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1843 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1844 # Example key: zones/us-central1-a
1845 &quot;a_key&quot;: {
1846 &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
1847 # populated.
1848 # different programming environments, including REST APIs and RPC APIs. It is
1849 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1850 # three pieces of data: error code, error message, and error details.
1851 #
1852 # You can find out more about this error model and how to work with it in the
1853 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1854 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1855 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1856 # message types for APIs to use.
1857 {
1858 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1859 },
1860 ],
1861 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1862 # user-facing error message should be localized and sent in the
1863 # google.rpc.Status.details field, or localized by the client.
1864 },
1865 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1866 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1867 },
1868 },
1869 },
1870 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1871 # This value is inRFC3339
1872 # text format.
1873 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1874 # following:
1875 # `PENDING`, `RUNNING`, or `DONE`.
1876 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1877 # operation.
1878 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1879 # of the target resource.
1880 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1881 # operations related to creating a snapshot, this points to the disk
1882 # that the snapshot was created from.
1883 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1884 # `[email protected]` or
1885 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1886 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1887 # operation, this field will be populated.
1888 {
1889 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1890 # Engine returns NO_RESULTS_ON_PAGE if there
1891 # are no results in the response.
1892 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1893 # value format. For example:
1894 #
1895 # &quot;data&quot;: [
1896 # {
1897 # &quot;key&quot;: &quot;scope&quot;,
1898 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1899 # }
1900 {
1901 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1902 # returned. For example, for warnings where there are no results in a list
1903 # request for a particular zone, this key might be scope and
1904 # the key value might be the zone name. Other examples might be a key
1905 # indicating a deprecated resource and a suggested replacement, or a
1906 # warning about invalid network settings (for example, if an instance
1907 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1908 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1909 },
1910 ],
1911 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1912 },
1913 ],
1914 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1915 # applicable when performing per-zone operations.
1916 }</pre>
1917 </div>
1918
1919 <div class="method">
1920 <code class="details" id="close">close()</code>
1921 <pre>Close httplib2 connections.</pre>
1922 </div>
1923
1924 </body></html>