Debian Codegraph @

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