Debian Codegraph @

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