Debian Codegraph @

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