Debian Codegraph @

docs/dyn/compute_v1.regionInstanceTemplates.html

raw
1 <html><body>
2 <style>
3
4 body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13 }
14
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51 }
52
53 .toc_element {
54 margin-top: 0.5em;
55 }
56
57 .firstline {
58 margin-left: 2 em;
59 }
60
61 .method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66 }
67
68 .details {
69 font-weight: bold;
70 font-size: 14px;
71 }
72
73 </style>
74
75 <h1><a href="compute_v1.html">Compute Engine API</a> . <a href="compute_v1.regionInstanceTemplates.html">regionInstanceTemplates</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#close">close()</a></code></p>
79 <p class="firstline">Close httplib2 connections.</p>
80 <p class="toc_element">
81 <code><a href="#delete">delete(project, region, instanceTemplate, requestId=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Deletes the specified instance template. Deleting an instance template is</p>
83 <p class="toc_element">
84 <code><a href="#get">get(project, region, instanceTemplate, x__xgafv=None)</a></code></p>
85 <p class="firstline">Returns the specified instance template.</p>
86 <p class="toc_element">
87 <code><a href="#insert">insert(project, region, body=None, requestId=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Creates an instance template in the specified project and region using the</p>
89 <p class="toc_element">
90 <code><a href="#list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Retrieves a list of instance templates that are contained within the</p>
92 <p class="toc_element">
93 <code><a href="#list_next">list_next()</a></code></p>
94 <p class="firstline">Retrieves the next page of results.</p>
95 <h3>Method Details</h3>
96 <div class="method">
97 <code class="details" id="close">close()</code>
98 <pre>Close httplib2 connections.</pre>
99 </div>
100
101 <div class="method">
102 <code class="details" id="delete">delete(project, region, instanceTemplate, requestId=None, x__xgafv=None)</code>
103 <pre>Deletes the specified instance template. Deleting an instance template is
104 permanent and cannot be undone.
105
106 Args:
107 project: string, Project ID for this request. (required)
108 region: string, The name of the region for this request. (required)
109 instanceTemplate: string, The name of the instance template to delete. (required)
110 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
111 that if you must retry your request, the server will know to ignore the
112 request if it has already been completed.
113
114 For example, consider a situation where you make an initial request and
115 the request times out. If you make the request again with the same
116 request ID, the server can check if original operation with the same
117 request ID was received, and if so, will ignore the second request. This
118 prevents clients from accidentally creating duplicate commitments.
119
120 The request ID must be
121 a valid UUID with the exception that zero UUID is not supported
122 (00000000-0000-0000-0000-000000000000).
123 x__xgafv: string, V1 error format.
124 Allowed values
125 1 - v1 error format
126 2 - v2 error format
127
128 Returns:
129 An object of the form:
130
131 { # Represents an Operation resource.
132 #
133 # Google Compute Engine has three Operation resources:
134 #
135 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
136 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
137 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
138 #
139 # You can use an operation resource to manage asynchronous API requests.
140 # For more information, readHandling
141 # API responses.
142 #
143 # Operations can be global, regional or zonal.
144 #
145 # - For global operations, use the `globalOperations`
146 # resource.
147 # - For regional operations, use the
148 # `regionOperations` resource.
149 # - For zonal operations, use
150 # the `zoneOperations` resource.
151 #
152 #
153 #
154 # For more information, read
155 # Global, Regional, and Zonal Resources.
156 #
157 # Note that completed Operation resources have a limited
158 # retention period.
159 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
160 # Not present otherwise.
161 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
162 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
163 # set when the operation is created.
164 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
165 # text format.
166 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
167 # this field will be populated.
168 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
169 # operation.
170 {
171 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
172 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
173 # details. There is a set of defined message types to use for providing
174 # details.The syntax depends on the error code. For example,
175 # QuotaExceededInfo will have details when the error code is
176 # QUOTA_EXCEEDED.
177 {
178 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
179 #
180 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
181 # is not enabled:
182 #
183 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
184 # &quot;domain&quot;: &quot;googleapis.com&quot;
185 # &quot;metadata&quot;: {
186 # &quot;resource&quot;: &quot;projects/123&quot;,
187 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
188 # }
189 # }
190 #
191 # This response indicates that the pubsub.googleapis.com API is not enabled.
192 #
193 # Example of an error that is returned when attempting to create a Spanner
194 # instance in a region that is out of stock:
195 #
196 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
197 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
198 # &quot;metadata&quot;: {
199 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
200 # }
201 # }
202 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
203 # is typically the registered service name of the tool or product that
204 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
205 # generated by some common infrastructure, the error domain must be a
206 # globally unique value that identifies the infrastructure. For Google API
207 # infrastructure, the error domain is &quot;googleapis.com&quot;.
208 &quot;metadatas&quot;: { # Additional structured details about this error.
209 #
210 # Keys must match a regular expression of `a-z+` but should
211 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
212 # length. When identifying the current value of an exceeded limit, the units
213 # should be contained in the key, not the value. For example, rather than
214 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
215 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
216 # instances that can be created in a single (batch) request.
217 &quot;a_key&quot;: &quot;A String&quot;,
218 },
219 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
220 # proximate cause of the error. Error reasons are unique within a particular
221 # domain of errors. This should be at most 63 characters and match a
222 # regular expression of `A-Z+[A-Z0-9]`, which represents
223 # UPPER_SNAKE_CASE.
224 },
225 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
226 #
227 # For example, if a quota check failed with an error indicating the calling
228 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
229 # directly to the right place in the developer console to flip the bit.
230 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
231 { # Describes a URL link.
232 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
233 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
234 },
235 ],
236 },
237 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
238 # which can be attached to an RPC error.
239 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
240 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
241 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
242 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
243 },
244 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
245 &quot;dimensions&quot;: { # The map holding related quota dimensions.
246 &quot;a_key&quot;: &quot;A String&quot;,
247 },
248 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
249 # type or metric.
250 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
251 # or metric.
252 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
253 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
254 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
255 },
256 },
257 ],
258 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
259 # This property is optional.
260 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
261 },
262 ],
263 },
264 &quot;getVersionOperationMetadata&quot;: {
265 &quot;inlineSbomInfo&quot;: {
266 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
267 # appropriate identifiers.
268 &quot;a_key&quot;: &quot;A String&quot;,
269 },
270 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
271 # identifiers.
272 &quot;a_key&quot;: &quot;A String&quot;,
273 },
274 },
275 },
276 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
277 # message that was returned, such as `NOT FOUND`.
278 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
279 # status code that was returned. For example, a `404` means the
280 # resource was not found.
281 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
282 # defined by the server.
283 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
284 # This value is inRFC3339
285 # text format.
286 &quot;instancesBulkInsertOperationMetadata&quot;: {
287 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
288 # Example key: zones/us-central1-a
289 &quot;a_key&quot;: {
290 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
291 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
292 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
293 # error.
294 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
295 # if the flow is rolling forward or rolling back.
296 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
297 },
298 },
299 },
300 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
301 # Operation resources.
302 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
303 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
304 # group of operations results from a `bulkInsert` API request.
305 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
306 # `update`, or `delete`, and so on.
307 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
308 # There is no requirement that this be linear or support any granularity of
309 # operations. This should not be used to guess when the operation will be
310 # complete. This number should monotonically increase as the operation
311 # progresses.
312 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
313 # applicable when performing regional operations.
314 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
315 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
316 # this field will contain information on all underlying zonal actions and
317 # their state.
318 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
319 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
320 # Example key: zones/us-central1-a
321 &quot;a_key&quot;: {
322 &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
323 # populated.
324 # different programming environments, including REST APIs and RPC APIs. It is
325 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
326 # three pieces of data: error code, error message, and error details.
327 #
328 # You can find out more about this error model and how to work with it in the
329 # [API Design Guide](https://cloud.google.com/apis/design/errors).
330 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
331 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
332 # message types for APIs to use.
333 {
334 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
335 },
336 ],
337 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
338 # user-facing error message should be localized and sent in the
339 # google.rpc.Status.details field, or localized by the client.
340 },
341 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
342 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
343 },
344 },
345 },
346 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
347 # This value is inRFC3339
348 # text format.
349 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
350 # following:
351 # `PENDING`, `RUNNING`, or `DONE`.
352 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
353 # operation.
354 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
355 # of the target resource.
356 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
357 # operations related to creating a snapshot, this points to the disk
358 # that the snapshot was created from.
359 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
360 # `[email protected]` or
361 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
362 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
363 # operation, this field will be populated.
364 {
365 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
366 # Engine returns NO_RESULTS_ON_PAGE if there
367 # are no results in the response.
368 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
369 # value format. For example:
370 #
371 # &quot;data&quot;: [
372 # {
373 # &quot;key&quot;: &quot;scope&quot;,
374 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
375 # }
376 {
377 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
378 # returned. For example, for warnings where there are no results in a list
379 # request for a particular zone, this key might be scope and
380 # the key value might be the zone name. Other examples might be a key
381 # indicating a deprecated resource and a suggested replacement, or a
382 # warning about invalid network settings (for example, if an instance
383 # attempts to perform IP forwarding but is not enabled for IP forwarding).
384 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
385 },
386 ],
387 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
388 },
389 ],
390 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
391 # applicable when performing per-zone operations.
392 }</pre>
393 </div>
394
395 <div class="method">
396 <code class="details" id="get">get(project, region, instanceTemplate, x__xgafv=None)</code>
397 <pre>Returns the specified instance template.
398
399 Args:
400 project: string, Project ID for this request. (required)
401 region: string, The name of the region for this request. (required)
402 instanceTemplate: string, The name of the instance template. (required)
403 x__xgafv: string, V1 error format.
404 Allowed values
405 1 - v1 error format
406 2 - v2 error format
407
408 Returns:
409 An object of the form:
410
411 { # Represents an Instance Template resource.
412 #
413 # Google Compute Engine has two Instance Template resources:
414 #
415 # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
416 # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
417 #
418 # You can reuse a global instance template in
419 # different regions whereas you can use a regional instance template in a
420 # specified region only. If you want to reduce cross-region dependency or
421 # achieve data residency, use a regional instance template.
422 #
423 # To create VMs, managed instance groups, and reservations, you can use either
424 # global or regional instance templates.
425 #
426 # For more information, readInstance Templates.
427 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
428 # text format.
429 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
430 # create the resource.
431 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this instance template. The server
432 # defines this identifier.
433 &quot;kind&quot;: &quot;compute#instanceTemplate&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
434 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
435 # The name must be 1-63 characters long, and comply withRFC1035.
436 # Specifically, the name must be 1-63 characters long and match the regular
437 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
438 # character must be a lowercase letter, and all following characters must be
439 # a dash, lowercase letter, or digit, except the last character, which cannot
440 # be a dash.
441 &quot;properties&quot;: { # The instance properties for this instance template.
442 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
443 # Note that for MachineImage, this is not supported yet.
444 # Options that would traditionally be configured in a BIOS belong
445 # here. Features that require operating system support may have
446 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
447 # disabled).
448 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
449 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
450 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
451 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
452 # multithreading (SMT) set this to 1. If unset, the maximum number
453 # of threads supported per core by the underlying processor is
454 # assumed.
455 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
456 # Supported modes include:
457 # * ALL_CORE_MAX
458 #
459 # Using empty string or not setting this field will use the platform-specific
460 # default turbo mode.
461 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
462 # the number of threads per core to compute the total number of virtual
463 # CPUs to expose to the instance. If unset, the number of cores is
464 # inferred from the instance&#x27;s nominal CPU count and the underlying
465 # platform&#x27;s SMT width.
466 },
467 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
468 # source IP addresses other than their own and receive packets with
469 # destination IP addresses other than their own. If these instances will be
470 # used as an IP gateway or it will be set as the next-hop in a Route
471 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
472 # documentation for more information.
473 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
474 # Note that for MachineImage, this is not supported yet.
475 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
476 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
477 },
478 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
479 # properties.
480 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
481 # from these properties.
482 { # An instance-attached disk resource.
483 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
484 # or X86_64.
485 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
486 # deleted (but not when the disk is detached from the instance).
487 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
488 # partition of the disk for its root filesystem.
489 &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
490 # running within the instance. This name can be used to reference the device
491 # for mounting, resizing, and so on, from within the instance.
492 #
493 # If not specified, the server chooses a default device name to apply to this
494 # disk, in the form persistent-disk-x, where x is a number
495 # assigned by Google Compute Engine. This field is only applicable for
496 # persistent disks.
497 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
498 # encryption key.
499 #
500 # If you are creating a new disk, this field encrypts the new disk using
501 # an encryption key that you provide. If you are attaching an existing
502 # disk that is already encrypted, this field decrypts the disk using
503 # the customer-supplied encryption key.
504 #
505 # If you encrypt a disk using a customer-supplied key, you must provide the
506 # same key again when you attempt to use this resource at a later time. For
507 # example, you must provide the key when you create a snapshot or an image
508 # from the disk or when you attach the disk to a virtual machine instance.
509 #
510 # If you do not provide an encryption key, then the disk will be encrypted
511 # using an automatically generated key and you do not need to provide a key
512 # to use the disk later.
513 #
514 # Note:
515 #
516 # Instance templates do not storecustomer-supplied
517 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
518 #
519 # You cannot create VMs that have disks with customer-supplied keys using
520 # the bulk
521 # insert method.
522 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
523 # For example:
524 #
525 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
526 # key_region/cryptoKeys/key
527 #
528 # The fully-qualifed key name may be returned for resource GET requests. For
529 # example:
530 #
531 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
532 # key_region/cryptoKeys/key
533 # /cryptoKeyVersions/1
534 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
535 # key. If absent, the Compute Engine default service account is used.
536 # For example:
537 #
538 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
539 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
540 # encryption key, encoded in RFC
541 # 4648 base64 to either encrypt or decrypt this resource. You can
542 # provide either the rawKey or thersaEncryptedKey.
543 # For example:
544 #
545 # &quot;rawKey&quot;:
546 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
547 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
548 # customer-supplied encryption key to either encrypt or decrypt this
549 # resource. You can provide either the rawKey or thersaEncryptedKey.
550 # For example:
551 #
552 # &quot;rsaEncryptedKey&quot;:
553 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
554 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
555 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
556 #
557 # The key must meet the following requirements before you can provide it to
558 # Compute Engine:
559 #
560 # 1. The key is wrapped using a RSA public key certificate provided by
561 # Google.
562 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
563 # encoding.
564 #
565 # Gets the RSA public key certificate provided by Google at:
566 #
567 #
568 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
569 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
570 # 4648 base64 encoded SHA-256 hash of the customer-supplied
571 # encryption key that protects this resource.
572 },
573 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
574 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
575 # currently attached to another instance. If you try to force attach a zonal
576 # disk to an instance, you will receive an error.
577 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
578 # only for bootable images. Read
579 # Enabling guest operating system features to see a list of available
580 # options.
581 { # Guest OS features.
582 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
583 # separate values. Set to one or more of the following values:
584 #
585 # - VIRTIO_SCSI_MULTIQUEUE
586 # - WINDOWS
587 # - MULTI_IP_SUBNET
588 # - UEFI_COMPATIBLE
589 # - GVNIC
590 # - SEV_CAPABLE
591 # - SUSPEND_RESUME_COMPATIBLE
592 # - SEV_LIVE_MIGRATABLE_V2
593 # - SEV_SNP_CAPABLE
594 # - TDX_CAPABLE
595 # - IDPF
596 # - SNP_SVSM_CAPABLE
597 # - CCA_CAPABLE
598 #
599 #
600 # For more information, see
601 # Enabling guest operating system features.
602 },
603 ],
604 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
605 # boot disk. If you have many disks attached to an instance, each
606 # disk would have a unique index number.
607 &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
608 # alongside the new instance. Use initialization parameters to create boot
609 # disks or local SSDs attached to the new instance.
610 #
611 # This property is mutually exclusive with the source property;
612 # you can only define one or the other, but not both.
613 # alongside the new instance. Use initialization parameters to create boot
614 # disks or local SSDs attached to the new instance.
615 #
616 # This field is persisted and returned for instanceTemplate and not returned
617 # in the context of instance.
618 #
619 # This property is mutually exclusive with the source property;
620 # you can only define one or the other, but not both.
621 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
622 # arm64 or x86_64.
623 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
624 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
625 # of the instance. If a disk with the same name already exists in the given
626 # region, the existing disk is attached to the new instance and the
627 # new disk is not created.
628 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
629 # 10 GB. If you specify a sourceImage, which is required for
630 # boot disks, the default size is the size of the sourceImage.
631 # If you do not specify a sourceImage, the default disk size
632 # is 500 GB.
633 &quot;diskType&quot;: &quot;A String&quot;,
634 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
635 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
636 # persistent disks.
637 &quot;a_key&quot;: &quot;A String&quot;,
638 },
639 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
640 &quot;A String&quot;,
641 ],
642 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
643 # is to use the existing disk.
644 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
645 # of I/O operations per second that the disk can handle. Values must be
646 # between 10,000 and 120,000. For more details, see theExtreme persistent
647 # disk documentation.
648 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
649 # number of throughput mb per second that the disk can handle. Values must
650 # greater than or equal to 1.
651 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
652 # the URLs of the zones where the disk should be replicated to.
653 # You must provide exactly two replica zones, and one zone must be the same
654 # as the instance zone.
655 &quot;A String&quot;,
656 ],
657 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
658 # have the same definition as resource
659 # manager tags. Keys and values can be either in numeric format,
660 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
661 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
662 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
663 # empty.
664 &quot;a_key&quot;: &quot;A String&quot;,
665 },
666 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
667 # Specified using the full or partial URL. For instance template, specify
668 # only the resource policy name.
669 &quot;A String&quot;,
670 ],
671 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
672 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
673 # is required.
674 #
675 # To create a disk with one of the public operating system
676 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
677 #
678 # projects/debian-cloud/global/images/family/debian-9
679 #
680 #
681 # Alternatively, use a specific version of a public operating system image:
682 #
683 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
684 #
685 #
686 # To create a disk with a custom image that you created, specify the
687 # image name in the following format:
688 #
689 # global/images/my-custom-image
690 #
691 #
692 # You can also specify a custom image by its image family, which returns
693 # the latest version of the image in that family. Replace the image name
694 # with family/family-name:
695 #
696 # global/images/family/my-image-family
697 #
698 #
699 # If the source image is deleted later, this field will not be set.
700 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
701 # encryption key of the source image. Required if the source image is
702 # protected by a customer-supplied encryption key.
703 #
704 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
705 # encryption keys, so you cannot create disks for instances in a managed instance group if the
706 # source images are encrypted with your own keys.
707 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
708 # For example:
709 #
710 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
711 # key_region/cryptoKeys/key
712 #
713 # The fully-qualifed key name may be returned for resource GET requests. For
714 # example:
715 #
716 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
717 # key_region/cryptoKeys/key
718 # /cryptoKeyVersions/1
719 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
720 # key. If absent, the Compute Engine default service account is used.
721 # For example:
722 #
723 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
724 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
725 # encryption key, encoded in RFC
726 # 4648 base64 to either encrypt or decrypt this resource. You can
727 # provide either the rawKey or thersaEncryptedKey.
728 # For example:
729 #
730 # &quot;rawKey&quot;:
731 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
732 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
733 # customer-supplied encryption key to either encrypt or decrypt this
734 # resource. You can provide either the rawKey or thersaEncryptedKey.
735 # For example:
736 #
737 # &quot;rsaEncryptedKey&quot;:
738 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
739 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
740 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
741 #
742 # The key must meet the following requirements before you can provide it to
743 # Compute Engine:
744 #
745 # 1. The key is wrapped using a RSA public key certificate provided by
746 # Google.
747 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
748 # encoding.
749 #
750 # Gets the RSA public key certificate provided by Google at:
751 #
752 #
753 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
754 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
755 # 4648 base64 encoded SHA-256 hash of the customer-supplied
756 # encryption key that protects this resource.
757 },
758 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
759 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
760 # is required.
761 #
762 # To create a disk with a snapshot that you created, specify the
763 # snapshot name in the following format:
764 #
765 # global/snapshots/my-backup
766 #
767 #
768 # If the source snapshot is deleted later, this field will not be set.
769 #
770 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
771 # an image instead when you create VMs using
772 # the bulk
773 # insert method.
774 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
775 # encryption key of the source snapshot.
776 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
777 # For example:
778 #
779 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
780 # key_region/cryptoKeys/key
781 #
782 # The fully-qualifed key name may be returned for resource GET requests. For
783 # example:
784 #
785 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
786 # key_region/cryptoKeys/key
787 # /cryptoKeyVersions/1
788 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
789 # key. If absent, the Compute Engine default service account is used.
790 # For example:
791 #
792 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
793 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
794 # encryption key, encoded in RFC
795 # 4648 base64 to either encrypt or decrypt this resource. You can
796 # provide either the rawKey or thersaEncryptedKey.
797 # For example:
798 #
799 # &quot;rawKey&quot;:
800 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
801 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
802 # customer-supplied encryption key to either encrypt or decrypt this
803 # resource. You can provide either the rawKey or thersaEncryptedKey.
804 # For example:
805 #
806 # &quot;rsaEncryptedKey&quot;:
807 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
808 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
809 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
810 #
811 # The key must meet the following requirements before you can provide it to
812 # Compute Engine:
813 #
814 # 1. The key is wrapped using a RSA public key certificate provided by
815 # Google.
816 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
817 # encoding.
818 #
819 # Gets the RSA public key certificate provided by Google at:
820 #
821 #
822 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
823 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
824 # 4648 base64 encoded SHA-256 hash of the customer-supplied
825 # encryption key that protects this resource.
826 },
827 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
828 # this as a partial or full URL to the resource. For example, the following
829 # are valid values:
830 #
831 #
832 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
833 # - projects/project/zones/zone/storagePools/storagePool
834 # - zones/zone/storagePools/storagePool
835 },
836 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
837 # either SCSI or NVME. For most machine types, the
838 # default is SCSI. Local SSDs can use either NVME or SCSI.
839 # In certain configurations, persistent disks can use NVMe. For more
840 # information, seeAbout
841 # persistent disks.
842 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
843 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
844 &quot;A String&quot;,
845 ],
846 &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
847 # in READ_WRITE mode.
848 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
849 # field is set to PRESERVED if the LocalSSD data has been saved
850 # to a persistent location by customer request. (see the
851 # discard_local_ssd option on Stop/Suspend).
852 # Read-only in the api.
853 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
854 # these are public keys which are safe to store in public
855 &quot;dbs&quot;: [ # The Key Database (db).
856 {
857 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
858 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
859 },
860 ],
861 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
862 {
863 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
864 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
865 },
866 ],
867 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
868 {
869 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
870 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
871 },
872 ],
873 &quot;pk&quot;: { # The Platform Key (PK).
874 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
875 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
876 },
877 },
878 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
879 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
880 # is required.
881 #
882 # If desired, you can also attach existing non-root persistent disks using
883 # this property. This field is only applicable for persistent disks.
884 #
885 # Note that for InstanceTemplate, specify the disk name for zonal disk,
886 # and the URL for regional disk.
887 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
888 },
889 ],
890 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
891 # created from these properties.
892 { # A specification of the type and number of accelerator cards attached to the
893 # instance.
894 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
895 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
896 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
897 # If you are creating an instance template, specify only the
898 # accelerator name.
899 # See GPUs on Compute Engine
900 # for a full list of accelerator types.
901 },
902 ],
903 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
904 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
905 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
906 &quot;a_key&quot;: &quot;A String&quot;,
907 },
908 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
909 # properties.
910 # This field only accepts a machine type name, for example `n2-standard-4`.
911 # If you use the machine type full or partial URL, for example
912 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
913 # the request will result in an `INTERNAL_ERROR`.
914 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
915 # these properties. These pairs can consist of custom metadata or predefined
916 # keys. SeeProject and
917 # instance metadata for more information.
918 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
919 # the metadata&#x27;s contents and used for optimistic locking. The
920 # fingerprint is initially generated by Compute Engine and changes after
921 # every request to modify or update metadata. You must always provide an
922 # up-to-date fingerprint hash in order to update or change metadata,
923 # otherwise the request will fail with error412 conditionNotMet.
924 #
925 # To see the latest fingerprint, make a get() request to
926 # retrieve the resource.
927 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
928 # less than 512 KB.
929 { # Metadata
930 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
931 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
932 # This is reflected as part of a URL in the metadata server. Additionally, to
933 # avoid ambiguity, keys must not conflict with any other metadata keys
934 # for the project.
935 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
936 # have meaning as interpreted by the image running in the instance. The
937 # only restriction placed on values is that their size must be less than
938 # or equal to 262144 bytes (256 KiB).
939 },
940 ],
941 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
942 # for metadata.
943 },
944 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
945 # scheduled on the specified or newer cpu/platform. Applicable values are the
946 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
947 # information, read Specifying a
948 # Minimum CPU Platform.
949 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
950 { # A network interface resource attached to an instance.
951 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
952 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
953 # no external internet access.
954 { # An access configuration attached to an instance&#x27;s network interface.
955 # Only one access config per instance is supported.
956 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
957 # The first IPv6 address of the external IPv6 range associated
958 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
959 # use a static external IP address, it must be unused and in the same region
960 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
961 # assign an external IPv6 address from the instance&#x27;s subnetwork.
962 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
963 # external IPv6 range.
964 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
965 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
966 # (IPv4), the default and recommended name is External NAT, but
967 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
968 # recommend name is External IPv6.
969 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
970 # address associated with this instance. Specify an unused static
971 # external IP address available to the project or leave this field undefined
972 # to use an IP from a shared ephemeral IP address pool. If you specify a
973 # static external IP address, it must live in the same region as the zone of
974 # the instance.
975 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
976 # configuration and can only take the following values: PREMIUM,STANDARD.
977 #
978 # If an AccessConfig is specified without a valid external IP address, an
979 # ephemeral IP will be created with this networkTier.
980 #
981 # If an AccessConfig with a valid external IP address is specified, it must
982 # match that of the networkTier associated with the Address resource owning
983 # that IP.
984 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
985 #
986 # 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
987 # first IP in associated external IPv6 range.
988 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
989 # config.
990 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
991 # external IP address of the instance to a DNS domain name.
992 #
993 # This field is not used in ipv6AccessConfig. A default PTR
994 # record will be created if the VM has external IPv6 range associated.
995 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
996 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
997 },
998 ],
999 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
1000 # You can only specify this field for network interfaces in VPC networks.
1001 { # An alias IP range attached to an instance&#x27;s network interface.
1002 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1003 # must belong to the specified subnetwork and cannot contain IP addresses
1004 # reserved by system or used by other network interfaces. This range may be
1005 # 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).
1006 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1007 # alias range. If not specified, the primary range of the subnetwork is used.
1008 },
1009 ],
1010 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
1011 # You can only specify this field for network interfaces in VPC networks.
1012 { # An alias IP range attached to an instance&#x27;s network interface.
1013 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1014 # must belong to the specified subnetwork and cannot contain IP addresses
1015 # reserved by system or used by other network interfaces. This range may be
1016 # 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).
1017 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1018 # alias range. If not specified, the primary range of the subnetwork is used.
1019 },
1020 ],
1021 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
1022 # with network_attachment.
1023 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
1024 # This field will be ignored when inserting an Instance or
1025 # adding a NetworkInterface. An up-to-date
1026 # 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.
1027 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
1028 # or not. If enabled, also indicates the version of IGMP supported.
1029 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
1030 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
1031 # one IPv6 access config, DIRECT_IPV6, is supported. If there
1032 # is no ipv6AccessConfig specified, then this instance will
1033 # have no external IPv6 Internet access.
1034 { # An access configuration attached to an instance&#x27;s network interface.
1035 # Only one access config per instance is supported.
1036 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1037 # The first IPv6 address of the external IPv6 range associated
1038 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1039 # use a static external IP address, it must be unused and in the same region
1040 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1041 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1042 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1043 # external IPv6 range.
1044 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1045 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1046 # (IPv4), the default and recommended name is External NAT, but
1047 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1048 # recommend name is External IPv6.
1049 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1050 # address associated with this instance. Specify an unused static
1051 # external IP address available to the project or leave this field undefined
1052 # to use an IP from a shared ephemeral IP address pool. If you specify a
1053 # static external IP address, it must live in the same region as the zone of
1054 # the instance.
1055 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1056 # configuration and can only take the following values: PREMIUM,STANDARD.
1057 #
1058 # If an AccessConfig is specified without a valid external IP address, an
1059 # ephemeral IP will be created with this networkTier.
1060 #
1061 # If an AccessConfig with a valid external IP address is specified, it must
1062 # match that of the networkTier associated with the Address resource owning
1063 # that IP.
1064 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
1065 #
1066 # 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
1067 # first IP in associated external IPv6 range.
1068 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
1069 # config.
1070 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
1071 # external IP address of the instance to a DNS domain name.
1072 #
1073 # This field is not used in ipv6AccessConfig. A default PTR
1074 # record will be created if the VM has external IPv6 range associated.
1075 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
1076 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
1077 },
1078 ],
1079 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
1080 # accessed from the Internet. This field is always inherited from its
1081 # subnetwork.
1082 #
1083 # Valid only if stackType is IPV4_IPV6.
1084 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
1085 # use a static internal IP address, it must be unused and in the same region
1086 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1087 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
1088 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
1089 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
1090 # server. For a VM, the network interface uses the nicN naming
1091 # format. Where N is a value between 0 and7. The default interface value is nic0.
1092 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
1093 # instance, if neither the network nor the subnetwork is specified, the
1094 # default network global/networks/default is used. If the
1095 # selected project doesn&#x27;t have the default network, you must specify a
1096 # network or subnet. If the network is not specified but the subnetwork is
1097 # specified, the network is inferred.
1098 #
1099 # If you specify this property, you can specify the network as
1100 # a full or partial URL. For example, the following are all valid URLs:
1101 #
1102 #
1103 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
1104 # - projects/project/global/networks/network
1105 # - global/networks/default
1106 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
1107 # to in the following format:
1108 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
1109 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
1110 # interface. If not specified by the user, an unused internal IP is
1111 # assigned by the system.
1112 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
1113 # VirtioNet.
1114 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
1115 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
1116 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
1117 # if not specified by the users.
1118 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
1119 # interface. Can only be used with network_attachment. It is not possible to
1120 # use on its own however, network_attachment can be used without
1121 # service_class_id.
1122 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
1123 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
1124 #
1125 # This field can be both set at instance creation and update network
1126 # interface operations.
1127 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
1128 # resource is inlegacy
1129 # mode, do not specify this field. If the network is in auto subnet
1130 # mode, specifying the subnetwork is optional. If the network is in custom
1131 # subnet mode, specifying the subnetwork is required. If you specify this
1132 # field, you can specify the subnetwork as a full or partial URL. For
1133 # example, the following are all valid URLs:
1134 #
1135 #
1136 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
1137 # - regions/region/subnetworks/subnetwork
1138 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
1139 # from 2 to 255 inclusively.
1140 },
1141 ],
1142 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
1143 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
1144 },
1145 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
1146 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
1147 # Note that for MachineImage, this is not supported yet.
1148 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
1149 # Note that for MachineImage, this is not supported yet.
1150 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
1151 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
1152 # Consuming reserved instances for examples.
1153 &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
1154 # the name of your reservation as its value.
1155 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
1156 # either a name to a reservation in the same project or
1157 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
1158 # shared reservation in the same zone but in a different project.
1159 &quot;A String&quot;,
1160 ],
1161 },
1162 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
1163 # have the same definition as resource
1164 # manager tags. Keys and values can be either in numeric format,
1165 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1166 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1167 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
1168 # PATCH) when empty.
1169 &quot;a_key&quot;: &quot;A String&quot;,
1170 },
1171 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
1172 # these properties.
1173 # Note that for MachineImage, this is not supported yet.
1174 &quot;A String&quot;,
1175 ],
1176 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
1177 # these properties.
1178 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
1179 # terminated by Compute Engine (not terminated by a user). You can only set
1180 # the automatic restart option for standard instances.Preemptible instances
1181 # cannot be automatically restarted.
1182 #
1183 # By default, this is set to true so an instance is
1184 # automatically restarted if it is terminated by Compute Engine.
1185 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
1186 # must be a number between 1 and the number of availability domains
1187 # specified in the spread placement policy attached to the instance.
1188 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
1189 # within the range of [90, 330] with the increment of 30, if unset, the
1190 # default behavior of host error recovery will be used.
1191 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
1192 &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
1193 # recovery of the Local Ssd state is attempted. Its value should be in
1194 # between 0 and 168 hours with hour granularity and the default value being 1
1195 # hour.
1196 # as a count of seconds and fractions of seconds at nanosecond
1197 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1198 # or &quot;month&quot;. Range is approximately 10,000 years.
1199 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1200 # Durations less than one second are represented with a 0
1201 # `seconds` field and a positive `nanos` field. Must be from 0
1202 # to 999,999,999 inclusive.
1203 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1204 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1205 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1206 },
1207 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
1208 # resources.
1209 # This field is for use by internal tools that use the public API.
1210 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
1211 # the instance termination action will be performed at the end of the run
1212 # duration.
1213 # as a count of seconds and fractions of seconds at nanosecond
1214 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1215 # or &quot;month&quot;. Range is approximately 10,000 years.
1216 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1217 # Durations less than one second are represented with a 0
1218 # `seconds` field and a positive `nanos` field. Must be from 0
1219 # to 999,999,999 inclusive.
1220 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1221 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1222 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1223 },
1224 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
1225 # on a sole-tenant node.
1226 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
1227 # affinity for more information.
1228 # Overrides reservationAffinity.
1229 { # Node Affinity: the configuration of desired nodes onto which this Instance
1230 # could be scheduled.
1231 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
1232 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
1233 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
1234 &quot;A String&quot;,
1235 ],
1236 },
1237 ],
1238 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
1239 # the default behavior is MIGRATE. Forpreemptible instances,
1240 # the default and only possible behavior is TERMINATE. For more
1241 # information, see
1242 # Set
1243 # VM host maintenance policy.
1244 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
1245 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
1246 # else, the Local SSD data will be preserved when the instance is stopped
1247 # at the end of the run duration/termination time.
1248 },
1249 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
1250 # instance creation or while the instance isstopped and
1251 # therefore, in a `TERMINATED` state. SeeInstance Life
1252 # Cycle for more information on the possible instance states.
1253 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
1254 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
1255 # Off and ACPI G3 Mechanical
1256 # Off for Standard VMs and 30 seconds for Spot VMs.
1257 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
1258 # termination action will be performed at the termination time.
1259 },
1260 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
1261 # service accounts are available to the instances that are created from
1262 # these properties. Use metadata queries to obtain the access tokens for
1263 # these instances.
1264 { # A service account.
1265 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
1266 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
1267 &quot;A String&quot;,
1268 ],
1269 },
1270 ],
1271 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
1272 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
1273 # default.
1274 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
1275 # default.
1276 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
1277 # default.
1278 },
1279 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
1280 # properties. The tags identify valid sources or targets for network
1281 # firewalls. The setTags method can modify this list of tags. Each tag within
1282 # the list must comply with RFC1035.
1283 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
1284 # the tags&#x27; contents and used for optimistic locking. The
1285 # fingerprint is initially generated by Compute Engine and changes after
1286 # every request to modify or update tags. You must always provide an
1287 # up-to-date fingerprint hash in order to update or change tags.
1288 #
1289 # To see the latest fingerprint, make get() request to the
1290 # instance.
1291 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
1292 # with RFC1035.
1293 &quot;A String&quot;,
1294 ],
1295 },
1296 &quot;workloadIdentityConfig&quot;: {
1297 &quot;identity&quot;: &quot;A String&quot;,
1298 &quot;identityCertificateEnabled&quot;: True or False,
1299 },
1300 },
1301 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the instance template resides. Only
1302 # applicable for regional resources.
1303 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this instance template. The server defines this
1304 # URL.
1305 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the template. You can provide this as a
1306 # partial or full URL to the resource. For example, the following are valid
1307 # values:
1308 #
1309 #
1310 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
1311 # - projects/project/zones/zone/instances/instance
1312 &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.
1313 # from a source instance.
1314 &quot;diskConfigs&quot;: [ # Attached disks configuration. If not provided, defaults are applied:
1315 # For boot disk and any other R/W disks, the source images for each disk
1316 # will be used. For read-only disks, they will be attached in read-only
1317 # mode. Local SSD disks will be created as blank volumes.
1318 { # A specification of the desired way to instantiate a disk in the instance
1319 # template when its created from a source instance.
1320 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
1321 # deleted (but not when the disk is detached from the instance).
1322 &quot;customImage&quot;: &quot;A String&quot;, # The custom source image to be used to restore this disk when instantiating
1323 # this instance template.
1324 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the device name of the disk to which the configurations apply to.
1325 &quot;instantiateFrom&quot;: &quot;A String&quot;, # Specifies whether to include the disk and what image to use. Possible
1326 # values are:
1327 #
1328 #
1329 # - source-image: to use the same image that was used to
1330 # create the source instance&#x27;s corresponding disk. Applicable to the boot
1331 # disk and additional read-write disks.
1332 # - source-image-family: to use the same image family that
1333 # was used to create the source instance&#x27;s corresponding disk. Applicable
1334 # to the boot disk and additional read-write disks.
1335 # - custom-image: to use a user-provided image url for disk
1336 # creation. Applicable to the boot disk and additional read-write
1337 # disks.
1338 # - attach-read-only: to attach a read-only
1339 # disk. Applicable to read-only disks.
1340 # - do-not-include: to exclude a disk from the template.
1341 # Applicable to additional read-write disks, local SSDs, and read-only
1342 # disks.
1343 },
1344 ],
1345 },
1346 }</pre>
1347 </div>
1348
1349 <div class="method">
1350 <code class="details" id="insert">insert(project, region, body=None, requestId=None, x__xgafv=None)</code>
1351 <pre>Creates an instance template in the specified project and region using the
1352 global instance template whose URL is included in the request.
1353
1354 Args:
1355 project: string, Project ID for this request. (required)
1356 region: string, The name of the region for this request. (required)
1357 body: object, The request body.
1358 The object takes the form of:
1359
1360 { # Represents an Instance Template resource.
1361 #
1362 # Google Compute Engine has two Instance Template resources:
1363 #
1364 # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
1365 # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
1366 #
1367 # You can reuse a global instance template in
1368 # different regions whereas you can use a regional instance template in a
1369 # specified region only. If you want to reduce cross-region dependency or
1370 # achieve data residency, use a regional instance template.
1371 #
1372 # To create VMs, managed instance groups, and reservations, you can use either
1373 # global or regional instance templates.
1374 #
1375 # For more information, readInstance Templates.
1376 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
1377 # text format.
1378 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
1379 # create the resource.
1380 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this instance template. The server
1381 # defines this identifier.
1382 &quot;kind&quot;: &quot;compute#instanceTemplate&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
1383 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
1384 # The name must be 1-63 characters long, and comply withRFC1035.
1385 # Specifically, the name must be 1-63 characters long and match the regular
1386 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
1387 # character must be a lowercase letter, and all following characters must be
1388 # a dash, lowercase letter, or digit, except the last character, which cannot
1389 # be a dash.
1390 &quot;properties&quot;: { # The instance properties for this instance template.
1391 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
1392 # Note that for MachineImage, this is not supported yet.
1393 # Options that would traditionally be configured in a BIOS belong
1394 # here. Features that require operating system support may have
1395 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
1396 # disabled).
1397 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
1398 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
1399 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
1400 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
1401 # multithreading (SMT) set this to 1. If unset, the maximum number
1402 # of threads supported per core by the underlying processor is
1403 # assumed.
1404 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
1405 # Supported modes include:
1406 # * ALL_CORE_MAX
1407 #
1408 # Using empty string or not setting this field will use the platform-specific
1409 # default turbo mode.
1410 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
1411 # the number of threads per core to compute the total number of virtual
1412 # CPUs to expose to the instance. If unset, the number of cores is
1413 # inferred from the instance&#x27;s nominal CPU count and the underlying
1414 # platform&#x27;s SMT width.
1415 },
1416 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
1417 # source IP addresses other than their own and receive packets with
1418 # destination IP addresses other than their own. If these instances will be
1419 # used as an IP gateway or it will be set as the next-hop in a Route
1420 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
1421 # documentation for more information.
1422 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
1423 # Note that for MachineImage, this is not supported yet.
1424 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
1425 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
1426 },
1427 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
1428 # properties.
1429 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
1430 # from these properties.
1431 { # An instance-attached disk resource.
1432 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
1433 # or X86_64.
1434 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
1435 # deleted (but not when the disk is detached from the instance).
1436 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
1437 # partition of the disk for its root filesystem.
1438 &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
1439 # running within the instance. This name can be used to reference the device
1440 # for mounting, resizing, and so on, from within the instance.
1441 #
1442 # If not specified, the server chooses a default device name to apply to this
1443 # disk, in the form persistent-disk-x, where x is a number
1444 # assigned by Google Compute Engine. This field is only applicable for
1445 # persistent disks.
1446 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
1447 # encryption key.
1448 #
1449 # If you are creating a new disk, this field encrypts the new disk using
1450 # an encryption key that you provide. If you are attaching an existing
1451 # disk that is already encrypted, this field decrypts the disk using
1452 # the customer-supplied encryption key.
1453 #
1454 # If you encrypt a disk using a customer-supplied key, you must provide the
1455 # same key again when you attempt to use this resource at a later time. For
1456 # example, you must provide the key when you create a snapshot or an image
1457 # from the disk or when you attach the disk to a virtual machine instance.
1458 #
1459 # If you do not provide an encryption key, then the disk will be encrypted
1460 # using an automatically generated key and you do not need to provide a key
1461 # to use the disk later.
1462 #
1463 # Note:
1464 #
1465 # Instance templates do not storecustomer-supplied
1466 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
1467 #
1468 # You cannot create VMs that have disks with customer-supplied keys using
1469 # the bulk
1470 # insert method.
1471 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1472 # For example:
1473 #
1474 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1475 # key_region/cryptoKeys/key
1476 #
1477 # The fully-qualifed key name may be returned for resource GET requests. For
1478 # example:
1479 #
1480 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1481 # key_region/cryptoKeys/key
1482 # /cryptoKeyVersions/1
1483 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1484 # key. If absent, the Compute Engine default service account is used.
1485 # For example:
1486 #
1487 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1488 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1489 # encryption key, encoded in RFC
1490 # 4648 base64 to either encrypt or decrypt this resource. You can
1491 # provide either the rawKey or thersaEncryptedKey.
1492 # For example:
1493 #
1494 # &quot;rawKey&quot;:
1495 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1496 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1497 # customer-supplied encryption key to either encrypt or decrypt this
1498 # resource. You can provide either the rawKey or thersaEncryptedKey.
1499 # For example:
1500 #
1501 # &quot;rsaEncryptedKey&quot;:
1502 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1503 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1504 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1505 #
1506 # The key must meet the following requirements before you can provide it to
1507 # Compute Engine:
1508 #
1509 # 1. The key is wrapped using a RSA public key certificate provided by
1510 # Google.
1511 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1512 # encoding.
1513 #
1514 # Gets the RSA public key certificate provided by Google at:
1515 #
1516 #
1517 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1518 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1519 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1520 # encryption key that protects this resource.
1521 },
1522 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
1523 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
1524 # currently attached to another instance. If you try to force attach a zonal
1525 # disk to an instance, you will receive an error.
1526 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
1527 # only for bootable images. Read
1528 # Enabling guest operating system features to see a list of available
1529 # options.
1530 { # Guest OS features.
1531 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
1532 # separate values. Set to one or more of the following values:
1533 #
1534 # - VIRTIO_SCSI_MULTIQUEUE
1535 # - WINDOWS
1536 # - MULTI_IP_SUBNET
1537 # - UEFI_COMPATIBLE
1538 # - GVNIC
1539 # - SEV_CAPABLE
1540 # - SUSPEND_RESUME_COMPATIBLE
1541 # - SEV_LIVE_MIGRATABLE_V2
1542 # - SEV_SNP_CAPABLE
1543 # - TDX_CAPABLE
1544 # - IDPF
1545 # - SNP_SVSM_CAPABLE
1546 # - CCA_CAPABLE
1547 #
1548 #
1549 # For more information, see
1550 # Enabling guest operating system features.
1551 },
1552 ],
1553 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
1554 # boot disk. If you have many disks attached to an instance, each
1555 # disk would have a unique index number.
1556 &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
1557 # alongside the new instance. Use initialization parameters to create boot
1558 # disks or local SSDs attached to the new instance.
1559 #
1560 # This property is mutually exclusive with the source property;
1561 # you can only define one or the other, but not both.
1562 # alongside the new instance. Use initialization parameters to create boot
1563 # disks or local SSDs attached to the new instance.
1564 #
1565 # This field is persisted and returned for instanceTemplate and not returned
1566 # in the context of instance.
1567 #
1568 # This property is mutually exclusive with the source property;
1569 # you can only define one or the other, but not both.
1570 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
1571 # arm64 or x86_64.
1572 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
1573 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
1574 # of the instance. If a disk with the same name already exists in the given
1575 # region, the existing disk is attached to the new instance and the
1576 # new disk is not created.
1577 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
1578 # 10 GB. If you specify a sourceImage, which is required for
1579 # boot disks, the default size is the size of the sourceImage.
1580 # If you do not specify a sourceImage, the default disk size
1581 # is 500 GB.
1582 &quot;diskType&quot;: &quot;A String&quot;,
1583 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
1584 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
1585 # persistent disks.
1586 &quot;a_key&quot;: &quot;A String&quot;,
1587 },
1588 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
1589 &quot;A String&quot;,
1590 ],
1591 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
1592 # is to use the existing disk.
1593 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
1594 # of I/O operations per second that the disk can handle. Values must be
1595 # between 10,000 and 120,000. For more details, see theExtreme persistent
1596 # disk documentation.
1597 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
1598 # number of throughput mb per second that the disk can handle. Values must
1599 # greater than or equal to 1.
1600 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
1601 # the URLs of the zones where the disk should be replicated to.
1602 # You must provide exactly two replica zones, and one zone must be the same
1603 # as the instance zone.
1604 &quot;A String&quot;,
1605 ],
1606 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
1607 # have the same definition as resource
1608 # manager tags. Keys and values can be either in numeric format,
1609 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1610 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1611 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
1612 # empty.
1613 &quot;a_key&quot;: &quot;A String&quot;,
1614 },
1615 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
1616 # Specified using the full or partial URL. For instance template, specify
1617 # only the resource policy name.
1618 &quot;A String&quot;,
1619 ],
1620 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
1621 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1622 # is required.
1623 #
1624 # To create a disk with one of the public operating system
1625 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
1626 #
1627 # projects/debian-cloud/global/images/family/debian-9
1628 #
1629 #
1630 # Alternatively, use a specific version of a public operating system image:
1631 #
1632 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
1633 #
1634 #
1635 # To create a disk with a custom image that you created, specify the
1636 # image name in the following format:
1637 #
1638 # global/images/my-custom-image
1639 #
1640 #
1641 # You can also specify a custom image by its image family, which returns
1642 # the latest version of the image in that family. Replace the image name
1643 # with family/family-name:
1644 #
1645 # global/images/family/my-image-family
1646 #
1647 #
1648 # If the source image is deleted later, this field will not be set.
1649 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
1650 # encryption key of the source image. Required if the source image is
1651 # protected by a customer-supplied encryption key.
1652 #
1653 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
1654 # encryption keys, so you cannot create disks for instances in a managed instance group if the
1655 # source images are encrypted with your own keys.
1656 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1657 # For example:
1658 #
1659 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1660 # key_region/cryptoKeys/key
1661 #
1662 # The fully-qualifed key name may be returned for resource GET requests. For
1663 # example:
1664 #
1665 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1666 # key_region/cryptoKeys/key
1667 # /cryptoKeyVersions/1
1668 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1669 # key. If absent, the Compute Engine default service account is used.
1670 # For example:
1671 #
1672 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1673 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1674 # encryption key, encoded in RFC
1675 # 4648 base64 to either encrypt or decrypt this resource. You can
1676 # provide either the rawKey or thersaEncryptedKey.
1677 # For example:
1678 #
1679 # &quot;rawKey&quot;:
1680 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1681 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1682 # customer-supplied encryption key to either encrypt or decrypt this
1683 # resource. You can provide either the rawKey or thersaEncryptedKey.
1684 # For example:
1685 #
1686 # &quot;rsaEncryptedKey&quot;:
1687 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1688 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1689 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1690 #
1691 # The key must meet the following requirements before you can provide it to
1692 # Compute Engine:
1693 #
1694 # 1. The key is wrapped using a RSA public key certificate provided by
1695 # Google.
1696 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1697 # encoding.
1698 #
1699 # Gets the RSA public key certificate provided by Google at:
1700 #
1701 #
1702 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1703 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1704 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1705 # encryption key that protects this resource.
1706 },
1707 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
1708 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
1709 # is required.
1710 #
1711 # To create a disk with a snapshot that you created, specify the
1712 # snapshot name in the following format:
1713 #
1714 # global/snapshots/my-backup
1715 #
1716 #
1717 # If the source snapshot is deleted later, this field will not be set.
1718 #
1719 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
1720 # an image instead when you create VMs using
1721 # the bulk
1722 # insert method.
1723 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
1724 # encryption key of the source snapshot.
1725 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1726 # For example:
1727 #
1728 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1729 # key_region/cryptoKeys/key
1730 #
1731 # The fully-qualifed key name may be returned for resource GET requests. For
1732 # example:
1733 #
1734 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1735 # key_region/cryptoKeys/key
1736 # /cryptoKeyVersions/1
1737 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1738 # key. If absent, the Compute Engine default service account is used.
1739 # For example:
1740 #
1741 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1742 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1743 # encryption key, encoded in RFC
1744 # 4648 base64 to either encrypt or decrypt this resource. You can
1745 # provide either the rawKey or thersaEncryptedKey.
1746 # For example:
1747 #
1748 # &quot;rawKey&quot;:
1749 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1750 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1751 # customer-supplied encryption key to either encrypt or decrypt this
1752 # resource. You can provide either the rawKey or thersaEncryptedKey.
1753 # For example:
1754 #
1755 # &quot;rsaEncryptedKey&quot;:
1756 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1757 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1758 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1759 #
1760 # The key must meet the following requirements before you can provide it to
1761 # Compute Engine:
1762 #
1763 # 1. The key is wrapped using a RSA public key certificate provided by
1764 # Google.
1765 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1766 # encoding.
1767 #
1768 # Gets the RSA public key certificate provided by Google at:
1769 #
1770 #
1771 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1772 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1773 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1774 # encryption key that protects this resource.
1775 },
1776 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
1777 # this as a partial or full URL to the resource. For example, the following
1778 # are valid values:
1779 #
1780 #
1781 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
1782 # - projects/project/zones/zone/storagePools/storagePool
1783 # - zones/zone/storagePools/storagePool
1784 },
1785 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
1786 # either SCSI or NVME. For most machine types, the
1787 # default is SCSI. Local SSDs can use either NVME or SCSI.
1788 # In certain configurations, persistent disks can use NVMe. For more
1789 # information, seeAbout
1790 # persistent disks.
1791 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
1792 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
1793 &quot;A String&quot;,
1794 ],
1795 &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
1796 # in READ_WRITE mode.
1797 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
1798 # field is set to PRESERVED if the LocalSSD data has been saved
1799 # to a persistent location by customer request. (see the
1800 # discard_local_ssd option on Stop/Suspend).
1801 # Read-only in the api.
1802 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
1803 # these are public keys which are safe to store in public
1804 &quot;dbs&quot;: [ # The Key Database (db).
1805 {
1806 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1807 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1808 },
1809 ],
1810 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
1811 {
1812 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1813 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1814 },
1815 ],
1816 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
1817 {
1818 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1819 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1820 },
1821 ],
1822 &quot;pk&quot;: { # The Platform Key (PK).
1823 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1824 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1825 },
1826 },
1827 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
1828 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1829 # is required.
1830 #
1831 # If desired, you can also attach existing non-root persistent disks using
1832 # this property. This field is only applicable for persistent disks.
1833 #
1834 # Note that for InstanceTemplate, specify the disk name for zonal disk,
1835 # and the URL for regional disk.
1836 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
1837 },
1838 ],
1839 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
1840 # created from these properties.
1841 { # A specification of the type and number of accelerator cards attached to the
1842 # instance.
1843 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
1844 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
1845 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
1846 # If you are creating an instance template, specify only the
1847 # accelerator name.
1848 # See GPUs on Compute Engine
1849 # for a full list of accelerator types.
1850 },
1851 ],
1852 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
1853 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
1854 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
1855 &quot;a_key&quot;: &quot;A String&quot;,
1856 },
1857 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
1858 # properties.
1859 # This field only accepts a machine type name, for example `n2-standard-4`.
1860 # If you use the machine type full or partial URL, for example
1861 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
1862 # the request will result in an `INTERNAL_ERROR`.
1863 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
1864 # these properties. These pairs can consist of custom metadata or predefined
1865 # keys. SeeProject and
1866 # instance metadata for more information.
1867 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
1868 # the metadata&#x27;s contents and used for optimistic locking. The
1869 # fingerprint is initially generated by Compute Engine and changes after
1870 # every request to modify or update metadata. You must always provide an
1871 # up-to-date fingerprint hash in order to update or change metadata,
1872 # otherwise the request will fail with error412 conditionNotMet.
1873 #
1874 # To see the latest fingerprint, make a get() request to
1875 # retrieve the resource.
1876 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
1877 # less than 512 KB.
1878 { # Metadata
1879 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
1880 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
1881 # This is reflected as part of a URL in the metadata server. Additionally, to
1882 # avoid ambiguity, keys must not conflict with any other metadata keys
1883 # for the project.
1884 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
1885 # have meaning as interpreted by the image running in the instance. The
1886 # only restriction placed on values is that their size must be less than
1887 # or equal to 262144 bytes (256 KiB).
1888 },
1889 ],
1890 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
1891 # for metadata.
1892 },
1893 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
1894 # scheduled on the specified or newer cpu/platform. Applicable values are the
1895 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
1896 # information, read Specifying a
1897 # Minimum CPU Platform.
1898 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
1899 { # A network interface resource attached to an instance.
1900 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
1901 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
1902 # no external internet access.
1903 { # An access configuration attached to an instance&#x27;s network interface.
1904 # Only one access config per instance is supported.
1905 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1906 # The first IPv6 address of the external IPv6 range associated
1907 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1908 # use a static external IP address, it must be unused and in the same region
1909 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1910 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1911 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1912 # external IPv6 range.
1913 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1914 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1915 # (IPv4), the default and recommended name is External NAT, but
1916 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1917 # recommend name is External IPv6.
1918 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1919 # address associated with this instance. Specify an unused static
1920 # external IP address available to the project or leave this field undefined
1921 # to use an IP from a shared ephemeral IP address pool. If you specify a
1922 # static external IP address, it must live in the same region as the zone of
1923 # the instance.
1924 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1925 # configuration and can only take the following values: PREMIUM,STANDARD.
1926 #
1927 # If an AccessConfig is specified without a valid external IP address, an
1928 # ephemeral IP will be created with this networkTier.
1929 #
1930 # If an AccessConfig with a valid external IP address is specified, it must
1931 # match that of the networkTier associated with the Address resource owning
1932 # that IP.
1933 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
1934 #
1935 # 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
1936 # first IP in associated external IPv6 range.
1937 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
1938 # config.
1939 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
1940 # external IP address of the instance to a DNS domain name.
1941 #
1942 # This field is not used in ipv6AccessConfig. A default PTR
1943 # record will be created if the VM has external IPv6 range associated.
1944 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
1945 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
1946 },
1947 ],
1948 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
1949 # You can only specify this field for network interfaces in VPC networks.
1950 { # An alias IP range attached to an instance&#x27;s network interface.
1951 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1952 # must belong to the specified subnetwork and cannot contain IP addresses
1953 # reserved by system or used by other network interfaces. This range may be
1954 # 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).
1955 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1956 # alias range. If not specified, the primary range of the subnetwork is used.
1957 },
1958 ],
1959 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
1960 # You can only specify this field for network interfaces in VPC networks.
1961 { # An alias IP range attached to an instance&#x27;s network interface.
1962 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1963 # must belong to the specified subnetwork and cannot contain IP addresses
1964 # reserved by system or used by other network interfaces. This range may be
1965 # 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).
1966 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1967 # alias range. If not specified, the primary range of the subnetwork is used.
1968 },
1969 ],
1970 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
1971 # with network_attachment.
1972 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
1973 # This field will be ignored when inserting an Instance or
1974 # adding a NetworkInterface. An up-to-date
1975 # 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.
1976 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
1977 # or not. If enabled, also indicates the version of IGMP supported.
1978 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
1979 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
1980 # one IPv6 access config, DIRECT_IPV6, is supported. If there
1981 # is no ipv6AccessConfig specified, then this instance will
1982 # have no external IPv6 Internet access.
1983 { # An access configuration attached to an instance&#x27;s network interface.
1984 # Only one access config per instance is supported.
1985 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1986 # The first IPv6 address of the external IPv6 range associated
1987 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1988 # use a static external IP address, it must be unused and in the same region
1989 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1990 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1991 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1992 # external IPv6 range.
1993 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1994 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1995 # (IPv4), the default and recommended name is External NAT, but
1996 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1997 # recommend name is External IPv6.
1998 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1999 # address associated with this instance. Specify an unused static
2000 # external IP address available to the project or leave this field undefined
2001 # to use an IP from a shared ephemeral IP address pool. If you specify a
2002 # static external IP address, it must live in the same region as the zone of
2003 # the instance.
2004 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
2005 # configuration and can only take the following values: PREMIUM,STANDARD.
2006 #
2007 # If an AccessConfig is specified without a valid external IP address, an
2008 # ephemeral IP will be created with this networkTier.
2009 #
2010 # If an AccessConfig with a valid external IP address is specified, it must
2011 # match that of the networkTier associated with the Address resource owning
2012 # that IP.
2013 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
2014 #
2015 # 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
2016 # first IP in associated external IPv6 range.
2017 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
2018 # config.
2019 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
2020 # external IP address of the instance to a DNS domain name.
2021 #
2022 # This field is not used in ipv6AccessConfig. A default PTR
2023 # record will be created if the VM has external IPv6 range associated.
2024 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
2025 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
2026 },
2027 ],
2028 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
2029 # accessed from the Internet. This field is always inherited from its
2030 # subnetwork.
2031 #
2032 # Valid only if stackType is IPV4_IPV6.
2033 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
2034 # use a static internal IP address, it must be unused and in the same region
2035 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
2036 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
2037 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
2038 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
2039 # server. For a VM, the network interface uses the nicN naming
2040 # format. Where N is a value between 0 and7. The default interface value is nic0.
2041 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
2042 # instance, if neither the network nor the subnetwork is specified, the
2043 # default network global/networks/default is used. If the
2044 # selected project doesn&#x27;t have the default network, you must specify a
2045 # network or subnet. If the network is not specified but the subnetwork is
2046 # specified, the network is inferred.
2047 #
2048 # If you specify this property, you can specify the network as
2049 # a full or partial URL. For example, the following are all valid URLs:
2050 #
2051 #
2052 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
2053 # - projects/project/global/networks/network
2054 # - global/networks/default
2055 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
2056 # to in the following format:
2057 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
2058 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
2059 # interface. If not specified by the user, an unused internal IP is
2060 # assigned by the system.
2061 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
2062 # VirtioNet.
2063 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
2064 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
2065 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
2066 # if not specified by the users.
2067 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
2068 # interface. Can only be used with network_attachment. It is not possible to
2069 # use on its own however, network_attachment can be used without
2070 # service_class_id.
2071 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
2072 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
2073 #
2074 # This field can be both set at instance creation and update network
2075 # interface operations.
2076 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
2077 # resource is inlegacy
2078 # mode, do not specify this field. If the network is in auto subnet
2079 # mode, specifying the subnetwork is optional. If the network is in custom
2080 # subnet mode, specifying the subnetwork is required. If you specify this
2081 # field, you can specify the subnetwork as a full or partial URL. For
2082 # example, the following are all valid URLs:
2083 #
2084 #
2085 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
2086 # - regions/region/subnetworks/subnetwork
2087 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
2088 # from 2 to 255 inclusively.
2089 },
2090 ],
2091 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
2092 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
2093 },
2094 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
2095 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
2096 # Note that for MachineImage, this is not supported yet.
2097 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
2098 # Note that for MachineImage, this is not supported yet.
2099 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
2100 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
2101 # Consuming reserved instances for examples.
2102 &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
2103 # the name of your reservation as its value.
2104 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
2105 # either a name to a reservation in the same project or
2106 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
2107 # shared reservation in the same zone but in a different project.
2108 &quot;A String&quot;,
2109 ],
2110 },
2111 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
2112 # have the same definition as resource
2113 # manager tags. Keys and values can be either in numeric format,
2114 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
2115 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
2116 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
2117 # PATCH) when empty.
2118 &quot;a_key&quot;: &quot;A String&quot;,
2119 },
2120 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
2121 # these properties.
2122 # Note that for MachineImage, this is not supported yet.
2123 &quot;A String&quot;,
2124 ],
2125 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
2126 # these properties.
2127 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
2128 # terminated by Compute Engine (not terminated by a user). You can only set
2129 # the automatic restart option for standard instances.Preemptible instances
2130 # cannot be automatically restarted.
2131 #
2132 # By default, this is set to true so an instance is
2133 # automatically restarted if it is terminated by Compute Engine.
2134 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
2135 # must be a number between 1 and the number of availability domains
2136 # specified in the spread placement policy attached to the instance.
2137 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
2138 # within the range of [90, 330] with the increment of 30, if unset, the
2139 # default behavior of host error recovery will be used.
2140 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
2141 &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
2142 # recovery of the Local Ssd state is attempted. Its value should be in
2143 # between 0 and 168 hours with hour granularity and the default value being 1
2144 # hour.
2145 # as a count of seconds and fractions of seconds at nanosecond
2146 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2147 # or &quot;month&quot;. Range is approximately 10,000 years.
2148 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2149 # Durations less than one second are represented with a 0
2150 # `seconds` field and a positive `nanos` field. Must be from 0
2151 # to 999,999,999 inclusive.
2152 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2153 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2154 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2155 },
2156 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
2157 # resources.
2158 # This field is for use by internal tools that use the public API.
2159 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
2160 # the instance termination action will be performed at the end of the run
2161 # duration.
2162 # as a count of seconds and fractions of seconds at nanosecond
2163 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2164 # or &quot;month&quot;. Range is approximately 10,000 years.
2165 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2166 # Durations less than one second are represented with a 0
2167 # `seconds` field and a positive `nanos` field. Must be from 0
2168 # to 999,999,999 inclusive.
2169 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2170 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2171 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2172 },
2173 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
2174 # on a sole-tenant node.
2175 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
2176 # affinity for more information.
2177 # Overrides reservationAffinity.
2178 { # Node Affinity: the configuration of desired nodes onto which this Instance
2179 # could be scheduled.
2180 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
2181 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
2182 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
2183 &quot;A String&quot;,
2184 ],
2185 },
2186 ],
2187 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
2188 # the default behavior is MIGRATE. Forpreemptible instances,
2189 # the default and only possible behavior is TERMINATE. For more
2190 # information, see
2191 # Set
2192 # VM host maintenance policy.
2193 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
2194 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
2195 # else, the Local SSD data will be preserved when the instance is stopped
2196 # at the end of the run duration/termination time.
2197 },
2198 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
2199 # instance creation or while the instance isstopped and
2200 # therefore, in a `TERMINATED` state. SeeInstance Life
2201 # Cycle for more information on the possible instance states.
2202 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
2203 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
2204 # Off and ACPI G3 Mechanical
2205 # Off for Standard VMs and 30 seconds for Spot VMs.
2206 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
2207 # termination action will be performed at the termination time.
2208 },
2209 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
2210 # service accounts are available to the instances that are created from
2211 # these properties. Use metadata queries to obtain the access tokens for
2212 # these instances.
2213 { # A service account.
2214 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
2215 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
2216 &quot;A String&quot;,
2217 ],
2218 },
2219 ],
2220 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
2221 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
2222 # default.
2223 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
2224 # default.
2225 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
2226 # default.
2227 },
2228 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
2229 # properties. The tags identify valid sources or targets for network
2230 # firewalls. The setTags method can modify this list of tags. Each tag within
2231 # the list must comply with RFC1035.
2232 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
2233 # the tags&#x27; contents and used for optimistic locking. The
2234 # fingerprint is initially generated by Compute Engine and changes after
2235 # every request to modify or update tags. You must always provide an
2236 # up-to-date fingerprint hash in order to update or change tags.
2237 #
2238 # To see the latest fingerprint, make get() request to the
2239 # instance.
2240 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
2241 # with RFC1035.
2242 &quot;A String&quot;,
2243 ],
2244 },
2245 &quot;workloadIdentityConfig&quot;: {
2246 &quot;identity&quot;: &quot;A String&quot;,
2247 &quot;identityCertificateEnabled&quot;: True or False,
2248 },
2249 },
2250 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the instance template resides. Only
2251 # applicable for regional resources.
2252 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this instance template. The server defines this
2253 # URL.
2254 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the template. You can provide this as a
2255 # partial or full URL to the resource. For example, the following are valid
2256 # values:
2257 #
2258 #
2259 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
2260 # - projects/project/zones/zone/instances/instance
2261 &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.
2262 # from a source instance.
2263 &quot;diskConfigs&quot;: [ # Attached disks configuration. If not provided, defaults are applied:
2264 # For boot disk and any other R/W disks, the source images for each disk
2265 # will be used. For read-only disks, they will be attached in read-only
2266 # mode. Local SSD disks will be created as blank volumes.
2267 { # A specification of the desired way to instantiate a disk in the instance
2268 # template when its created from a source instance.
2269 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
2270 # deleted (but not when the disk is detached from the instance).
2271 &quot;customImage&quot;: &quot;A String&quot;, # The custom source image to be used to restore this disk when instantiating
2272 # this instance template.
2273 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the device name of the disk to which the configurations apply to.
2274 &quot;instantiateFrom&quot;: &quot;A String&quot;, # Specifies whether to include the disk and what image to use. Possible
2275 # values are:
2276 #
2277 #
2278 # - source-image: to use the same image that was used to
2279 # create the source instance&#x27;s corresponding disk. Applicable to the boot
2280 # disk and additional read-write disks.
2281 # - source-image-family: to use the same image family that
2282 # was used to create the source instance&#x27;s corresponding disk. Applicable
2283 # to the boot disk and additional read-write disks.
2284 # - custom-image: to use a user-provided image url for disk
2285 # creation. Applicable to the boot disk and additional read-write
2286 # disks.
2287 # - attach-read-only: to attach a read-only
2288 # disk. Applicable to read-only disks.
2289 # - do-not-include: to exclude a disk from the template.
2290 # Applicable to additional read-write disks, local SSDs, and read-only
2291 # disks.
2292 },
2293 ],
2294 },
2295 }
2296
2297 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2298 that if you must retry your request, the server will know to ignore the
2299 request if it has already been completed.
2300
2301 For example, consider a situation where you make an initial request and
2302 the request times out. If you make the request again with the same
2303 request ID, the server can check if original operation with the same
2304 request ID was received, and if so, will ignore the second request. This
2305 prevents clients from accidentally creating duplicate commitments.
2306
2307 The request ID must be
2308 a valid UUID with the exception that zero UUID is not supported
2309 (00000000-0000-0000-0000-000000000000).
2310 x__xgafv: string, V1 error format.
2311 Allowed values
2312 1 - v1 error format
2313 2 - v2 error format
2314
2315 Returns:
2316 An object of the form:
2317
2318 { # Represents an Operation resource.
2319 #
2320 # Google Compute Engine has three Operation resources:
2321 #
2322 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
2323 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
2324 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
2325 #
2326 # You can use an operation resource to manage asynchronous API requests.
2327 # For more information, readHandling
2328 # API responses.
2329 #
2330 # Operations can be global, regional or zonal.
2331 #
2332 # - For global operations, use the `globalOperations`
2333 # resource.
2334 # - For regional operations, use the
2335 # `regionOperations` resource.
2336 # - For zonal operations, use
2337 # the `zoneOperations` resource.
2338 #
2339 #
2340 #
2341 # For more information, read
2342 # Global, Regional, and Zonal Resources.
2343 #
2344 # Note that completed Operation resources have a limited
2345 # retention period.
2346 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2347 # Not present otherwise.
2348 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2349 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2350 # set when the operation is created.
2351 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2352 # text format.
2353 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2354 # this field will be populated.
2355 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2356 # operation.
2357 {
2358 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2359 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2360 # details. There is a set of defined message types to use for providing
2361 # details.The syntax depends on the error code. For example,
2362 # QuotaExceededInfo will have details when the error code is
2363 # QUOTA_EXCEEDED.
2364 {
2365 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2366 #
2367 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2368 # is not enabled:
2369 #
2370 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2371 # &quot;domain&quot;: &quot;googleapis.com&quot;
2372 # &quot;metadata&quot;: {
2373 # &quot;resource&quot;: &quot;projects/123&quot;,
2374 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2375 # }
2376 # }
2377 #
2378 # This response indicates that the pubsub.googleapis.com API is not enabled.
2379 #
2380 # Example of an error that is returned when attempting to create a Spanner
2381 # instance in a region that is out of stock:
2382 #
2383 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2384 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2385 # &quot;metadata&quot;: {
2386 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2387 # }
2388 # }
2389 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2390 # is typically the registered service name of the tool or product that
2391 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2392 # generated by some common infrastructure, the error domain must be a
2393 # globally unique value that identifies the infrastructure. For Google API
2394 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2395 &quot;metadatas&quot;: { # Additional structured details about this error.
2396 #
2397 # Keys must match a regular expression of `a-z+` but should
2398 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2399 # length. When identifying the current value of an exceeded limit, the units
2400 # should be contained in the key, not the value. For example, rather than
2401 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2402 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2403 # instances that can be created in a single (batch) request.
2404 &quot;a_key&quot;: &quot;A String&quot;,
2405 },
2406 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2407 # proximate cause of the error. Error reasons are unique within a particular
2408 # domain of errors. This should be at most 63 characters and match a
2409 # regular expression of `A-Z+[A-Z0-9]`, which represents
2410 # UPPER_SNAKE_CASE.
2411 },
2412 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2413 #
2414 # For example, if a quota check failed with an error indicating the calling
2415 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2416 # directly to the right place in the developer console to flip the bit.
2417 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2418 { # Describes a URL link.
2419 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2420 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2421 },
2422 ],
2423 },
2424 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2425 # which can be attached to an RPC error.
2426 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2427 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2428 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2429 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2430 },
2431 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2432 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2433 &quot;a_key&quot;: &quot;A String&quot;,
2434 },
2435 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2436 # type or metric.
2437 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2438 # or metric.
2439 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2440 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2441 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2442 },
2443 },
2444 ],
2445 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2446 # This property is optional.
2447 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2448 },
2449 ],
2450 },
2451 &quot;getVersionOperationMetadata&quot;: {
2452 &quot;inlineSbomInfo&quot;: {
2453 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2454 # appropriate identifiers.
2455 &quot;a_key&quot;: &quot;A String&quot;,
2456 },
2457 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2458 # identifiers.
2459 &quot;a_key&quot;: &quot;A String&quot;,
2460 },
2461 },
2462 },
2463 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2464 # message that was returned, such as `NOT FOUND`.
2465 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2466 # status code that was returned. For example, a `404` means the
2467 # resource was not found.
2468 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2469 # defined by the server.
2470 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2471 # This value is inRFC3339
2472 # text format.
2473 &quot;instancesBulkInsertOperationMetadata&quot;: {
2474 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2475 # Example key: zones/us-central1-a
2476 &quot;a_key&quot;: {
2477 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2478 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2479 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2480 # error.
2481 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2482 # if the flow is rolling forward or rolling back.
2483 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2484 },
2485 },
2486 },
2487 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2488 # Operation resources.
2489 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2490 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2491 # group of operations results from a `bulkInsert` API request.
2492 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2493 # `update`, or `delete`, and so on.
2494 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2495 # There is no requirement that this be linear or support any granularity of
2496 # operations. This should not be used to guess when the operation will be
2497 # complete. This number should monotonically increase as the operation
2498 # progresses.
2499 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2500 # applicable when performing regional operations.
2501 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2502 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2503 # this field will contain information on all underlying zonal actions and
2504 # their state.
2505 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2506 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2507 # Example key: zones/us-central1-a
2508 &quot;a_key&quot;: {
2509 &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
2510 # populated.
2511 # different programming environments, including REST APIs and RPC APIs. It is
2512 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2513 # three pieces of data: error code, error message, and error details.
2514 #
2515 # You can find out more about this error model and how to work with it in the
2516 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2517 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2518 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2519 # message types for APIs to use.
2520 {
2521 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2522 },
2523 ],
2524 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2525 # user-facing error message should be localized and sent in the
2526 # google.rpc.Status.details field, or localized by the client.
2527 },
2528 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2529 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2530 },
2531 },
2532 },
2533 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2534 # This value is inRFC3339
2535 # text format.
2536 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2537 # following:
2538 # `PENDING`, `RUNNING`, or `DONE`.
2539 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2540 # operation.
2541 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2542 # of the target resource.
2543 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2544 # operations related to creating a snapshot, this points to the disk
2545 # that the snapshot was created from.
2546 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2547 # `[email protected]` or
2548 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2549 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2550 # operation, this field will be populated.
2551 {
2552 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2553 # Engine returns NO_RESULTS_ON_PAGE if there
2554 # are no results in the response.
2555 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2556 # value format. For example:
2557 #
2558 # &quot;data&quot;: [
2559 # {
2560 # &quot;key&quot;: &quot;scope&quot;,
2561 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2562 # }
2563 {
2564 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2565 # returned. For example, for warnings where there are no results in a list
2566 # request for a particular zone, this key might be scope and
2567 # the key value might be the zone name. Other examples might be a key
2568 # indicating a deprecated resource and a suggested replacement, or a
2569 # warning about invalid network settings (for example, if an instance
2570 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2571 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2572 },
2573 ],
2574 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2575 },
2576 ],
2577 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2578 # applicable when performing per-zone operations.
2579 }</pre>
2580 </div>
2581
2582 <div class="method">
2583 <code class="details" id="list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
2584 <pre>Retrieves a list of instance templates that are contained within the
2585 specified project and region.
2586
2587 Args:
2588 project: string, Project ID for this request. (required)
2589 region: string, The name of the regions for this request. (required)
2590 filter: string, A filter expression that filters resources listed in the response. Most
2591 Compute resources support two types of filter expressions:
2592 expressions that support regular expressions and expressions that follow
2593 API improvement proposal AIP-160.
2594 These two types of filter expressions cannot be mixed in one request.
2595
2596 If you want to use AIP-160, your expression must specify the field name, an
2597 operator, and the value that you want to use for filtering. The value
2598 must be a string, a number, or a boolean. The operator
2599 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
2600
2601 For example, if you are filtering Compute Engine instances, you can
2602 exclude instances named `example-instance` by specifying
2603 `name != example-instance`.
2604
2605 The `:*` comparison can be used to test whether a key has been defined.
2606 For example, to find all objects with `owner` label use:
2607 ```
2608 labels.owner:*
2609 ```
2610
2611 You can also filter nested fields. For example, you could specify
2612 `scheduling.automaticRestart = false` to include instances only
2613 if they are not scheduled for automatic restarts. You can use filtering
2614 on nested fields to filter based onresource labels.
2615
2616 To filter on multiple expressions, provide each separate expression within
2617 parentheses. For example:
2618 ```
2619 (scheduling.automaticRestart = true)
2620 (cpuPlatform = &quot;Intel Skylake&quot;)
2621 ```
2622 By default, each expression is an `AND` expression. However, you
2623 can include `AND` and `OR` expressions explicitly.
2624 For example:
2625 ```
2626 (cpuPlatform = &quot;Intel Skylake&quot;) OR
2627 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
2628 (scheduling.automaticRestart = true)
2629 ```
2630
2631 If you want to use a regular expression, use the `eq` (equal) or `ne`
2632 (not equal) operator against a single un-parenthesized expression with or
2633 without quotes or against multiple parenthesized expressions. Examples:
2634
2635 `fieldname eq unquoted literal`
2636 `fieldname eq &#x27;single quoted literal&#x27;`
2637 `fieldname eq &quot;double quoted literal&quot;`
2638 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
2639
2640 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
2641 The literal value must match the entire field.
2642
2643 For example, to filter for instances that do not end with name &quot;instance&quot;,
2644 you would use `name ne .*instance`.
2645
2646 You cannot combine constraints on multiple fields using regular
2647 expressions.
2648 maxResults: integer, The maximum number of results per page that should be returned.
2649 If the number of available results is larger than `maxResults`,
2650 Compute Engine returns a `nextPageToken` that can be used to get
2651 the next page of results in subsequent list requests. Acceptable values are
2652 `0` to `500`, inclusive. (Default: `500`)
2653 orderBy: string, Sorts list results by a certain order. By default, results
2654 are returned in alphanumerical order based on the resource name.
2655
2656 You can also sort results in descending order based on the creation
2657 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
2658 results based on the `creationTimestamp` field in
2659 reverse chronological order (newest result first). Use this to sort
2660 resources like operations so that the newest operation is returned first.
2661
2662 Currently, only sorting by `name` or
2663 `creationTimestamp desc` is supported.
2664 pageToken: string, Specifies a page token to use. Set `pageToken` to the
2665 `nextPageToken` returned by a previous list request to get
2666 the next page of results.
2667 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
2668 of failure. The default value is false.
2669
2670 For example, when partial success behavior is enabled, aggregatedList for a
2671 single zone scope either returns all resources in the zone or no resources,
2672 with an error code.
2673 x__xgafv: string, V1 error format.
2674 Allowed values
2675 1 - v1 error format
2676 2 - v2 error format
2677
2678 Returns:
2679 An object of the form:
2680
2681 { # A list of instance templates.
2682 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
2683 &quot;items&quot;: [ # A list of InstanceTemplate resources.
2684 { # Represents an Instance Template resource.
2685 #
2686 # Google Compute Engine has two Instance Template resources:
2687 #
2688 # * [Global](/compute/docs/reference/rest/v1/instanceTemplates)
2689 # * [Regional](/compute/docs/reference/rest/v1/regionInstanceTemplates)
2690 #
2691 # You can reuse a global instance template in
2692 # different regions whereas you can use a regional instance template in a
2693 # specified region only. If you want to reduce cross-region dependency or
2694 # achieve data residency, use a regional instance template.
2695 #
2696 # To create VMs, managed instance groups, and reservations, you can use either
2697 # global or regional instance templates.
2698 #
2699 # For more information, readInstance Templates.
2700 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this instance template inRFC3339
2701 # text format.
2702 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
2703 # create the resource.
2704 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this instance template. The server
2705 # defines this identifier.
2706 &quot;kind&quot;: &quot;compute#instanceTemplate&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplate for instance templates.
2707 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
2708 # The name must be 1-63 characters long, and comply withRFC1035.
2709 # Specifically, the name must be 1-63 characters long and match the regular
2710 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
2711 # character must be a lowercase letter, and all following characters must be
2712 # a dash, lowercase letter, or digit, except the last character, which cannot
2713 # be a dash.
2714 &quot;properties&quot;: { # The instance properties for this instance template.
2715 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
2716 # Note that for MachineImage, this is not supported yet.
2717 # Options that would traditionally be configured in a BIOS belong
2718 # here. Features that require operating system support may have
2719 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
2720 # disabled).
2721 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
2722 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
2723 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
2724 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
2725 # multithreading (SMT) set this to 1. If unset, the maximum number
2726 # of threads supported per core by the underlying processor is
2727 # assumed.
2728 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
2729 # Supported modes include:
2730 # * ALL_CORE_MAX
2731 #
2732 # Using empty string or not setting this field will use the platform-specific
2733 # default turbo mode.
2734 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
2735 # the number of threads per core to compute the total number of virtual
2736 # CPUs to expose to the instance. If unset, the number of cores is
2737 # inferred from the instance&#x27;s nominal CPU count and the underlying
2738 # platform&#x27;s SMT width.
2739 },
2740 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
2741 # source IP addresses other than their own and receive packets with
2742 # destination IP addresses other than their own. If these instances will be
2743 # used as an IP gateway or it will be set as the next-hop in a Route
2744 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
2745 # documentation for more information.
2746 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
2747 # Note that for MachineImage, this is not supported yet.
2748 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
2749 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
2750 },
2751 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
2752 # properties.
2753 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
2754 # from these properties.
2755 { # An instance-attached disk resource.
2756 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
2757 # or X86_64.
2758 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
2759 # deleted (but not when the disk is detached from the instance).
2760 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
2761 # partition of the disk for its root filesystem.
2762 &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
2763 # running within the instance. This name can be used to reference the device
2764 # for mounting, resizing, and so on, from within the instance.
2765 #
2766 # If not specified, the server chooses a default device name to apply to this
2767 # disk, in the form persistent-disk-x, where x is a number
2768 # assigned by Google Compute Engine. This field is only applicable for
2769 # persistent disks.
2770 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
2771 # encryption key.
2772 #
2773 # If you are creating a new disk, this field encrypts the new disk using
2774 # an encryption key that you provide. If you are attaching an existing
2775 # disk that is already encrypted, this field decrypts the disk using
2776 # the customer-supplied encryption key.
2777 #
2778 # If you encrypt a disk using a customer-supplied key, you must provide the
2779 # same key again when you attempt to use this resource at a later time. For
2780 # example, you must provide the key when you create a snapshot or an image
2781 # from the disk or when you attach the disk to a virtual machine instance.
2782 #
2783 # If you do not provide an encryption key, then the disk will be encrypted
2784 # using an automatically generated key and you do not need to provide a key
2785 # to use the disk later.
2786 #
2787 # Note:
2788 #
2789 # Instance templates do not storecustomer-supplied
2790 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
2791 #
2792 # You cannot create VMs that have disks with customer-supplied keys using
2793 # the bulk
2794 # insert method.
2795 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2796 # For example:
2797 #
2798 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2799 # key_region/cryptoKeys/key
2800 #
2801 # The fully-qualifed key name may be returned for resource GET requests. For
2802 # example:
2803 #
2804 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2805 # key_region/cryptoKeys/key
2806 # /cryptoKeyVersions/1
2807 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2808 # key. If absent, the Compute Engine default service account is used.
2809 # For example:
2810 #
2811 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2812 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2813 # encryption key, encoded in RFC
2814 # 4648 base64 to either encrypt or decrypt this resource. You can
2815 # provide either the rawKey or thersaEncryptedKey.
2816 # For example:
2817 #
2818 # &quot;rawKey&quot;:
2819 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2820 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2821 # customer-supplied encryption key to either encrypt or decrypt this
2822 # resource. You can provide either the rawKey or thersaEncryptedKey.
2823 # For example:
2824 #
2825 # &quot;rsaEncryptedKey&quot;:
2826 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2827 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2828 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2829 #
2830 # The key must meet the following requirements before you can provide it to
2831 # Compute Engine:
2832 #
2833 # 1. The key is wrapped using a RSA public key certificate provided by
2834 # Google.
2835 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2836 # encoding.
2837 #
2838 # Gets the RSA public key certificate provided by Google at:
2839 #
2840 #
2841 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2842 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2843 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2844 # encryption key that protects this resource.
2845 },
2846 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
2847 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
2848 # currently attached to another instance. If you try to force attach a zonal
2849 # disk to an instance, you will receive an error.
2850 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2851 # only for bootable images. Read
2852 # Enabling guest operating system features to see a list of available
2853 # options.
2854 { # Guest OS features.
2855 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2856 # separate values. Set to one or more of the following values:
2857 #
2858 # - VIRTIO_SCSI_MULTIQUEUE
2859 # - WINDOWS
2860 # - MULTI_IP_SUBNET
2861 # - UEFI_COMPATIBLE
2862 # - GVNIC
2863 # - SEV_CAPABLE
2864 # - SUSPEND_RESUME_COMPATIBLE
2865 # - SEV_LIVE_MIGRATABLE_V2
2866 # - SEV_SNP_CAPABLE
2867 # - TDX_CAPABLE
2868 # - IDPF
2869 # - SNP_SVSM_CAPABLE
2870 # - CCA_CAPABLE
2871 #
2872 #
2873 # For more information, see
2874 # Enabling guest operating system features.
2875 },
2876 ],
2877 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
2878 # boot disk. If you have many disks attached to an instance, each
2879 # disk would have a unique index number.
2880 &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
2881 # alongside the new instance. Use initialization parameters to create boot
2882 # disks or local SSDs attached to the new instance.
2883 #
2884 # This property is mutually exclusive with the source property;
2885 # you can only define one or the other, but not both.
2886 # alongside the new instance. Use initialization parameters to create boot
2887 # disks or local SSDs attached to the new instance.
2888 #
2889 # This field is persisted and returned for instanceTemplate and not returned
2890 # in the context of instance.
2891 #
2892 # This property is mutually exclusive with the source property;
2893 # you can only define one or the other, but not both.
2894 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
2895 # arm64 or x86_64.
2896 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
2897 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
2898 # of the instance. If a disk with the same name already exists in the given
2899 # region, the existing disk is attached to the new instance and the
2900 # new disk is not created.
2901 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
2902 # 10 GB. If you specify a sourceImage, which is required for
2903 # boot disks, the default size is the size of the sourceImage.
2904 # If you do not specify a sourceImage, the default disk size
2905 # is 500 GB.
2906 &quot;diskType&quot;: &quot;A String&quot;,
2907 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
2908 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
2909 # persistent disks.
2910 &quot;a_key&quot;: &quot;A String&quot;,
2911 },
2912 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
2913 &quot;A String&quot;,
2914 ],
2915 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
2916 # is to use the existing disk.
2917 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
2918 # of I/O operations per second that the disk can handle. Values must be
2919 # between 10,000 and 120,000. For more details, see theExtreme persistent
2920 # disk documentation.
2921 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
2922 # number of throughput mb per second that the disk can handle. Values must
2923 # greater than or equal to 1.
2924 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
2925 # the URLs of the zones where the disk should be replicated to.
2926 # You must provide exactly two replica zones, and one zone must be the same
2927 # as the instance zone.
2928 &quot;A String&quot;,
2929 ],
2930 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
2931 # have the same definition as resource
2932 # manager tags. Keys and values can be either in numeric format,
2933 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
2934 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
2935 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
2936 # empty.
2937 &quot;a_key&quot;: &quot;A String&quot;,
2938 },
2939 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
2940 # Specified using the full or partial URL. For instance template, specify
2941 # only the resource policy name.
2942 &quot;A String&quot;,
2943 ],
2944 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
2945 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
2946 # is required.
2947 #
2948 # To create a disk with one of the public operating system
2949 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
2950 #
2951 # projects/debian-cloud/global/images/family/debian-9
2952 #
2953 #
2954 # Alternatively, use a specific version of a public operating system image:
2955 #
2956 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
2957 #
2958 #
2959 # To create a disk with a custom image that you created, specify the
2960 # image name in the following format:
2961 #
2962 # global/images/my-custom-image
2963 #
2964 #
2965 # You can also specify a custom image by its image family, which returns
2966 # the latest version of the image in that family. Replace the image name
2967 # with family/family-name:
2968 #
2969 # global/images/family/my-image-family
2970 #
2971 #
2972 # If the source image is deleted later, this field will not be set.
2973 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
2974 # encryption key of the source image. Required if the source image is
2975 # protected by a customer-supplied encryption key.
2976 #
2977 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
2978 # encryption keys, so you cannot create disks for instances in a managed instance group if the
2979 # source images are encrypted with your own keys.
2980 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2981 # For example:
2982 #
2983 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2984 # key_region/cryptoKeys/key
2985 #
2986 # The fully-qualifed key name may be returned for resource GET requests. For
2987 # example:
2988 #
2989 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2990 # key_region/cryptoKeys/key
2991 # /cryptoKeyVersions/1
2992 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2993 # key. If absent, the Compute Engine default service account is used.
2994 # For example:
2995 #
2996 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2997 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2998 # encryption key, encoded in RFC
2999 # 4648 base64 to either encrypt or decrypt this resource. You can
3000 # provide either the rawKey or thersaEncryptedKey.
3001 # For example:
3002 #
3003 # &quot;rawKey&quot;:
3004 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3005 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3006 # customer-supplied encryption key to either encrypt or decrypt this
3007 # resource. You can provide either the rawKey or thersaEncryptedKey.
3008 # For example:
3009 #
3010 # &quot;rsaEncryptedKey&quot;:
3011 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3012 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3013 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3014 #
3015 # The key must meet the following requirements before you can provide it to
3016 # Compute Engine:
3017 #
3018 # 1. The key is wrapped using a RSA public key certificate provided by
3019 # Google.
3020 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3021 # encoding.
3022 #
3023 # Gets the RSA public key certificate provided by Google at:
3024 #
3025 #
3026 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3027 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3028 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3029 # encryption key that protects this resource.
3030 },
3031 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
3032 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
3033 # is required.
3034 #
3035 # To create a disk with a snapshot that you created, specify the
3036 # snapshot name in the following format:
3037 #
3038 # global/snapshots/my-backup
3039 #
3040 #
3041 # If the source snapshot is deleted later, this field will not be set.
3042 #
3043 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
3044 # an image instead when you create VMs using
3045 # the bulk
3046 # insert method.
3047 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3048 # encryption key of the source snapshot.
3049 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3050 # For example:
3051 #
3052 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3053 # key_region/cryptoKeys/key
3054 #
3055 # The fully-qualifed key name may be returned for resource GET requests. For
3056 # example:
3057 #
3058 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3059 # key_region/cryptoKeys/key
3060 # /cryptoKeyVersions/1
3061 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3062 # key. If absent, the Compute Engine default service account is used.
3063 # For example:
3064 #
3065 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3066 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3067 # encryption key, encoded in RFC
3068 # 4648 base64 to either encrypt or decrypt this resource. You can
3069 # provide either the rawKey or thersaEncryptedKey.
3070 # For example:
3071 #
3072 # &quot;rawKey&quot;:
3073 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3074 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3075 # customer-supplied encryption key to either encrypt or decrypt this
3076 # resource. You can provide either the rawKey or thersaEncryptedKey.
3077 # For example:
3078 #
3079 # &quot;rsaEncryptedKey&quot;:
3080 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3081 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3082 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3083 #
3084 # The key must meet the following requirements before you can provide it to
3085 # Compute Engine:
3086 #
3087 # 1. The key is wrapped using a RSA public key certificate provided by
3088 # Google.
3089 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3090 # encoding.
3091 #
3092 # Gets the RSA public key certificate provided by Google at:
3093 #
3094 #
3095 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3096 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3097 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3098 # encryption key that protects this resource.
3099 },
3100 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3101 # this as a partial or full URL to the resource. For example, the following
3102 # are valid values:
3103 #
3104 #
3105 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3106 # - projects/project/zones/zone/storagePools/storagePool
3107 # - zones/zone/storagePools/storagePool
3108 },
3109 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
3110 # either SCSI or NVME. For most machine types, the
3111 # default is SCSI. Local SSDs can use either NVME or SCSI.
3112 # In certain configurations, persistent disks can use NVMe. For more
3113 # information, seeAbout
3114 # persistent disks.
3115 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
3116 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
3117 &quot;A String&quot;,
3118 ],
3119 &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
3120 # in READ_WRITE mode.
3121 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
3122 # field is set to PRESERVED if the LocalSSD data has been saved
3123 # to a persistent location by customer request. (see the
3124 # discard_local_ssd option on Stop/Suspend).
3125 # Read-only in the api.
3126 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
3127 # these are public keys which are safe to store in public
3128 &quot;dbs&quot;: [ # The Key Database (db).
3129 {
3130 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3131 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3132 },
3133 ],
3134 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
3135 {
3136 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3137 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3138 },
3139 ],
3140 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
3141 {
3142 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3143 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3144 },
3145 ],
3146 &quot;pk&quot;: { # The Platform Key (PK).
3147 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3148 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3149 },
3150 },
3151 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
3152 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3153 # is required.
3154 #
3155 # If desired, you can also attach existing non-root persistent disks using
3156 # this property. This field is only applicable for persistent disks.
3157 #
3158 # Note that for InstanceTemplate, specify the disk name for zonal disk,
3159 # and the URL for regional disk.
3160 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
3161 },
3162 ],
3163 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
3164 # created from these properties.
3165 { # A specification of the type and number of accelerator cards attached to the
3166 # instance.
3167 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
3168 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
3169 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
3170 # If you are creating an instance template, specify only the
3171 # accelerator name.
3172 # See GPUs on Compute Engine
3173 # for a full list of accelerator types.
3174 },
3175 ],
3176 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
3177 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
3178 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
3179 &quot;a_key&quot;: &quot;A String&quot;,
3180 },
3181 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
3182 # properties.
3183 # This field only accepts a machine type name, for example `n2-standard-4`.
3184 # If you use the machine type full or partial URL, for example
3185 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
3186 # the request will result in an `INTERNAL_ERROR`.
3187 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
3188 # these properties. These pairs can consist of custom metadata or predefined
3189 # keys. SeeProject and
3190 # instance metadata for more information.
3191 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
3192 # the metadata&#x27;s contents and used for optimistic locking. The
3193 # fingerprint is initially generated by Compute Engine and changes after
3194 # every request to modify or update metadata. You must always provide an
3195 # up-to-date fingerprint hash in order to update or change metadata,
3196 # otherwise the request will fail with error412 conditionNotMet.
3197 #
3198 # To see the latest fingerprint, make a get() request to
3199 # retrieve the resource.
3200 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
3201 # less than 512 KB.
3202 { # Metadata
3203 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
3204 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
3205 # This is reflected as part of a URL in the metadata server. Additionally, to
3206 # avoid ambiguity, keys must not conflict with any other metadata keys
3207 # for the project.
3208 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
3209 # have meaning as interpreted by the image running in the instance. The
3210 # only restriction placed on values is that their size must be less than
3211 # or equal to 262144 bytes (256 KiB).
3212 },
3213 ],
3214 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
3215 # for metadata.
3216 },
3217 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
3218 # scheduled on the specified or newer cpu/platform. Applicable values are the
3219 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
3220 # information, read Specifying a
3221 # Minimum CPU Platform.
3222 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
3223 { # A network interface resource attached to an instance.
3224 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
3225 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
3226 # no external internet access.
3227 { # An access configuration attached to an instance&#x27;s network interface.
3228 # Only one access config per instance is supported.
3229 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
3230 # The first IPv6 address of the external IPv6 range associated
3231 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
3232 # use a static external IP address, it must be unused and in the same region
3233 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3234 # assign an external IPv6 address from the instance&#x27;s subnetwork.
3235 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
3236 # external IPv6 range.
3237 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
3238 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
3239 # (IPv4), the default and recommended name is External NAT, but
3240 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
3241 # recommend name is External IPv6.
3242 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
3243 # address associated with this instance. Specify an unused static
3244 # external IP address available to the project or leave this field undefined
3245 # to use an IP from a shared ephemeral IP address pool. If you specify a
3246 # static external IP address, it must live in the same region as the zone of
3247 # the instance.
3248 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
3249 # configuration and can only take the following values: PREMIUM,STANDARD.
3250 #
3251 # If an AccessConfig is specified without a valid external IP address, an
3252 # ephemeral IP will be created with this networkTier.
3253 #
3254 # If an AccessConfig with a valid external IP address is specified, it must
3255 # match that of the networkTier associated with the Address resource owning
3256 # that IP.
3257 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
3258 #
3259 # 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
3260 # first IP in associated external IPv6 range.
3261 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
3262 # config.
3263 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
3264 # external IP address of the instance to a DNS domain name.
3265 #
3266 # This field is not used in ipv6AccessConfig. A default PTR
3267 # record will be created if the VM has external IPv6 range associated.
3268 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
3269 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
3270 },
3271 ],
3272 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
3273 # You can only specify this field for network interfaces in VPC networks.
3274 { # An alias IP range attached to an instance&#x27;s network interface.
3275 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
3276 # must belong to the specified subnetwork and cannot contain IP addresses
3277 # reserved by system or used by other network interfaces. This range may be
3278 # 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).
3279 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
3280 # alias range. If not specified, the primary range of the subnetwork is used.
3281 },
3282 ],
3283 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
3284 # You can only specify this field for network interfaces in VPC networks.
3285 { # An alias IP range attached to an instance&#x27;s network interface.
3286 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
3287 # must belong to the specified subnetwork and cannot contain IP addresses
3288 # reserved by system or used by other network interfaces. This range may be
3289 # 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).
3290 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
3291 # alias range. If not specified, the primary range of the subnetwork is used.
3292 },
3293 ],
3294 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
3295 # with network_attachment.
3296 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
3297 # This field will be ignored when inserting an Instance or
3298 # adding a NetworkInterface. An up-to-date
3299 # 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.
3300 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
3301 # or not. If enabled, also indicates the version of IGMP supported.
3302 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
3303 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
3304 # one IPv6 access config, DIRECT_IPV6, is supported. If there
3305 # is no ipv6AccessConfig specified, then this instance will
3306 # have no external IPv6 Internet access.
3307 { # An access configuration attached to an instance&#x27;s network interface.
3308 # Only one access config per instance is supported.
3309 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
3310 # The first IPv6 address of the external IPv6 range associated
3311 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
3312 # use a static external IP address, it must be unused and in the same region
3313 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3314 # assign an external IPv6 address from the instance&#x27;s subnetwork.
3315 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
3316 # external IPv6 range.
3317 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
3318 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
3319 # (IPv4), the default and recommended name is External NAT, but
3320 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
3321 # recommend name is External IPv6.
3322 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
3323 # address associated with this instance. Specify an unused static
3324 # external IP address available to the project or leave this field undefined
3325 # to use an IP from a shared ephemeral IP address pool. If you specify a
3326 # static external IP address, it must live in the same region as the zone of
3327 # the instance.
3328 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
3329 # configuration and can only take the following values: PREMIUM,STANDARD.
3330 #
3331 # If an AccessConfig is specified without a valid external IP address, an
3332 # ephemeral IP will be created with this networkTier.
3333 #
3334 # If an AccessConfig with a valid external IP address is specified, it must
3335 # match that of the networkTier associated with the Address resource owning
3336 # that IP.
3337 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
3338 #
3339 # 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
3340 # first IP in associated external IPv6 range.
3341 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
3342 # config.
3343 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
3344 # external IP address of the instance to a DNS domain name.
3345 #
3346 # This field is not used in ipv6AccessConfig. A default PTR
3347 # record will be created if the VM has external IPv6 range associated.
3348 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
3349 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
3350 },
3351 ],
3352 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
3353 # accessed from the Internet. This field is always inherited from its
3354 # subnetwork.
3355 #
3356 # Valid only if stackType is IPV4_IPV6.
3357 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
3358 # use a static internal IP address, it must be unused and in the same region
3359 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3360 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
3361 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
3362 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
3363 # server. For a VM, the network interface uses the nicN naming
3364 # format. Where N is a value between 0 and7. The default interface value is nic0.
3365 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
3366 # instance, if neither the network nor the subnetwork is specified, the
3367 # default network global/networks/default is used. If the
3368 # selected project doesn&#x27;t have the default network, you must specify a
3369 # network or subnet. If the network is not specified but the subnetwork is
3370 # specified, the network is inferred.
3371 #
3372 # If you specify this property, you can specify the network as
3373 # a full or partial URL. For example, the following are all valid URLs:
3374 #
3375 #
3376 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
3377 # - projects/project/global/networks/network
3378 # - global/networks/default
3379 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
3380 # to in the following format:
3381 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
3382 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
3383 # interface. If not specified by the user, an unused internal IP is
3384 # assigned by the system.
3385 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
3386 # VirtioNet.
3387 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
3388 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
3389 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
3390 # if not specified by the users.
3391 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
3392 # interface. Can only be used with network_attachment. It is not possible to
3393 # use on its own however, network_attachment can be used without
3394 # service_class_id.
3395 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
3396 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
3397 #
3398 # This field can be both set at instance creation and update network
3399 # interface operations.
3400 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
3401 # resource is inlegacy
3402 # mode, do not specify this field. If the network is in auto subnet
3403 # mode, specifying the subnetwork is optional. If the network is in custom
3404 # subnet mode, specifying the subnetwork is required. If you specify this
3405 # field, you can specify the subnetwork as a full or partial URL. For
3406 # example, the following are all valid URLs:
3407 #
3408 #
3409 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
3410 # - regions/region/subnetworks/subnetwork
3411 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
3412 # from 2 to 255 inclusively.
3413 },
3414 ],
3415 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
3416 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
3417 },
3418 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
3419 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
3420 # Note that for MachineImage, this is not supported yet.
3421 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
3422 # Note that for MachineImage, this is not supported yet.
3423 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
3424 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
3425 # Consuming reserved instances for examples.
3426 &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
3427 # the name of your reservation as its value.
3428 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
3429 # either a name to a reservation in the same project or
3430 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
3431 # shared reservation in the same zone but in a different project.
3432 &quot;A String&quot;,
3433 ],
3434 },
3435 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
3436 # have the same definition as resource
3437 # manager tags. Keys and values can be either in numeric format,
3438 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3439 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3440 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
3441 # PATCH) when empty.
3442 &quot;a_key&quot;: &quot;A String&quot;,
3443 },
3444 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
3445 # these properties.
3446 # Note that for MachineImage, this is not supported yet.
3447 &quot;A String&quot;,
3448 ],
3449 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
3450 # these properties.
3451 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
3452 # terminated by Compute Engine (not terminated by a user). You can only set
3453 # the automatic restart option for standard instances.Preemptible instances
3454 # cannot be automatically restarted.
3455 #
3456 # By default, this is set to true so an instance is
3457 # automatically restarted if it is terminated by Compute Engine.
3458 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
3459 # must be a number between 1 and the number of availability domains
3460 # specified in the spread placement policy attached to the instance.
3461 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
3462 # within the range of [90, 330] with the increment of 30, if unset, the
3463 # default behavior of host error recovery will be used.
3464 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
3465 &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
3466 # recovery of the Local Ssd state is attempted. Its value should be in
3467 # between 0 and 168 hours with hour granularity and the default value being 1
3468 # hour.
3469 # as a count of seconds and fractions of seconds at nanosecond
3470 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3471 # or &quot;month&quot;. Range is approximately 10,000 years.
3472 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3473 # Durations less than one second are represented with a 0
3474 # `seconds` field and a positive `nanos` field. Must be from 0
3475 # to 999,999,999 inclusive.
3476 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3477 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3478 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3479 },
3480 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
3481 # resources.
3482 # This field is for use by internal tools that use the public API.
3483 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
3484 # the instance termination action will be performed at the end of the run
3485 # duration.
3486 # as a count of seconds and fractions of seconds at nanosecond
3487 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3488 # or &quot;month&quot;. Range is approximately 10,000 years.
3489 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3490 # Durations less than one second are represented with a 0
3491 # `seconds` field and a positive `nanos` field. Must be from 0
3492 # to 999,999,999 inclusive.
3493 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3494 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3495 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3496 },
3497 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
3498 # on a sole-tenant node.
3499 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
3500 # affinity for more information.
3501 # Overrides reservationAffinity.
3502 { # Node Affinity: the configuration of desired nodes onto which this Instance
3503 # could be scheduled.
3504 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
3505 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
3506 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
3507 &quot;A String&quot;,
3508 ],
3509 },
3510 ],
3511 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
3512 # the default behavior is MIGRATE. Forpreemptible instances,
3513 # the default and only possible behavior is TERMINATE. For more
3514 # information, see
3515 # Set
3516 # VM host maintenance policy.
3517 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
3518 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
3519 # else, the Local SSD data will be preserved when the instance is stopped
3520 # at the end of the run duration/termination time.
3521 },
3522 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
3523 # instance creation or while the instance isstopped and
3524 # therefore, in a `TERMINATED` state. SeeInstance Life
3525 # Cycle for more information on the possible instance states.
3526 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
3527 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
3528 # Off and ACPI G3 Mechanical
3529 # Off for Standard VMs and 30 seconds for Spot VMs.
3530 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
3531 # termination action will be performed at the termination time.
3532 },
3533 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
3534 # service accounts are available to the instances that are created from
3535 # these properties. Use metadata queries to obtain the access tokens for
3536 # these instances.
3537 { # A service account.
3538 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
3539 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
3540 &quot;A String&quot;,
3541 ],
3542 },
3543 ],
3544 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
3545 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
3546 # default.
3547 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
3548 # default.
3549 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
3550 # default.
3551 },
3552 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
3553 # properties. The tags identify valid sources or targets for network
3554 # firewalls. The setTags method can modify this list of tags. Each tag within
3555 # the list must comply with RFC1035.
3556 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
3557 # the tags&#x27; contents and used for optimistic locking. The
3558 # fingerprint is initially generated by Compute Engine and changes after
3559 # every request to modify or update tags. You must always provide an
3560 # up-to-date fingerprint hash in order to update or change tags.
3561 #
3562 # To see the latest fingerprint, make get() request to the
3563 # instance.
3564 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
3565 # with RFC1035.
3566 &quot;A String&quot;,
3567 ],
3568 },
3569 &quot;workloadIdentityConfig&quot;: {
3570 &quot;identity&quot;: &quot;A String&quot;,
3571 &quot;identityCertificateEnabled&quot;: True or False,
3572 },
3573 },
3574 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the region where the instance template resides. Only
3575 # applicable for regional resources.
3576 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this instance template. The server defines this
3577 # URL.
3578 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the template. You can provide this as a
3579 # partial or full URL to the resource. For example, the following are valid
3580 # values:
3581 #
3582 #
3583 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
3584 # - projects/project/zones/zone/instances/instance
3585 &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.
3586 # from a source instance.
3587 &quot;diskConfigs&quot;: [ # Attached disks configuration. If not provided, defaults are applied:
3588 # For boot disk and any other R/W disks, the source images for each disk
3589 # will be used. For read-only disks, they will be attached in read-only
3590 # mode. Local SSD disks will be created as blank volumes.
3591 { # A specification of the desired way to instantiate a disk in the instance
3592 # template when its created from a source instance.
3593 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
3594 # deleted (but not when the disk is detached from the instance).
3595 &quot;customImage&quot;: &quot;A String&quot;, # The custom source image to be used to restore this disk when instantiating
3596 # this instance template.
3597 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the device name of the disk to which the configurations apply to.
3598 &quot;instantiateFrom&quot;: &quot;A String&quot;, # Specifies whether to include the disk and what image to use. Possible
3599 # values are:
3600 #
3601 #
3602 # - source-image: to use the same image that was used to
3603 # create the source instance&#x27;s corresponding disk. Applicable to the boot
3604 # disk and additional read-write disks.
3605 # - source-image-family: to use the same image family that
3606 # was used to create the source instance&#x27;s corresponding disk. Applicable
3607 # to the boot disk and additional read-write disks.
3608 # - custom-image: to use a user-provided image url for disk
3609 # creation. Applicable to the boot disk and additional read-write
3610 # disks.
3611 # - attach-read-only: to attach a read-only
3612 # disk. Applicable to read-only disks.
3613 # - do-not-include: to exclude a disk from the template.
3614 # Applicable to additional read-write disks, local SSDs, and read-only
3615 # disks.
3616 },
3617 ],
3618 },
3619 },
3620 ],
3621 &quot;kind&quot;: &quot;compute#instanceTemplateList&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#instanceTemplatesListResponse for instance template
3622 # lists.
3623 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
3624 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
3625 # the query parameter pageToken in the next list request.
3626 # Subsequent list requests will have their own nextPageToken to
3627 # continue paging through the results.
3628 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
3629 &quot;warning&quot;: { # [Output Only] Informational warning message.
3630 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3631 # Engine returns NO_RESULTS_ON_PAGE if there
3632 # are no results in the response.
3633 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3634 # value format. For example:
3635 #
3636 # &quot;data&quot;: [
3637 # {
3638 # &quot;key&quot;: &quot;scope&quot;,
3639 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3640 # }
3641 {
3642 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3643 # returned. For example, for warnings where there are no results in a list
3644 # request for a particular zone, this key might be scope and
3645 # the key value might be the zone name. Other examples might be a key
3646 # indicating a deprecated resource and a suggested replacement, or a
3647 # warning about invalid network settings (for example, if an instance
3648 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3649 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3650 },
3651 ],
3652 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3653 },
3654 }</pre>
3655 </div>
3656
3657 <div class="method">
3658 <code class="details" id="list_next">list_next()</code>
3659 <pre>Retrieves the next page of results.
3660
3661 Args:
3662 previous_request: The request for the previous page. (required)
3663 previous_response: The response from the request for the previous page. (required)
3664
3665 Returns:
3666 A request object that you can call &#x27;execute()&#x27; on to request the next
3667 page. Returns None if there are no more items in the collection.
3668 </pre>
3669 </div>
3670
3671 </body></html>