Debian Codegraph @

docs/dyn/compute_v1.instanceTemplates.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_v1.html">Compute Engine API</a> . <a href="compute_v1.instanceTemplates.html">instanceTemplates</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Retrieves the list of all InstanceTemplates resources, regional and global,</p>
80 <p class="toc_element">
81 <code><a href="#aggregatedList_next">aggregatedList_next()</a></code></p>
82 <p class="firstline">Retrieves the next page of results.</p>
83 <p class="toc_element">
84 <code><a href="#close">close()</a></code></p>
85 <p class="firstline">Close httplib2 connections.</p>
86 <p class="toc_element">
87 <code><a href="#delete">delete(project, instanceTemplate, requestId=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Deletes the specified instance template. Deleting an instance template is</p>
89 <p class="toc_element">
90 <code><a href="#get">get(project, instanceTemplate, x__xgafv=None)</a></code></p>
91 <p class="firstline">Returns the specified instance template.</p>
92 <p class="toc_element">
93 <code><a href="#getIamPolicy">getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</a></code></p>
94 <p class="firstline">Gets the access control policy for a resource. May be empty if no such</p>
95 <p class="toc_element">
96 <code><a href="#insert">insert(project, body=None, requestId=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Creates an instance template in the specified project using the</p>
98 <p class="toc_element">
99 <code><a href="#list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Retrieves a list of instance templates that are contained within</p>
101 <p class="toc_element">
102 <code><a href="#list_next">list_next()</a></code></p>
103 <p class="firstline">Retrieves the next page of results.</p>
104 <p class="toc_element">
105 <code><a href="#setIamPolicy">setIamPolicy(project, resource, body=None, x__xgafv=None)</a></code></p>
106 <p class="firstline">Sets the access control policy on the specified resource.</p>
107 <p class="toc_element">
108 <code><a href="#testIamPermissions">testIamPermissions(project, resource, body=None, x__xgafv=None)</a></code></p>
109 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
110 <h3>Method Details</h3>
111 <div class="method">
112 <code class="details" id="aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</code>
113 <pre>Retrieves the list of all InstanceTemplates resources, regional and global,
114 available to the specified project.
115
116 To prevent failure, Google recommends that you set the
117 `returnPartialSuccess` parameter to `true`.
118
119 Args:
120 project: string, Name of the project scoping this request. (required)
121 filter: string, A filter expression that filters resources listed in the response. Most
122 Compute resources support two types of filter expressions:
123 expressions that support regular expressions and expressions that follow
124 API improvement proposal AIP-160.
125 These two types of filter expressions cannot be mixed in one request.
126
127 If you want to use AIP-160, your expression must specify the field name, an
128 operator, and the value that you want to use for filtering. The value
129 must be a string, a number, or a boolean. The operator
130 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
131
132 For example, if you are filtering Compute Engine instances, you can
133 exclude instances named `example-instance` by specifying
134 `name != example-instance`.
135
136 The `:*` comparison can be used to test whether a key has been defined.
137 For example, to find all objects with `owner` label use:
138 ```
139 labels.owner:*
140 ```
141
142 You can also filter nested fields. For example, you could specify
143 `scheduling.automaticRestart = false` to include instances only
144 if they are not scheduled for automatic restarts. You can use filtering
145 on nested fields to filter based onresource labels.
146
147 To filter on multiple expressions, provide each separate expression within
148 parentheses. For example:
149 ```
150 (scheduling.automaticRestart = true)
151 (cpuPlatform = &quot;Intel Skylake&quot;)
152 ```
153 By default, each expression is an `AND` expression. However, you
154 can include `AND` and `OR` expressions explicitly.
155 For example:
156 ```
157 (cpuPlatform = &quot;Intel Skylake&quot;) OR
158 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
159 (scheduling.automaticRestart = true)
160 ```
161
162 If you want to use a regular expression, use the `eq` (equal) or `ne`
163 (not equal) operator against a single un-parenthesized expression with or
164 without quotes or against multiple parenthesized expressions. Examples:
165
166 `fieldname eq unquoted literal`
167 `fieldname eq &#x27;single quoted literal&#x27;`
168 `fieldname eq &quot;double quoted literal&quot;`
169 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
170
171 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
172 The literal value must match the entire field.
173
174 For example, to filter for instances that do not end with name &quot;instance&quot;,
175 you would use `name ne .*instance`.
176
177 You cannot combine constraints on multiple fields using regular
178 expressions.
179 includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region,
180 global) should be included in the response. For new resource types added
181 after this field, the flag has no effect as new resource types will always
182 include every visible scope for each scope type in response. For resource
183 types which predate this field, if this flag is omitted or false, only
184 scopes of the scope types where the resource type is expected to be found
185 will be included.
186 maxResults: integer, The maximum number of results per page that should be returned.
187 If the number of available results is larger than `maxResults`,
188 Compute Engine returns a `nextPageToken` that can be used to get
189 the next page of results in subsequent list requests. Acceptable values are
190 `0` to `500`, inclusive. (Default: `500`)
191 orderBy: string, Sorts list results by a certain order. By default, results
192 are returned in alphanumerical order based on the resource name.
193
194 You can also sort results in descending order based on the creation
195 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
196 results based on the `creationTimestamp` field in
197 reverse chronological order (newest result first). Use this to sort
198 resources like operations so that the newest operation is returned first.
199
200 Currently, only sorting by `name` or
201 `creationTimestamp desc` is supported.
202 pageToken: string, Specifies a page token to use. Set `pageToken` to the
203 `nextPageToken` returned by a previous list request to get
204 the next page of results.
205 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
206 of failure. The default value is false.
207
208 For example, when partial success behavior is enabled, aggregatedList for a
209 single zone scope either returns all resources in the zone or no resources,
210 with an error code.
211 serviceProjectNumber: string, The Shared VPC service project id or service project number for which
212 aggregated list request is invoked for subnetworks list-usable api.
213 x__xgafv: string, V1 error format.
214 Allowed values
215 1 - v1 error format
216 2 - v2 error format
217
218 Returns:
219 An object of the form:
220
221 { # Contains a list of InstanceTemplatesScopedList.
222 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
223 &quot;items&quot;: { # A list of InstanceTemplatesScopedList resources.
224 &quot;a_key&quot;: { # The name of the scope that contains this set of instance templates.
225 &quot;instanceTemplates&quot;: [ # [Output Only] A list of instance templates that are contained within
226 # the specified project and zone.
227 { # Represents an Instance Template resource.
228 #
229 # Google Compute Engine has two Instance Template resources:
230 #
231 # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
232 # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
233 #
234 # You can reuse a global instance template in
235 # different regions whereas you can use a regional instance template in a
236 # specified region only. If you want to reduce cross-region dependency or
237 # achieve data residency, use a regional instance template.
238 #
239 # To create VMs, managed instance groups, and reservations, you can use either
240 # global or regional instance templates.
241 #
242 # For more information, readInstance Templates.
243 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
244 # text format.
245 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
246 # create the resource.
247 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this instance template. The server
248 # defines this identifier.
249 &quot;kind&quot;: &quot;compute#instanceTemplate&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
250 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
251 # The name must be 1-63 characters long, and comply withRFC1035.
252 # Specifically, the name must be 1-63 characters long and match the regular
253 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
254 # character must be a lowercase letter, and all following characters must be
255 # a dash, lowercase letter, or digit, except the last character, which cannot
256 # be a dash.
257 &quot;properties&quot;: { # The instance properties for this instance template.
258 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
259 # Note that for MachineImage, this is not supported yet.
260 # Options that would traditionally be configured in a BIOS belong
261 # here. Features that require operating system support may have
262 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
263 # disabled).
264 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
265 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
266 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
267 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
268 # multithreading (SMT) set this to 1. If unset, the maximum number
269 # of threads supported per core by the underlying processor is
270 # assumed.
271 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
272 # Supported modes include:
273 # * ALL_CORE_MAX
274 #
275 # Using empty string or not setting this field will use the platform-specific
276 # default turbo mode.
277 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
278 # the number of threads per core to compute the total number of virtual
279 # CPUs to expose to the instance. If unset, the number of cores is
280 # inferred from the instance&#x27;s nominal CPU count and the underlying
281 # platform&#x27;s SMT width.
282 },
283 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
284 # source IP addresses other than their own and receive packets with
285 # destination IP addresses other than their own. If these instances will be
286 # used as an IP gateway or it will be set as the next-hop in a Route
287 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
288 # documentation for more information.
289 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
290 # Note that for MachineImage, this is not supported yet.
291 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
292 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
293 },
294 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
295 # properties.
296 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
297 # from these properties.
298 { # An instance-attached disk resource.
299 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
300 # or X86_64.
301 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
302 # deleted (but not when the disk is detached from the instance).
303 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
304 # partition of the disk for its root filesystem.
305 &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
306 # running within the instance. This name can be used to reference the device
307 # for mounting, resizing, and so on, from within the instance.
308 #
309 # If not specified, the server chooses a default device name to apply to this
310 # disk, in the form persistent-disk-x, where x is a number
311 # assigned by Google Compute Engine. This field is only applicable for
312 # persistent disks.
313 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
314 # encryption key.
315 #
316 # If you are creating a new disk, this field encrypts the new disk using
317 # an encryption key that you provide. If you are attaching an existing
318 # disk that is already encrypted, this field decrypts the disk using
319 # the customer-supplied encryption key.
320 #
321 # If you encrypt a disk using a customer-supplied key, you must provide the
322 # same key again when you attempt to use this resource at a later time. For
323 # example, you must provide the key when you create a snapshot or an image
324 # from the disk or when you attach the disk to a virtual machine instance.
325 #
326 # If you do not provide an encryption key, then the disk will be encrypted
327 # using an automatically generated key and you do not need to provide a key
328 # to use the disk later.
329 #
330 # Note:
331 #
332 # Instance templates do not storecustomer-supplied
333 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
334 #
335 # You cannot create VMs that have disks with customer-supplied keys using
336 # the bulk
337 # insert method.
338 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
339 # For example:
340 #
341 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
342 # key_region/cryptoKeys/key
343 #
344 # The fully-qualifed key name may be returned for resource GET requests. For
345 # example:
346 #
347 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
348 # key_region/cryptoKeys/key
349 # /cryptoKeyVersions/1
350 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
351 # key. If absent, the Compute Engine default service account is used.
352 # For example:
353 #
354 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
355 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
356 # encryption key, encoded in RFC
357 # 4648 base64 to either encrypt or decrypt this resource. You can
358 # provide either the rawKey or thersaEncryptedKey.
359 # For example:
360 #
361 # &quot;rawKey&quot;:
362 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
363 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
364 # customer-supplied encryption key to either encrypt or decrypt this
365 # resource. You can provide either the rawKey or thersaEncryptedKey.
366 # For example:
367 #
368 # &quot;rsaEncryptedKey&quot;:
369 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
370 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
371 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
372 #
373 # The key must meet the following requirements before you can provide it to
374 # Compute Engine:
375 #
376 # 1. The key is wrapped using a RSA public key certificate provided by
377 # Google.
378 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
379 # encoding.
380 #
381 # Gets the RSA public key certificate provided by Google at:
382 #
383 #
384 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
385 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
386 # 4648 base64 encoded SHA-256 hash of the customer-supplied
387 # encryption key that protects this resource.
388 },
389 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
390 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
391 # currently attached to another instance. If you try to force attach a zonal
392 # disk to an instance, you will receive an error.
393 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
394 # only for bootable images. Read
395 # Enabling guest operating system features to see a list of available
396 # options.
397 { # Guest OS features.
398 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
399 # separate values. Set to one or more of the following values:
400 #
401 # - VIRTIO_SCSI_MULTIQUEUE
402 # - WINDOWS
403 # - MULTI_IP_SUBNET
404 # - UEFI_COMPATIBLE
405 # - GVNIC
406 # - SEV_CAPABLE
407 # - SUSPEND_RESUME_COMPATIBLE
408 # - SEV_LIVE_MIGRATABLE_V2
409 # - SEV_SNP_CAPABLE
410 # - TDX_CAPABLE
411 # - IDPF
412 # - SNP_SVSM_CAPABLE
413 # - CCA_CAPABLE
414 #
415 #
416 # For more information, see
417 # Enabling guest operating system features.
418 },
419 ],
420 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
421 # boot disk. If you have many disks attached to an instance, each
422 # disk would have a unique index number.
423 &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
424 # alongside the new instance. Use initialization parameters to create boot
425 # disks or local SSDs attached to the new instance.
426 #
427 # This property is mutually exclusive with the source property;
428 # you can only define one or the other, but not both.
429 # alongside the new instance. Use initialization parameters to create boot
430 # disks or local SSDs attached to the new instance.
431 #
432 # This field is persisted and returned for instanceTemplate and not returned
433 # in the context of instance.
434 #
435 # This property is mutually exclusive with the source property;
436 # you can only define one or the other, but not both.
437 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
438 # arm64 or x86_64.
439 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
440 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
441 # of the instance. If a disk with the same name already exists in the given
442 # region, the existing disk is attached to the new instance and the
443 # new disk is not created.
444 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
445 # 10 GB. If you specify a sourceImage, which is required for
446 # boot disks, the default size is the size of the sourceImage.
447 # If you do not specify a sourceImage, the default disk size
448 # is 500 GB.
449 &quot;diskType&quot;: &quot;A String&quot;,
450 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
451 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
452 # persistent disks.
453 &quot;a_key&quot;: &quot;A String&quot;,
454 },
455 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
456 &quot;A String&quot;,
457 ],
458 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
459 # is to use the existing disk.
460 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
461 # of I/O operations per second that the disk can handle. Values must be
462 # between 10,000 and 120,000. For more details, see theExtreme persistent
463 # disk documentation.
464 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
465 # number of throughput mb per second that the disk can handle. Values must
466 # greater than or equal to 1.
467 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
468 # the URLs of the zones where the disk should be replicated to.
469 # You must provide exactly two replica zones, and one zone must be the same
470 # as the instance zone.
471 &quot;A String&quot;,
472 ],
473 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
474 # have the same definition as resource
475 # manager tags. Keys and values can be either in numeric format,
476 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
477 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
478 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
479 # empty.
480 &quot;a_key&quot;: &quot;A String&quot;,
481 },
482 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
483 # Specified using the full or partial URL. For instance template, specify
484 # only the resource policy name.
485 &quot;A String&quot;,
486 ],
487 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
488 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
489 # is required.
490 #
491 # To create a disk with one of the public operating system
492 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
493 #
494 # projects/debian-cloud/global/images/family/debian-9
495 #
496 #
497 # Alternatively, use a specific version of a public operating system image:
498 #
499 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
500 #
501 #
502 # To create a disk with a custom image that you created, specify the
503 # image name in the following format:
504 #
505 # global/images/my-custom-image
506 #
507 #
508 # You can also specify a custom image by its image family, which returns
509 # the latest version of the image in that family. Replace the image name
510 # with family/family-name:
511 #
512 # global/images/family/my-image-family
513 #
514 #
515 # If the source image is deleted later, this field will not be set.
516 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
517 # encryption key of the source image. Required if the source image is
518 # protected by a customer-supplied encryption key.
519 #
520 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
521 # encryption keys, so you cannot create disks for instances in a managed instance group if the
522 # source images are encrypted with your own keys.
523 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
524 # For example:
525 #
526 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
527 # key_region/cryptoKeys/key
528 #
529 # The fully-qualifed key name may be returned for resource GET requests. For
530 # example:
531 #
532 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
533 # key_region/cryptoKeys/key
534 # /cryptoKeyVersions/1
535 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
536 # key. If absent, the Compute Engine default service account is used.
537 # For example:
538 #
539 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
540 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
541 # encryption key, encoded in RFC
542 # 4648 base64 to either encrypt or decrypt this resource. You can
543 # provide either the rawKey or thersaEncryptedKey.
544 # For example:
545 #
546 # &quot;rawKey&quot;:
547 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
548 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
549 # customer-supplied encryption key to either encrypt or decrypt this
550 # resource. You can provide either the rawKey or thersaEncryptedKey.
551 # For example:
552 #
553 # &quot;rsaEncryptedKey&quot;:
554 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
555 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
556 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
557 #
558 # The key must meet the following requirements before you can provide it to
559 # Compute Engine:
560 #
561 # 1. The key is wrapped using a RSA public key certificate provided by
562 # Google.
563 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
564 # encoding.
565 #
566 # Gets the RSA public key certificate provided by Google at:
567 #
568 #
569 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
570 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
571 # 4648 base64 encoded SHA-256 hash of the customer-supplied
572 # encryption key that protects this resource.
573 },
574 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
575 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
576 # is required.
577 #
578 # To create a disk with a snapshot that you created, specify the
579 # snapshot name in the following format:
580 #
581 # global/snapshots/my-backup
582 #
583 #
584 # If the source snapshot is deleted later, this field will not be set.
585 #
586 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
587 # an image instead when you create VMs using
588 # the bulk
589 # insert method.
590 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
591 # encryption key of the source snapshot.
592 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
593 # For example:
594 #
595 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
596 # key_region/cryptoKeys/key
597 #
598 # The fully-qualifed key name may be returned for resource GET requests. For
599 # example:
600 #
601 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
602 # key_region/cryptoKeys/key
603 # /cryptoKeyVersions/1
604 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
605 # key. If absent, the Compute Engine default service account is used.
606 # For example:
607 #
608 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
609 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
610 # encryption key, encoded in RFC
611 # 4648 base64 to either encrypt or decrypt this resource. You can
612 # provide either the rawKey or thersaEncryptedKey.
613 # For example:
614 #
615 # &quot;rawKey&quot;:
616 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
617 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
618 # customer-supplied encryption key to either encrypt or decrypt this
619 # resource. You can provide either the rawKey or thersaEncryptedKey.
620 # For example:
621 #
622 # &quot;rsaEncryptedKey&quot;:
623 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
624 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
625 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
626 #
627 # The key must meet the following requirements before you can provide it to
628 # Compute Engine:
629 #
630 # 1. The key is wrapped using a RSA public key certificate provided by
631 # Google.
632 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
633 # encoding.
634 #
635 # Gets the RSA public key certificate provided by Google at:
636 #
637 #
638 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
639 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
640 # 4648 base64 encoded SHA-256 hash of the customer-supplied
641 # encryption key that protects this resource.
642 },
643 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
644 # this as a partial or full URL to the resource. For example, the following
645 # are valid values:
646 #
647 #
648 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
649 # - projects/project/zones/zone/storagePools/storagePool
650 # - zones/zone/storagePools/storagePool
651 },
652 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
653 # either SCSI or NVME. For most machine types, the
654 # default is SCSI. Local SSDs can use either NVME or SCSI.
655 # In certain configurations, persistent disks can use NVMe. For more
656 # information, seeAbout
657 # persistent disks.
658 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
659 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
660 &quot;A String&quot;,
661 ],
662 &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
663 # in READ_WRITE mode.
664 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
665 # field is set to PRESERVED if the LocalSSD data has been saved
666 # to a persistent location by customer request. (see the
667 # discard_local_ssd option on Stop/Suspend).
668 # Read-only in the api.
669 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
670 # these are public keys which are safe to store in public
671 &quot;dbs&quot;: [ # The Key Database (db).
672 {
673 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
674 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
675 },
676 ],
677 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
678 {
679 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
680 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
681 },
682 ],
683 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
684 {
685 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
686 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
687 },
688 ],
689 &quot;pk&quot;: { # The Platform Key (PK).
690 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
691 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
692 },
693 },
694 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
695 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
696 # is required.
697 #
698 # If desired, you can also attach existing non-root persistent disks using
699 # this property. This field is only applicable for persistent disks.
700 #
701 # Note that for InstanceTemplate, specify the disk name for zonal disk,
702 # and the URL for regional disk.
703 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
704 },
705 ],
706 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
707 # created from these properties.
708 { # A specification of the type and number of accelerator cards attached to the
709 # instance.
710 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
711 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
712 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
713 # If you are creating an instance template, specify only the
714 # accelerator name.
715 # See GPUs on Compute Engine
716 # for a full list of accelerator types.
717 },
718 ],
719 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
720 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
721 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
722 &quot;a_key&quot;: &quot;A String&quot;,
723 },
724 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
725 # properties.
726 # This field only accepts a machine type name, for example `n2-standard-4`.
727 # If you use the machine type full or partial URL, for example
728 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
729 # the request will result in an `INTERNAL_ERROR`.
730 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
731 # these properties. These pairs can consist of custom metadata or predefined
732 # keys. SeeProject and
733 # instance metadata for more information.
734 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
735 # the metadata&#x27;s contents and used for optimistic locking. The
736 # fingerprint is initially generated by Compute Engine and changes after
737 # every request to modify or update metadata. You must always provide an
738 # up-to-date fingerprint hash in order to update or change metadata,
739 # otherwise the request will fail with error412 conditionNotMet.
740 #
741 # To see the latest fingerprint, make a get() request to
742 # retrieve the resource.
743 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
744 # less than 512 KB.
745 { # Metadata
746 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
747 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
748 # This is reflected as part of a URL in the metadata server. Additionally, to
749 # avoid ambiguity, keys must not conflict with any other metadata keys
750 # for the project.
751 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
752 # have meaning as interpreted by the image running in the instance. The
753 # only restriction placed on values is that their size must be less than
754 # or equal to 262144 bytes (256 KiB).
755 },
756 ],
757 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
758 # for metadata.
759 },
760 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
761 # scheduled on the specified or newer cpu/platform. Applicable values are the
762 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
763 # information, read Specifying a
764 # Minimum CPU Platform.
765 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
766 { # A network interface resource attached to an instance.
767 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
768 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
769 # no external internet access.
770 { # An access configuration attached to an instance&#x27;s network interface.
771 # Only one access config per instance is supported.
772 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
773 # The first IPv6 address of the external IPv6 range associated
774 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
775 # use a static external IP address, it must be unused and in the same region
776 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
777 # assign an external IPv6 address from the instance&#x27;s subnetwork.
778 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
779 # external IPv6 range.
780 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
781 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
782 # (IPv4), the default and recommended name is External NAT, but
783 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
784 # recommend name is External IPv6.
785 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
786 # address associated with this instance. Specify an unused static
787 # external IP address available to the project or leave this field undefined
788 # to use an IP from a shared ephemeral IP address pool. If you specify a
789 # static external IP address, it must live in the same region as the zone of
790 # the instance.
791 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
792 # configuration and can only take the following values: PREMIUM,STANDARD.
793 #
794 # If an AccessConfig is specified without a valid external IP address, an
795 # ephemeral IP will be created with this networkTier.
796 #
797 # If an AccessConfig with a valid external IP address is specified, it must
798 # match that of the networkTier associated with the Address resource owning
799 # that IP.
800 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
801 #
802 # 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
803 # first IP in associated external IPv6 range.
804 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
805 # config.
806 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
807 # external IP address of the instance to a DNS domain name.
808 #
809 # This field is not used in ipv6AccessConfig. A default PTR
810 # record will be created if the VM has external IPv6 range associated.
811 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
812 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
813 },
814 ],
815 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
816 # You can only specify this field for network interfaces in VPC networks.
817 { # An alias IP range attached to an instance&#x27;s network interface.
818 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
819 # must belong to the specified subnetwork and cannot contain IP addresses
820 # reserved by system or used by other network interfaces. This range may be
821 # 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).
822 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
823 # alias range. If not specified, the primary range of the subnetwork is used.
824 },
825 ],
826 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
827 # You can only specify this field for network interfaces in VPC networks.
828 { # An alias IP range attached to an instance&#x27;s network interface.
829 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
830 # must belong to the specified subnetwork and cannot contain IP addresses
831 # reserved by system or used by other network interfaces. This range may be
832 # 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).
833 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
834 # alias range. If not specified, the primary range of the subnetwork is used.
835 },
836 ],
837 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
838 # with network_attachment.
839 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
840 # This field will be ignored when inserting an Instance or
841 # adding a NetworkInterface. An up-to-date
842 # 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.
843 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
844 # or not. If enabled, also indicates the version of IGMP supported.
845 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
846 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
847 # one IPv6 access config, DIRECT_IPV6, is supported. If there
848 # is no ipv6AccessConfig specified, then this instance will
849 # have no external IPv6 Internet access.
850 { # An access configuration attached to an instance&#x27;s network interface.
851 # Only one access config per instance is supported.
852 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
853 # The first IPv6 address of the external IPv6 range associated
854 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
855 # use a static external IP address, it must be unused and in the same region
856 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
857 # assign an external IPv6 address from the instance&#x27;s subnetwork.
858 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
859 # external IPv6 range.
860 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
861 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
862 # (IPv4), the default and recommended name is External NAT, but
863 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
864 # recommend name is External IPv6.
865 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
866 # address associated with this instance. Specify an unused static
867 # external IP address available to the project or leave this field undefined
868 # to use an IP from a shared ephemeral IP address pool. If you specify a
869 # static external IP address, it must live in the same region as the zone of
870 # the instance.
871 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
872 # configuration and can only take the following values: PREMIUM,STANDARD.
873 #
874 # If an AccessConfig is specified without a valid external IP address, an
875 # ephemeral IP will be created with this networkTier.
876 #
877 # If an AccessConfig with a valid external IP address is specified, it must
878 # match that of the networkTier associated with the Address resource owning
879 # that IP.
880 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
881 #
882 # 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
883 # first IP in associated external IPv6 range.
884 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
885 # config.
886 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
887 # external IP address of the instance to a DNS domain name.
888 #
889 # This field is not used in ipv6AccessConfig. A default PTR
890 # record will be created if the VM has external IPv6 range associated.
891 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
892 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
893 },
894 ],
895 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
896 # accessed from the Internet. This field is always inherited from its
897 # subnetwork.
898 #
899 # Valid only if stackType is IPV4_IPV6.
900 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
901 # use a static internal IP address, it must be unused and in the same region
902 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
903 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
904 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
905 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
906 # server. For a VM, the network interface uses the nicN naming
907 # format. Where N is a value between 0 and7. The default interface value is nic0.
908 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
909 # instance, if neither the network nor the subnetwork is specified, the
910 # default network global/networks/default is used. If the
911 # selected project doesn&#x27;t have the default network, you must specify a
912 # network or subnet. If the network is not specified but the subnetwork is
913 # specified, the network is inferred.
914 #
915 # If you specify this property, you can specify the network as
916 # a full or partial URL. For example, the following are all valid URLs:
917 #
918 #
919 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
920 # - projects/project/global/networks/network
921 # - global/networks/default
922 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
923 # to in the following format:
924 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
925 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
926 # interface. If not specified by the user, an unused internal IP is
927 # assigned by the system.
928 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
929 # VirtioNet.
930 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
931 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
932 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
933 # if not specified by the users.
934 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
935 # interface. Can only be used with network_attachment. It is not possible to
936 # use on its own however, network_attachment can be used without
937 # service_class_id.
938 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
939 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
940 #
941 # This field can be both set at instance creation and update network
942 # interface operations.
943 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
944 # resource is inlegacy
945 # mode, do not specify this field. If the network is in auto subnet
946 # mode, specifying the subnetwork is optional. If the network is in custom
947 # subnet mode, specifying the subnetwork is required. If you specify this
948 # field, you can specify the subnetwork as a full or partial URL. For
949 # example, the following are all valid URLs:
950 #
951 #
952 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
953 # - regions/region/subnetworks/subnetwork
954 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
955 # from 2 to 255 inclusively.
956 },
957 ],
958 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
959 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
960 },
961 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
962 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
963 # Note that for MachineImage, this is not supported yet.
964 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
965 # Note that for MachineImage, this is not supported yet.
966 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
967 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
968 # Consuming reserved instances for examples.
969 &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
970 # the name of your reservation as its value.
971 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
972 # either a name to a reservation in the same project or
973 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
974 # shared reservation in the same zone but in a different project.
975 &quot;A String&quot;,
976 ],
977 },
978 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
979 # have the same definition as resource
980 # manager tags. Keys and values can be either in numeric format,
981 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
982 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
983 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
984 # PATCH) when empty.
985 &quot;a_key&quot;: &quot;A String&quot;,
986 },
987 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
988 # these properties.
989 # Note that for MachineImage, this is not supported yet.
990 &quot;A String&quot;,
991 ],
992 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
993 # these properties.
994 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
995 # terminated by Compute Engine (not terminated by a user). You can only set
996 # the automatic restart option for standard instances.Preemptible instances
997 # cannot be automatically restarted.
998 #
999 # By default, this is set to true so an instance is
1000 # automatically restarted if it is terminated by Compute Engine.
1001 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
1002 # must be a number between 1 and the number of availability domains
1003 # specified in the spread placement policy attached to the instance.
1004 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
1005 # within the range of [90, 330] with the increment of 30, if unset, the
1006 # default behavior of host error recovery will be used.
1007 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
1008 &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
1009 # recovery of the Local Ssd state is attempted. Its value should be in
1010 # between 0 and 168 hours with hour granularity and the default value being 1
1011 # hour.
1012 # as a count of seconds and fractions of seconds at nanosecond
1013 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1014 # or &quot;month&quot;. Range is approximately 10,000 years.
1015 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1016 # Durations less than one second are represented with a 0
1017 # `seconds` field and a positive `nanos` field. Must be from 0
1018 # to 999,999,999 inclusive.
1019 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1020 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1021 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1022 },
1023 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
1024 # resources.
1025 # This field is for use by internal tools that use the public API.
1026 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
1027 # the instance termination action will be performed at the end of the run
1028 # duration.
1029 # as a count of seconds and fractions of seconds at nanosecond
1030 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1031 # or &quot;month&quot;. Range is approximately 10,000 years.
1032 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1033 # Durations less than one second are represented with a 0
1034 # `seconds` field and a positive `nanos` field. Must be from 0
1035 # to 999,999,999 inclusive.
1036 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1037 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1038 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1039 },
1040 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
1041 # on a sole-tenant node.
1042 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
1043 # affinity for more information.
1044 # Overrides reservationAffinity.
1045 { # Node Affinity: the configuration of desired nodes onto which this Instance
1046 # could be scheduled.
1047 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
1048 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
1049 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
1050 &quot;A String&quot;,
1051 ],
1052 },
1053 ],
1054 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
1055 # the default behavior is MIGRATE. Forpreemptible instances,
1056 # the default and only possible behavior is TERMINATE. For more
1057 # information, see
1058 # Set
1059 # VM host maintenance policy.
1060 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
1061 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
1062 # else, the Local SSD data will be preserved when the instance is stopped
1063 # at the end of the run duration/termination time.
1064 },
1065 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
1066 # instance creation or while the instance isstopped and
1067 # therefore, in a `TERMINATED` state. SeeInstance Life
1068 # Cycle for more information on the possible instance states.
1069 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
1070 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
1071 # Off and ACPI G3 Mechanical
1072 # Off for Standard VMs and 30 seconds for Spot VMs.
1073 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
1074 # termination action will be performed at the termination time.
1075 },
1076 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
1077 # service accounts are available to the instances that are created from
1078 # these properties. Use metadata queries to obtain the access tokens for
1079 # these instances.
1080 { # A service account.
1081 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
1082 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
1083 &quot;A String&quot;,
1084 ],
1085 },
1086 ],
1087 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
1088 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
1089 # default.
1090 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
1091 # default.
1092 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
1093 # default.
1094 },
1095 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
1096 # properties. The tags identify valid sources or targets for network
1097 # firewalls. The setTags method can modify this list of tags. Each tag within
1098 # the list must comply with RFC1035.
1099 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
1100 # the tags&#x27; contents and used for optimistic locking. The
1101 # fingerprint is initially generated by Compute Engine and changes after
1102 # every request to modify or update tags. You must always provide an
1103 # up-to-date fingerprint hash in order to update or change tags.
1104 #
1105 # To see the latest fingerprint, make get() request to the
1106 # instance.
1107 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
1108 # with RFC1035.
1109 &quot;A String&quot;,
1110 ],
1111 },
1112 &quot;workloadIdentityConfig&quot;: {
1113 &quot;identity&quot;: &quot;A String&quot;,
1114 &quot;identityCertificateEnabled&quot;: True or False,
1115 },
1116 },
1117 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the instance template resides. Only
1118 # applicable for regional resources.
1119 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this instance template. The server defines this
1120 # URL.
1121 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the template. You can provide this as a
1122 # partial or full URL to the resource. For example, the following are valid
1123 # values:
1124 #
1125 #
1126 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
1127 # - projects/project/zones/zone/instances/instance
1128 &quot;sourceInstanceParams&quot;: { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
1129 # from a source instance.
1130 &quot;diskConfigs&quot;: [ # Attached disks configuration. If not provided, defaults are applied:
1131 # For boot disk and any other R/W disks, the source images for each disk
1132 # will be used. For read-only disks, they will be attached in read-only
1133 # mode. Local SSD disks will be created as blank volumes.
1134 { # A specification of the desired way to instantiate a disk in the instance
1135 # template when its created from a source instance.
1136 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
1137 # deleted (but not when the disk is detached from the instance).
1138 &quot;customImage&quot;: &quot;A String&quot;, # The custom source image to be used to restore this disk when instantiating
1139 # this instance template.
1140 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the device name of the disk to which the configurations apply to.
1141 &quot;instantiateFrom&quot;: &quot;A String&quot;, # Specifies whether to include the disk and what image to use. Possible
1142 # values are:
1143 #
1144 #
1145 # - source-image: to use the same image that was used to
1146 # create the source instance&#x27;s corresponding disk. Applicable to the boot
1147 # disk and additional read-write disks.
1148 # - source-image-family: to use the same image family that
1149 # was used to create the source instance&#x27;s corresponding disk. Applicable
1150 # to the boot disk and additional read-write disks.
1151 # - custom-image: to use a user-provided image url for disk
1152 # creation. Applicable to the boot disk and additional read-write
1153 # disks.
1154 # - attach-read-only: to attach a read-only
1155 # disk. Applicable to read-only disks.
1156 # - do-not-include: to exclude a disk from the template.
1157 # Applicable to additional read-write disks, local SSDs, and read-only
1158 # disks.
1159 },
1160 ],
1161 },
1162 },
1163 ],
1164 &quot;warning&quot;: { # [Output Only] An informational warning that replaces the list of instance
1165 # templates when the list is empty.
1166 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1167 # Engine returns NO_RESULTS_ON_PAGE if there
1168 # are no results in the response.
1169 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1170 # value format. For example:
1171 #
1172 # &quot;data&quot;: [
1173 # {
1174 # &quot;key&quot;: &quot;scope&quot;,
1175 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1176 # }
1177 {
1178 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1179 # returned. For example, for warnings where there are no results in a list
1180 # request for a particular zone, this key might be scope and
1181 # the key value might be the zone name. Other examples might be a key
1182 # indicating a deprecated resource and a suggested replacement, or a
1183 # warning about invalid network settings (for example, if an instance
1184 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1185 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1186 },
1187 ],
1188 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1189 },
1190 },
1191 },
1192 &quot;kind&quot;: &quot;compute#instanceTemplateAggregatedList&quot;, # Output only. Type of resource.
1193 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
1194 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
1195 # the query parameter pageToken in the next list request.
1196 # Subsequent list requests will have their own nextPageToken to
1197 # continue paging through the results.
1198 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
1199 &quot;warning&quot;: { # [Output Only] Informational warning message.
1200 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1201 # Engine returns NO_RESULTS_ON_PAGE if there
1202 # are no results in the response.
1203 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1204 # value format. For example:
1205 #
1206 # &quot;data&quot;: [
1207 # {
1208 # &quot;key&quot;: &quot;scope&quot;,
1209 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1210 # }
1211 {
1212 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1213 # returned. For example, for warnings where there are no results in a list
1214 # request for a particular zone, this key might be scope and
1215 # the key value might be the zone name. Other examples might be a key
1216 # indicating a deprecated resource and a suggested replacement, or a
1217 # warning about invalid network settings (for example, if an instance
1218 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1219 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1220 },
1221 ],
1222 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1223 },
1224 }</pre>
1225 </div>
1226
1227 <div class="method">
1228 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
1229 <pre>Retrieves the next page of results.
1230
1231 Args:
1232 previous_request: The request for the previous page. (required)
1233 previous_response: The response from the request for the previous page. (required)
1234
1235 Returns:
1236 A request object that you can call &#x27;execute()&#x27; on to request the next
1237 page. Returns None if there are no more items in the collection.
1238 </pre>
1239 </div>
1240
1241 <div class="method">
1242 <code class="details" id="close">close()</code>
1243 <pre>Close httplib2 connections.</pre>
1244 </div>
1245
1246 <div class="method">
1247 <code class="details" id="delete">delete(project, instanceTemplate, requestId=None, x__xgafv=None)</code>
1248 <pre>Deletes the specified instance template. Deleting an instance template is
1249 permanent and cannot be undone. It is not possible to delete templates
1250 that are already in use by a managed instance group.
1251
1252 Args:
1253 project: string, Project ID for this request. (required)
1254 instanceTemplate: string, The name of the instance template to delete. (required)
1255 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1256 that if you must retry your request, the server will know to ignore the
1257 request if it has already been completed.
1258
1259 For example, consider a situation where you make an initial request and
1260 the request times out. If you make the request again with the same
1261 request ID, the server can check if original operation with the same
1262 request ID was received, and if so, will ignore the second request. This
1263 prevents clients from accidentally creating duplicate commitments.
1264
1265 The request ID must be
1266 a valid UUID with the exception that zero UUID is not supported
1267 (00000000-0000-0000-0000-000000000000).
1268 x__xgafv: string, V1 error format.
1269 Allowed values
1270 1 - v1 error format
1271 2 - v2 error format
1272
1273 Returns:
1274 An object of the form:
1275
1276 { # Represents an Operation resource.
1277 #
1278 # Google Compute Engine has three Operation resources:
1279 #
1280 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
1281 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
1282 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
1283 #
1284 # You can use an operation resource to manage asynchronous API requests.
1285 # For more information, readHandling
1286 # API responses.
1287 #
1288 # Operations can be global, regional or zonal.
1289 #
1290 # - For global operations, use the `globalOperations`
1291 # resource.
1292 # - For regional operations, use the
1293 # `regionOperations` resource.
1294 # - For zonal operations, use
1295 # the `zoneOperations` resource.
1296 #
1297 #
1298 #
1299 # For more information, read
1300 # Global, Regional, and Zonal Resources.
1301 #
1302 # Note that completed Operation resources have a limited
1303 # retention period.
1304 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1305 # Not present otherwise.
1306 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1307 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1308 # set when the operation is created.
1309 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1310 # text format.
1311 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1312 # this field will be populated.
1313 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1314 # operation.
1315 {
1316 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1317 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1318 # details. There is a set of defined message types to use for providing
1319 # details.The syntax depends on the error code. For example,
1320 # QuotaExceededInfo will have details when the error code is
1321 # QUOTA_EXCEEDED.
1322 {
1323 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1324 #
1325 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1326 # is not enabled:
1327 #
1328 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1329 # &quot;domain&quot;: &quot;googleapis.com&quot;
1330 # &quot;metadata&quot;: {
1331 # &quot;resource&quot;: &quot;projects/123&quot;,
1332 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1333 # }
1334 # }
1335 #
1336 # This response indicates that the pubsub.googleapis.com API is not enabled.
1337 #
1338 # Example of an error that is returned when attempting to create a Spanner
1339 # instance in a region that is out of stock:
1340 #
1341 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1342 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1343 # &quot;metadata&quot;: {
1344 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1345 # }
1346 # }
1347 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1348 # is typically the registered service name of the tool or product that
1349 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1350 # generated by some common infrastructure, the error domain must be a
1351 # globally unique value that identifies the infrastructure. For Google API
1352 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1353 &quot;metadatas&quot;: { # Additional structured details about this error.
1354 #
1355 # Keys must match a regular expression of `a-z+` but should
1356 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1357 # length. When identifying the current value of an exceeded limit, the units
1358 # should be contained in the key, not the value. For example, rather than
1359 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1360 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1361 # instances that can be created in a single (batch) request.
1362 &quot;a_key&quot;: &quot;A String&quot;,
1363 },
1364 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1365 # proximate cause of the error. Error reasons are unique within a particular
1366 # domain of errors. This should be at most 63 characters and match a
1367 # regular expression of `A-Z+[A-Z0-9]`, which represents
1368 # UPPER_SNAKE_CASE.
1369 },
1370 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1371 #
1372 # For example, if a quota check failed with an error indicating the calling
1373 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1374 # directly to the right place in the developer console to flip the bit.
1375 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1376 { # Describes a URL link.
1377 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1378 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1379 },
1380 ],
1381 },
1382 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1383 # which can be attached to an RPC error.
1384 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1385 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1386 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1387 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1388 },
1389 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1390 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1391 &quot;a_key&quot;: &quot;A String&quot;,
1392 },
1393 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1394 # type or metric.
1395 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1396 # or metric.
1397 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1398 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1399 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1400 },
1401 },
1402 ],
1403 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1404 # This property is optional.
1405 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1406 },
1407 ],
1408 },
1409 &quot;getVersionOperationMetadata&quot;: {
1410 &quot;inlineSbomInfo&quot;: {
1411 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1412 # appropriate identifiers.
1413 &quot;a_key&quot;: &quot;A String&quot;,
1414 },
1415 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1416 # identifiers.
1417 &quot;a_key&quot;: &quot;A String&quot;,
1418 },
1419 },
1420 },
1421 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1422 # message that was returned, such as `NOT FOUND`.
1423 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1424 # status code that was returned. For example, a `404` means the
1425 # resource was not found.
1426 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1427 # defined by the server.
1428 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1429 # This value is inRFC3339
1430 # text format.
1431 &quot;instancesBulkInsertOperationMetadata&quot;: {
1432 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1433 # Example key: zones/us-central1-a
1434 &quot;a_key&quot;: {
1435 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1436 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1437 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1438 # error.
1439 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1440 # if the flow is rolling forward or rolling back.
1441 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1442 },
1443 },
1444 },
1445 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1446 # Operation resources.
1447 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1448 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1449 # group of operations results from a `bulkInsert` API request.
1450 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1451 # `update`, or `delete`, and so on.
1452 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1453 # There is no requirement that this be linear or support any granularity of
1454 # operations. This should not be used to guess when the operation will be
1455 # complete. This number should monotonically increase as the operation
1456 # progresses.
1457 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1458 # applicable when performing regional operations.
1459 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1460 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1461 # this field will contain information on all underlying zonal actions and
1462 # their state.
1463 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1464 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1465 # Example key: zones/us-central1-a
1466 &quot;a_key&quot;: {
1467 &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
1468 # populated.
1469 # different programming environments, including REST APIs and RPC APIs. It is
1470 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1471 # three pieces of data: error code, error message, and error details.
1472 #
1473 # You can find out more about this error model and how to work with it in the
1474 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1475 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1476 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1477 # message types for APIs to use.
1478 {
1479 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1480 },
1481 ],
1482 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1483 # user-facing error message should be localized and sent in the
1484 # google.rpc.Status.details field, or localized by the client.
1485 },
1486 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1487 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1488 },
1489 },
1490 },
1491 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1492 # This value is inRFC3339
1493 # text format.
1494 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1495 # following:
1496 # `PENDING`, `RUNNING`, or `DONE`.
1497 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1498 # operation.
1499 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1500 # of the target resource.
1501 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1502 # operations related to creating a snapshot, this points to the disk
1503 # that the snapshot was created from.
1504 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1505 # `[email protected]` or
1506 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1507 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1508 # operation, this field will be populated.
1509 {
1510 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1511 # Engine returns NO_RESULTS_ON_PAGE if there
1512 # are no results in the response.
1513 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1514 # value format. For example:
1515 #
1516 # &quot;data&quot;: [
1517 # {
1518 # &quot;key&quot;: &quot;scope&quot;,
1519 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1520 # }
1521 {
1522 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1523 # returned. For example, for warnings where there are no results in a list
1524 # request for a particular zone, this key might be scope and
1525 # the key value might be the zone name. Other examples might be a key
1526 # indicating a deprecated resource and a suggested replacement, or a
1527 # warning about invalid network settings (for example, if an instance
1528 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1529 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1530 },
1531 ],
1532 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1533 },
1534 ],
1535 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1536 # applicable when performing per-zone operations.
1537 }</pre>
1538 </div>
1539
1540 <div class="method">
1541 <code class="details" id="get">get(project, instanceTemplate, x__xgafv=None)</code>
1542 <pre>Returns the specified instance template.
1543
1544 Args:
1545 project: string, Project ID for this request. (required)
1546 instanceTemplate: string, The name of the instance template. (required)
1547 x__xgafv: string, V1 error format.
1548 Allowed values
1549 1 - v1 error format
1550 2 - v2 error format
1551
1552 Returns:
1553 An object of the form:
1554
1555 { # Represents an Instance Template resource.
1556 #
1557 # Google Compute Engine has two Instance Template resources:
1558 #
1559 # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
1560 # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
1561 #
1562 # You can reuse a global instance template in
1563 # different regions whereas you can use a regional instance template in a
1564 # specified region only. If you want to reduce cross-region dependency or
1565 # achieve data residency, use a regional instance template.
1566 #
1567 # To create VMs, managed instance groups, and reservations, you can use either
1568 # global or regional instance templates.
1569 #
1570 # For more information, readInstance Templates.
1571 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
1572 # text format.
1573 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1574 # create the resource.
1575 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this instance template. The server
1576 # defines this identifier.
1577 &quot;kind&quot;: &quot;compute#instanceTemplate&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
1578 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
1579 # The name must be 1-63 characters long, and comply withRFC1035.
1580 # Specifically, the name must be 1-63 characters long and match the regular
1581 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
1582 # character must be a lowercase letter, and all following characters must be
1583 # a dash, lowercase letter, or digit, except the last character, which cannot
1584 # be a dash.
1585 &quot;properties&quot;: { # The instance properties for this instance template.
1586 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
1587 # Note that for MachineImage, this is not supported yet.
1588 # Options that would traditionally be configured in a BIOS belong
1589 # here. Features that require operating system support may have
1590 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
1591 # disabled).
1592 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
1593 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
1594 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
1595 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
1596 # multithreading (SMT) set this to 1. If unset, the maximum number
1597 # of threads supported per core by the underlying processor is
1598 # assumed.
1599 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
1600 # Supported modes include:
1601 # * ALL_CORE_MAX
1602 #
1603 # Using empty string or not setting this field will use the platform-specific
1604 # default turbo mode.
1605 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
1606 # the number of threads per core to compute the total number of virtual
1607 # CPUs to expose to the instance. If unset, the number of cores is
1608 # inferred from the instance&#x27;s nominal CPU count and the underlying
1609 # platform&#x27;s SMT width.
1610 },
1611 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
1612 # source IP addresses other than their own and receive packets with
1613 # destination IP addresses other than their own. If these instances will be
1614 # used as an IP gateway or it will be set as the next-hop in a Route
1615 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
1616 # documentation for more information.
1617 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
1618 # Note that for MachineImage, this is not supported yet.
1619 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
1620 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
1621 },
1622 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
1623 # properties.
1624 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
1625 # from these properties.
1626 { # An instance-attached disk resource.
1627 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
1628 # or X86_64.
1629 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
1630 # deleted (but not when the disk is detached from the instance).
1631 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
1632 # partition of the disk for its root filesystem.
1633 &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
1634 # running within the instance. This name can be used to reference the device
1635 # for mounting, resizing, and so on, from within the instance.
1636 #
1637 # If not specified, the server chooses a default device name to apply to this
1638 # disk, in the form persistent-disk-x, where x is a number
1639 # assigned by Google Compute Engine. This field is only applicable for
1640 # persistent disks.
1641 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
1642 # encryption key.
1643 #
1644 # If you are creating a new disk, this field encrypts the new disk using
1645 # an encryption key that you provide. If you are attaching an existing
1646 # disk that is already encrypted, this field decrypts the disk using
1647 # the customer-supplied encryption key.
1648 #
1649 # If you encrypt a disk using a customer-supplied key, you must provide the
1650 # same key again when you attempt to use this resource at a later time. For
1651 # example, you must provide the key when you create a snapshot or an image
1652 # from the disk or when you attach the disk to a virtual machine instance.
1653 #
1654 # If you do not provide an encryption key, then the disk will be encrypted
1655 # using an automatically generated key and you do not need to provide a key
1656 # to use the disk later.
1657 #
1658 # Note:
1659 #
1660 # Instance templates do not storecustomer-supplied
1661 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
1662 #
1663 # You cannot create VMs that have disks with customer-supplied keys using
1664 # the bulk
1665 # insert method.
1666 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1667 # For example:
1668 #
1669 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1670 # key_region/cryptoKeys/key
1671 #
1672 # The fully-qualifed key name may be returned for resource GET requests. For
1673 # example:
1674 #
1675 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1676 # key_region/cryptoKeys/key
1677 # /cryptoKeyVersions/1
1678 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1679 # key. If absent, the Compute Engine default service account is used.
1680 # For example:
1681 #
1682 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1683 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1684 # encryption key, encoded in RFC
1685 # 4648 base64 to either encrypt or decrypt this resource. You can
1686 # provide either the rawKey or thersaEncryptedKey.
1687 # For example:
1688 #
1689 # &quot;rawKey&quot;:
1690 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1691 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1692 # customer-supplied encryption key to either encrypt or decrypt this
1693 # resource. You can provide either the rawKey or thersaEncryptedKey.
1694 # For example:
1695 #
1696 # &quot;rsaEncryptedKey&quot;:
1697 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1698 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1699 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1700 #
1701 # The key must meet the following requirements before you can provide it to
1702 # Compute Engine:
1703 #
1704 # 1. The key is wrapped using a RSA public key certificate provided by
1705 # Google.
1706 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1707 # encoding.
1708 #
1709 # Gets the RSA public key certificate provided by Google at:
1710 #
1711 #
1712 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1713 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1714 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1715 # encryption key that protects this resource.
1716 },
1717 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
1718 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
1719 # currently attached to another instance. If you try to force attach a zonal
1720 # disk to an instance, you will receive an error.
1721 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
1722 # only for bootable images. Read
1723 # Enabling guest operating system features to see a list of available
1724 # options.
1725 { # Guest OS features.
1726 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
1727 # separate values. Set to one or more of the following values:
1728 #
1729 # - VIRTIO_SCSI_MULTIQUEUE
1730 # - WINDOWS
1731 # - MULTI_IP_SUBNET
1732 # - UEFI_COMPATIBLE
1733 # - GVNIC
1734 # - SEV_CAPABLE
1735 # - SUSPEND_RESUME_COMPATIBLE
1736 # - SEV_LIVE_MIGRATABLE_V2
1737 # - SEV_SNP_CAPABLE
1738 # - TDX_CAPABLE
1739 # - IDPF
1740 # - SNP_SVSM_CAPABLE
1741 # - CCA_CAPABLE
1742 #
1743 #
1744 # For more information, see
1745 # Enabling guest operating system features.
1746 },
1747 ],
1748 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
1749 # boot disk. If you have many disks attached to an instance, each
1750 # disk would have a unique index number.
1751 &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
1752 # alongside the new instance. Use initialization parameters to create boot
1753 # disks or local SSDs attached to the new instance.
1754 #
1755 # This property is mutually exclusive with the source property;
1756 # you can only define one or the other, but not both.
1757 # alongside the new instance. Use initialization parameters to create boot
1758 # disks or local SSDs attached to the new instance.
1759 #
1760 # This field is persisted and returned for instanceTemplate and not returned
1761 # in the context of instance.
1762 #
1763 # This property is mutually exclusive with the source property;
1764 # you can only define one or the other, but not both.
1765 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
1766 # arm64 or x86_64.
1767 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
1768 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
1769 # of the instance. If a disk with the same name already exists in the given
1770 # region, the existing disk is attached to the new instance and the
1771 # new disk is not created.
1772 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
1773 # 10 GB. If you specify a sourceImage, which is required for
1774 # boot disks, the default size is the size of the sourceImage.
1775 # If you do not specify a sourceImage, the default disk size
1776 # is 500 GB.
1777 &quot;diskType&quot;: &quot;A String&quot;,
1778 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
1779 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
1780 # persistent disks.
1781 &quot;a_key&quot;: &quot;A String&quot;,
1782 },
1783 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
1784 &quot;A String&quot;,
1785 ],
1786 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
1787 # is to use the existing disk.
1788 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
1789 # of I/O operations per second that the disk can handle. Values must be
1790 # between 10,000 and 120,000. For more details, see theExtreme persistent
1791 # disk documentation.
1792 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
1793 # number of throughput mb per second that the disk can handle. Values must
1794 # greater than or equal to 1.
1795 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
1796 # the URLs of the zones where the disk should be replicated to.
1797 # You must provide exactly two replica zones, and one zone must be the same
1798 # as the instance zone.
1799 &quot;A String&quot;,
1800 ],
1801 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
1802 # have the same definition as resource
1803 # manager tags. Keys and values can be either in numeric format,
1804 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1805 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1806 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
1807 # empty.
1808 &quot;a_key&quot;: &quot;A String&quot;,
1809 },
1810 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
1811 # Specified using the full or partial URL. For instance template, specify
1812 # only the resource policy name.
1813 &quot;A String&quot;,
1814 ],
1815 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
1816 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1817 # is required.
1818 #
1819 # To create a disk with one of the public operating system
1820 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
1821 #
1822 # projects/debian-cloud/global/images/family/debian-9
1823 #
1824 #
1825 # Alternatively, use a specific version of a public operating system image:
1826 #
1827 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
1828 #
1829 #
1830 # To create a disk with a custom image that you created, specify the
1831 # image name in the following format:
1832 #
1833 # global/images/my-custom-image
1834 #
1835 #
1836 # You can also specify a custom image by its image family, which returns
1837 # the latest version of the image in that family. Replace the image name
1838 # with family/family-name:
1839 #
1840 # global/images/family/my-image-family
1841 #
1842 #
1843 # If the source image is deleted later, this field will not be set.
1844 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
1845 # encryption key of the source image. Required if the source image is
1846 # protected by a customer-supplied encryption key.
1847 #
1848 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
1849 # encryption keys, so you cannot create disks for instances in a managed instance group if the
1850 # source images are encrypted with your own keys.
1851 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1852 # For example:
1853 #
1854 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1855 # key_region/cryptoKeys/key
1856 #
1857 # The fully-qualifed key name may be returned for resource GET requests. For
1858 # example:
1859 #
1860 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1861 # key_region/cryptoKeys/key
1862 # /cryptoKeyVersions/1
1863 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1864 # key. If absent, the Compute Engine default service account is used.
1865 # For example:
1866 #
1867 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1868 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1869 # encryption key, encoded in RFC
1870 # 4648 base64 to either encrypt or decrypt this resource. You can
1871 # provide either the rawKey or thersaEncryptedKey.
1872 # For example:
1873 #
1874 # &quot;rawKey&quot;:
1875 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1876 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1877 # customer-supplied encryption key to either encrypt or decrypt this
1878 # resource. You can provide either the rawKey or thersaEncryptedKey.
1879 # For example:
1880 #
1881 # &quot;rsaEncryptedKey&quot;:
1882 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1883 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1884 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1885 #
1886 # The key must meet the following requirements before you can provide it to
1887 # Compute Engine:
1888 #
1889 # 1. The key is wrapped using a RSA public key certificate provided by
1890 # Google.
1891 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1892 # encoding.
1893 #
1894 # Gets the RSA public key certificate provided by Google at:
1895 #
1896 #
1897 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1898 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1899 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1900 # encryption key that protects this resource.
1901 },
1902 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
1903 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
1904 # is required.
1905 #
1906 # To create a disk with a snapshot that you created, specify the
1907 # snapshot name in the following format:
1908 #
1909 # global/snapshots/my-backup
1910 #
1911 #
1912 # If the source snapshot is deleted later, this field will not be set.
1913 #
1914 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
1915 # an image instead when you create VMs using
1916 # the bulk
1917 # insert method.
1918 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
1919 # encryption key of the source snapshot.
1920 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1921 # For example:
1922 #
1923 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1924 # key_region/cryptoKeys/key
1925 #
1926 # The fully-qualifed key name may be returned for resource GET requests. For
1927 # example:
1928 #
1929 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1930 # key_region/cryptoKeys/key
1931 # /cryptoKeyVersions/1
1932 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1933 # key. If absent, the Compute Engine default service account is used.
1934 # For example:
1935 #
1936 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1937 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1938 # encryption key, encoded in RFC
1939 # 4648 base64 to either encrypt or decrypt this resource. You can
1940 # provide either the rawKey or thersaEncryptedKey.
1941 # For example:
1942 #
1943 # &quot;rawKey&quot;:
1944 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1945 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1946 # customer-supplied encryption key to either encrypt or decrypt this
1947 # resource. You can provide either the rawKey or thersaEncryptedKey.
1948 # For example:
1949 #
1950 # &quot;rsaEncryptedKey&quot;:
1951 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1952 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1953 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1954 #
1955 # The key must meet the following requirements before you can provide it to
1956 # Compute Engine:
1957 #
1958 # 1. The key is wrapped using a RSA public key certificate provided by
1959 # Google.
1960 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1961 # encoding.
1962 #
1963 # Gets the RSA public key certificate provided by Google at:
1964 #
1965 #
1966 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1967 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1968 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1969 # encryption key that protects this resource.
1970 },
1971 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
1972 # this as a partial or full URL to the resource. For example, the following
1973 # are valid values:
1974 #
1975 #
1976 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
1977 # - projects/project/zones/zone/storagePools/storagePool
1978 # - zones/zone/storagePools/storagePool
1979 },
1980 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
1981 # either SCSI or NVME. For most machine types, the
1982 # default is SCSI. Local SSDs can use either NVME or SCSI.
1983 # In certain configurations, persistent disks can use NVMe. For more
1984 # information, seeAbout
1985 # persistent disks.
1986 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
1987 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
1988 &quot;A String&quot;,
1989 ],
1990 &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
1991 # in READ_WRITE mode.
1992 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
1993 # field is set to PRESERVED if the LocalSSD data has been saved
1994 # to a persistent location by customer request. (see the
1995 # discard_local_ssd option on Stop/Suspend).
1996 # Read-only in the api.
1997 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
1998 # these are public keys which are safe to store in public
1999 &quot;dbs&quot;: [ # The Key Database (db).
2000 {
2001 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
2002 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
2003 },
2004 ],
2005 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
2006 {
2007 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
2008 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
2009 },
2010 ],
2011 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
2012 {
2013 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
2014 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
2015 },
2016 ],
2017 &quot;pk&quot;: { # The Platform Key (PK).
2018 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
2019 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
2020 },
2021 },
2022 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
2023 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
2024 # is required.
2025 #
2026 # If desired, you can also attach existing non-root persistent disks using
2027 # this property. This field is only applicable for persistent disks.
2028 #
2029 # Note that for InstanceTemplate, specify the disk name for zonal disk,
2030 # and the URL for regional disk.
2031 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
2032 },
2033 ],
2034 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
2035 # created from these properties.
2036 { # A specification of the type and number of accelerator cards attached to the
2037 # instance.
2038 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
2039 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
2040 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
2041 # If you are creating an instance template, specify only the
2042 # accelerator name.
2043 # See GPUs on Compute Engine
2044 # for a full list of accelerator types.
2045 },
2046 ],
2047 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
2048 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
2049 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
2050 &quot;a_key&quot;: &quot;A String&quot;,
2051 },
2052 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
2053 # properties.
2054 # This field only accepts a machine type name, for example `n2-standard-4`.
2055 # If you use the machine type full or partial URL, for example
2056 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
2057 # the request will result in an `INTERNAL_ERROR`.
2058 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
2059 # these properties. These pairs can consist of custom metadata or predefined
2060 # keys. SeeProject and
2061 # instance metadata for more information.
2062 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
2063 # the metadata&#x27;s contents and used for optimistic locking. The
2064 # fingerprint is initially generated by Compute Engine and changes after
2065 # every request to modify or update metadata. You must always provide an
2066 # up-to-date fingerprint hash in order to update or change metadata,
2067 # otherwise the request will fail with error412 conditionNotMet.
2068 #
2069 # To see the latest fingerprint, make a get() request to
2070 # retrieve the resource.
2071 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
2072 # less than 512 KB.
2073 { # Metadata
2074 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
2075 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
2076 # This is reflected as part of a URL in the metadata server. Additionally, to
2077 # avoid ambiguity, keys must not conflict with any other metadata keys
2078 # for the project.
2079 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
2080 # have meaning as interpreted by the image running in the instance. The
2081 # only restriction placed on values is that their size must be less than
2082 # or equal to 262144 bytes (256 KiB).
2083 },
2084 ],
2085 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
2086 # for metadata.
2087 },
2088 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
2089 # scheduled on the specified or newer cpu/platform. Applicable values are the
2090 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
2091 # information, read Specifying a
2092 # Minimum CPU Platform.
2093 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
2094 { # A network interface resource attached to an instance.
2095 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
2096 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
2097 # no external internet access.
2098 { # An access configuration attached to an instance&#x27;s network interface.
2099 # Only one access config per instance is supported.
2100 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
2101 # The first IPv6 address of the external IPv6 range associated
2102 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
2103 # use a static external IP address, it must be unused and in the same region
2104 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
2105 # assign an external IPv6 address from the instance&#x27;s subnetwork.
2106 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
2107 # external IPv6 range.
2108 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
2109 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
2110 # (IPv4), the default and recommended name is External NAT, but
2111 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
2112 # recommend name is External IPv6.
2113 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
2114 # address associated with this instance. Specify an unused static
2115 # external IP address available to the project or leave this field undefined
2116 # to use an IP from a shared ephemeral IP address pool. If you specify a
2117 # static external IP address, it must live in the same region as the zone of
2118 # the instance.
2119 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
2120 # configuration and can only take the following values: PREMIUM,STANDARD.
2121 #
2122 # If an AccessConfig is specified without a valid external IP address, an
2123 # ephemeral IP will be created with this networkTier.
2124 #
2125 # If an AccessConfig with a valid external IP address is specified, it must
2126 # match that of the networkTier associated with the Address resource owning
2127 # that IP.
2128 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
2129 #
2130 # 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
2131 # first IP in associated external IPv6 range.
2132 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
2133 # config.
2134 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
2135 # external IP address of the instance to a DNS domain name.
2136 #
2137 # This field is not used in ipv6AccessConfig. A default PTR
2138 # record will be created if the VM has external IPv6 range associated.
2139 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
2140 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
2141 },
2142 ],
2143 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
2144 # You can only specify this field for network interfaces in VPC networks.
2145 { # An alias IP range attached to an instance&#x27;s network interface.
2146 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
2147 # must belong to the specified subnetwork and cannot contain IP addresses
2148 # reserved by system or used by other network interfaces. This range may be
2149 # 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).
2150 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
2151 # alias range. If not specified, the primary range of the subnetwork is used.
2152 },
2153 ],
2154 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
2155 # You can only specify this field for network interfaces in VPC networks.
2156 { # An alias IP range attached to an instance&#x27;s network interface.
2157 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
2158 # must belong to the specified subnetwork and cannot contain IP addresses
2159 # reserved by system or used by other network interfaces. This range may be
2160 # 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).
2161 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
2162 # alias range. If not specified, the primary range of the subnetwork is used.
2163 },
2164 ],
2165 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
2166 # with network_attachment.
2167 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
2168 # This field will be ignored when inserting an Instance or
2169 # adding a NetworkInterface. An up-to-date
2170 # 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.
2171 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
2172 # or not. If enabled, also indicates the version of IGMP supported.
2173 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
2174 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
2175 # one IPv6 access config, DIRECT_IPV6, is supported. If there
2176 # is no ipv6AccessConfig specified, then this instance will
2177 # have no external IPv6 Internet access.
2178 { # An access configuration attached to an instance&#x27;s network interface.
2179 # Only one access config per instance is supported.
2180 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
2181 # The first IPv6 address of the external IPv6 range associated
2182 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
2183 # use a static external IP address, it must be unused and in the same region
2184 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
2185 # assign an external IPv6 address from the instance&#x27;s subnetwork.
2186 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
2187 # external IPv6 range.
2188 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
2189 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
2190 # (IPv4), the default and recommended name is External NAT, but
2191 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
2192 # recommend name is External IPv6.
2193 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
2194 # address associated with this instance. Specify an unused static
2195 # external IP address available to the project or leave this field undefined
2196 # to use an IP from a shared ephemeral IP address pool. If you specify a
2197 # static external IP address, it must live in the same region as the zone of
2198 # the instance.
2199 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
2200 # configuration and can only take the following values: PREMIUM,STANDARD.
2201 #
2202 # If an AccessConfig is specified without a valid external IP address, an
2203 # ephemeral IP will be created with this networkTier.
2204 #
2205 # If an AccessConfig with a valid external IP address is specified, it must
2206 # match that of the networkTier associated with the Address resource owning
2207 # that IP.
2208 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
2209 #
2210 # 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
2211 # first IP in associated external IPv6 range.
2212 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
2213 # config.
2214 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
2215 # external IP address of the instance to a DNS domain name.
2216 #
2217 # This field is not used in ipv6AccessConfig. A default PTR
2218 # record will be created if the VM has external IPv6 range associated.
2219 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
2220 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
2221 },
2222 ],
2223 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
2224 # accessed from the Internet. This field is always inherited from its
2225 # subnetwork.
2226 #
2227 # Valid only if stackType is IPV4_IPV6.
2228 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
2229 # use a static internal IP address, it must be unused and in the same region
2230 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
2231 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
2232 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
2233 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
2234 # server. For a VM, the network interface uses the nicN naming
2235 # format. Where N is a value between 0 and7. The default interface value is nic0.
2236 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
2237 # instance, if neither the network nor the subnetwork is specified, the
2238 # default network global/networks/default is used. If the
2239 # selected project doesn&#x27;t have the default network, you must specify a
2240 # network or subnet. If the network is not specified but the subnetwork is
2241 # specified, the network is inferred.
2242 #
2243 # If you specify this property, you can specify the network as
2244 # a full or partial URL. For example, the following are all valid URLs:
2245 #
2246 #
2247 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
2248 # - projects/project/global/networks/network
2249 # - global/networks/default
2250 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
2251 # to in the following format:
2252 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
2253 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
2254 # interface. If not specified by the user, an unused internal IP is
2255 # assigned by the system.
2256 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
2257 # VirtioNet.
2258 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
2259 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
2260 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
2261 # if not specified by the users.
2262 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
2263 # interface. Can only be used with network_attachment. It is not possible to
2264 # use on its own however, network_attachment can be used without
2265 # service_class_id.
2266 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
2267 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
2268 #
2269 # This field can be both set at instance creation and update network
2270 # interface operations.
2271 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
2272 # resource is inlegacy
2273 # mode, do not specify this field. If the network is in auto subnet
2274 # mode, specifying the subnetwork is optional. If the network is in custom
2275 # subnet mode, specifying the subnetwork is required. If you specify this
2276 # field, you can specify the subnetwork as a full or partial URL. For
2277 # example, the following are all valid URLs:
2278 #
2279 #
2280 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
2281 # - regions/region/subnetworks/subnetwork
2282 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
2283 # from 2 to 255 inclusively.
2284 },
2285 ],
2286 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
2287 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
2288 },
2289 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
2290 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
2291 # Note that for MachineImage, this is not supported yet.
2292 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
2293 # Note that for MachineImage, this is not supported yet.
2294 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
2295 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
2296 # Consuming reserved instances for examples.
2297 &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
2298 # the name of your reservation as its value.
2299 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
2300 # either a name to a reservation in the same project or
2301 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
2302 # shared reservation in the same zone but in a different project.
2303 &quot;A String&quot;,
2304 ],
2305 },
2306 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
2307 # have the same definition as resource
2308 # manager tags. Keys and values can be either in numeric format,
2309 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
2310 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
2311 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
2312 # PATCH) when empty.
2313 &quot;a_key&quot;: &quot;A String&quot;,
2314 },
2315 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
2316 # these properties.
2317 # Note that for MachineImage, this is not supported yet.
2318 &quot;A String&quot;,
2319 ],
2320 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
2321 # these properties.
2322 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
2323 # terminated by Compute Engine (not terminated by a user). You can only set
2324 # the automatic restart option for standard instances.Preemptible instances
2325 # cannot be automatically restarted.
2326 #
2327 # By default, this is set to true so an instance is
2328 # automatically restarted if it is terminated by Compute Engine.
2329 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
2330 # must be a number between 1 and the number of availability domains
2331 # specified in the spread placement policy attached to the instance.
2332 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
2333 # within the range of [90, 330] with the increment of 30, if unset, the
2334 # default behavior of host error recovery will be used.
2335 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
2336 &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
2337 # recovery of the Local Ssd state is attempted. Its value should be in
2338 # between 0 and 168 hours with hour granularity and the default value being 1
2339 # hour.
2340 # as a count of seconds and fractions of seconds at nanosecond
2341 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2342 # or &quot;month&quot;. Range is approximately 10,000 years.
2343 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2344 # Durations less than one second are represented with a 0
2345 # `seconds` field and a positive `nanos` field. Must be from 0
2346 # to 999,999,999 inclusive.
2347 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2348 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2349 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2350 },
2351 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
2352 # resources.
2353 # This field is for use by internal tools that use the public API.
2354 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
2355 # the instance termination action will be performed at the end of the run
2356 # duration.
2357 # as a count of seconds and fractions of seconds at nanosecond
2358 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2359 # or &quot;month&quot;. Range is approximately 10,000 years.
2360 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2361 # Durations less than one second are represented with a 0
2362 # `seconds` field and a positive `nanos` field. Must be from 0
2363 # to 999,999,999 inclusive.
2364 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2365 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2366 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2367 },
2368 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
2369 # on a sole-tenant node.
2370 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
2371 # affinity for more information.
2372 # Overrides reservationAffinity.
2373 { # Node Affinity: the configuration of desired nodes onto which this Instance
2374 # could be scheduled.
2375 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
2376 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
2377 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
2378 &quot;A String&quot;,
2379 ],
2380 },
2381 ],
2382 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
2383 # the default behavior is MIGRATE. Forpreemptible instances,
2384 # the default and only possible behavior is TERMINATE. For more
2385 # information, see
2386 # Set
2387 # VM host maintenance policy.
2388 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
2389 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
2390 # else, the Local SSD data will be preserved when the instance is stopped
2391 # at the end of the run duration/termination time.
2392 },
2393 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
2394 # instance creation or while the instance isstopped and
2395 # therefore, in a `TERMINATED` state. SeeInstance Life
2396 # Cycle for more information on the possible instance states.
2397 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
2398 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
2399 # Off and ACPI G3 Mechanical
2400 # Off for Standard VMs and 30 seconds for Spot VMs.
2401 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
2402 # termination action will be performed at the termination time.
2403 },
2404 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
2405 # service accounts are available to the instances that are created from
2406 # these properties. Use metadata queries to obtain the access tokens for
2407 # these instances.
2408 { # A service account.
2409 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
2410 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
2411 &quot;A String&quot;,
2412 ],
2413 },
2414 ],
2415 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
2416 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
2417 # default.
2418 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
2419 # default.
2420 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
2421 # default.
2422 },
2423 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
2424 # properties. The tags identify valid sources or targets for network
2425 # firewalls. The setTags method can modify this list of tags. Each tag within
2426 # the list must comply with RFC1035.
2427 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
2428 # the tags&#x27; contents and used for optimistic locking. The
2429 # fingerprint is initially generated by Compute Engine and changes after
2430 # every request to modify or update tags. You must always provide an
2431 # up-to-date fingerprint hash in order to update or change tags.
2432 #
2433 # To see the latest fingerprint, make get() request to the
2434 # instance.
2435 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
2436 # with RFC1035.
2437 &quot;A String&quot;,
2438 ],
2439 },
2440 &quot;workloadIdentityConfig&quot;: {
2441 &quot;identity&quot;: &quot;A String&quot;,
2442 &quot;identityCertificateEnabled&quot;: True or False,
2443 },
2444 },
2445 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the instance template resides. Only
2446 # applicable for regional resources.
2447 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this instance template. The server defines this
2448 # URL.
2449 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the template. You can provide this as a
2450 # partial or full URL to the resource. For example, the following are valid
2451 # values:
2452 #
2453 #
2454 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
2455 # - projects/project/zones/zone/instances/instance
2456 &quot;sourceInstanceParams&quot;: { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
2457 # from a source instance.
2458 &quot;diskConfigs&quot;: [ # Attached disks configuration. If not provided, defaults are applied:
2459 # For boot disk and any other R/W disks, the source images for each disk
2460 # will be used. For read-only disks, they will be attached in read-only
2461 # mode. Local SSD disks will be created as blank volumes.
2462 { # A specification of the desired way to instantiate a disk in the instance
2463 # template when its created from a source instance.
2464 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
2465 # deleted (but not when the disk is detached from the instance).
2466 &quot;customImage&quot;: &quot;A String&quot;, # The custom source image to be used to restore this disk when instantiating
2467 # this instance template.
2468 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the device name of the disk to which the configurations apply to.
2469 &quot;instantiateFrom&quot;: &quot;A String&quot;, # Specifies whether to include the disk and what image to use. Possible
2470 # values are:
2471 #
2472 #
2473 # - source-image: to use the same image that was used to
2474 # create the source instance&#x27;s corresponding disk. Applicable to the boot
2475 # disk and additional read-write disks.
2476 # - source-image-family: to use the same image family that
2477 # was used to create the source instance&#x27;s corresponding disk. Applicable
2478 # to the boot disk and additional read-write disks.
2479 # - custom-image: to use a user-provided image url for disk
2480 # creation. Applicable to the boot disk and additional read-write
2481 # disks.
2482 # - attach-read-only: to attach a read-only
2483 # disk. Applicable to read-only disks.
2484 # - do-not-include: to exclude a disk from the template.
2485 # Applicable to additional read-write disks, local SSDs, and read-only
2486 # disks.
2487 },
2488 ],
2489 },
2490 }</pre>
2491 </div>
2492
2493 <div class="method">
2494 <code class="details" id="getIamPolicy">getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</code>
2495 <pre>Gets the access control policy for a resource. May be empty if no such
2496 policy or resource exists.
2497
2498 Args:
2499 project: string, Project ID for this request. (required)
2500 resource: string, Name or id of the resource for this request. (required)
2501 optionsRequestedPolicyVersion: integer, Requested IAM Policy version.
2502 x__xgafv: string, V1 error format.
2503 Allowed values
2504 1 - v1 error format
2505 2 - v2 error format
2506
2507 Returns:
2508 An object of the form:
2509
2510 { # An Identity and Access Management (IAM) policy, which specifies access
2511 # controls for Google Cloud resources.
2512 #
2513 #
2514 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
2515 # `members`, or principals, to a single `role`. Principals can be user
2516 # accounts, service accounts, Google groups, and domains (such as G Suite). A
2517 # `role` is a named list of permissions; each `role` can be an IAM predefined
2518 # role or a user-created custom role.
2519 #
2520 # For some types of Google Cloud resources, a `binding` can also specify a
2521 # `condition`, which is a logical expression that allows access to a resource
2522 # only if the expression evaluates to `true`. A condition can add constraints
2523 # based on attributes of the request, the resource, or both. To learn which
2524 # resources support conditions in their IAM policies, see the
2525 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2526 #
2527 # **JSON example:**
2528 #
2529 # ```
2530 # {
2531 # &quot;bindings&quot;: [
2532 # {
2533 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
2534 # &quot;members&quot;: [
2535 # &quot;user:[email protected]&quot;,
2536 # &quot;group:[email protected]&quot;,
2537 # &quot;domain:google.com&quot;,
2538 # &quot;serviceAccount:[email protected]&quot;
2539 # ]
2540 # },
2541 # {
2542 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
2543 # &quot;members&quot;: [
2544 # &quot;user:[email protected]&quot;
2545 # ],
2546 # &quot;condition&quot;: {
2547 # &quot;title&quot;: &quot;expirable access&quot;,
2548 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
2549 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
2550 # }
2551 # }
2552 # ],
2553 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
2554 # &quot;version&quot;: 3
2555 # }
2556 # ```
2557 #
2558 # **YAML example:**
2559 #
2560 # ```
2561 # bindings:
2562 # - members:
2563 # - user:[email protected]
2564 # - group:[email protected]
2565 # - domain:google.com
2566 # - serviceAccount:[email protected]
2567 # role: roles/resourcemanager.organizationAdmin
2568 # - members:
2569 # - user:[email protected]
2570 # role: roles/resourcemanager.organizationViewer
2571 # condition:
2572 # title: expirable access
2573 # description: Does not grant access after Sep 2020
2574 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
2575 # etag: BwWWja0YfJA=
2576 # version: 3
2577 # ```
2578 #
2579 # For a description of IAM and its features, see the
2580 # [IAM documentation](https://cloud.google.com/iam/docs/).
2581 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
2582 { # Specifies the audit configuration for a service.
2583 # The configuration determines which permission types are logged, and what
2584 # identities, if any, are exempted from logging.
2585 # An AuditConfig must have one or more AuditLogConfigs.
2586 #
2587 # If there are AuditConfigs for both `allServices` and a specific service,
2588 # the union of the two AuditConfigs is used for that service: the log_types
2589 # specified in each AuditConfig are enabled, and the exempted_members in each
2590 # AuditLogConfig are exempted.
2591 #
2592 # Example Policy with multiple AuditConfigs:
2593 #
2594 # {
2595 # &quot;audit_configs&quot;: [
2596 # {
2597 # &quot;service&quot;: &quot;allServices&quot;,
2598 # &quot;audit_log_configs&quot;: [
2599 # {
2600 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
2601 # &quot;exempted_members&quot;: [
2602 # &quot;user:[email protected]&quot;
2603 # ]
2604 # },
2605 # {
2606 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
2607 # },
2608 # {
2609 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
2610 # }
2611 # ]
2612 # },
2613 # {
2614 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
2615 # &quot;audit_log_configs&quot;: [
2616 # {
2617 # &quot;log_type&quot;: &quot;DATA_READ&quot;
2618 # },
2619 # {
2620 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
2621 # &quot;exempted_members&quot;: [
2622 # &quot;user:[email protected]&quot;
2623 # ]
2624 # }
2625 # ]
2626 # }
2627 # ]
2628 # }
2629 #
2630 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
2631 # logging. It also exempts `[email protected]` from DATA_READ logging, and
2632 # `[email protected]` from DATA_WRITE logging.
2633 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
2634 { # Provides the configuration for logging a type of permissions.
2635 # Example:
2636 #
2637 # {
2638 # &quot;audit_log_configs&quot;: [
2639 # {
2640 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
2641 # &quot;exempted_members&quot;: [
2642 # &quot;user:[email protected]&quot;
2643 # ]
2644 # },
2645 # {
2646 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
2647 # }
2648 # ]
2649 # }
2650 #
2651 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
2652 # [email protected] from DATA_READ logging.
2653 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
2654 # permission.
2655 # Follows the same format of Binding.members.
2656 &quot;A String&quot;,
2657 ],
2658 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
2659 },
2660 ],
2661 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
2662 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
2663 # `allServices` is a special value that covers all services.
2664 },
2665 ],
2666 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
2667 # may specify a `condition` that determines how and when the `bindings` are
2668 # applied. Each of the `bindings` must contain at least one principal.
2669 #
2670 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
2671 # of these principals can be Google groups. Each occurrence of a principal
2672 # counts towards these limits. For example, if the `bindings` grant 50
2673 # different roles to `user:[email protected]`, and not to any other
2674 # principal, then you can add another 1,450 principals to the `bindings` in
2675 # the `Policy`.
2676 { # Associates `members`, or principals, with a `role`.
2677 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
2678 #
2679 # If the condition evaluates to `true`, then this binding applies to the
2680 # current request.
2681 #
2682 # If the condition evaluates to `false`, then this binding does not apply to
2683 # the current request. However, a different role binding might grant the same
2684 # role to one or more of the principals in this binding.
2685 #
2686 # To learn which resources support conditions in their IAM policies, see the
2687 # [IAM
2688 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2689 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
2690 # are documented at https://github.com/google/cel-spec.
2691 #
2692 # Example (Comparison):
2693 #
2694 # title: &quot;Summary size limit&quot;
2695 # description: &quot;Determines if a summary is less than 100 chars&quot;
2696 # expression: &quot;document.summary.size() &lt; 100&quot;
2697 #
2698 # Example (Equality):
2699 #
2700 # title: &quot;Requestor is owner&quot;
2701 # description: &quot;Determines if requestor is the document owner&quot;
2702 # expression: &quot;document.owner == request.auth.claims.email&quot;
2703 #
2704 # Example (Logic):
2705 #
2706 # title: &quot;Public documents&quot;
2707 # description: &quot;Determine whether the document should be publicly visible&quot;
2708 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
2709 #
2710 # Example (Data Manipulation):
2711 #
2712 # title: &quot;Notification string&quot;
2713 # description: &quot;Create a notification string with a timestamp.&quot;
2714 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
2715 #
2716 # The exact variables and functions that may be referenced within an expression
2717 # are determined by the service that evaluates it. See the service
2718 # documentation for additional information.
2719 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
2720 # describes the expression, e.g. when hovered over it in a UI.
2721 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
2722 # syntax.
2723 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
2724 # reporting, e.g. a file name and a position in the file.
2725 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
2726 # its purpose. This can be used e.g. in UIs which allow to enter the
2727 # expression.
2728 },
2729 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
2730 # `members` can have the following values:
2731 #
2732 # * `allUsers`: A special identifier that represents anyone who is
2733 # on the internet; with or without a Google account.
2734 #
2735 # * `allAuthenticatedUsers`: A special identifier that represents anyone
2736 # who is authenticated with a Google account or a service account.
2737 # Does not include identities that come from external identity providers
2738 # (IdPs) through identity federation.
2739 #
2740 # * `user:{emailid}`: An email address that represents a specific Google
2741 # account. For example, `[email protected]` .
2742 #
2743 #
2744 # * `serviceAccount:{emailid}`: An email address that represents a Google
2745 # service account. For example,
2746 # `[email protected]`.
2747 #
2748 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
2749 # identifier for a
2750 # [Kubernetes service
2751 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
2752 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
2753 #
2754 # * `group:{emailid}`: An email address that represents a Google group.
2755 # For example, `[email protected]`.
2756 #
2757 #
2758 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
2759 # users of that domain. For example, `google.com` or `example.com`.
2760 #
2761 #
2762 #
2763 #
2764 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
2765 # A single identity in a workforce identity pool.
2766 #
2767 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
2768 # All workforce identities in a group.
2769 #
2770 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
2771 # All workforce identities with a specific attribute value.
2772 #
2773 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
2774 # All identities in a workforce identity pool.
2775 #
2776 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
2777 # A single identity in a workload identity pool.
2778 #
2779 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
2780 # A workload identity pool group.
2781 #
2782 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
2783 # All identities in a workload identity pool with a certain attribute.
2784 #
2785 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
2786 # All identities in a workload identity pool.
2787 #
2788 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
2789 # identifier) representing a user that has been recently deleted. For
2790 # example, `[email protected]?uid=123456789012345678901`. If the user is
2791 # recovered, this value reverts to `user:{emailid}` and the recovered user
2792 # retains the role in the binding.
2793 #
2794 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
2795 # unique identifier) representing a service account that has been recently
2796 # deleted. For example,
2797 # `[email protected]?uid=123456789012345678901`.
2798 # If the service account is undeleted, this value reverts to
2799 # `serviceAccount:{emailid}` and the undeleted service account retains the
2800 # role in the binding.
2801 #
2802 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
2803 # identifier) representing a Google group that has been recently
2804 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
2805 # the group is recovered, this value reverts to `group:{emailid}` and the
2806 # recovered group retains the role in the binding.
2807 #
2808 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
2809 # Deleted single identity in a workforce identity pool. For example,
2810 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
2811 &quot;A String&quot;,
2812 ],
2813 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
2814 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
2815 #
2816 # For an overview of the IAM roles and permissions, see the
2817 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
2818 # a list of the available pre-defined roles, see
2819 # [here](https://cloud.google.com/iam/docs/understanding-roles).
2820 },
2821 ],
2822 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
2823 # prevent simultaneous updates of a policy from overwriting each other.
2824 # It is strongly suggested that systems make use of the `etag` in the
2825 # read-modify-write cycle to perform policy updates in order to avoid race
2826 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
2827 # systems are expected to put that etag in the request to `setIamPolicy` to
2828 # ensure that their change will be applied to the same version of the policy.
2829 #
2830 # **Important:** If you use IAM Conditions, you must include the `etag` field
2831 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
2832 # you to overwrite a version `3` policy with a version `1` policy, and all of
2833 # the conditions in the version `3` policy are lost.
2834 &quot;version&quot;: 42, # Specifies the format of the policy.
2835 #
2836 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
2837 # are rejected.
2838 #
2839 # Any operation that affects conditional role bindings must specify version
2840 # `3`. This requirement applies to the following operations:
2841 #
2842 # * Getting a policy that includes a conditional role binding
2843 # * Adding a conditional role binding to a policy
2844 # * Changing a conditional role binding in a policy
2845 # * Removing any role binding, with or without a condition, from a policy
2846 # that includes conditions
2847 #
2848 # **Important:** If you use IAM Conditions, you must include the `etag` field
2849 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
2850 # you to overwrite a version `3` policy with a version `1` policy, and all of
2851 # the conditions in the version `3` policy are lost.
2852 #
2853 # If a policy does not include any conditions, operations on that policy may
2854 # specify any valid version or leave the field unset.
2855 #
2856 # To learn which resources support conditions in their IAM policies, see the
2857 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2858 }</pre>
2859 </div>
2860
2861 <div class="method">
2862 <code class="details" id="insert">insert(project, body=None, requestId=None, x__xgafv=None)</code>
2863 <pre>Creates an instance template in the specified project using the
2864 data that is included in the request. If you are creating a new template to
2865 update an existing instance group, your new instance template must use the
2866 same network or, if applicable, the same subnetwork as the original
2867 template.
2868
2869 Args:
2870 project: string, Project ID for this request. (required)
2871 body: object, The request body.
2872 The object takes the form of:
2873
2874 { # Represents an Instance Template resource.
2875 #
2876 # Google Compute Engine has two Instance Template resources:
2877 #
2878 # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
2879 # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
2880 #
2881 # You can reuse a global instance template in
2882 # different regions whereas you can use a regional instance template in a
2883 # specified region only. If you want to reduce cross-region dependency or
2884 # achieve data residency, use a regional instance template.
2885 #
2886 # To create VMs, managed instance groups, and reservations, you can use either
2887 # global or regional instance templates.
2888 #
2889 # For more information, readInstance Templates.
2890 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
2891 # text format.
2892 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
2893 # create the resource.
2894 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this instance template. The server
2895 # defines this identifier.
2896 &quot;kind&quot;: &quot;compute#instanceTemplate&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
2897 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
2898 # The name must be 1-63 characters long, and comply withRFC1035.
2899 # Specifically, the name must be 1-63 characters long and match the regular
2900 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
2901 # character must be a lowercase letter, and all following characters must be
2902 # a dash, lowercase letter, or digit, except the last character, which cannot
2903 # be a dash.
2904 &quot;properties&quot;: { # The instance properties for this instance template.
2905 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
2906 # Note that for MachineImage, this is not supported yet.
2907 # Options that would traditionally be configured in a BIOS belong
2908 # here. Features that require operating system support may have
2909 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
2910 # disabled).
2911 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
2912 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
2913 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
2914 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
2915 # multithreading (SMT) set this to 1. If unset, the maximum number
2916 # of threads supported per core by the underlying processor is
2917 # assumed.
2918 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
2919 # Supported modes include:
2920 # * ALL_CORE_MAX
2921 #
2922 # Using empty string or not setting this field will use the platform-specific
2923 # default turbo mode.
2924 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
2925 # the number of threads per core to compute the total number of virtual
2926 # CPUs to expose to the instance. If unset, the number of cores is
2927 # inferred from the instance&#x27;s nominal CPU count and the underlying
2928 # platform&#x27;s SMT width.
2929 },
2930 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
2931 # source IP addresses other than their own and receive packets with
2932 # destination IP addresses other than their own. If these instances will be
2933 # used as an IP gateway or it will be set as the next-hop in a Route
2934 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
2935 # documentation for more information.
2936 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
2937 # Note that for MachineImage, this is not supported yet.
2938 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
2939 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
2940 },
2941 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
2942 # properties.
2943 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
2944 # from these properties.
2945 { # An instance-attached disk resource.
2946 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
2947 # or X86_64.
2948 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
2949 # deleted (but not when the disk is detached from the instance).
2950 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
2951 # partition of the disk for its root filesystem.
2952 &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
2953 # running within the instance. This name can be used to reference the device
2954 # for mounting, resizing, and so on, from within the instance.
2955 #
2956 # If not specified, the server chooses a default device name to apply to this
2957 # disk, in the form persistent-disk-x, where x is a number
2958 # assigned by Google Compute Engine. This field is only applicable for
2959 # persistent disks.
2960 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
2961 # encryption key.
2962 #
2963 # If you are creating a new disk, this field encrypts the new disk using
2964 # an encryption key that you provide. If you are attaching an existing
2965 # disk that is already encrypted, this field decrypts the disk using
2966 # the customer-supplied encryption key.
2967 #
2968 # If you encrypt a disk using a customer-supplied key, you must provide the
2969 # same key again when you attempt to use this resource at a later time. For
2970 # example, you must provide the key when you create a snapshot or an image
2971 # from the disk or when you attach the disk to a virtual machine instance.
2972 #
2973 # If you do not provide an encryption key, then the disk will be encrypted
2974 # using an automatically generated key and you do not need to provide a key
2975 # to use the disk later.
2976 #
2977 # Note:
2978 #
2979 # Instance templates do not storecustomer-supplied
2980 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
2981 #
2982 # You cannot create VMs that have disks with customer-supplied keys using
2983 # the bulk
2984 # insert method.
2985 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2986 # For example:
2987 #
2988 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2989 # key_region/cryptoKeys/key
2990 #
2991 # The fully-qualifed key name may be returned for resource GET requests. For
2992 # example:
2993 #
2994 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2995 # key_region/cryptoKeys/key
2996 # /cryptoKeyVersions/1
2997 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2998 # key. If absent, the Compute Engine default service account is used.
2999 # For example:
3000 #
3001 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3002 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3003 # encryption key, encoded in RFC
3004 # 4648 base64 to either encrypt or decrypt this resource. You can
3005 # provide either the rawKey or thersaEncryptedKey.
3006 # For example:
3007 #
3008 # &quot;rawKey&quot;:
3009 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3010 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3011 # customer-supplied encryption key to either encrypt or decrypt this
3012 # resource. You can provide either the rawKey or thersaEncryptedKey.
3013 # For example:
3014 #
3015 # &quot;rsaEncryptedKey&quot;:
3016 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3017 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3018 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3019 #
3020 # The key must meet the following requirements before you can provide it to
3021 # Compute Engine:
3022 #
3023 # 1. The key is wrapped using a RSA public key certificate provided by
3024 # Google.
3025 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3026 # encoding.
3027 #
3028 # Gets the RSA public key certificate provided by Google at:
3029 #
3030 #
3031 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3032 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3033 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3034 # encryption key that protects this resource.
3035 },
3036 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
3037 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
3038 # currently attached to another instance. If you try to force attach a zonal
3039 # disk to an instance, you will receive an error.
3040 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
3041 # only for bootable images. Read
3042 # Enabling guest operating system features to see a list of available
3043 # options.
3044 { # Guest OS features.
3045 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
3046 # separate values. Set to one or more of the following values:
3047 #
3048 # - VIRTIO_SCSI_MULTIQUEUE
3049 # - WINDOWS
3050 # - MULTI_IP_SUBNET
3051 # - UEFI_COMPATIBLE
3052 # - GVNIC
3053 # - SEV_CAPABLE
3054 # - SUSPEND_RESUME_COMPATIBLE
3055 # - SEV_LIVE_MIGRATABLE_V2
3056 # - SEV_SNP_CAPABLE
3057 # - TDX_CAPABLE
3058 # - IDPF
3059 # - SNP_SVSM_CAPABLE
3060 # - CCA_CAPABLE
3061 #
3062 #
3063 # For more information, see
3064 # Enabling guest operating system features.
3065 },
3066 ],
3067 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
3068 # boot disk. If you have many disks attached to an instance, each
3069 # disk would have a unique index number.
3070 &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
3071 # alongside the new instance. Use initialization parameters to create boot
3072 # disks or local SSDs attached to the new instance.
3073 #
3074 # This property is mutually exclusive with the source property;
3075 # you can only define one or the other, but not both.
3076 # alongside the new instance. Use initialization parameters to create boot
3077 # disks or local SSDs attached to the new instance.
3078 #
3079 # This field is persisted and returned for instanceTemplate and not returned
3080 # in the context of instance.
3081 #
3082 # This property is mutually exclusive with the source property;
3083 # you can only define one or the other, but not both.
3084 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
3085 # arm64 or x86_64.
3086 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
3087 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
3088 # of the instance. If a disk with the same name already exists in the given
3089 # region, the existing disk is attached to the new instance and the
3090 # new disk is not created.
3091 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
3092 # 10 GB. If you specify a sourceImage, which is required for
3093 # boot disks, the default size is the size of the sourceImage.
3094 # If you do not specify a sourceImage, the default disk size
3095 # is 500 GB.
3096 &quot;diskType&quot;: &quot;A String&quot;,
3097 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
3098 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
3099 # persistent disks.
3100 &quot;a_key&quot;: &quot;A String&quot;,
3101 },
3102 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
3103 &quot;A String&quot;,
3104 ],
3105 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
3106 # is to use the existing disk.
3107 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
3108 # of I/O operations per second that the disk can handle. Values must be
3109 # between 10,000 and 120,000. For more details, see theExtreme persistent
3110 # disk documentation.
3111 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
3112 # number of throughput mb per second that the disk can handle. Values must
3113 # greater than or equal to 1.
3114 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
3115 # the URLs of the zones where the disk should be replicated to.
3116 # You must provide exactly two replica zones, and one zone must be the same
3117 # as the instance zone.
3118 &quot;A String&quot;,
3119 ],
3120 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
3121 # have the same definition as resource
3122 # manager tags. Keys and values can be either in numeric format,
3123 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3124 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3125 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
3126 # empty.
3127 &quot;a_key&quot;: &quot;A String&quot;,
3128 },
3129 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
3130 # Specified using the full or partial URL. For instance template, specify
3131 # only the resource policy name.
3132 &quot;A String&quot;,
3133 ],
3134 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
3135 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3136 # is required.
3137 #
3138 # To create a disk with one of the public operating system
3139 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
3140 #
3141 # projects/debian-cloud/global/images/family/debian-9
3142 #
3143 #
3144 # Alternatively, use a specific version of a public operating system image:
3145 #
3146 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
3147 #
3148 #
3149 # To create a disk with a custom image that you created, specify the
3150 # image name in the following format:
3151 #
3152 # global/images/my-custom-image
3153 #
3154 #
3155 # You can also specify a custom image by its image family, which returns
3156 # the latest version of the image in that family. Replace the image name
3157 # with family/family-name:
3158 #
3159 # global/images/family/my-image-family
3160 #
3161 #
3162 # If the source image is deleted later, this field will not be set.
3163 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
3164 # encryption key of the source image. Required if the source image is
3165 # protected by a customer-supplied encryption key.
3166 #
3167 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
3168 # encryption keys, so you cannot create disks for instances in a managed instance group if the
3169 # source images are encrypted with your own keys.
3170 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3171 # For example:
3172 #
3173 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3174 # key_region/cryptoKeys/key
3175 #
3176 # The fully-qualifed key name may be returned for resource GET requests. For
3177 # example:
3178 #
3179 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3180 # key_region/cryptoKeys/key
3181 # /cryptoKeyVersions/1
3182 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3183 # key. If absent, the Compute Engine default service account is used.
3184 # For example:
3185 #
3186 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3187 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3188 # encryption key, encoded in RFC
3189 # 4648 base64 to either encrypt or decrypt this resource. You can
3190 # provide either the rawKey or thersaEncryptedKey.
3191 # For example:
3192 #
3193 # &quot;rawKey&quot;:
3194 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3195 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3196 # customer-supplied encryption key to either encrypt or decrypt this
3197 # resource. You can provide either the rawKey or thersaEncryptedKey.
3198 # For example:
3199 #
3200 # &quot;rsaEncryptedKey&quot;:
3201 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3202 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3203 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3204 #
3205 # The key must meet the following requirements before you can provide it to
3206 # Compute Engine:
3207 #
3208 # 1. The key is wrapped using a RSA public key certificate provided by
3209 # Google.
3210 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3211 # encoding.
3212 #
3213 # Gets the RSA public key certificate provided by Google at:
3214 #
3215 #
3216 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3217 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3218 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3219 # encryption key that protects this resource.
3220 },
3221 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
3222 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
3223 # is required.
3224 #
3225 # To create a disk with a snapshot that you created, specify the
3226 # snapshot name in the following format:
3227 #
3228 # global/snapshots/my-backup
3229 #
3230 #
3231 # If the source snapshot is deleted later, this field will not be set.
3232 #
3233 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
3234 # an image instead when you create VMs using
3235 # the bulk
3236 # insert method.
3237 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3238 # encryption key of the source snapshot.
3239 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3240 # For example:
3241 #
3242 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3243 # key_region/cryptoKeys/key
3244 #
3245 # The fully-qualifed key name may be returned for resource GET requests. For
3246 # example:
3247 #
3248 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3249 # key_region/cryptoKeys/key
3250 # /cryptoKeyVersions/1
3251 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3252 # key. If absent, the Compute Engine default service account is used.
3253 # For example:
3254 #
3255 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3256 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3257 # encryption key, encoded in RFC
3258 # 4648 base64 to either encrypt or decrypt this resource. You can
3259 # provide either the rawKey or thersaEncryptedKey.
3260 # For example:
3261 #
3262 # &quot;rawKey&quot;:
3263 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3264 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3265 # customer-supplied encryption key to either encrypt or decrypt this
3266 # resource. You can provide either the rawKey or thersaEncryptedKey.
3267 # For example:
3268 #
3269 # &quot;rsaEncryptedKey&quot;:
3270 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3271 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3272 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3273 #
3274 # The key must meet the following requirements before you can provide it to
3275 # Compute Engine:
3276 #
3277 # 1. The key is wrapped using a RSA public key certificate provided by
3278 # Google.
3279 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3280 # encoding.
3281 #
3282 # Gets the RSA public key certificate provided by Google at:
3283 #
3284 #
3285 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3286 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3287 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3288 # encryption key that protects this resource.
3289 },
3290 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3291 # this as a partial or full URL to the resource. For example, the following
3292 # are valid values:
3293 #
3294 #
3295 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3296 # - projects/project/zones/zone/storagePools/storagePool
3297 # - zones/zone/storagePools/storagePool
3298 },
3299 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
3300 # either SCSI or NVME. For most machine types, the
3301 # default is SCSI. Local SSDs can use either NVME or SCSI.
3302 # In certain configurations, persistent disks can use NVMe. For more
3303 # information, seeAbout
3304 # persistent disks.
3305 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
3306 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
3307 &quot;A String&quot;,
3308 ],
3309 &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
3310 # in READ_WRITE mode.
3311 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
3312 # field is set to PRESERVED if the LocalSSD data has been saved
3313 # to a persistent location by customer request. (see the
3314 # discard_local_ssd option on Stop/Suspend).
3315 # Read-only in the api.
3316 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
3317 # these are public keys which are safe to store in public
3318 &quot;dbs&quot;: [ # The Key Database (db).
3319 {
3320 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3321 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3322 },
3323 ],
3324 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
3325 {
3326 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3327 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3328 },
3329 ],
3330 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
3331 {
3332 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3333 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3334 },
3335 ],
3336 &quot;pk&quot;: { # The Platform Key (PK).
3337 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3338 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3339 },
3340 },
3341 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
3342 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3343 # is required.
3344 #
3345 # If desired, you can also attach existing non-root persistent disks using
3346 # this property. This field is only applicable for persistent disks.
3347 #
3348 # Note that for InstanceTemplate, specify the disk name for zonal disk,
3349 # and the URL for regional disk.
3350 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
3351 },
3352 ],
3353 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
3354 # created from these properties.
3355 { # A specification of the type and number of accelerator cards attached to the
3356 # instance.
3357 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
3358 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
3359 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
3360 # If you are creating an instance template, specify only the
3361 # accelerator name.
3362 # See GPUs on Compute Engine
3363 # for a full list of accelerator types.
3364 },
3365 ],
3366 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
3367 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
3368 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
3369 &quot;a_key&quot;: &quot;A String&quot;,
3370 },
3371 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
3372 # properties.
3373 # This field only accepts a machine type name, for example `n2-standard-4`.
3374 # If you use the machine type full or partial URL, for example
3375 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
3376 # the request will result in an `INTERNAL_ERROR`.
3377 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
3378 # these properties. These pairs can consist of custom metadata or predefined
3379 # keys. SeeProject and
3380 # instance metadata for more information.
3381 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
3382 # the metadata&#x27;s contents and used for optimistic locking. The
3383 # fingerprint is initially generated by Compute Engine and changes after
3384 # every request to modify or update metadata. You must always provide an
3385 # up-to-date fingerprint hash in order to update or change metadata,
3386 # otherwise the request will fail with error412 conditionNotMet.
3387 #
3388 # To see the latest fingerprint, make a get() request to
3389 # retrieve the resource.
3390 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
3391 # less than 512 KB.
3392 { # Metadata
3393 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
3394 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
3395 # This is reflected as part of a URL in the metadata server. Additionally, to
3396 # avoid ambiguity, keys must not conflict with any other metadata keys
3397 # for the project.
3398 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
3399 # have meaning as interpreted by the image running in the instance. The
3400 # only restriction placed on values is that their size must be less than
3401 # or equal to 262144 bytes (256 KiB).
3402 },
3403 ],
3404 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
3405 # for metadata.
3406 },
3407 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
3408 # scheduled on the specified or newer cpu/platform. Applicable values are the
3409 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
3410 # information, read Specifying a
3411 # Minimum CPU Platform.
3412 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
3413 { # A network interface resource attached to an instance.
3414 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
3415 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
3416 # no external internet access.
3417 { # An access configuration attached to an instance&#x27;s network interface.
3418 # Only one access config per instance is supported.
3419 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
3420 # The first IPv6 address of the external IPv6 range associated
3421 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
3422 # use a static external IP address, it must be unused and in the same region
3423 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3424 # assign an external IPv6 address from the instance&#x27;s subnetwork.
3425 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
3426 # external IPv6 range.
3427 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
3428 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
3429 # (IPv4), the default and recommended name is External NAT, but
3430 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
3431 # recommend name is External IPv6.
3432 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
3433 # address associated with this instance. Specify an unused static
3434 # external IP address available to the project or leave this field undefined
3435 # to use an IP from a shared ephemeral IP address pool. If you specify a
3436 # static external IP address, it must live in the same region as the zone of
3437 # the instance.
3438 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
3439 # configuration and can only take the following values: PREMIUM,STANDARD.
3440 #
3441 # If an AccessConfig is specified without a valid external IP address, an
3442 # ephemeral IP will be created with this networkTier.
3443 #
3444 # If an AccessConfig with a valid external IP address is specified, it must
3445 # match that of the networkTier associated with the Address resource owning
3446 # that IP.
3447 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
3448 #
3449 # 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
3450 # first IP in associated external IPv6 range.
3451 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
3452 # config.
3453 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
3454 # external IP address of the instance to a DNS domain name.
3455 #
3456 # This field is not used in ipv6AccessConfig. A default PTR
3457 # record will be created if the VM has external IPv6 range associated.
3458 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
3459 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
3460 },
3461 ],
3462 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
3463 # You can only specify this field for network interfaces in VPC networks.
3464 { # An alias IP range attached to an instance&#x27;s network interface.
3465 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
3466 # must belong to the specified subnetwork and cannot contain IP addresses
3467 # reserved by system or used by other network interfaces. This range may be
3468 # 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).
3469 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
3470 # alias range. If not specified, the primary range of the subnetwork is used.
3471 },
3472 ],
3473 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
3474 # You can only specify this field for network interfaces in VPC networks.
3475 { # An alias IP range attached to an instance&#x27;s network interface.
3476 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
3477 # must belong to the specified subnetwork and cannot contain IP addresses
3478 # reserved by system or used by other network interfaces. This range may be
3479 # 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).
3480 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
3481 # alias range. If not specified, the primary range of the subnetwork is used.
3482 },
3483 ],
3484 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
3485 # with network_attachment.
3486 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
3487 # This field will be ignored when inserting an Instance or
3488 # adding a NetworkInterface. An up-to-date
3489 # 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.
3490 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
3491 # or not. If enabled, also indicates the version of IGMP supported.
3492 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
3493 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
3494 # one IPv6 access config, DIRECT_IPV6, is supported. If there
3495 # is no ipv6AccessConfig specified, then this instance will
3496 # have no external IPv6 Internet access.
3497 { # An access configuration attached to an instance&#x27;s network interface.
3498 # Only one access config per instance is supported.
3499 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
3500 # The first IPv6 address of the external IPv6 range associated
3501 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
3502 # use a static external IP address, it must be unused and in the same region
3503 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3504 # assign an external IPv6 address from the instance&#x27;s subnetwork.
3505 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
3506 # external IPv6 range.
3507 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
3508 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
3509 # (IPv4), the default and recommended name is External NAT, but
3510 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
3511 # recommend name is External IPv6.
3512 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
3513 # address associated with this instance. Specify an unused static
3514 # external IP address available to the project or leave this field undefined
3515 # to use an IP from a shared ephemeral IP address pool. If you specify a
3516 # static external IP address, it must live in the same region as the zone of
3517 # the instance.
3518 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
3519 # configuration and can only take the following values: PREMIUM,STANDARD.
3520 #
3521 # If an AccessConfig is specified without a valid external IP address, an
3522 # ephemeral IP will be created with this networkTier.
3523 #
3524 # If an AccessConfig with a valid external IP address is specified, it must
3525 # match that of the networkTier associated with the Address resource owning
3526 # that IP.
3527 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
3528 #
3529 # 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
3530 # first IP in associated external IPv6 range.
3531 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
3532 # config.
3533 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
3534 # external IP address of the instance to a DNS domain name.
3535 #
3536 # This field is not used in ipv6AccessConfig. A default PTR
3537 # record will be created if the VM has external IPv6 range associated.
3538 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
3539 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
3540 },
3541 ],
3542 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
3543 # accessed from the Internet. This field is always inherited from its
3544 # subnetwork.
3545 #
3546 # Valid only if stackType is IPV4_IPV6.
3547 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
3548 # use a static internal IP address, it must be unused and in the same region
3549 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3550 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
3551 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
3552 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
3553 # server. For a VM, the network interface uses the nicN naming
3554 # format. Where N is a value between 0 and7. The default interface value is nic0.
3555 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
3556 # instance, if neither the network nor the subnetwork is specified, the
3557 # default network global/networks/default is used. If the
3558 # selected project doesn&#x27;t have the default network, you must specify a
3559 # network or subnet. If the network is not specified but the subnetwork is
3560 # specified, the network is inferred.
3561 #
3562 # If you specify this property, you can specify the network as
3563 # a full or partial URL. For example, the following are all valid URLs:
3564 #
3565 #
3566 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
3567 # - projects/project/global/networks/network
3568 # - global/networks/default
3569 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
3570 # to in the following format:
3571 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
3572 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
3573 # interface. If not specified by the user, an unused internal IP is
3574 # assigned by the system.
3575 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
3576 # VirtioNet.
3577 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
3578 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
3579 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
3580 # if not specified by the users.
3581 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
3582 # interface. Can only be used with network_attachment. It is not possible to
3583 # use on its own however, network_attachment can be used without
3584 # service_class_id.
3585 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
3586 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
3587 #
3588 # This field can be both set at instance creation and update network
3589 # interface operations.
3590 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
3591 # resource is inlegacy
3592 # mode, do not specify this field. If the network is in auto subnet
3593 # mode, specifying the subnetwork is optional. If the network is in custom
3594 # subnet mode, specifying the subnetwork is required. If you specify this
3595 # field, you can specify the subnetwork as a full or partial URL. For
3596 # example, the following are all valid URLs:
3597 #
3598 #
3599 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
3600 # - regions/region/subnetworks/subnetwork
3601 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
3602 # from 2 to 255 inclusively.
3603 },
3604 ],
3605 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
3606 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
3607 },
3608 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
3609 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
3610 # Note that for MachineImage, this is not supported yet.
3611 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
3612 # Note that for MachineImage, this is not supported yet.
3613 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
3614 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
3615 # Consuming reserved instances for examples.
3616 &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
3617 # the name of your reservation as its value.
3618 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
3619 # either a name to a reservation in the same project or
3620 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
3621 # shared reservation in the same zone but in a different project.
3622 &quot;A String&quot;,
3623 ],
3624 },
3625 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
3626 # have the same definition as resource
3627 # manager tags. Keys and values can be either in numeric format,
3628 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3629 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3630 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
3631 # PATCH) when empty.
3632 &quot;a_key&quot;: &quot;A String&quot;,
3633 },
3634 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
3635 # these properties.
3636 # Note that for MachineImage, this is not supported yet.
3637 &quot;A String&quot;,
3638 ],
3639 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
3640 # these properties.
3641 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
3642 # terminated by Compute Engine (not terminated by a user). You can only set
3643 # the automatic restart option for standard instances.Preemptible instances
3644 # cannot be automatically restarted.
3645 #
3646 # By default, this is set to true so an instance is
3647 # automatically restarted if it is terminated by Compute Engine.
3648 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
3649 # must be a number between 1 and the number of availability domains
3650 # specified in the spread placement policy attached to the instance.
3651 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
3652 # within the range of [90, 330] with the increment of 30, if unset, the
3653 # default behavior of host error recovery will be used.
3654 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
3655 &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
3656 # recovery of the Local Ssd state is attempted. Its value should be in
3657 # between 0 and 168 hours with hour granularity and the default value being 1
3658 # hour.
3659 # as a count of seconds and fractions of seconds at nanosecond
3660 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3661 # or &quot;month&quot;. Range is approximately 10,000 years.
3662 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3663 # Durations less than one second are represented with a 0
3664 # `seconds` field and a positive `nanos` field. Must be from 0
3665 # to 999,999,999 inclusive.
3666 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3667 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3668 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3669 },
3670 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
3671 # resources.
3672 # This field is for use by internal tools that use the public API.
3673 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
3674 # the instance termination action will be performed at the end of the run
3675 # duration.
3676 # as a count of seconds and fractions of seconds at nanosecond
3677 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3678 # or &quot;month&quot;. Range is approximately 10,000 years.
3679 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3680 # Durations less than one second are represented with a 0
3681 # `seconds` field and a positive `nanos` field. Must be from 0
3682 # to 999,999,999 inclusive.
3683 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3684 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3685 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3686 },
3687 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
3688 # on a sole-tenant node.
3689 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
3690 # affinity for more information.
3691 # Overrides reservationAffinity.
3692 { # Node Affinity: the configuration of desired nodes onto which this Instance
3693 # could be scheduled.
3694 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
3695 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
3696 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
3697 &quot;A String&quot;,
3698 ],
3699 },
3700 ],
3701 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
3702 # the default behavior is MIGRATE. Forpreemptible instances,
3703 # the default and only possible behavior is TERMINATE. For more
3704 # information, see
3705 # Set
3706 # VM host maintenance policy.
3707 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
3708 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
3709 # else, the Local SSD data will be preserved when the instance is stopped
3710 # at the end of the run duration/termination time.
3711 },
3712 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
3713 # instance creation or while the instance isstopped and
3714 # therefore, in a `TERMINATED` state. SeeInstance Life
3715 # Cycle for more information on the possible instance states.
3716 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
3717 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
3718 # Off and ACPI G3 Mechanical
3719 # Off for Standard VMs and 30 seconds for Spot VMs.
3720 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
3721 # termination action will be performed at the termination time.
3722 },
3723 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
3724 # service accounts are available to the instances that are created from
3725 # these properties. Use metadata queries to obtain the access tokens for
3726 # these instances.
3727 { # A service account.
3728 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
3729 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
3730 &quot;A String&quot;,
3731 ],
3732 },
3733 ],
3734 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
3735 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
3736 # default.
3737 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
3738 # default.
3739 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
3740 # default.
3741 },
3742 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
3743 # properties. The tags identify valid sources or targets for network
3744 # firewalls. The setTags method can modify this list of tags. Each tag within
3745 # the list must comply with RFC1035.
3746 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
3747 # the tags&#x27; contents and used for optimistic locking. The
3748 # fingerprint is initially generated by Compute Engine and changes after
3749 # every request to modify or update tags. You must always provide an
3750 # up-to-date fingerprint hash in order to update or change tags.
3751 #
3752 # To see the latest fingerprint, make get() request to the
3753 # instance.
3754 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
3755 # with RFC1035.
3756 &quot;A String&quot;,
3757 ],
3758 },
3759 &quot;workloadIdentityConfig&quot;: {
3760 &quot;identity&quot;: &quot;A String&quot;,
3761 &quot;identityCertificateEnabled&quot;: True or False,
3762 },
3763 },
3764 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the instance template resides. Only
3765 # applicable for regional resources.
3766 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this instance template. The server defines this
3767 # URL.
3768 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the template. You can provide this as a
3769 # partial or full URL to the resource. For example, the following are valid
3770 # values:
3771 #
3772 #
3773 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
3774 # - projects/project/zones/zone/instances/instance
3775 &quot;sourceInstanceParams&quot;: { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
3776 # from a source instance.
3777 &quot;diskConfigs&quot;: [ # Attached disks configuration. If not provided, defaults are applied:
3778 # For boot disk and any other R/W disks, the source images for each disk
3779 # will be used. For read-only disks, they will be attached in read-only
3780 # mode. Local SSD disks will be created as blank volumes.
3781 { # A specification of the desired way to instantiate a disk in the instance
3782 # template when its created from a source instance.
3783 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
3784 # deleted (but not when the disk is detached from the instance).
3785 &quot;customImage&quot;: &quot;A String&quot;, # The custom source image to be used to restore this disk when instantiating
3786 # this instance template.
3787 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the device name of the disk to which the configurations apply to.
3788 &quot;instantiateFrom&quot;: &quot;A String&quot;, # Specifies whether to include the disk and what image to use. Possible
3789 # values are:
3790 #
3791 #
3792 # - source-image: to use the same image that was used to
3793 # create the source instance&#x27;s corresponding disk. Applicable to the boot
3794 # disk and additional read-write disks.
3795 # - source-image-family: to use the same image family that
3796 # was used to create the source instance&#x27;s corresponding disk. Applicable
3797 # to the boot disk and additional read-write disks.
3798 # - custom-image: to use a user-provided image url for disk
3799 # creation. Applicable to the boot disk and additional read-write
3800 # disks.
3801 # - attach-read-only: to attach a read-only
3802 # disk. Applicable to read-only disks.
3803 # - do-not-include: to exclude a disk from the template.
3804 # Applicable to additional read-write disks, local SSDs, and read-only
3805 # disks.
3806 },
3807 ],
3808 },
3809 }
3810
3811 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3812 that if you must retry your request, the server will know to ignore the
3813 request if it has already been completed.
3814
3815 For example, consider a situation where you make an initial request and
3816 the request times out. If you make the request again with the same
3817 request ID, the server can check if original operation with the same
3818 request ID was received, and if so, will ignore the second request. This
3819 prevents clients from accidentally creating duplicate commitments.
3820
3821 The request ID must be
3822 a valid UUID with the exception that zero UUID is not supported
3823 (00000000-0000-0000-0000-000000000000).
3824 x__xgafv: string, V1 error format.
3825 Allowed values
3826 1 - v1 error format
3827 2 - v2 error format
3828
3829 Returns:
3830 An object of the form:
3831
3832 { # Represents an Operation resource.
3833 #
3834 # Google Compute Engine has three Operation resources:
3835 #
3836 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
3837 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
3838 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
3839 #
3840 # You can use an operation resource to manage asynchronous API requests.
3841 # For more information, readHandling
3842 # API responses.
3843 #
3844 # Operations can be global, regional or zonal.
3845 #
3846 # - For global operations, use the `globalOperations`
3847 # resource.
3848 # - For regional operations, use the
3849 # `regionOperations` resource.
3850 # - For zonal operations, use
3851 # the `zoneOperations` resource.
3852 #
3853 #
3854 #
3855 # For more information, read
3856 # Global, Regional, and Zonal Resources.
3857 #
3858 # Note that completed Operation resources have a limited
3859 # retention period.
3860 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3861 # Not present otherwise.
3862 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3863 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3864 # set when the operation is created.
3865 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3866 # text format.
3867 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3868 # this field will be populated.
3869 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3870 # operation.
3871 {
3872 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3873 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3874 # details. There is a set of defined message types to use for providing
3875 # details.The syntax depends on the error code. For example,
3876 # QuotaExceededInfo will have details when the error code is
3877 # QUOTA_EXCEEDED.
3878 {
3879 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3880 #
3881 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3882 # is not enabled:
3883 #
3884 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3885 # &quot;domain&quot;: &quot;googleapis.com&quot;
3886 # &quot;metadata&quot;: {
3887 # &quot;resource&quot;: &quot;projects/123&quot;,
3888 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3889 # }
3890 # }
3891 #
3892 # This response indicates that the pubsub.googleapis.com API is not enabled.
3893 #
3894 # Example of an error that is returned when attempting to create a Spanner
3895 # instance in a region that is out of stock:
3896 #
3897 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3898 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3899 # &quot;metadata&quot;: {
3900 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3901 # }
3902 # }
3903 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3904 # is typically the registered service name of the tool or product that
3905 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3906 # generated by some common infrastructure, the error domain must be a
3907 # globally unique value that identifies the infrastructure. For Google API
3908 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3909 &quot;metadatas&quot;: { # Additional structured details about this error.
3910 #
3911 # Keys must match a regular expression of `a-z+` but should
3912 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3913 # length. When identifying the current value of an exceeded limit, the units
3914 # should be contained in the key, not the value. For example, rather than
3915 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3916 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3917 # instances that can be created in a single (batch) request.
3918 &quot;a_key&quot;: &quot;A String&quot;,
3919 },
3920 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3921 # proximate cause of the error. Error reasons are unique within a particular
3922 # domain of errors. This should be at most 63 characters and match a
3923 # regular expression of `A-Z+[A-Z0-9]`, which represents
3924 # UPPER_SNAKE_CASE.
3925 },
3926 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3927 #
3928 # For example, if a quota check failed with an error indicating the calling
3929 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3930 # directly to the right place in the developer console to flip the bit.
3931 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3932 { # Describes a URL link.
3933 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3934 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3935 },
3936 ],
3937 },
3938 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3939 # which can be attached to an RPC error.
3940 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3941 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3942 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3943 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3944 },
3945 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3946 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3947 &quot;a_key&quot;: &quot;A String&quot;,
3948 },
3949 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3950 # type or metric.
3951 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3952 # or metric.
3953 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3954 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3955 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3956 },
3957 },
3958 ],
3959 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3960 # This property is optional.
3961 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3962 },
3963 ],
3964 },
3965 &quot;getVersionOperationMetadata&quot;: {
3966 &quot;inlineSbomInfo&quot;: {
3967 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3968 # appropriate identifiers.
3969 &quot;a_key&quot;: &quot;A String&quot;,
3970 },
3971 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3972 # identifiers.
3973 &quot;a_key&quot;: &quot;A String&quot;,
3974 },
3975 },
3976 },
3977 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3978 # message that was returned, such as `NOT FOUND`.
3979 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3980 # status code that was returned. For example, a `404` means the
3981 # resource was not found.
3982 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3983 # defined by the server.
3984 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3985 # This value is inRFC3339
3986 # text format.
3987 &quot;instancesBulkInsertOperationMetadata&quot;: {
3988 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3989 # Example key: zones/us-central1-a
3990 &quot;a_key&quot;: {
3991 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3992 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3993 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3994 # error.
3995 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3996 # if the flow is rolling forward or rolling back.
3997 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3998 },
3999 },
4000 },
4001 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4002 # Operation resources.
4003 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4004 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4005 # group of operations results from a `bulkInsert` API request.
4006 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4007 # `update`, or `delete`, and so on.
4008 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4009 # There is no requirement that this be linear or support any granularity of
4010 # operations. This should not be used to guess when the operation will be
4011 # complete. This number should monotonically increase as the operation
4012 # progresses.
4013 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4014 # applicable when performing regional operations.
4015 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4016 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4017 # this field will contain information on all underlying zonal actions and
4018 # their state.
4019 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4020 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4021 # Example key: zones/us-central1-a
4022 &quot;a_key&quot;: {
4023 &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
4024 # populated.
4025 # different programming environments, including REST APIs and RPC APIs. It is
4026 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4027 # three pieces of data: error code, error message, and error details.
4028 #
4029 # You can find out more about this error model and how to work with it in the
4030 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4031 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4032 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4033 # message types for APIs to use.
4034 {
4035 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4036 },
4037 ],
4038 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4039 # user-facing error message should be localized and sent in the
4040 # google.rpc.Status.details field, or localized by the client.
4041 },
4042 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4043 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4044 },
4045 },
4046 },
4047 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4048 # This value is inRFC3339
4049 # text format.
4050 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4051 # following:
4052 # `PENDING`, `RUNNING`, or `DONE`.
4053 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4054 # operation.
4055 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4056 # of the target resource.
4057 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4058 # operations related to creating a snapshot, this points to the disk
4059 # that the snapshot was created from.
4060 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4061 # `[email protected]` or
4062 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4063 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4064 # operation, this field will be populated.
4065 {
4066 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4067 # Engine returns NO_RESULTS_ON_PAGE if there
4068 # are no results in the response.
4069 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4070 # value format. For example:
4071 #
4072 # &quot;data&quot;: [
4073 # {
4074 # &quot;key&quot;: &quot;scope&quot;,
4075 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4076 # }
4077 {
4078 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4079 # returned. For example, for warnings where there are no results in a list
4080 # request for a particular zone, this key might be scope and
4081 # the key value might be the zone name. Other examples might be a key
4082 # indicating a deprecated resource and a suggested replacement, or a
4083 # warning about invalid network settings (for example, if an instance
4084 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4085 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4086 },
4087 ],
4088 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4089 },
4090 ],
4091 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4092 # applicable when performing per-zone operations.
4093 }</pre>
4094 </div>
4095
4096 <div class="method">
4097 <code class="details" id="list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
4098 <pre>Retrieves a list of instance templates that are contained within
4099 the specified project.
4100
4101 Args:
4102 project: string, Project ID for this request. (required)
4103 filter: string, A filter expression that filters resources listed in the response. Most
4104 Compute resources support two types of filter expressions:
4105 expressions that support regular expressions and expressions that follow
4106 API improvement proposal AIP-160.
4107 These two types of filter expressions cannot be mixed in one request.
4108
4109 If you want to use AIP-160, your expression must specify the field name, an
4110 operator, and the value that you want to use for filtering. The value
4111 must be a string, a number, or a boolean. The operator
4112 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
4113
4114 For example, if you are filtering Compute Engine instances, you can
4115 exclude instances named `example-instance` by specifying
4116 `name != example-instance`.
4117
4118 The `:*` comparison can be used to test whether a key has been defined.
4119 For example, to find all objects with `owner` label use:
4120 ```
4121 labels.owner:*
4122 ```
4123
4124 You can also filter nested fields. For example, you could specify
4125 `scheduling.automaticRestart = false` to include instances only
4126 if they are not scheduled for automatic restarts. You can use filtering
4127 on nested fields to filter based onresource labels.
4128
4129 To filter on multiple expressions, provide each separate expression within
4130 parentheses. For example:
4131 ```
4132 (scheduling.automaticRestart = true)
4133 (cpuPlatform = &quot;Intel Skylake&quot;)
4134 ```
4135 By default, each expression is an `AND` expression. However, you
4136 can include `AND` and `OR` expressions explicitly.
4137 For example:
4138 ```
4139 (cpuPlatform = &quot;Intel Skylake&quot;) OR
4140 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
4141 (scheduling.automaticRestart = true)
4142 ```
4143
4144 If you want to use a regular expression, use the `eq` (equal) or `ne`
4145 (not equal) operator against a single un-parenthesized expression with or
4146 without quotes or against multiple parenthesized expressions. Examples:
4147
4148 `fieldname eq unquoted literal`
4149 `fieldname eq &#x27;single quoted literal&#x27;`
4150 `fieldname eq &quot;double quoted literal&quot;`
4151 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
4152
4153 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
4154 The literal value must match the entire field.
4155
4156 For example, to filter for instances that do not end with name &quot;instance&quot;,
4157 you would use `name ne .*instance`.
4158
4159 You cannot combine constraints on multiple fields using regular
4160 expressions.
4161 maxResults: integer, The maximum number of results per page that should be returned.
4162 If the number of available results is larger than `maxResults`,
4163 Compute Engine returns a `nextPageToken` that can be used to get
4164 the next page of results in subsequent list requests. Acceptable values are
4165 `0` to `500`, inclusive. (Default: `500`)
4166 orderBy: string, Sorts list results by a certain order. By default, results
4167 are returned in alphanumerical order based on the resource name.
4168
4169 You can also sort results in descending order based on the creation
4170 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
4171 results based on the `creationTimestamp` field in
4172 reverse chronological order (newest result first). Use this to sort
4173 resources like operations so that the newest operation is returned first.
4174
4175 Currently, only sorting by `name` or
4176 `creationTimestamp desc` is supported.
4177 pageToken: string, Specifies a page token to use. Set `pageToken` to the
4178 `nextPageToken` returned by a previous list request to get
4179 the next page of results.
4180 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
4181 of failure. The default value is false.
4182
4183 For example, when partial success behavior is enabled, aggregatedList for a
4184 single zone scope either returns all resources in the zone or no resources,
4185 with an error code.
4186 x__xgafv: string, V1 error format.
4187 Allowed values
4188 1 - v1 error format
4189 2 - v2 error format
4190
4191 Returns:
4192 An object of the form:
4193
4194 { # A list of instance templates.
4195 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
4196 &quot;items&quot;: [ # A list of InstanceTemplate resources.
4197 { # Represents an Instance Template resource.
4198 #
4199 # Google Compute Engine has two Instance Template resources:
4200 #
4201 # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
4202 # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
4203 #
4204 # You can reuse a global instance template in
4205 # different regions whereas you can use a regional instance template in a
4206 # specified region only. If you want to reduce cross-region dependency or
4207 # achieve data residency, use a regional instance template.
4208 #
4209 # To create VMs, managed instance groups, and reservations, you can use either
4210 # global or regional instance templates.
4211 #
4212 # For more information, readInstance Templates.
4213 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
4214 # text format.
4215 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
4216 # create the resource.
4217 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this instance template. The server
4218 # defines this identifier.
4219 &quot;kind&quot;: &quot;compute#instanceTemplate&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
4220 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
4221 # The name must be 1-63 characters long, and comply withRFC1035.
4222 # Specifically, the name must be 1-63 characters long and match the regular
4223 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
4224 # character must be a lowercase letter, and all following characters must be
4225 # a dash, lowercase letter, or digit, except the last character, which cannot
4226 # be a dash.
4227 &quot;properties&quot;: { # The instance properties for this instance template.
4228 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
4229 # Note that for MachineImage, this is not supported yet.
4230 # Options that would traditionally be configured in a BIOS belong
4231 # here. Features that require operating system support may have
4232 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
4233 # disabled).
4234 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
4235 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
4236 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
4237 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
4238 # multithreading (SMT) set this to 1. If unset, the maximum number
4239 # of threads supported per core by the underlying processor is
4240 # assumed.
4241 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
4242 # Supported modes include:
4243 # * ALL_CORE_MAX
4244 #
4245 # Using empty string or not setting this field will use the platform-specific
4246 # default turbo mode.
4247 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
4248 # the number of threads per core to compute the total number of virtual
4249 # CPUs to expose to the instance. If unset, the number of cores is
4250 # inferred from the instance&#x27;s nominal CPU count and the underlying
4251 # platform&#x27;s SMT width.
4252 },
4253 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
4254 # source IP addresses other than their own and receive packets with
4255 # destination IP addresses other than their own. If these instances will be
4256 # used as an IP gateway or it will be set as the next-hop in a Route
4257 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
4258 # documentation for more information.
4259 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
4260 # Note that for MachineImage, this is not supported yet.
4261 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
4262 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
4263 },
4264 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
4265 # properties.
4266 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
4267 # from these properties.
4268 { # An instance-attached disk resource.
4269 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
4270 # or X86_64.
4271 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
4272 # deleted (but not when the disk is detached from the instance).
4273 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
4274 # partition of the disk for its root filesystem.
4275 &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
4276 # running within the instance. This name can be used to reference the device
4277 # for mounting, resizing, and so on, from within the instance.
4278 #
4279 # If not specified, the server chooses a default device name to apply to this
4280 # disk, in the form persistent-disk-x, where x is a number
4281 # assigned by Google Compute Engine. This field is only applicable for
4282 # persistent disks.
4283 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
4284 # encryption key.
4285 #
4286 # If you are creating a new disk, this field encrypts the new disk using
4287 # an encryption key that you provide. If you are attaching an existing
4288 # disk that is already encrypted, this field decrypts the disk using
4289 # the customer-supplied encryption key.
4290 #
4291 # If you encrypt a disk using a customer-supplied key, you must provide the
4292 # same key again when you attempt to use this resource at a later time. For
4293 # example, you must provide the key when you create a snapshot or an image
4294 # from the disk or when you attach the disk to a virtual machine instance.
4295 #
4296 # If you do not provide an encryption key, then the disk will be encrypted
4297 # using an automatically generated key and you do not need to provide a key
4298 # to use the disk later.
4299 #
4300 # Note:
4301 #
4302 # Instance templates do not storecustomer-supplied
4303 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
4304 #
4305 # You cannot create VMs that have disks with customer-supplied keys using
4306 # the bulk
4307 # insert method.
4308 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4309 # For example:
4310 #
4311 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4312 # key_region/cryptoKeys/key
4313 #
4314 # The fully-qualifed key name may be returned for resource GET requests. For
4315 # example:
4316 #
4317 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4318 # key_region/cryptoKeys/key
4319 # /cryptoKeyVersions/1
4320 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4321 # key. If absent, the Compute Engine default service account is used.
4322 # For example:
4323 #
4324 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4325 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4326 # encryption key, encoded in RFC
4327 # 4648 base64 to either encrypt or decrypt this resource. You can
4328 # provide either the rawKey or thersaEncryptedKey.
4329 # For example:
4330 #
4331 # &quot;rawKey&quot;:
4332 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4333 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4334 # customer-supplied encryption key to either encrypt or decrypt this
4335 # resource. You can provide either the rawKey or thersaEncryptedKey.
4336 # For example:
4337 #
4338 # &quot;rsaEncryptedKey&quot;:
4339 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4340 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4341 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4342 #
4343 # The key must meet the following requirements before you can provide it to
4344 # Compute Engine:
4345 #
4346 # 1. The key is wrapped using a RSA public key certificate provided by
4347 # Google.
4348 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4349 # encoding.
4350 #
4351 # Gets the RSA public key certificate provided by Google at:
4352 #
4353 #
4354 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4355 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4356 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4357 # encryption key that protects this resource.
4358 },
4359 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
4360 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
4361 # currently attached to another instance. If you try to force attach a zonal
4362 # disk to an instance, you will receive an error.
4363 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4364 # only for bootable images. Read
4365 # Enabling guest operating system features to see a list of available
4366 # options.
4367 { # Guest OS features.
4368 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4369 # separate values. Set to one or more of the following values:
4370 #
4371 # - VIRTIO_SCSI_MULTIQUEUE
4372 # - WINDOWS
4373 # - MULTI_IP_SUBNET
4374 # - UEFI_COMPATIBLE
4375 # - GVNIC
4376 # - SEV_CAPABLE
4377 # - SUSPEND_RESUME_COMPATIBLE
4378 # - SEV_LIVE_MIGRATABLE_V2
4379 # - SEV_SNP_CAPABLE
4380 # - TDX_CAPABLE
4381 # - IDPF
4382 # - SNP_SVSM_CAPABLE
4383 # - CCA_CAPABLE
4384 #
4385 #
4386 # For more information, see
4387 # Enabling guest operating system features.
4388 },
4389 ],
4390 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
4391 # boot disk. If you have many disks attached to an instance, each
4392 # disk would have a unique index number.
4393 &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
4394 # alongside the new instance. Use initialization parameters to create boot
4395 # disks or local SSDs attached to the new instance.
4396 #
4397 # This property is mutually exclusive with the source property;
4398 # you can only define one or the other, but not both.
4399 # alongside the new instance. Use initialization parameters to create boot
4400 # disks or local SSDs attached to the new instance.
4401 #
4402 # This field is persisted and returned for instanceTemplate and not returned
4403 # in the context of instance.
4404 #
4405 # This property is mutually exclusive with the source property;
4406 # you can only define one or the other, but not both.
4407 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
4408 # arm64 or x86_64.
4409 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
4410 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
4411 # of the instance. If a disk with the same name already exists in the given
4412 # region, the existing disk is attached to the new instance and the
4413 # new disk is not created.
4414 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
4415 # 10 GB. If you specify a sourceImage, which is required for
4416 # boot disks, the default size is the size of the sourceImage.
4417 # If you do not specify a sourceImage, the default disk size
4418 # is 500 GB.
4419 &quot;diskType&quot;: &quot;A String&quot;,
4420 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
4421 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
4422 # persistent disks.
4423 &quot;a_key&quot;: &quot;A String&quot;,
4424 },
4425 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
4426 &quot;A String&quot;,
4427 ],
4428 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
4429 # is to use the existing disk.
4430 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
4431 # of I/O operations per second that the disk can handle. Values must be
4432 # between 10,000 and 120,000. For more details, see theExtreme persistent
4433 # disk documentation.
4434 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
4435 # number of throughput mb per second that the disk can handle. Values must
4436 # greater than or equal to 1.
4437 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
4438 # the URLs of the zones where the disk should be replicated to.
4439 # You must provide exactly two replica zones, and one zone must be the same
4440 # as the instance zone.
4441 &quot;A String&quot;,
4442 ],
4443 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
4444 # have the same definition as resource
4445 # manager tags. Keys and values can be either in numeric format,
4446 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4447 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4448 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
4449 # empty.
4450 &quot;a_key&quot;: &quot;A String&quot;,
4451 },
4452 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
4453 # Specified using the full or partial URL. For instance template, specify
4454 # only the resource policy name.
4455 &quot;A String&quot;,
4456 ],
4457 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
4458 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4459 # is required.
4460 #
4461 # To create a disk with one of the public operating system
4462 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
4463 #
4464 # projects/debian-cloud/global/images/family/debian-9
4465 #
4466 #
4467 # Alternatively, use a specific version of a public operating system image:
4468 #
4469 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
4470 #
4471 #
4472 # To create a disk with a custom image that you created, specify the
4473 # image name in the following format:
4474 #
4475 # global/images/my-custom-image
4476 #
4477 #
4478 # You can also specify a custom image by its image family, which returns
4479 # the latest version of the image in that family. Replace the image name
4480 # with family/family-name:
4481 #
4482 # global/images/family/my-image-family
4483 #
4484 #
4485 # If the source image is deleted later, this field will not be set.
4486 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
4487 # encryption key of the source image. Required if the source image is
4488 # protected by a customer-supplied encryption key.
4489 #
4490 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
4491 # encryption keys, so you cannot create disks for instances in a managed instance group if the
4492 # source images are encrypted with your own keys.
4493 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4494 # For example:
4495 #
4496 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4497 # key_region/cryptoKeys/key
4498 #
4499 # The fully-qualifed key name may be returned for resource GET requests. For
4500 # example:
4501 #
4502 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4503 # key_region/cryptoKeys/key
4504 # /cryptoKeyVersions/1
4505 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4506 # key. If absent, the Compute Engine default service account is used.
4507 # For example:
4508 #
4509 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4510 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4511 # encryption key, encoded in RFC
4512 # 4648 base64 to either encrypt or decrypt this resource. You can
4513 # provide either the rawKey or thersaEncryptedKey.
4514 # For example:
4515 #
4516 # &quot;rawKey&quot;:
4517 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4518 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4519 # customer-supplied encryption key to either encrypt or decrypt this
4520 # resource. You can provide either the rawKey or thersaEncryptedKey.
4521 # For example:
4522 #
4523 # &quot;rsaEncryptedKey&quot;:
4524 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4525 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4526 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4527 #
4528 # The key must meet the following requirements before you can provide it to
4529 # Compute Engine:
4530 #
4531 # 1. The key is wrapped using a RSA public key certificate provided by
4532 # Google.
4533 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4534 # encoding.
4535 #
4536 # Gets the RSA public key certificate provided by Google at:
4537 #
4538 #
4539 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4540 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4541 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4542 # encryption key that protects this resource.
4543 },
4544 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
4545 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
4546 # is required.
4547 #
4548 # To create a disk with a snapshot that you created, specify the
4549 # snapshot name in the following format:
4550 #
4551 # global/snapshots/my-backup
4552 #
4553 #
4554 # If the source snapshot is deleted later, this field will not be set.
4555 #
4556 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
4557 # an image instead when you create VMs using
4558 # the bulk
4559 # insert method.
4560 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
4561 # encryption key of the source snapshot.
4562 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4563 # For example:
4564 #
4565 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4566 # key_region/cryptoKeys/key
4567 #
4568 # The fully-qualifed key name may be returned for resource GET requests. For
4569 # example:
4570 #
4571 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4572 # key_region/cryptoKeys/key
4573 # /cryptoKeyVersions/1
4574 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4575 # key. If absent, the Compute Engine default service account is used.
4576 # For example:
4577 #
4578 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4579 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4580 # encryption key, encoded in RFC
4581 # 4648 base64 to either encrypt or decrypt this resource. You can
4582 # provide either the rawKey or thersaEncryptedKey.
4583 # For example:
4584 #
4585 # &quot;rawKey&quot;:
4586 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4587 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4588 # customer-supplied encryption key to either encrypt or decrypt this
4589 # resource. You can provide either the rawKey or thersaEncryptedKey.
4590 # For example:
4591 #
4592 # &quot;rsaEncryptedKey&quot;:
4593 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4594 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4595 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4596 #
4597 # The key must meet the following requirements before you can provide it to
4598 # Compute Engine:
4599 #
4600 # 1. The key is wrapped using a RSA public key certificate provided by
4601 # Google.
4602 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4603 # encoding.
4604 #
4605 # Gets the RSA public key certificate provided by Google at:
4606 #
4607 #
4608 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4609 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4610 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4611 # encryption key that protects this resource.
4612 },
4613 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
4614 # this as a partial or full URL to the resource. For example, the following
4615 # are valid values:
4616 #
4617 #
4618 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
4619 # - projects/project/zones/zone/storagePools/storagePool
4620 # - zones/zone/storagePools/storagePool
4621 },
4622 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
4623 # either SCSI or NVME. For most machine types, the
4624 # default is SCSI. Local SSDs can use either NVME or SCSI.
4625 # In certain configurations, persistent disks can use NVMe. For more
4626 # information, seeAbout
4627 # persistent disks.
4628 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
4629 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
4630 &quot;A String&quot;,
4631 ],
4632 &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
4633 # in READ_WRITE mode.
4634 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
4635 # field is set to PRESERVED if the LocalSSD data has been saved
4636 # to a persistent location by customer request. (see the
4637 # discard_local_ssd option on Stop/Suspend).
4638 # Read-only in the api.
4639 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
4640 # these are public keys which are safe to store in public
4641 &quot;dbs&quot;: [ # The Key Database (db).
4642 {
4643 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4644 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4645 },
4646 ],
4647 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
4648 {
4649 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4650 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4651 },
4652 ],
4653 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
4654 {
4655 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4656 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4657 },
4658 ],
4659 &quot;pk&quot;: { # The Platform Key (PK).
4660 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4661 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4662 },
4663 },
4664 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
4665 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4666 # is required.
4667 #
4668 # If desired, you can also attach existing non-root persistent disks using
4669 # this property. This field is only applicable for persistent disks.
4670 #
4671 # Note that for InstanceTemplate, specify the disk name for zonal disk,
4672 # and the URL for regional disk.
4673 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
4674 },
4675 ],
4676 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
4677 # created from these properties.
4678 { # A specification of the type and number of accelerator cards attached to the
4679 # instance.
4680 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
4681 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
4682 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
4683 # If you are creating an instance template, specify only the
4684 # accelerator name.
4685 # See GPUs on Compute Engine
4686 # for a full list of accelerator types.
4687 },
4688 ],
4689 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
4690 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
4691 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
4692 &quot;a_key&quot;: &quot;A String&quot;,
4693 },
4694 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
4695 # properties.
4696 # This field only accepts a machine type name, for example `n2-standard-4`.
4697 # If you use the machine type full or partial URL, for example
4698 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
4699 # the request will result in an `INTERNAL_ERROR`.
4700 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
4701 # these properties. These pairs can consist of custom metadata or predefined
4702 # keys. SeeProject and
4703 # instance metadata for more information.
4704 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
4705 # the metadata&#x27;s contents and used for optimistic locking. The
4706 # fingerprint is initially generated by Compute Engine and changes after
4707 # every request to modify or update metadata. You must always provide an
4708 # up-to-date fingerprint hash in order to update or change metadata,
4709 # otherwise the request will fail with error412 conditionNotMet.
4710 #
4711 # To see the latest fingerprint, make a get() request to
4712 # retrieve the resource.
4713 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
4714 # less than 512 KB.
4715 { # Metadata
4716 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
4717 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
4718 # This is reflected as part of a URL in the metadata server. Additionally, to
4719 # avoid ambiguity, keys must not conflict with any other metadata keys
4720 # for the project.
4721 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
4722 # have meaning as interpreted by the image running in the instance. The
4723 # only restriction placed on values is that their size must be less than
4724 # or equal to 262144 bytes (256 KiB).
4725 },
4726 ],
4727 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
4728 # for metadata.
4729 },
4730 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
4731 # scheduled on the specified or newer cpu/platform. Applicable values are the
4732 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
4733 # information, read Specifying a
4734 # Minimum CPU Platform.
4735 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
4736 { # A network interface resource attached to an instance.
4737 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
4738 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
4739 # no external internet access.
4740 { # An access configuration attached to an instance&#x27;s network interface.
4741 # Only one access config per instance is supported.
4742 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
4743 # The first IPv6 address of the external IPv6 range associated
4744 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
4745 # use a static external IP address, it must be unused and in the same region
4746 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
4747 # assign an external IPv6 address from the instance&#x27;s subnetwork.
4748 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
4749 # external IPv6 range.
4750 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
4751 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
4752 # (IPv4), the default and recommended name is External NAT, but
4753 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
4754 # recommend name is External IPv6.
4755 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
4756 # address associated with this instance. Specify an unused static
4757 # external IP address available to the project or leave this field undefined
4758 # to use an IP from a shared ephemeral IP address pool. If you specify a
4759 # static external IP address, it must live in the same region as the zone of
4760 # the instance.
4761 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
4762 # configuration and can only take the following values: PREMIUM,STANDARD.
4763 #
4764 # If an AccessConfig is specified without a valid external IP address, an
4765 # ephemeral IP will be created with this networkTier.
4766 #
4767 # If an AccessConfig with a valid external IP address is specified, it must
4768 # match that of the networkTier associated with the Address resource owning
4769 # that IP.
4770 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
4771 #
4772 # 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
4773 # first IP in associated external IPv6 range.
4774 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
4775 # config.
4776 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
4777 # external IP address of the instance to a DNS domain name.
4778 #
4779 # This field is not used in ipv6AccessConfig. A default PTR
4780 # record will be created if the VM has external IPv6 range associated.
4781 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
4782 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
4783 },
4784 ],
4785 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
4786 # You can only specify this field for network interfaces in VPC networks.
4787 { # An alias IP range attached to an instance&#x27;s network interface.
4788 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
4789 # must belong to the specified subnetwork and cannot contain IP addresses
4790 # reserved by system or used by other network interfaces. This range may be
4791 # 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).
4792 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
4793 # alias range. If not specified, the primary range of the subnetwork is used.
4794 },
4795 ],
4796 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
4797 # You can only specify this field for network interfaces in VPC networks.
4798 { # An alias IP range attached to an instance&#x27;s network interface.
4799 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
4800 # must belong to the specified subnetwork and cannot contain IP addresses
4801 # reserved by system or used by other network interfaces. This range may be
4802 # 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).
4803 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
4804 # alias range. If not specified, the primary range of the subnetwork is used.
4805 },
4806 ],
4807 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
4808 # with network_attachment.
4809 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
4810 # This field will be ignored when inserting an Instance or
4811 # adding a NetworkInterface. An up-to-date
4812 # 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.
4813 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
4814 # or not. If enabled, also indicates the version of IGMP supported.
4815 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
4816 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
4817 # one IPv6 access config, DIRECT_IPV6, is supported. If there
4818 # is no ipv6AccessConfig specified, then this instance will
4819 # have no external IPv6 Internet access.
4820 { # An access configuration attached to an instance&#x27;s network interface.
4821 # Only one access config per instance is supported.
4822 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
4823 # The first IPv6 address of the external IPv6 range associated
4824 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
4825 # use a static external IP address, it must be unused and in the same region
4826 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
4827 # assign an external IPv6 address from the instance&#x27;s subnetwork.
4828 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
4829 # external IPv6 range.
4830 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
4831 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
4832 # (IPv4), the default and recommended name is External NAT, but
4833 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
4834 # recommend name is External IPv6.
4835 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
4836 # address associated with this instance. Specify an unused static
4837 # external IP address available to the project or leave this field undefined
4838 # to use an IP from a shared ephemeral IP address pool. If you specify a
4839 # static external IP address, it must live in the same region as the zone of
4840 # the instance.
4841 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
4842 # configuration and can only take the following values: PREMIUM,STANDARD.
4843 #
4844 # If an AccessConfig is specified without a valid external IP address, an
4845 # ephemeral IP will be created with this networkTier.
4846 #
4847 # If an AccessConfig with a valid external IP address is specified, it must
4848 # match that of the networkTier associated with the Address resource owning
4849 # that IP.
4850 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
4851 #
4852 # 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
4853 # first IP in associated external IPv6 range.
4854 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
4855 # config.
4856 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
4857 # external IP address of the instance to a DNS domain name.
4858 #
4859 # This field is not used in ipv6AccessConfig. A default PTR
4860 # record will be created if the VM has external IPv6 range associated.
4861 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
4862 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
4863 },
4864 ],
4865 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
4866 # accessed from the Internet. This field is always inherited from its
4867 # subnetwork.
4868 #
4869 # Valid only if stackType is IPV4_IPV6.
4870 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
4871 # use a static internal IP address, it must be unused and in the same region
4872 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
4873 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
4874 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
4875 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
4876 # server. For a VM, the network interface uses the nicN naming
4877 # format. Where N is a value between 0 and7. The default interface value is nic0.
4878 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
4879 # instance, if neither the network nor the subnetwork is specified, the
4880 # default network global/networks/default is used. If the
4881 # selected project doesn&#x27;t have the default network, you must specify a
4882 # network or subnet. If the network is not specified but the subnetwork is
4883 # specified, the network is inferred.
4884 #
4885 # If you specify this property, you can specify the network as
4886 # a full or partial URL. For example, the following are all valid URLs:
4887 #
4888 #
4889 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
4890 # - projects/project/global/networks/network
4891 # - global/networks/default
4892 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
4893 # to in the following format:
4894 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
4895 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
4896 # interface. If not specified by the user, an unused internal IP is
4897 # assigned by the system.
4898 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
4899 # VirtioNet.
4900 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
4901 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
4902 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
4903 # if not specified by the users.
4904 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
4905 # interface. Can only be used with network_attachment. It is not possible to
4906 # use on its own however, network_attachment can be used without
4907 # service_class_id.
4908 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
4909 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
4910 #
4911 # This field can be both set at instance creation and update network
4912 # interface operations.
4913 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
4914 # resource is inlegacy
4915 # mode, do not specify this field. If the network is in auto subnet
4916 # mode, specifying the subnetwork is optional. If the network is in custom
4917 # subnet mode, specifying the subnetwork is required. If you specify this
4918 # field, you can specify the subnetwork as a full or partial URL. For
4919 # example, the following are all valid URLs:
4920 #
4921 #
4922 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
4923 # - regions/region/subnetworks/subnetwork
4924 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
4925 # from 2 to 255 inclusively.
4926 },
4927 ],
4928 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
4929 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
4930 },
4931 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
4932 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
4933 # Note that for MachineImage, this is not supported yet.
4934 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
4935 # Note that for MachineImage, this is not supported yet.
4936 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
4937 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
4938 # Consuming reserved instances for examples.
4939 &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
4940 # the name of your reservation as its value.
4941 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
4942 # either a name to a reservation in the same project or
4943 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
4944 # shared reservation in the same zone but in a different project.
4945 &quot;A String&quot;,
4946 ],
4947 },
4948 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
4949 # have the same definition as resource
4950 # manager tags. Keys and values can be either in numeric format,
4951 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4952 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4953 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
4954 # PATCH) when empty.
4955 &quot;a_key&quot;: &quot;A String&quot;,
4956 },
4957 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
4958 # these properties.
4959 # Note that for MachineImage, this is not supported yet.
4960 &quot;A String&quot;,
4961 ],
4962 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
4963 # these properties.
4964 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
4965 # terminated by Compute Engine (not terminated by a user). You can only set
4966 # the automatic restart option for standard instances.Preemptible instances
4967 # cannot be automatically restarted.
4968 #
4969 # By default, this is set to true so an instance is
4970 # automatically restarted if it is terminated by Compute Engine.
4971 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
4972 # must be a number between 1 and the number of availability domains
4973 # specified in the spread placement policy attached to the instance.
4974 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
4975 # within the range of [90, 330] with the increment of 30, if unset, the
4976 # default behavior of host error recovery will be used.
4977 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
4978 &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
4979 # recovery of the Local Ssd state is attempted. Its value should be in
4980 # between 0 and 168 hours with hour granularity and the default value being 1
4981 # hour.
4982 # as a count of seconds and fractions of seconds at nanosecond
4983 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4984 # or &quot;month&quot;. Range is approximately 10,000 years.
4985 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4986 # Durations less than one second are represented with a 0
4987 # `seconds` field and a positive `nanos` field. Must be from 0
4988 # to 999,999,999 inclusive.
4989 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4990 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4991 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4992 },
4993 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
4994 # resources.
4995 # This field is for use by internal tools that use the public API.
4996 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
4997 # the instance termination action will be performed at the end of the run
4998 # duration.
4999 # as a count of seconds and fractions of seconds at nanosecond
5000 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5001 # or &quot;month&quot;. Range is approximately 10,000 years.
5002 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5003 # Durations less than one second are represented with a 0
5004 # `seconds` field and a positive `nanos` field. Must be from 0
5005 # to 999,999,999 inclusive.
5006 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5007 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5008 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5009 },
5010 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
5011 # on a sole-tenant node.
5012 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
5013 # affinity for more information.
5014 # Overrides reservationAffinity.
5015 { # Node Affinity: the configuration of desired nodes onto which this Instance
5016 # could be scheduled.
5017 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
5018 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
5019 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
5020 &quot;A String&quot;,
5021 ],
5022 },
5023 ],
5024 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
5025 # the default behavior is MIGRATE. Forpreemptible instances,
5026 # the default and only possible behavior is TERMINATE. For more
5027 # information, see
5028 # Set
5029 # VM host maintenance policy.
5030 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
5031 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
5032 # else, the Local SSD data will be preserved when the instance is stopped
5033 # at the end of the run duration/termination time.
5034 },
5035 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
5036 # instance creation or while the instance isstopped and
5037 # therefore, in a `TERMINATED` state. SeeInstance Life
5038 # Cycle for more information on the possible instance states.
5039 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
5040 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
5041 # Off and ACPI G3 Mechanical
5042 # Off for Standard VMs and 30 seconds for Spot VMs.
5043 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
5044 # termination action will be performed at the termination time.
5045 },
5046 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
5047 # service accounts are available to the instances that are created from
5048 # these properties. Use metadata queries to obtain the access tokens for
5049 # these instances.
5050 { # A service account.
5051 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
5052 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
5053 &quot;A String&quot;,
5054 ],
5055 },
5056 ],
5057 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
5058 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
5059 # default.
5060 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
5061 # default.
5062 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
5063 # default.
5064 },
5065 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
5066 # properties. The tags identify valid sources or targets for network
5067 # firewalls. The setTags method can modify this list of tags. Each tag within
5068 # the list must comply with RFC1035.
5069 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
5070 # the tags&#x27; contents and used for optimistic locking. The
5071 # fingerprint is initially generated by Compute Engine and changes after
5072 # every request to modify or update tags. You must always provide an
5073 # up-to-date fingerprint hash in order to update or change tags.
5074 #
5075 # To see the latest fingerprint, make get() request to the
5076 # instance.
5077 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
5078 # with RFC1035.
5079 &quot;A String&quot;,
5080 ],
5081 },
5082 &quot;workloadIdentityConfig&quot;: {
5083 &quot;identity&quot;: &quot;A String&quot;,
5084 &quot;identityCertificateEnabled&quot;: True or False,
5085 },
5086 },
5087 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the instance template resides. Only
5088 # applicable for regional resources.
5089 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this instance template. The server defines this
5090 # URL.
5091 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the template. You can provide this as a
5092 # partial or full URL to the resource. For example, the following are valid
5093 # values:
5094 #
5095 #
5096 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
5097 # - projects/project/zones/zone/instances/instance
5098 &quot;sourceInstanceParams&quot;: { # A specification of the parameters to use when creating the instance template # The source instance params to use to create this instance template.
5099 # from a source instance.
5100 &quot;diskConfigs&quot;: [ # Attached disks configuration. If not provided, defaults are applied:
5101 # For boot disk and any other R/W disks, the source images for each disk
5102 # will be used. For read-only disks, they will be attached in read-only
5103 # mode. Local SSD disks will be created as blank volumes.
5104 { # A specification of the desired way to instantiate a disk in the instance
5105 # template when its created from a source instance.
5106 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
5107 # deleted (but not when the disk is detached from the instance).
5108 &quot;customImage&quot;: &quot;A String&quot;, # The custom source image to be used to restore this disk when instantiating
5109 # this instance template.
5110 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the device name of the disk to which the configurations apply to.
5111 &quot;instantiateFrom&quot;: &quot;A String&quot;, # Specifies whether to include the disk and what image to use. Possible
5112 # values are:
5113 #
5114 #
5115 # - source-image: to use the same image that was used to
5116 # create the source instance&#x27;s corresponding disk. Applicable to the boot
5117 # disk and additional read-write disks.
5118 # - source-image-family: to use the same image family that
5119 # was used to create the source instance&#x27;s corresponding disk. Applicable
5120 # to the boot disk and additional read-write disks.
5121 # - custom-image: to use a user-provided image url for disk
5122 # creation. Applicable to the boot disk and additional read-write
5123 # disks.
5124 # - attach-read-only: to attach a read-only
5125 # disk. Applicable to read-only disks.
5126 # - do-not-include: to exclude a disk from the template.
5127 # Applicable to additional read-write disks, local SSDs, and read-only
5128 # disks.
5129 },
5130 ],
5131 },
5132 },
5133 ],
5134 &quot;kind&quot;: &quot;compute#instanceTemplateList&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template
5135 # lists.
5136 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
5137 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
5138 # the query parameter pageToken in the next list request.
5139 # Subsequent list requests will have their own nextPageToken to
5140 # continue paging through the results.
5141 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
5142 &quot;warning&quot;: { # [Output Only] Informational warning message.
5143 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
5144 # Engine returns NO_RESULTS_ON_PAGE if there
5145 # are no results in the response.
5146 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
5147 # value format. For example:
5148 #
5149 # &quot;data&quot;: [
5150 # {
5151 # &quot;key&quot;: &quot;scope&quot;,
5152 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
5153 # }
5154 {
5155 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
5156 # returned. For example, for warnings where there are no results in a list
5157 # request for a particular zone, this key might be scope and
5158 # the key value might be the zone name. Other examples might be a key
5159 # indicating a deprecated resource and a suggested replacement, or a
5160 # warning about invalid network settings (for example, if an instance
5161 # attempts to perform IP forwarding but is not enabled for IP forwarding).
5162 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
5163 },
5164 ],
5165 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
5166 },
5167 }</pre>
5168 </div>
5169
5170 <div class="method">
5171 <code class="details" id="list_next">list_next()</code>
5172 <pre>Retrieves the next page of results.
5173
5174 Args:
5175 previous_request: The request for the previous page. (required)
5176 previous_response: The response from the request for the previous page. (required)
5177
5178 Returns:
5179 A request object that you can call &#x27;execute()&#x27; on to request the next
5180 page. Returns None if there are no more items in the collection.
5181 </pre>
5182 </div>
5183
5184 <div class="method">
5185 <code class="details" id="setIamPolicy">setIamPolicy(project, resource, body=None, x__xgafv=None)</code>
5186 <pre>Sets the access control policy on the specified resource.
5187 Replaces any existing policy.
5188
5189 Args:
5190 project: string, Project ID for this request. (required)
5191 resource: string, Name or id of the resource for this request. (required)
5192 body: object, The request body.
5193 The object takes the form of:
5194
5195 {
5196 &quot;bindings&quot;: [ # Flatten Policy to create a backward compatible wire-format.
5197 # Deprecated. Use &#x27;policy&#x27; to specify bindings.
5198 { # Associates `members`, or principals, with a `role`.
5199 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
5200 #
5201 # If the condition evaluates to `true`, then this binding applies to the
5202 # current request.
5203 #
5204 # If the condition evaluates to `false`, then this binding does not apply to
5205 # the current request. However, a different role binding might grant the same
5206 # role to one or more of the principals in this binding.
5207 #
5208 # To learn which resources support conditions in their IAM policies, see the
5209 # [IAM
5210 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5211 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
5212 # are documented at https://github.com/google/cel-spec.
5213 #
5214 # Example (Comparison):
5215 #
5216 # title: &quot;Summary size limit&quot;
5217 # description: &quot;Determines if a summary is less than 100 chars&quot;
5218 # expression: &quot;document.summary.size() &lt; 100&quot;
5219 #
5220 # Example (Equality):
5221 #
5222 # title: &quot;Requestor is owner&quot;
5223 # description: &quot;Determines if requestor is the document owner&quot;
5224 # expression: &quot;document.owner == request.auth.claims.email&quot;
5225 #
5226 # Example (Logic):
5227 #
5228 # title: &quot;Public documents&quot;
5229 # description: &quot;Determine whether the document should be publicly visible&quot;
5230 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
5231 #
5232 # Example (Data Manipulation):
5233 #
5234 # title: &quot;Notification string&quot;
5235 # description: &quot;Create a notification string with a timestamp.&quot;
5236 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
5237 #
5238 # The exact variables and functions that may be referenced within an expression
5239 # are determined by the service that evaluates it. See the service
5240 # documentation for additional information.
5241 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
5242 # describes the expression, e.g. when hovered over it in a UI.
5243 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
5244 # syntax.
5245 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
5246 # reporting, e.g. a file name and a position in the file.
5247 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
5248 # its purpose. This can be used e.g. in UIs which allow to enter the
5249 # expression.
5250 },
5251 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
5252 # `members` can have the following values:
5253 #
5254 # * `allUsers`: A special identifier that represents anyone who is
5255 # on the internet; with or without a Google account.
5256 #
5257 # * `allAuthenticatedUsers`: A special identifier that represents anyone
5258 # who is authenticated with a Google account or a service account.
5259 # Does not include identities that come from external identity providers
5260 # (IdPs) through identity federation.
5261 #
5262 # * `user:{emailid}`: An email address that represents a specific Google
5263 # account. For example, `[email protected]` .
5264 #
5265 #
5266 # * `serviceAccount:{emailid}`: An email address that represents a Google
5267 # service account. For example,
5268 # `[email protected]`.
5269 #
5270 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
5271 # identifier for a
5272 # [Kubernetes service
5273 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
5274 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
5275 #
5276 # * `group:{emailid}`: An email address that represents a Google group.
5277 # For example, `[email protected]`.
5278 #
5279 #
5280 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
5281 # users of that domain. For example, `google.com` or `example.com`.
5282 #
5283 #
5284 #
5285 #
5286 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5287 # A single identity in a workforce identity pool.
5288 #
5289 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
5290 # All workforce identities in a group.
5291 #
5292 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5293 # All workforce identities with a specific attribute value.
5294 #
5295 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
5296 # All identities in a workforce identity pool.
5297 #
5298 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
5299 # A single identity in a workload identity pool.
5300 #
5301 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
5302 # A workload identity pool group.
5303 #
5304 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5305 # All identities in a workload identity pool with a certain attribute.
5306 #
5307 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
5308 # All identities in a workload identity pool.
5309 #
5310 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
5311 # identifier) representing a user that has been recently deleted. For
5312 # example, `[email protected]?uid=123456789012345678901`. If the user is
5313 # recovered, this value reverts to `user:{emailid}` and the recovered user
5314 # retains the role in the binding.
5315 #
5316 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
5317 # unique identifier) representing a service account that has been recently
5318 # deleted. For example,
5319 # `[email protected]?uid=123456789012345678901`.
5320 # If the service account is undeleted, this value reverts to
5321 # `serviceAccount:{emailid}` and the undeleted service account retains the
5322 # role in the binding.
5323 #
5324 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
5325 # identifier) representing a Google group that has been recently
5326 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
5327 # the group is recovered, this value reverts to `group:{emailid}` and the
5328 # recovered group retains the role in the binding.
5329 #
5330 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5331 # Deleted single identity in a workforce identity pool. For example,
5332 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
5333 &quot;A String&quot;,
5334 ],
5335 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
5336 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
5337 #
5338 # For an overview of the IAM roles and permissions, see the
5339 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
5340 # a list of the available pre-defined roles, see
5341 # [here](https://cloud.google.com/iam/docs/understanding-roles).
5342 },
5343 ],
5344 &quot;etag&quot;: &quot;A String&quot;, # Flatten Policy to create a backward compatible wire-format.
5345 # Deprecated. Use &#x27;policy&#x27; to specify the etag.
5346 &quot;policy&quot;: { # An Identity and Access Management (IAM) policy, which specifies access # REQUIRED: The complete policy to be applied to the &#x27;resource&#x27;. The size of
5347 # the policy is limited to a few 10s of KB. An empty policy is in general a
5348 # valid policy but certain services (like Projects) might reject them.
5349 # controls for Google Cloud resources.
5350 #
5351 #
5352 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
5353 # `members`, or principals, to a single `role`. Principals can be user
5354 # accounts, service accounts, Google groups, and domains (such as G Suite). A
5355 # `role` is a named list of permissions; each `role` can be an IAM predefined
5356 # role or a user-created custom role.
5357 #
5358 # For some types of Google Cloud resources, a `binding` can also specify a
5359 # `condition`, which is a logical expression that allows access to a resource
5360 # only if the expression evaluates to `true`. A condition can add constraints
5361 # based on attributes of the request, the resource, or both. To learn which
5362 # resources support conditions in their IAM policies, see the
5363 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5364 #
5365 # **JSON example:**
5366 #
5367 # ```
5368 # {
5369 # &quot;bindings&quot;: [
5370 # {
5371 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
5372 # &quot;members&quot;: [
5373 # &quot;user:[email protected]&quot;,
5374 # &quot;group:[email protected]&quot;,
5375 # &quot;domain:google.com&quot;,
5376 # &quot;serviceAccount:[email protected]&quot;
5377 # ]
5378 # },
5379 # {
5380 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
5381 # &quot;members&quot;: [
5382 # &quot;user:[email protected]&quot;
5383 # ],
5384 # &quot;condition&quot;: {
5385 # &quot;title&quot;: &quot;expirable access&quot;,
5386 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
5387 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
5388 # }
5389 # }
5390 # ],
5391 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
5392 # &quot;version&quot;: 3
5393 # }
5394 # ```
5395 #
5396 # **YAML example:**
5397 #
5398 # ```
5399 # bindings:
5400 # - members:
5401 # - user:[email protected]
5402 # - group:[email protected]
5403 # - domain:google.com
5404 # - serviceAccount:[email protected]
5405 # role: roles/resourcemanager.organizationAdmin
5406 # - members:
5407 # - user:[email protected]
5408 # role: roles/resourcemanager.organizationViewer
5409 # condition:
5410 # title: expirable access
5411 # description: Does not grant access after Sep 2020
5412 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
5413 # etag: BwWWja0YfJA=
5414 # version: 3
5415 # ```
5416 #
5417 # For a description of IAM and its features, see the
5418 # [IAM documentation](https://cloud.google.com/iam/docs/).
5419 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
5420 { # Specifies the audit configuration for a service.
5421 # The configuration determines which permission types are logged, and what
5422 # identities, if any, are exempted from logging.
5423 # An AuditConfig must have one or more AuditLogConfigs.
5424 #
5425 # If there are AuditConfigs for both `allServices` and a specific service,
5426 # the union of the two AuditConfigs is used for that service: the log_types
5427 # specified in each AuditConfig are enabled, and the exempted_members in each
5428 # AuditLogConfig are exempted.
5429 #
5430 # Example Policy with multiple AuditConfigs:
5431 #
5432 # {
5433 # &quot;audit_configs&quot;: [
5434 # {
5435 # &quot;service&quot;: &quot;allServices&quot;,
5436 # &quot;audit_log_configs&quot;: [
5437 # {
5438 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5439 # &quot;exempted_members&quot;: [
5440 # &quot;user:[email protected]&quot;
5441 # ]
5442 # },
5443 # {
5444 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5445 # },
5446 # {
5447 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
5448 # }
5449 # ]
5450 # },
5451 # {
5452 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
5453 # &quot;audit_log_configs&quot;: [
5454 # {
5455 # &quot;log_type&quot;: &quot;DATA_READ&quot;
5456 # },
5457 # {
5458 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
5459 # &quot;exempted_members&quot;: [
5460 # &quot;user:[email protected]&quot;
5461 # ]
5462 # }
5463 # ]
5464 # }
5465 # ]
5466 # }
5467 #
5468 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
5469 # logging. It also exempts `[email protected]` from DATA_READ logging, and
5470 # `[email protected]` from DATA_WRITE logging.
5471 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
5472 { # Provides the configuration for logging a type of permissions.
5473 # Example:
5474 #
5475 # {
5476 # &quot;audit_log_configs&quot;: [
5477 # {
5478 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5479 # &quot;exempted_members&quot;: [
5480 # &quot;user:[email protected]&quot;
5481 # ]
5482 # },
5483 # {
5484 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5485 # }
5486 # ]
5487 # }
5488 #
5489 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
5490 # [email protected] from DATA_READ logging.
5491 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
5492 # permission.
5493 # Follows the same format of Binding.members.
5494 &quot;A String&quot;,
5495 ],
5496 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
5497 },
5498 ],
5499 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
5500 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
5501 # `allServices` is a special value that covers all services.
5502 },
5503 ],
5504 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
5505 # may specify a `condition` that determines how and when the `bindings` are
5506 # applied. Each of the `bindings` must contain at least one principal.
5507 #
5508 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
5509 # of these principals can be Google groups. Each occurrence of a principal
5510 # counts towards these limits. For example, if the `bindings` grant 50
5511 # different roles to `user:[email protected]`, and not to any other
5512 # principal, then you can add another 1,450 principals to the `bindings` in
5513 # the `Policy`.
5514 { # Associates `members`, or principals, with a `role`.
5515 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
5516 #
5517 # If the condition evaluates to `true`, then this binding applies to the
5518 # current request.
5519 #
5520 # If the condition evaluates to `false`, then this binding does not apply to
5521 # the current request. However, a different role binding might grant the same
5522 # role to one or more of the principals in this binding.
5523 #
5524 # To learn which resources support conditions in their IAM policies, see the
5525 # [IAM
5526 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5527 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
5528 # are documented at https://github.com/google/cel-spec.
5529 #
5530 # Example (Comparison):
5531 #
5532 # title: &quot;Summary size limit&quot;
5533 # description: &quot;Determines if a summary is less than 100 chars&quot;
5534 # expression: &quot;document.summary.size() &lt; 100&quot;
5535 #
5536 # Example (Equality):
5537 #
5538 # title: &quot;Requestor is owner&quot;
5539 # description: &quot;Determines if requestor is the document owner&quot;
5540 # expression: &quot;document.owner == request.auth.claims.email&quot;
5541 #
5542 # Example (Logic):
5543 #
5544 # title: &quot;Public documents&quot;
5545 # description: &quot;Determine whether the document should be publicly visible&quot;
5546 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
5547 #
5548 # Example (Data Manipulation):
5549 #
5550 # title: &quot;Notification string&quot;
5551 # description: &quot;Create a notification string with a timestamp.&quot;
5552 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
5553 #
5554 # The exact variables and functions that may be referenced within an expression
5555 # are determined by the service that evaluates it. See the service
5556 # documentation for additional information.
5557 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
5558 # describes the expression, e.g. when hovered over it in a UI.
5559 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
5560 # syntax.
5561 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
5562 # reporting, e.g. a file name and a position in the file.
5563 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
5564 # its purpose. This can be used e.g. in UIs which allow to enter the
5565 # expression.
5566 },
5567 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
5568 # `members` can have the following values:
5569 #
5570 # * `allUsers`: A special identifier that represents anyone who is
5571 # on the internet; with or without a Google account.
5572 #
5573 # * `allAuthenticatedUsers`: A special identifier that represents anyone
5574 # who is authenticated with a Google account or a service account.
5575 # Does not include identities that come from external identity providers
5576 # (IdPs) through identity federation.
5577 #
5578 # * `user:{emailid}`: An email address that represents a specific Google
5579 # account. For example, `[email protected]` .
5580 #
5581 #
5582 # * `serviceAccount:{emailid}`: An email address that represents a Google
5583 # service account. For example,
5584 # `[email protected]`.
5585 #
5586 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
5587 # identifier for a
5588 # [Kubernetes service
5589 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
5590 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
5591 #
5592 # * `group:{emailid}`: An email address that represents a Google group.
5593 # For example, `[email protected]`.
5594 #
5595 #
5596 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
5597 # users of that domain. For example, `google.com` or `example.com`.
5598 #
5599 #
5600 #
5601 #
5602 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5603 # A single identity in a workforce identity pool.
5604 #
5605 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
5606 # All workforce identities in a group.
5607 #
5608 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5609 # All workforce identities with a specific attribute value.
5610 #
5611 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
5612 # All identities in a workforce identity pool.
5613 #
5614 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
5615 # A single identity in a workload identity pool.
5616 #
5617 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
5618 # A workload identity pool group.
5619 #
5620 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5621 # All identities in a workload identity pool with a certain attribute.
5622 #
5623 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
5624 # All identities in a workload identity pool.
5625 #
5626 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
5627 # identifier) representing a user that has been recently deleted. For
5628 # example, `[email protected]?uid=123456789012345678901`. If the user is
5629 # recovered, this value reverts to `user:{emailid}` and the recovered user
5630 # retains the role in the binding.
5631 #
5632 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
5633 # unique identifier) representing a service account that has been recently
5634 # deleted. For example,
5635 # `[email protected]?uid=123456789012345678901`.
5636 # If the service account is undeleted, this value reverts to
5637 # `serviceAccount:{emailid}` and the undeleted service account retains the
5638 # role in the binding.
5639 #
5640 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
5641 # identifier) representing a Google group that has been recently
5642 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
5643 # the group is recovered, this value reverts to `group:{emailid}` and the
5644 # recovered group retains the role in the binding.
5645 #
5646 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5647 # Deleted single identity in a workforce identity pool. For example,
5648 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
5649 &quot;A String&quot;,
5650 ],
5651 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
5652 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
5653 #
5654 # For an overview of the IAM roles and permissions, see the
5655 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
5656 # a list of the available pre-defined roles, see
5657 # [here](https://cloud.google.com/iam/docs/understanding-roles).
5658 },
5659 ],
5660 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
5661 # prevent simultaneous updates of a policy from overwriting each other.
5662 # It is strongly suggested that systems make use of the `etag` in the
5663 # read-modify-write cycle to perform policy updates in order to avoid race
5664 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
5665 # systems are expected to put that etag in the request to `setIamPolicy` to
5666 # ensure that their change will be applied to the same version of the policy.
5667 #
5668 # **Important:** If you use IAM Conditions, you must include the `etag` field
5669 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5670 # you to overwrite a version `3` policy with a version `1` policy, and all of
5671 # the conditions in the version `3` policy are lost.
5672 &quot;version&quot;: 42, # Specifies the format of the policy.
5673 #
5674 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
5675 # are rejected.
5676 #
5677 # Any operation that affects conditional role bindings must specify version
5678 # `3`. This requirement applies to the following operations:
5679 #
5680 # * Getting a policy that includes a conditional role binding
5681 # * Adding a conditional role binding to a policy
5682 # * Changing a conditional role binding in a policy
5683 # * Removing any role binding, with or without a condition, from a policy
5684 # that includes conditions
5685 #
5686 # **Important:** If you use IAM Conditions, you must include the `etag` field
5687 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
5688 # you to overwrite a version `3` policy with a version `1` policy, and all of
5689 # the conditions in the version `3` policy are lost.
5690 #
5691 # If a policy does not include any conditions, operations on that policy may
5692 # specify any valid version or leave the field unset.
5693 #
5694 # To learn which resources support conditions in their IAM policies, see the
5695 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5696 },
5697 }
5698
5699 x__xgafv: string, V1 error format.
5700 Allowed values
5701 1 - v1 error format
5702 2 - v2 error format
5703
5704 Returns:
5705 An object of the form:
5706
5707 { # An Identity and Access Management (IAM) policy, which specifies access
5708 # controls for Google Cloud resources.
5709 #
5710 #
5711 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
5712 # `members`, or principals, to a single `role`. Principals can be user
5713 # accounts, service accounts, Google groups, and domains (such as G Suite). A
5714 # `role` is a named list of permissions; each `role` can be an IAM predefined
5715 # role or a user-created custom role.
5716 #
5717 # For some types of Google Cloud resources, a `binding` can also specify a
5718 # `condition`, which is a logical expression that allows access to a resource
5719 # only if the expression evaluates to `true`. A condition can add constraints
5720 # based on attributes of the request, the resource, or both. To learn which
5721 # resources support conditions in their IAM policies, see the
5722 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5723 #
5724 # **JSON example:**
5725 #
5726 # ```
5727 # {
5728 # &quot;bindings&quot;: [
5729 # {
5730 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
5731 # &quot;members&quot;: [
5732 # &quot;user:[email protected]&quot;,
5733 # &quot;group:[email protected]&quot;,
5734 # &quot;domain:google.com&quot;,
5735 # &quot;serviceAccount:[email protected]&quot;
5736 # ]
5737 # },
5738 # {
5739 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
5740 # &quot;members&quot;: [
5741 # &quot;user:[email protected]&quot;
5742 # ],
5743 # &quot;condition&quot;: {
5744 # &quot;title&quot;: &quot;expirable access&quot;,
5745 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
5746 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
5747 # }
5748 # }
5749 # ],
5750 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
5751 # &quot;version&quot;: 3
5752 # }
5753 # ```
5754 #
5755 # **YAML example:**
5756 #
5757 # ```
5758 # bindings:
5759 # - members:
5760 # - user:[email protected]
5761 # - group:[email protected]
5762 # - domain:google.com
5763 # - serviceAccount:[email protected]
5764 # role: roles/resourcemanager.organizationAdmin
5765 # - members:
5766 # - user:[email protected]
5767 # role: roles/resourcemanager.organizationViewer
5768 # condition:
5769 # title: expirable access
5770 # description: Does not grant access after Sep 2020
5771 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
5772 # etag: BwWWja0YfJA=
5773 # version: 3
5774 # ```
5775 #
5776 # For a description of IAM and its features, see the
5777 # [IAM documentation](https://cloud.google.com/iam/docs/).
5778 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
5779 { # Specifies the audit configuration for a service.
5780 # The configuration determines which permission types are logged, and what
5781 # identities, if any, are exempted from logging.
5782 # An AuditConfig must have one or more AuditLogConfigs.
5783 #
5784 # If there are AuditConfigs for both `allServices` and a specific service,
5785 # the union of the two AuditConfigs is used for that service: the log_types
5786 # specified in each AuditConfig are enabled, and the exempted_members in each
5787 # AuditLogConfig are exempted.
5788 #
5789 # Example Policy with multiple AuditConfigs:
5790 #
5791 # {
5792 # &quot;audit_configs&quot;: [
5793 # {
5794 # &quot;service&quot;: &quot;allServices&quot;,
5795 # &quot;audit_log_configs&quot;: [
5796 # {
5797 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5798 # &quot;exempted_members&quot;: [
5799 # &quot;user:[email protected]&quot;
5800 # ]
5801 # },
5802 # {
5803 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5804 # },
5805 # {
5806 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
5807 # }
5808 # ]
5809 # },
5810 # {
5811 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
5812 # &quot;audit_log_configs&quot;: [
5813 # {
5814 # &quot;log_type&quot;: &quot;DATA_READ&quot;
5815 # },
5816 # {
5817 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
5818 # &quot;exempted_members&quot;: [
5819 # &quot;user:[email protected]&quot;
5820 # ]
5821 # }
5822 # ]
5823 # }
5824 # ]
5825 # }
5826 #
5827 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
5828 # logging. It also exempts `[email protected]` from DATA_READ logging, and
5829 # `[email protected]` from DATA_WRITE logging.
5830 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
5831 { # Provides the configuration for logging a type of permissions.
5832 # Example:
5833 #
5834 # {
5835 # &quot;audit_log_configs&quot;: [
5836 # {
5837 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
5838 # &quot;exempted_members&quot;: [
5839 # &quot;user:[email protected]&quot;
5840 # ]
5841 # },
5842 # {
5843 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
5844 # }
5845 # ]
5846 # }
5847 #
5848 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
5849 # [email protected] from DATA_READ logging.
5850 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
5851 # permission.
5852 # Follows the same format of Binding.members.
5853 &quot;A String&quot;,
5854 ],
5855 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
5856 },
5857 ],
5858 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
5859 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
5860 # `allServices` is a special value that covers all services.
5861 },
5862 ],
5863 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
5864 # may specify a `condition` that determines how and when the `bindings` are
5865 # applied. Each of the `bindings` must contain at least one principal.
5866 #
5867 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
5868 # of these principals can be Google groups. Each occurrence of a principal
5869 # counts towards these limits. For example, if the `bindings` grant 50
5870 # different roles to `user:[email protected]`, and not to any other
5871 # principal, then you can add another 1,450 principals to the `bindings` in
5872 # the `Policy`.
5873 { # Associates `members`, or principals, with a `role`.
5874 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
5875 #
5876 # If the condition evaluates to `true`, then this binding applies to the
5877 # current request.
5878 #
5879 # If the condition evaluates to `false`, then this binding does not apply to
5880 # the current request. However, a different role binding might grant the same
5881 # role to one or more of the principals in this binding.
5882 #
5883 # To learn which resources support conditions in their IAM policies, see the
5884 # [IAM
5885 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
5886 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
5887 # are documented at https://github.com/google/cel-spec.
5888 #
5889 # Example (Comparison):
5890 #
5891 # title: &quot;Summary size limit&quot;
5892 # description: &quot;Determines if a summary is less than 100 chars&quot;
5893 # expression: &quot;document.summary.size() &lt; 100&quot;
5894 #
5895 # Example (Equality):
5896 #
5897 # title: &quot;Requestor is owner&quot;
5898 # description: &quot;Determines if requestor is the document owner&quot;
5899 # expression: &quot;document.owner == request.auth.claims.email&quot;
5900 #
5901 # Example (Logic):
5902 #
5903 # title: &quot;Public documents&quot;
5904 # description: &quot;Determine whether the document should be publicly visible&quot;
5905 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
5906 #
5907 # Example (Data Manipulation):
5908 #
5909 # title: &quot;Notification string&quot;
5910 # description: &quot;Create a notification string with a timestamp.&quot;
5911 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
5912 #
5913 # The exact variables and functions that may be referenced within an expression
5914 # are determined by the service that evaluates it. See the service
5915 # documentation for additional information.
5916 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
5917 # describes the expression, e.g. when hovered over it in a UI.
5918 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
5919 # syntax.
5920 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
5921 # reporting, e.g. a file name and a position in the file.
5922 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
5923 # its purpose. This can be used e.g. in UIs which allow to enter the
5924 # expression.
5925 },
5926 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
5927 # `members` can have the following values:
5928 #
5929 # * `allUsers`: A special identifier that represents anyone who is
5930 # on the internet; with or without a Google account.
5931 #
5932 # * `allAuthenticatedUsers`: A special identifier that represents anyone
5933 # who is authenticated with a Google account or a service account.
5934 # Does not include identities that come from external identity providers
5935 # (IdPs) through identity federation.
5936 #
5937 # * `user:{emailid}`: An email address that represents a specific Google
5938 # account. For example, `[email protected]` .
5939 #
5940 #
5941 # * `serviceAccount:{emailid}`: An email address that represents a Google
5942 # service account. For example,
5943 # `[email protected]`.
5944 #
5945 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
5946 # identifier for a
5947 # [Kubernetes service
5948 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
5949 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
5950 #
5951 # * `group:{emailid}`: An email address that represents a Google group.
5952 # For example, `[email protected]`.
5953 #
5954 #
5955 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
5956 # users of that domain. For example, `google.com` or `example.com`.
5957 #
5958 #
5959 #
5960 #
5961 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
5962 # A single identity in a workforce identity pool.
5963 #
5964 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
5965 # All workforce identities in a group.
5966 #
5967 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5968 # All workforce identities with a specific attribute value.
5969 #
5970 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
5971 # All identities in a workforce identity pool.
5972 #
5973 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
5974 # A single identity in a workload identity pool.
5975 #
5976 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
5977 # A workload identity pool group.
5978 #
5979 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
5980 # All identities in a workload identity pool with a certain attribute.
5981 #
5982 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
5983 # All identities in a workload identity pool.
5984 #
5985 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
5986 # identifier) representing a user that has been recently deleted. For
5987 # example, `[email protected]?uid=123456789012345678901`. If the user is
5988 # recovered, this value reverts to `user:{emailid}` and the recovered user
5989 # retains the role in the binding.
5990 #
5991 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
5992 # unique identifier) representing a service account that has been recently
5993 # deleted. For example,
5994 # `[email protected]?uid=123456789012345678901`.
5995 # If the service account is undeleted, this value reverts to
5996 # `serviceAccount:{emailid}` and the undeleted service account retains the
5997 # role in the binding.
5998 #
5999 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
6000 # identifier) representing a Google group that has been recently
6001 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
6002 # the group is recovered, this value reverts to `group:{emailid}` and the
6003 # recovered group retains the role in the binding.
6004 #
6005 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
6006 # Deleted single identity in a workforce identity pool. For example,
6007 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
6008 &quot;A String&quot;,
6009 ],
6010 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
6011 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
6012 #
6013 # For an overview of the IAM roles and permissions, see the
6014 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
6015 # a list of the available pre-defined roles, see
6016 # [here](https://cloud.google.com/iam/docs/understanding-roles).
6017 },
6018 ],
6019 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
6020 # prevent simultaneous updates of a policy from overwriting each other.
6021 # It is strongly suggested that systems make use of the `etag` in the
6022 # read-modify-write cycle to perform policy updates in order to avoid race
6023 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
6024 # systems are expected to put that etag in the request to `setIamPolicy` to
6025 # ensure that their change will be applied to the same version of the policy.
6026 #
6027 # **Important:** If you use IAM Conditions, you must include the `etag` field
6028 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
6029 # you to overwrite a version `3` policy with a version `1` policy, and all of
6030 # the conditions in the version `3` policy are lost.
6031 &quot;version&quot;: 42, # Specifies the format of the policy.
6032 #
6033 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
6034 # are rejected.
6035 #
6036 # Any operation that affects conditional role bindings must specify version
6037 # `3`. This requirement applies to the following operations:
6038 #
6039 # * Getting a policy that includes a conditional role binding
6040 # * Adding a conditional role binding to a policy
6041 # * Changing a conditional role binding in a policy
6042 # * Removing any role binding, with or without a condition, from a policy
6043 # that includes conditions
6044 #
6045 # **Important:** If you use IAM Conditions, you must include the `etag` field
6046 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
6047 # you to overwrite a version `3` policy with a version `1` policy, and all of
6048 # the conditions in the version `3` policy are lost.
6049 #
6050 # If a policy does not include any conditions, operations on that policy may
6051 # specify any valid version or leave the field unset.
6052 #
6053 # To learn which resources support conditions in their IAM policies, see the
6054 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
6055 }</pre>
6056 </div>
6057
6058 <div class="method">
6059 <code class="details" id="testIamPermissions">testIamPermissions(project, resource, body=None, x__xgafv=None)</code>
6060 <pre>Returns permissions that a caller has on the specified resource.
6061
6062 Args:
6063 project: string, Project ID for this request. (required)
6064 resource: string, Name or id of the resource for this request. (required)
6065 body: object, The request body.
6066 The object takes the form of:
6067
6068 {
6069 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
6070 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
6071 &quot;A String&quot;,
6072 ],
6073 }
6074
6075 x__xgafv: string, V1 error format.
6076 Allowed values
6077 1 - v1 error format
6078 2 - v2 error format
6079
6080 Returns:
6081 An object of the form:
6082
6083 {
6084 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
6085 # allowed.
6086 &quot;A String&quot;,
6087 ],
6088 }</pre>
6089 </div>
6090
6091 </body></html>