Debian Codegraph @

docs/dyn/compute_alpha.machineImages.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.machineImages.html">machineImages</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, machineImage, requestId=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Deletes the specified machine image. Deleting a machine image is permanent</p>
83 <p class="toc_element">
84 <code><a href="#get">get(project, machineImage, x__xgafv=None)</a></code></p>
85 <p class="firstline">Returns the specified machine image.</p>
86 <p class="toc_element">
87 <code><a href="#getIamPolicy">getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Gets the access control policy for a resource. May be empty if no such</p>
89 <p class="toc_element">
90 <code><a href="#insert">insert(project, body=None, requestId=None, sourceInstance=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Creates a machine image in the specified project using the</p>
92 <p class="toc_element">
93 <code><a href="#list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
94 <p class="firstline">Retrieves a list of machine images that are contained within</p>
95 <p class="toc_element">
96 <code><a href="#list_next">list_next()</a></code></p>
97 <p class="firstline">Retrieves the next page of results.</p>
98 <p class="toc_element">
99 <code><a href="#setIamPolicy">setIamPolicy(project, resource, body=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Sets the access control policy on the specified resource.</p>
101 <p class="toc_element">
102 <code><a href="#setLabels">setLabels(project, resource, body=None, x__xgafv=None)</a></code></p>
103 <p class="firstline">Sets the labels on a machine image. To learn more about labels, read theLabeling</p>
104 <p class="toc_element">
105 <code><a href="#testIamPermissions">testIamPermissions(project, resource, body=None, x__xgafv=None)</a></code></p>
106 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
107 <h3>Method Details</h3>
108 <div class="method">
109 <code class="details" id="close">close()</code>
110 <pre>Close httplib2 connections.</pre>
111 </div>
112
113 <div class="method">
114 <code class="details" id="delete">delete(project, machineImage, requestId=None, x__xgafv=None)</code>
115 <pre>Deletes the specified machine image. Deleting a machine image is permanent
116 and cannot be undone.
117
118 Args:
119 project: string, Project ID for this request. (required)
120 machineImage: string, The name of the machine image to delete. (required)
121 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
122 that if you must retry your request, the server will know to ignore the
123 request if it has already been completed.
124
125 For example, consider a situation where you make an initial request and
126 the request times out. If you make the request again with the same
127 request ID, the server can check if original operation with the same
128 request ID was received, and if so, will ignore the second request. This
129 prevents clients from accidentally creating duplicate commitments.
130
131 The request ID must be
132 a valid UUID with the exception that zero UUID is not supported
133 (00000000-0000-0000-0000-000000000000).
134 x__xgafv: string, V1 error format.
135 Allowed values
136 1 - v1 error format
137 2 - v2 error format
138
139 Returns:
140 An object of the form:
141
142 { # Represents an Operation resource.
143 #
144 # Google Compute Engine has three Operation resources:
145 #
146 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
147 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
148 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
149 #
150 # You can use an operation resource to manage asynchronous API requests.
151 # For more information, readHandling
152 # API responses.
153 #
154 # Operations can be global, regional or zonal.
155 #
156 # - For global operations, use the `globalOperations`
157 # resource.
158 # - For regional operations, use the
159 # `regionOperations` resource.
160 # - For zonal operations, use
161 # the `zoneOperations` resource.
162 #
163 #
164 #
165 # For more information, read
166 # Global, Regional, and Zonal Resources.
167 #
168 # Note that completed Operation resources have a limited
169 # retention period.
170 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
171 # Not present otherwise.
172 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
173 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
174 # set when the operation is created.
175 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
176 # text format.
177 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
178 # this field will be populated.
179 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
180 # operation.
181 {
182 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
183 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
184 # details. There is a set of defined message types to use for providing
185 # details.The syntax depends on the error code. For example,
186 # QuotaExceededInfo will have details when the error code is
187 # QUOTA_EXCEEDED.
188 {
189 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
190 #
191 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
192 # is not enabled:
193 #
194 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
195 # &quot;domain&quot;: &quot;googleapis.com&quot;
196 # &quot;metadata&quot;: {
197 # &quot;resource&quot;: &quot;projects/123&quot;,
198 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
199 # }
200 # }
201 #
202 # This response indicates that the pubsub.googleapis.com API is not enabled.
203 #
204 # Example of an error that is returned when attempting to create a Spanner
205 # instance in a region that is out of stock:
206 #
207 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
208 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
209 # &quot;metadata&quot;: {
210 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
211 # }
212 # }
213 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
214 # is typically the registered service name of the tool or product that
215 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
216 # generated by some common infrastructure, the error domain must be a
217 # globally unique value that identifies the infrastructure. For Google API
218 # infrastructure, the error domain is &quot;googleapis.com&quot;.
219 &quot;metadatas&quot;: { # Additional structured details about this error.
220 #
221 # Keys must match a regular expression of `a-z+` but should
222 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
223 # length. When identifying the current value of an exceeded limit, the units
224 # should be contained in the key, not the value. For example, rather than
225 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
226 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
227 # instances that can be created in a single (batch) request.
228 &quot;a_key&quot;: &quot;A String&quot;,
229 },
230 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
231 # proximate cause of the error. Error reasons are unique within a particular
232 # domain of errors. This should be at most 63 characters and match a
233 # regular expression of `A-Z+[A-Z0-9]`, which represents
234 # UPPER_SNAKE_CASE.
235 },
236 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
237 #
238 # For example, if a quota check failed with an error indicating the calling
239 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
240 # directly to the right place in the developer console to flip the bit.
241 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
242 { # Describes a URL link.
243 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
244 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
245 },
246 ],
247 },
248 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
249 # which can be attached to an RPC error.
250 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
251 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
252 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
253 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
254 },
255 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
256 &quot;dimensions&quot;: { # The map holding related quota dimensions.
257 &quot;a_key&quot;: &quot;A String&quot;,
258 },
259 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
260 # type or metric.
261 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
262 # or metric.
263 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
264 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
265 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
266 },
267 },
268 ],
269 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
270 # This property is optional.
271 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
272 },
273 ],
274 },
275 &quot;getVersionOperationMetadata&quot;: {
276 &quot;inlineSbomInfo&quot;: {
277 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
278 # appropriate identifiers.
279 &quot;a_key&quot;: &quot;A String&quot;,
280 },
281 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
282 # identifiers.
283 &quot;a_key&quot;: &quot;A String&quot;,
284 },
285 },
286 },
287 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
288 # message that was returned, such as `NOT FOUND`.
289 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
290 # status code that was returned. For example, a `404` means the
291 # resource was not found.
292 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
293 # defined by the server.
294 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
295 # This value is inRFC3339
296 # text format.
297 &quot;instancesBulkInsertOperationMetadata&quot;: {
298 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
299 # Example key: zones/us-central1-a
300 &quot;a_key&quot;: {
301 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
302 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
303 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
304 # error.
305 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
306 # if the flow is rolling forward or rolling back.
307 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
308 },
309 },
310 },
311 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
312 # Operation resources.
313 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
314 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
315 # group of operations results from a `bulkInsert` API request.
316 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
317 # `update`, or `delete`, and so on.
318 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
319 # There is no requirement that this be linear or support any granularity of
320 # operations. This should not be used to guess when the operation will be
321 # complete. This number should monotonically increase as the operation
322 # progresses.
323 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
324 # applicable when performing regional operations.
325 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
326 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
327 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
328 # this field will contain information on all underlying zonal actions and
329 # their state.
330 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
331 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
332 # Example key: zones/us-central1-a
333 &quot;a_key&quot;: {
334 &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
335 # populated.
336 # different programming environments, including REST APIs and RPC APIs. It is
337 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
338 # three pieces of data: error code, error message, and error details.
339 #
340 # You can find out more about this error model and how to work with it in the
341 # [API Design Guide](https://cloud.google.com/apis/design/errors).
342 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
343 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
344 # message types for APIs to use.
345 {
346 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
347 },
348 ],
349 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
350 # user-facing error message should be localized and sent in the
351 # google.rpc.Status.details field, or localized by the client.
352 },
353 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
354 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
355 },
356 },
357 },
358 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
359 # This value is inRFC3339
360 # text format.
361 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
362 # following:
363 # `PENDING`, `RUNNING`, or `DONE`.
364 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
365 # operation.
366 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
367 # of the target resource.
368 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
369 # operations related to creating a snapshot, this points to the disk
370 # that the snapshot was created from.
371 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
372 # `[email protected]` or
373 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
374 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
375 # operation, this field will be populated.
376 {
377 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
378 # Engine returns NO_RESULTS_ON_PAGE if there
379 # are no results in the response.
380 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
381 # value format. For example:
382 #
383 # &quot;data&quot;: [
384 # {
385 # &quot;key&quot;: &quot;scope&quot;,
386 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
387 # }
388 {
389 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
390 # returned. For example, for warnings where there are no results in a list
391 # request for a particular zone, this key might be scope and
392 # the key value might be the zone name. Other examples might be a key
393 # indicating a deprecated resource and a suggested replacement, or a
394 # warning about invalid network settings (for example, if an instance
395 # attempts to perform IP forwarding but is not enabled for IP forwarding).
396 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
397 },
398 ],
399 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
400 },
401 ],
402 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
403 # applicable when performing per-zone operations.
404 }</pre>
405 </div>
406
407 <div class="method">
408 <code class="details" id="get">get(project, machineImage, x__xgafv=None)</code>
409 <pre>Returns the specified machine image.
410
411 Args:
412 project: string, Project ID for this request. (required)
413 machineImage: string, The name of the machine image. (required)
414 x__xgafv: string, V1 error format.
415 Allowed values
416 1 - v1 error format
417 2 - v2 error format
418
419 Returns:
420 An object of the form:
421
422 { # Represents a machine image resource.
423 #
424 # A machine image is a Compute Engine resource that stores all the
425 # configuration, metadata, permissions, and data from one or more disks
426 # required to create a Virtual machine (VM) instance. For more information, seeMachine images.
427 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this machine image inRFC3339
428 # text format.
429 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
430 # create the resource.
431 &quot;guestFlush&quot;: True or False, # [Input Only] Whether to attempt an application consistent machine image by
432 # informing the OS to prepare for the snapshot process.
433 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this machine image. The server
434 # defines this identifier.
435 &quot;instanceProperties&quot;: { # [Output Only] Properties of source instance
436 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
437 # Note that for MachineImage, this is not supported yet.
438 # Options that would traditionally be configured in a BIOS belong
439 # here. Features that require operating system support may have
440 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
441 # disabled).
442 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
443 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
444 &quot;enableWatchdogTimer&quot;: True or False, # Whether to enable the watchdog timer.
445 &quot;numaNodeCount&quot;: 42, # The number of vNUMA nodes.
446 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
447 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
448 # multithreading (SMT) set this to 1. If unset, the maximum number
449 # of threads supported per core by the underlying processor is
450 # assumed.
451 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
452 # Supported modes include:
453 # * ALL_CORE_MAX
454 #
455 # Using empty string or not setting this field will use the platform-specific
456 # default turbo mode.
457 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
458 # the number of threads per core to compute the total number of virtual
459 # CPUs to expose to the instance. If unset, the number of cores is
460 # inferred from the instance&#x27;s nominal CPU count and the underlying
461 # platform&#x27;s SMT width.
462 },
463 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
464 # source IP addresses other than their own and receive packets with
465 # destination IP addresses other than their own. If these instances will be
466 # used as an IP gateway or it will be set as the next-hop in a Route
467 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
468 # documentation for more information.
469 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
470 # Note that for MachineImage, this is not supported yet.
471 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
472 &quot;confidentialParavisorConfig&quot;: { # A set of Confidential Paravisor (SVSM) options. # Defines a set of Confidential Paravisor (SVSM) options.
473 &quot;confidentialTpmType&quot;: &quot;A String&quot;,
474 &quot;sevSnpIrqMode&quot;: &quot;A String&quot;,
475 },
476 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
477 },
478 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
479 # properties.
480 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
481 # from these properties.
482 { # An instance-attached disk resource.
483 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
484 # or X86_64.
485 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
486 # deleted (but not when the disk is detached from the instance).
487 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
488 # partition of the disk for its root filesystem.
489 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies a unique device name of your choice that is reflected into the/dev/disk/by-id/google-* tree of a Linux operating system
490 # running within the instance. This name can be used to reference the device
491 # for mounting, resizing, and so on, from within the instance.
492 #
493 # If not specified, the server chooses a default device name to apply to this
494 # disk, in the form persistent-disk-x, where x is a number
495 # assigned by Google Compute Engine. This field is only applicable for
496 # persistent disks.
497 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
498 # encryption key.
499 #
500 # If you are creating a new disk, this field encrypts the new disk using
501 # an encryption key that you provide. If you are attaching an existing
502 # disk that is already encrypted, this field decrypts the disk using
503 # the customer-supplied encryption key.
504 #
505 # If you encrypt a disk using a customer-supplied key, you must provide the
506 # same key again when you attempt to use this resource at a later time. For
507 # example, you must provide the key when you create a snapshot or an image
508 # from the disk or when you attach the disk to a virtual machine instance.
509 #
510 # If you do not provide an encryption key, then the disk will be encrypted
511 # using an automatically generated key and you do not need to provide a key
512 # to use the disk later.
513 #
514 # Note:
515 #
516 # Instance templates do not storecustomer-supplied
517 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
518 #
519 # You cannot create VMs that have disks with customer-supplied keys using
520 # the bulk
521 # insert method.
522 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
523 # For example:
524 #
525 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
526 # key_region/cryptoKeys/key
527 #
528 # The fully-qualifed key name may be returned for resource GET requests. For
529 # example:
530 #
531 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
532 # key_region/cryptoKeys/key
533 # /cryptoKeyVersions/1
534 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
535 # key. If absent, the Compute Engine default service account is used.
536 # For example:
537 #
538 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
539 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
540 # encryption key, encoded in RFC
541 # 4648 base64 to either encrypt or decrypt this resource. You can
542 # provide either the rawKey or thersaEncryptedKey.
543 # For example:
544 #
545 # &quot;rawKey&quot;:
546 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
547 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
548 # customer-supplied encryption key to either encrypt or decrypt this
549 # resource. You can provide either the rawKey or thersaEncryptedKey.
550 # For example:
551 #
552 # &quot;rsaEncryptedKey&quot;:
553 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
554 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
555 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
556 #
557 # The key must meet the following requirements before you can provide it to
558 # Compute Engine:
559 #
560 # 1. The key is wrapped using a RSA public key certificate provided by
561 # Google.
562 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
563 # encoding.
564 #
565 # Gets the RSA public key certificate provided by Google at:
566 #
567 #
568 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
569 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
570 # 4648 base64 encoded SHA-256 hash of the customer-supplied
571 # encryption key that protects this resource.
572 },
573 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
574 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
575 # currently attached to another instance. If you try to force attach a zonal
576 # disk to an instance, you will receive an error.
577 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
578 # only for bootable images. Read
579 # Enabling guest operating system features to see a list of available
580 # options.
581 { # Guest OS features.
582 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
583 # separate values. Set to one or more of the following values:
584 #
585 # - VIRTIO_SCSI_MULTIQUEUE
586 # - WINDOWS
587 # - MULTI_IP_SUBNET
588 # - UEFI_COMPATIBLE
589 # - GVNIC
590 # - SEV_CAPABLE
591 # - SUSPEND_RESUME_COMPATIBLE
592 # - SEV_LIVE_MIGRATABLE_V2
593 # - SEV_SNP_CAPABLE
594 # - TDX_CAPABLE
595 # - IDPF
596 # - SNP_SVSM_CAPABLE
597 # - CCA_CAPABLE
598 #
599 #
600 # For more information, see
601 # Enabling guest operating system features.
602 },
603 ],
604 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
605 # boot disk. If you have many disks attached to an instance, each
606 # disk would have a unique index number.
607 &quot;initializeParams&quot;: { # [Input Only] Specifies the parameters for a new disk that will be created # [Input Only] Specifies the parameters for a new disk that will be created
608 # alongside the new instance. Use initialization parameters to create boot
609 # disks or local SSDs attached to the new instance.
610 #
611 # This property is mutually exclusive with the source property;
612 # you can only define one or the other, but not both.
613 # alongside the new instance. Use initialization parameters to create boot
614 # disks or local SSDs attached to the new instance.
615 #
616 # This field is persisted and returned for instanceTemplate and not returned
617 # in the context of instance.
618 #
619 # This property is mutually exclusive with the source property;
620 # you can only define one or the other, but not both.
621 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
622 # arm64 or x86_64.
623 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
624 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
625 # of the instance. If a disk with the same name already exists in the given
626 # region, the existing disk is attached to the new instance and the
627 # new disk is not created.
628 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
629 # 10 GB. If you specify a sourceImage, which is required for
630 # boot disks, the default size is the size of the sourceImage.
631 # If you do not specify a sourceImage, the default disk size
632 # is 500 GB.
633 &quot;diskType&quot;: &quot;A String&quot;,
634 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
635 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
636 # only for bootable images. Read
637 # Enabling guest operating system features to see a list of available
638 # options.
639 #
640 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
641 { # Guest OS features.
642 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
643 # separate values. Set to one or more of the following values:
644 #
645 # - VIRTIO_SCSI_MULTIQUEUE
646 # - WINDOWS
647 # - MULTI_IP_SUBNET
648 # - UEFI_COMPATIBLE
649 # - GVNIC
650 # - SEV_CAPABLE
651 # - SUSPEND_RESUME_COMPATIBLE
652 # - SEV_LIVE_MIGRATABLE_V2
653 # - SEV_SNP_CAPABLE
654 # - TDX_CAPABLE
655 # - IDPF
656 # - SNP_SVSM_CAPABLE
657 # - CCA_CAPABLE
658 #
659 #
660 # For more information, see
661 # Enabling guest operating system features.
662 },
663 ],
664 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
665 # which is either SCSI or NVME. The default isSCSI.
666 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
667 # persistent disks.
668 &quot;a_key&quot;: &quot;A String&quot;,
669 },
670 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
671 # disk.
672 &quot;A String&quot;,
673 ],
674 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
675 &quot;A String&quot;,
676 ],
677 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
678 # more than one instance.
679 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
680 # is to use the existing disk.
681 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
682 # of I/O operations per second that the disk can handle. Values must be
683 # between 10,000 and 120,000. For more details, see theExtreme persistent
684 # disk documentation.
685 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
686 # number of throughput mb per second that the disk can handle. Values must
687 # greater than or equal to 1.
688 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
689 # the URLs of the zones where the disk should be replicated to.
690 # You must provide exactly two replica zones, and one zone must be the same
691 # as the instance zone.
692 &quot;A String&quot;,
693 ],
694 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
695 # have the same definition as resource
696 # manager tags. Keys and values can be either in numeric format,
697 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
698 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
699 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
700 # empty.
701 &quot;a_key&quot;: &quot;A String&quot;,
702 },
703 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
704 # Specified using the full or partial URL. For instance template, specify
705 # only the resource policy name.
706 &quot;A String&quot;,
707 ],
708 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
709 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
710 # is required.
711 #
712 # To create a disk with one of the public operating system
713 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
714 #
715 # projects/debian-cloud/global/images/family/debian-9
716 #
717 #
718 # Alternatively, use a specific version of a public operating system image:
719 #
720 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
721 #
722 #
723 # To create a disk with a custom image that you created, specify the
724 # image name in the following format:
725 #
726 # global/images/my-custom-image
727 #
728 #
729 # You can also specify a custom image by its image family, which returns
730 # the latest version of the image in that family. Replace the image name
731 # with family/family-name:
732 #
733 # global/images/family/my-image-family
734 #
735 #
736 # If the source image is deleted later, this field will not be set.
737 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
738 # encryption key of the source image. Required if the source image is
739 # protected by a customer-supplied encryption key.
740 #
741 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
742 # encryption keys, so you cannot create disks for instances in a managed instance group if the
743 # source images are encrypted with your own keys.
744 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
745 # For example:
746 #
747 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
748 # key_region/cryptoKeys/key
749 #
750 # The fully-qualifed key name may be returned for resource GET requests. For
751 # example:
752 #
753 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
754 # key_region/cryptoKeys/key
755 # /cryptoKeyVersions/1
756 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
757 # key. If absent, the Compute Engine default service account is used.
758 # For example:
759 #
760 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
761 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
762 # encryption key, encoded in RFC
763 # 4648 base64 to either encrypt or decrypt this resource. You can
764 # provide either the rawKey or thersaEncryptedKey.
765 # For example:
766 #
767 # &quot;rawKey&quot;:
768 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
769 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
770 # customer-supplied encryption key to either encrypt or decrypt this
771 # resource. You can provide either the rawKey or thersaEncryptedKey.
772 # For example:
773 #
774 # &quot;rsaEncryptedKey&quot;:
775 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
776 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
777 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
778 #
779 # The key must meet the following requirements before you can provide it to
780 # Compute Engine:
781 #
782 # 1. The key is wrapped using a RSA public key certificate provided by
783 # Google.
784 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
785 # encoding.
786 #
787 # Gets the RSA public key certificate provided by Google at:
788 #
789 #
790 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
791 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
792 # 4648 base64 encoded SHA-256 hash of the customer-supplied
793 # encryption key that protects this resource.
794 },
795 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
796 # instance boot disk, one of initializeParams.sourceSnapshot
797 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
798 # is required.
799 #
800 # To create a disk with a snapshot that you created, specify the
801 # snapshot name in the following format:
802 #
803 # us-central1-a/instantSnapshots/my-backup
804 #
805 #
806 # If the source instant-snapshot is deleted later, this field will not be
807 # set.
808 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
809 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.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 # global/snapshots/my-backup
816 #
817 #
818 # If the source snapshot is deleted later, this field will not be set.
819 #
820 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
821 # an image instead when you create VMs using
822 # the bulk
823 # insert method.
824 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
825 # encryption key of the source snapshot.
826 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
827 # For example:
828 #
829 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
830 # key_region/cryptoKeys/key
831 #
832 # The fully-qualifed key name may be returned for resource GET requests. For
833 # example:
834 #
835 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
836 # key_region/cryptoKeys/key
837 # /cryptoKeyVersions/1
838 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
839 # key. If absent, the Compute Engine default service account is used.
840 # For example:
841 #
842 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
843 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
844 # encryption key, encoded in RFC
845 # 4648 base64 to either encrypt or decrypt this resource. You can
846 # provide either the rawKey or thersaEncryptedKey.
847 # For example:
848 #
849 # &quot;rawKey&quot;:
850 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
851 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
852 # customer-supplied encryption key to either encrypt or decrypt this
853 # resource. You can provide either the rawKey or thersaEncryptedKey.
854 # For example:
855 #
856 # &quot;rsaEncryptedKey&quot;:
857 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
858 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
859 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
860 #
861 # The key must meet the following requirements before you can provide it to
862 # Compute Engine:
863 #
864 # 1. The key is wrapped using a RSA public key certificate provided by
865 # Google.
866 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
867 # encoding.
868 #
869 # Gets the RSA public key certificate provided by Google at:
870 #
871 #
872 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
873 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
874 # 4648 base64 encoded SHA-256 hash of the customer-supplied
875 # encryption key that protects this resource.
876 },
877 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
878 # this as a partial or full URL to the resource. For example, the following
879 # are valid values:
880 #
881 #
882 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
883 # - projects/project/zones/zone/storagePools/storagePool
884 # - zones/zone/storagePools/storagePool
885 },
886 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
887 # either SCSI or NVME. For most machine types, the
888 # default is SCSI. Local SSDs can use either NVME or SCSI.
889 # In certain configurations, persistent disks can use NVMe. For more
890 # information, seeAbout
891 # persistent disks.
892 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
893 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
894 &quot;A String&quot;,
895 ],
896 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
897 # disk is not allowed to be detached from the instance, or to be used as the
898 # source of the snapshot creation, and the image creation. The instance with
899 # at least one locked attached disk is not allow to be used as source of
900 # machine image creation, instant snapshot creation, and not allowed to be
901 # deleted with --keep-disk parameter set to true for locked disks.
902 &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
903 # in READ_WRITE mode.
904 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
905 # field is set to PRESERVED if the LocalSSD data has been saved
906 # to a persistent location by customer request. (see the
907 # discard_local_ssd option on Stop/Suspend).
908 # Read-only in the api.
909 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
910 # these are public keys which are safe to store in public
911 &quot;dbs&quot;: [ # The Key Database (db).
912 {
913 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
914 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
915 },
916 ],
917 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
918 {
919 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
920 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
921 },
922 ],
923 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
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;pk&quot;: { # The Platform Key (PK).
930 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
931 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
932 },
933 },
934 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
935 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
936 # is required.
937 #
938 # If desired, you can also attach existing non-root persistent disks using
939 # this property. This field is only applicable for persistent disks.
940 #
941 # Note that for InstanceTemplate, specify the disk name for zonal disk,
942 # and the URL for regional disk.
943 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
944 },
945 ],
946 &quot;displayDevice&quot;: { # A set of Display Device options # Display Device properties to enable support
947 # for remote display products like: Teradici,
948 # VNC and TeamViewer
949 # Note that for MachineImage, this is not supported yet.
950 &quot;enableDisplay&quot;: True or False, # Defines whether the instance has Display enabled.
951 },
952 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
953 # created from these properties.
954 { # A specification of the type and number of accelerator cards attached to the
955 # instance.
956 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
957 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
958 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
959 # If you are creating an instance template, specify only the
960 # accelerator name.
961 # See GPUs on Compute Engine
962 # for a full list of accelerator types.
963 },
964 ],
965 &quot;identity&quot;: &quot;A String&quot;,
966 &quot;identityCertificate&quot;: True or False,
967 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
968 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
969 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
970 &quot;a_key&quot;: &quot;A String&quot;,
971 },
972 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
973 # properties.
974 # This field only accepts a machine type name, for example `n2-standard-4`.
975 # If you use the machine type full or partial URL, for example
976 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
977 # the request will result in an `INTERNAL_ERROR`.
978 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
979 # these properties. These pairs can consist of custom metadata or predefined
980 # keys. SeeProject and
981 # instance metadata for more information.
982 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
983 # the metadata&#x27;s contents and used for optimistic locking. The
984 # fingerprint is initially generated by Compute Engine and changes after
985 # every request to modify or update metadata. You must always provide an
986 # up-to-date fingerprint hash in order to update or change metadata,
987 # otherwise the request will fail with error412 conditionNotMet.
988 #
989 # To see the latest fingerprint, make a get() request to
990 # retrieve the resource.
991 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
992 # less than 512 KB.
993 { # Metadata
994 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
995 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
996 # This is reflected as part of a URL in the metadata server. Additionally, to
997 # avoid ambiguity, keys must not conflict with any other metadata keys
998 # for the project.
999 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
1000 # have meaning as interpreted by the image running in the instance. The
1001 # only restriction placed on values is that their size must be less than
1002 # or equal to 262144 bytes (256 KiB).
1003 },
1004 ],
1005 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
1006 # for metadata.
1007 },
1008 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
1009 # scheduled on the specified or newer cpu/platform. Applicable values are the
1010 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
1011 # information, read Specifying a
1012 # Minimum CPU Platform.
1013 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
1014 { # A network interface resource attached to an instance.
1015 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
1016 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
1017 # no external internet access.
1018 { # An access configuration attached to an instance&#x27;s network interface.
1019 # Only one access config per instance is supported.
1020 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1021 # The first IPv6 address of the external IPv6 range associated
1022 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1023 # use a static external IP address, it must be unused and in the same region
1024 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1025 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1026 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1027 # external IPv6 range.
1028 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1029 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1030 # (IPv4), the default and recommended name is External NAT, but
1031 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1032 # recommend name is External IPv6.
1033 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1034 # address associated with this instance. Specify an unused static
1035 # external IP address available to the project or leave this field undefined
1036 # to use an IP from a shared ephemeral IP address pool. If you specify a
1037 # static external IP address, it must live in the same region as the zone of
1038 # the instance.
1039 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1040 # configuration and can only take the following values: PREMIUM,STANDARD.
1041 #
1042 # If an AccessConfig is specified without a valid external IP address, an
1043 # ephemeral IP will be created with this networkTier.
1044 #
1045 # If an AccessConfig with a valid external IP address is specified, it must
1046 # match that of the networkTier associated with the Address resource owning
1047 # that IP.
1048 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
1049 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
1050 #
1051 # 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
1052 # first IP in associated external IPv6 range.
1053 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
1054 # config.
1055 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
1056 # external IP address of this access configuration.
1057 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
1058 # external IP address of the instance to a DNS domain name.
1059 #
1060 # This field is not used in ipv6AccessConfig. A default PTR
1061 # record will be created if the VM has external IPv6 range associated.
1062 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
1063 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
1064 },
1065 ],
1066 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
1067 # You can only specify this field for network interfaces in VPC networks.
1068 { # An alias IP range attached to an instance&#x27;s network interface.
1069 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1070 # must belong to the specified subnetwork and cannot contain IP addresses
1071 # reserved by system or used by other network interfaces. This range may be
1072 # 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).
1073 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1074 # alias range. If not specified, the primary range of the subnetwork is used.
1075 },
1076 ],
1077 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
1078 # You can only specify this field for network interfaces in VPC networks.
1079 { # An alias IP range attached to an instance&#x27;s network interface.
1080 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1081 # must belong to the specified subnetwork and cannot contain IP addresses
1082 # reserved by system or used by other network interfaces. This range may be
1083 # 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).
1084 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1085 # alias range. If not specified, the primary range of the subnetwork is used.
1086 },
1087 ],
1088 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
1089 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
1090 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
1091 # with network_attachment.
1092 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
1093 # This field will be ignored when inserting an Instance or
1094 # adding a NetworkInterface. An up-to-date
1095 # 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.
1096 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
1097 # or not. If enabled, also indicates the version of IGMP supported.
1098 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
1099 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
1100 # one IPv6 access config, DIRECT_IPV6, is supported. If there
1101 # is no ipv6AccessConfig specified, then this instance will
1102 # have no external IPv6 Internet access.
1103 { # An access configuration attached to an instance&#x27;s network interface.
1104 # Only one access config per instance is supported.
1105 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1106 # The first IPv6 address of the external IPv6 range associated
1107 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1108 # use a static external IP address, it must be unused and in the same region
1109 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1110 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1111 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1112 # external IPv6 range.
1113 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1114 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1115 # (IPv4), the default and recommended name is External NAT, but
1116 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1117 # recommend name is External IPv6.
1118 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1119 # address associated with this instance. Specify an unused static
1120 # external IP address available to the project or leave this field undefined
1121 # to use an IP from a shared ephemeral IP address pool. If you specify a
1122 # static external IP address, it must live in the same region as the zone of
1123 # the instance.
1124 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1125 # configuration and can only take the following values: PREMIUM,STANDARD.
1126 #
1127 # If an AccessConfig is specified without a valid external IP address, an
1128 # ephemeral IP will be created with this networkTier.
1129 #
1130 # If an AccessConfig with a valid external IP address is specified, it must
1131 # match that of the networkTier associated with the Address resource owning
1132 # that IP.
1133 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
1134 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
1135 #
1136 # 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
1137 # first IP in associated external IPv6 range.
1138 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
1139 # config.
1140 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
1141 # external IP address of this access configuration.
1142 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
1143 # external IP address of the instance to a DNS domain name.
1144 #
1145 # This field is not used in ipv6AccessConfig. A default PTR
1146 # record will be created if the VM has external IPv6 range associated.
1147 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
1148 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
1149 },
1150 ],
1151 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
1152 # accessed from the Internet. This field is always inherited from its
1153 # subnetwork.
1154 #
1155 # Valid only if stackType is IPV4_IPV6.
1156 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
1157 # use a static internal IP address, it must be unused and in the same region
1158 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1159 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
1160 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
1161 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
1162 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
1163 # server. For a VM, the network interface uses the nicN naming
1164 # format. Where N is a value between 0 and7. The default interface value is nic0.
1165 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
1166 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
1167 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
1168 # instance, if neither the network nor the subnetwork is specified, the
1169 # default network global/networks/default is used. If the
1170 # selected project doesn&#x27;t have the default network, you must specify a
1171 # network or subnet. If the network is not specified but the subnetwork is
1172 # specified, the network is inferred.
1173 #
1174 # If you specify this property, you can specify the network as
1175 # a full or partial URL. For example, the following are all valid URLs:
1176 #
1177 #
1178 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
1179 # - projects/project/global/networks/network
1180 # - global/networks/default
1181 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
1182 # to in the following format:
1183 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
1184 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
1185 # interface. If not specified by the user, an unused internal IP is
1186 # assigned by the system.
1187 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
1188 # VirtioNet.
1189 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
1190 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
1191 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
1192 # if not specified by the users.
1193 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
1194 # interface. Can only be used with network_attachment. It is not possible to
1195 # use on its own however, network_attachment can be used without
1196 # service_class_id.
1197 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
1198 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
1199 #
1200 # This field can be both set at instance creation and update network
1201 # interface operations.
1202 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
1203 # subnetworks that support L2. Every network interface will get a default
1204 # untagged (vlan not specified) subinterface. Users can specify additional
1205 # tagged subinterfaces which are sub-fields to the Network Interface.
1206 {
1207 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
1208 # subinterface. If specified, ip_allocation_mode should be set to
1209 # ALLOCATE_IP.
1210 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
1211 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
1212 # as that of the network interface.
1213 # If not specified the subnet of network interface will be used.
1214 # If you specify this property, you can specify the subnetwork as a full
1215 # or partial URL. For example, the following are all valid URLs:
1216 #
1217 #
1218 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
1219 # - regions/region/subnetworks/subnetwork
1220 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
1221 # this subinterface is connecting.
1222 },
1223 ],
1224 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
1225 # resource is inlegacy
1226 # mode, do not specify this field. If the network is in auto subnet
1227 # mode, specifying the subnetwork is optional. If the network is in custom
1228 # subnet mode, specifying the subnetwork is required. If you specify this
1229 # field, you can specify the subnetwork as a full or partial URL. For
1230 # example, the following are all valid URLs:
1231 #
1232 #
1233 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
1234 # - regions/region/subnetworks/subnetwork
1235 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
1236 # from 2 to 255 inclusively.
1237 },
1238 ],
1239 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
1240 &quot;externalIpEgressBandwidthTier&quot;: &quot;A String&quot;,
1241 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
1242 },
1243 &quot;partnerMetadata&quot;: { # Partner Metadata assigned to the instance properties. A map from a
1244 # subdomain (namespace) to entries map.
1245 &quot;a_key&quot;: {
1246 &quot;entries&quot;: { # Map of a partner metadata that belong to the same subdomain.
1247 # It accepts any value including google.protobuf.Struct.
1248 &quot;a_key&quot;: &quot;&quot;,
1249 },
1250 },
1251 },
1252 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
1253 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
1254 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
1255 # Note that for MachineImage, this is not supported yet.
1256 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
1257 # Note that for MachineImage, this is not supported yet.
1258 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
1259 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
1260 # Consuming reserved instances for examples.
1261 &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
1262 # the name of your reservation as its value.
1263 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
1264 # either a name to a reservation in the same project or
1265 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
1266 # shared reservation in the same zone but in a different project.
1267 &quot;A String&quot;,
1268 ],
1269 },
1270 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
1271 # have the same definition as resource
1272 # manager tags. Keys and values can be either in numeric format,
1273 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1274 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1275 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
1276 # PATCH) when empty.
1277 &quot;a_key&quot;: &quot;A String&quot;,
1278 },
1279 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
1280 # these properties.
1281 # Note that for MachineImage, this is not supported yet.
1282 &quot;A String&quot;,
1283 ],
1284 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
1285 # these properties.
1286 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
1287 # terminated by Compute Engine (not terminated by a user). You can only set
1288 # the automatic restart option for standard instances.Preemptible instances
1289 # cannot be automatically restarted.
1290 #
1291 # By default, this is set to true so an instance is
1292 # automatically restarted if it is terminated by Compute Engine.
1293 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
1294 # must be a number between 1 and the number of availability domains
1295 # specified in the spread placement policy attached to the instance.
1296 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
1297 # 0 or unset means default vCPUs of the current machine type.
1298 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
1299 # 0 or unset means default amount of memory of the current machine type.
1300 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
1301 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
1302 &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
1303 # graceful shutdown isn&#x27;t complete after this time, then the instance
1304 # transitions to the STOPPING state.
1305 # as a count of seconds and fractions of seconds at nanosecond
1306 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1307 # or &quot;month&quot;. Range is approximately 10,000 years.
1308 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1309 # Durations less than one second are represented with a 0
1310 # `seconds` field and a positive `nanos` field. Must be from 0
1311 # to 999,999,999 inclusive.
1312 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1313 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1314 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1315 },
1316 },
1317 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
1318 # within the range of [90, 330] with the increment of 30, if unset, the
1319 # default behavior of host error recovery will be used.
1320 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
1321 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
1322 # only be set during instance creation, or when the instance is not currently
1323 # running. It must not be set if thepreemptible option is
1324 # also set.
1325 &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
1326 # recovery of the Local Ssd state is attempted. Its value should be in
1327 # between 0 and 168 hours with hour granularity and the default value being 1
1328 # hour.
1329 # as a count of seconds and fractions of seconds at nanosecond
1330 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1331 # or &quot;month&quot;. Range is approximately 10,000 years.
1332 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1333 # Durations less than one second are represented with a 0
1334 # `seconds` field and a positive `nanos` field. Must be from 0
1335 # to 999,999,999 inclusive.
1336 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1337 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1338 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1339 },
1340 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
1341 # resources.
1342 # This field is for use by internal tools that use the public API.
1343 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
1344 # be scheduled for maintenance.
1345 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
1346 # are: `PERIODIC`.
1347 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
1348 # the instance termination action will be performed at the end of the run
1349 # duration.
1350 # as a count of seconds and fractions of seconds at nanosecond
1351 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1352 # or &quot;month&quot;. Range is approximately 10,000 years.
1353 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1354 # Durations less than one second are represented with a 0
1355 # `seconds` field and a positive `nanos` field. Must be from 0
1356 # to 999,999,999 inclusive.
1357 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1358 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1359 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1360 },
1361 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
1362 # on a sole-tenant node.
1363 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
1364 # affinity for more information.
1365 # Overrides reservationAffinity.
1366 { # Node Affinity: the configuration of desired nodes onto which this Instance
1367 # could be scheduled.
1368 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
1369 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
1370 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
1371 &quot;A String&quot;,
1372 ],
1373 },
1374 ],
1375 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
1376 # the default behavior is MIGRATE. Forpreemptible instances,
1377 # the default and only possible behavior is TERMINATE. For more
1378 # information, see
1379 # Set
1380 # VM host maintenance policy.
1381 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
1382 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
1383 # else, the Local SSD data will be preserved when the instance is stopped
1384 # at the end of the run duration/termination time.
1385 },
1386 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
1387 # instance creation or while the instance isstopped and
1388 # therefore, in a `TERMINATED` state. SeeInstance Life
1389 # Cycle for more information on the possible instance states.
1390 &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
1391 # Off signal is triggered for Spot
1392 # VMs only. If not specified, there will be no wait before the G2 Soft
1393 # Off signal is triggered.
1394 # as a count of seconds and fractions of seconds at nanosecond
1395 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1396 # or &quot;month&quot;. Range is approximately 10,000 years.
1397 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1398 # Durations less than one second are represented with a 0
1399 # `seconds` field and a positive `nanos` field. Must be from 0
1400 # to 999,999,999 inclusive.
1401 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1402 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1403 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1404 },
1405 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
1406 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
1407 # Timeout between GCE ACPI G2 Soft
1408 # Off and ACPI G3 Mechanical
1409 # Off during shutdown operation of VM.
1410 #
1411 # For Standard VMs values between 0s and 120s are allowed. For Spot and
1412 # Preemptible VMs supported values are between 0s and 30s.
1413 #
1414 # If no value is specified for shutdownDuration, default values are 90s for
1415 # Standard VMs and 30s for Spot/Preemptible VMs.
1416 # as a count of seconds and fractions of seconds at nanosecond
1417 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1418 # or &quot;month&quot;. Range is approximately 10,000 years.
1419 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1420 # Durations less than one second are represented with a 0
1421 # `seconds` field and a positive `nanos` field. Must be from 0
1422 # to 999,999,999 inclusive.
1423 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1424 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1425 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1426 },
1427 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
1428 # Off and ACPI G3 Mechanical
1429 # Off for Standard VMs and 30 seconds for Spot VMs.
1430 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
1431 # termination action will be performed at the termination time.
1432 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
1433 &quot;mode&quot;: &quot;A String&quot;,
1434 },
1435 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
1436 # unspecified, the default mode is `OFF`.
1437 },
1438 &quot;secureTags&quot;: [ # [Input Only] Secure tags to apply to this instance.
1439 # Maximum number of secure tags allowed is 50.
1440 # Note that for MachineImage, this is not supported yet.
1441 &quot;A String&quot;,
1442 ],
1443 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
1444 # service accounts are available to the instances that are created from
1445 # these properties. Use metadata queries to obtain the access tokens for
1446 # these instances.
1447 { # A service account.
1448 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
1449 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
1450 &quot;A String&quot;,
1451 ],
1452 },
1453 ],
1454 &quot;serviceIntegrationSpecs&quot;: { # Mapping of user defined keys to ServiceIntegrationSpec.
1455 &quot;a_key&quot;: { # Specifies the parameters to configure an integration with instances.
1456 &quot;backupDr&quot;: { # Specifies parameters to Backup and DR to attach a BackupPlan to a compute
1457 # instance for managed VM backup.
1458 &quot;plan&quot;: &quot;A String&quot;, # The BackupPlan resource to attach to the instance. Specified as a
1459 # resource reference in instances, and regional instance templates, and as
1460 # just the plan name in global instance templates
1461 },
1462 },
1463 },
1464 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
1465 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
1466 # default.
1467 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
1468 # default.
1469 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
1470 # default.
1471 },
1472 &quot;shieldedVmConfig&quot;: { # A set of Shielded VM options. # Specifies the Shielded VM options for the instances that are created from
1473 # these properties.
1474 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.
1475 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.
1476 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.
1477 },
1478 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
1479 # properties. The tags identify valid sources or targets for network
1480 # firewalls. The setTags method can modify this list of tags. Each tag within
1481 # the list must comply with RFC1035.
1482 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
1483 # the tags&#x27; contents and used for optimistic locking. The
1484 # fingerprint is initially generated by Compute Engine and changes after
1485 # every request to modify or update tags. You must always provide an
1486 # up-to-date fingerprint hash in order to update or change tags.
1487 #
1488 # To see the latest fingerprint, make get() request to the
1489 # instance.
1490 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
1491 # with RFC1035.
1492 &quot;A String&quot;,
1493 ],
1494 },
1495 &quot;workloadIdentityConfig&quot;: {
1496 &quot;identity&quot;: &quot;A String&quot;,
1497 &quot;identityCertificateEnabled&quot;: True or False,
1498 },
1499 },
1500 &quot;kind&quot;: &quot;compute#machineImage&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.
1501 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this machine image, which is
1502 # essentially a hash of the labels set used for optimistic locking. The
1503 # fingerprint is initially generated by Compute Engine and changes after
1504 # every request to modify or update labels. You must always provide an
1505 # up-to-date fingerprint hash in order to update or change labels.
1506 #
1507 # To see the latest fingerprint, make get() request to the
1508 # machine image.
1509 &quot;labels&quot;: { # Labels to apply to this machine image. These can be later modified by
1510 # the setLabels method.
1511 &quot;a_key&quot;: &quot;A String&quot;,
1512 },
1513 &quot;machineImageEncryptionKey&quot;: { # Encrypts the machine image using acustomer-supplied
1514 # encryption key.
1515 #
1516 # After you encrypt a machine image using a customer-supplied key, you must
1517 # provide the same key if you use the machine image later. For example, you
1518 # must provide the encryption key when you create an instance from the
1519 # encrypted machine image in a future request.
1520 #
1521 # Customer-supplied encryption keys do not protect access to metadata of the
1522 # machine image.
1523 #
1524 # If you do not provide an encryption key when creating the machine image,
1525 # then the machine image will be encrypted using an automatically generated
1526 # key and you do not need to provide a key to use the machine image later.
1527 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1528 # For example:
1529 #
1530 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1531 # key_region/cryptoKeys/key
1532 #
1533 # The fully-qualifed key name may be returned for resource GET requests. For
1534 # example:
1535 #
1536 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1537 # key_region/cryptoKeys/key
1538 # /cryptoKeyVersions/1
1539 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1540 # key. If absent, the Compute Engine default service account is used.
1541 # For example:
1542 #
1543 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1544 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1545 # encryption key, encoded in RFC
1546 # 4648 base64 to either encrypt or decrypt this resource. You can
1547 # provide either the rawKey or thersaEncryptedKey.
1548 # For example:
1549 #
1550 # &quot;rawKey&quot;:
1551 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1552 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1553 # customer-supplied encryption key to either encrypt or decrypt this
1554 # resource. You can provide either the rawKey or thersaEncryptedKey.
1555 # For example:
1556 #
1557 # &quot;rsaEncryptedKey&quot;:
1558 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1559 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1560 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1561 #
1562 # The key must meet the following requirements before you can provide it to
1563 # Compute Engine:
1564 #
1565 # 1. The key is wrapped using a RSA public key certificate provided by
1566 # Google.
1567 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1568 # encoding.
1569 #
1570 # Gets the RSA public key certificate provided by Google at:
1571 #
1572 #
1573 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1574 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1575 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1576 # encryption key that protects this resource.
1577 },
1578 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
1579 # The name must be 1-63 characters long, and comply withRFC1035.
1580 # Specifically, the name must be 1-63 characters long and match the regular
1581 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
1582 # character must be a lowercase letter, and all following characters must be
1583 # a dash, lowercase letter, or digit, except the last character, which cannot
1584 # be a dash.
1585 &quot;params&quot;: { # Machine Image parameters # Input only. [Input Only] Additional parameters that are passed in the request, but are
1586 # not persisted in the resource.
1587 &quot;excludedDisks&quot;: [ # Input only. [Input Only] Specifies the list of disk device names that must be
1588 # excluded from the new machine image.
1589 &quot;A String&quot;,
1590 ],
1591 &quot;includedDisks&quot;: [ # Input only. [Input Only] Specifies the list of disk device names that must be
1592 # included with the new machine image.
1593 &quot;A String&quot;,
1594 ],
1595 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the machine image. Tag keys and values
1596 # have the same definition as resource
1597 # manager tags. Keys and values can be either in numeric format,
1598 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
1599 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
1600 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
1601 # PATCH) when empty.
1602 &quot;a_key&quot;: &quot;A String&quot;,
1603 },
1604 },
1605 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
1606 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
1607 &quot;savedDisks&quot;: [ # Output only. An array of Machine Image specific properties for disks attached to the
1608 # source instance
1609 { # An instance-attached disk resource.
1610 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk.
1611 &quot;kind&quot;: &quot;compute#savedDisk&quot;, # Output only. [Output Only] Type of the resource. Always compute#savedDisk
1612 # for attached disks.
1613 &quot;sourceDisk&quot;: &quot;A String&quot;, # Output only. Specifies a URL of the disk attached to the source instance.
1614 &quot;storageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Size of the individual disk snapshot used by this machine
1615 # image.
1616 &quot;storageBytesStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] An indicator whether storageBytes is in a
1617 # stable state or it is being adjusted as a result of shared storage
1618 # reallocation. This status can either be UPDATING, meaning
1619 # the size of the snapshot is being updated, or UP_TO_DATE,
1620 # meaning the size of the snapshot is up-to-date.
1621 },
1622 ],
1623 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this machine image. The server defines this URL.
1624 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1625 &quot;sourceDiskEncryptionKeys&quot;: [ # [Input Only] Thecustomer-supplied
1626 # encryption key of the disks attached to the source instance. Required
1627 # if the source disk is protected by a customer-supplied encryption key.
1628 {
1629 &quot;diskEncryptionKey&quot;: { # Thecustomer-supplied
1630 # encryption key of the source disk. Required if the source disk is
1631 # protected by a customer-supplied encryption key.
1632 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1633 # For example:
1634 #
1635 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1636 # key_region/cryptoKeys/key
1637 #
1638 # The fully-qualifed key name may be returned for resource GET requests. For
1639 # example:
1640 #
1641 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1642 # key_region/cryptoKeys/key
1643 # /cryptoKeyVersions/1
1644 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1645 # key. If absent, the Compute Engine default service account is used.
1646 # For example:
1647 #
1648 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1649 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1650 # encryption key, encoded in RFC
1651 # 4648 base64 to either encrypt or decrypt this resource. You can
1652 # provide either the rawKey or thersaEncryptedKey.
1653 # For example:
1654 #
1655 # &quot;rawKey&quot;:
1656 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1657 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1658 # customer-supplied encryption key to either encrypt or decrypt this
1659 # resource. You can provide either the rawKey or thersaEncryptedKey.
1660 # For example:
1661 #
1662 # &quot;rsaEncryptedKey&quot;:
1663 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1664 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1665 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1666 #
1667 # The key must meet the following requirements before you can provide it to
1668 # Compute Engine:
1669 #
1670 # 1. The key is wrapped using a RSA public key certificate provided by
1671 # Google.
1672 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1673 # encoding.
1674 #
1675 # Gets the RSA public key certificate provided by Google at:
1676 #
1677 #
1678 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1679 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1680 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1681 # encryption key that protects this resource.
1682 },
1683 &quot;sourceDisk&quot;: &quot;A String&quot;, # URL of the disk attached to the source instance. This can be a full or
1684 # valid partial URL. For example, the following are valid values:
1685 #
1686 #
1687 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
1688 # - projects/project/zones/zone/disks/disk
1689 # - zones/zone/disks/disk
1690 },
1691 ],
1692 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the machine image. You can provide this
1693 # as a partial or full URL to the resource. For example, the following are
1694 # valid values:
1695 #
1696 #
1697 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
1698 # - projects/project/zones/zone/instances/instance
1699 &quot;sourceInstanceProperties&quot;: { # DEPRECATED: Please use compute#instanceProperties instead. # Output only. [Output Only] DEPRECATED: Please use instance_properties
1700 # instead for source instance related properties. New properties will not be
1701 # added to this field.
1702 # New properties will not be added to this field.
1703 &quot;canIpForward&quot;: True or False, # Enables instances created based on this machine image to send packets with
1704 # source IP addresses other than their own and receive packets with
1705 # destination IP addresses other than their own. If these instances will be
1706 # used as an IP gateway or it will be set as the next-hop in a Route
1707 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
1708 # documentation for more information.
1709 &quot;deletionProtection&quot;: True or False, # Whether the instance created from this machine image should be protected
1710 # against deletion.
1711 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from this
1712 # machine image.
1713 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
1714 # from this machine image.
1715 { # DEPRECATED: Please use compute#savedDisk instead.
1716 # An instance-attached disk resource.
1717 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
1718 # deleted (but not when the disk is detached from the instance).
1719 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
1720 # partition of the disk for its root filesystem.
1721 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the name of the disk attached to the source instance.
1722 &quot;diskEncryptionKey&quot;: { # The encryption key for the disk.
1723 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1724 # For example:
1725 #
1726 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1727 # key_region/cryptoKeys/key
1728 #
1729 # The fully-qualifed key name may be returned for resource GET requests. For
1730 # example:
1731 #
1732 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1733 # key_region/cryptoKeys/key
1734 # /cryptoKeyVersions/1
1735 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1736 # key. If absent, the Compute Engine default service account is used.
1737 # For example:
1738 #
1739 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1740 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1741 # encryption key, encoded in RFC
1742 # 4648 base64 to either encrypt or decrypt this resource. You can
1743 # provide either the rawKey or thersaEncryptedKey.
1744 # For example:
1745 #
1746 # &quot;rawKey&quot;:
1747 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1748 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1749 # customer-supplied encryption key to either encrypt or decrypt this
1750 # resource. You can provide either the rawKey or thersaEncryptedKey.
1751 # For example:
1752 #
1753 # &quot;rsaEncryptedKey&quot;:
1754 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1755 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1756 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1757 #
1758 # The key must meet the following requirements before you can provide it to
1759 # Compute Engine:
1760 #
1761 # 1. The key is wrapped using a RSA public key certificate provided by
1762 # Google.
1763 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1764 # encoding.
1765 #
1766 # Gets the RSA public key certificate provided by Google at:
1767 #
1768 #
1769 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1770 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1771 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1772 # encryption key that protects this resource.
1773 },
1774 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in base-2 GB.
1775 &quot;diskType&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or
1776 # pd-ssd
1777 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable only
1778 # for bootable images. Read
1779 # Enabling guest operating system features to see a list of available
1780 # options.
1781 { # Guest OS features.
1782 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
1783 # separate values. Set to one or more of the following values:
1784 #
1785 # - VIRTIO_SCSI_MULTIQUEUE
1786 # - WINDOWS
1787 # - MULTI_IP_SUBNET
1788 # - UEFI_COMPATIBLE
1789 # - GVNIC
1790 # - SEV_CAPABLE
1791 # - SUSPEND_RESUME_COMPATIBLE
1792 # - SEV_LIVE_MIGRATABLE_V2
1793 # - SEV_SNP_CAPABLE
1794 # - TDX_CAPABLE
1795 # - IDPF
1796 # - SNP_SVSM_CAPABLE
1797 # - CCA_CAPABLE
1798 #
1799 #
1800 # For more information, see
1801 # Enabling guest operating system features.
1802 },
1803 ],
1804 &quot;index&quot;: 42, # Output only. Specifies zero-based index of the disk that is attached to the source
1805 # instance.
1806 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
1807 # either SCSI or NVME.
1808 &quot;kind&quot;: &quot;compute#savedAttachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
1809 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
1810 &quot;A String&quot;,
1811 ],
1812 &quot;mode&quot;: &quot;A String&quot;, # The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY.
1813 &quot;source&quot;: &quot;A String&quot;, # Specifies a URL of the disk attached to the source instance.
1814 &quot;storageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] A size of the storage used by the disk&#x27;s snapshot by this
1815 # machine image.
1816 &quot;storageBytesStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] An indicator whether storageBytes is in a
1817 # stable state or it is being adjusted as a result of shared storage
1818 # reallocation. This status can either be UPDATING, meaning
1819 # the size of the snapshot is being updated, or UP_TO_DATE,
1820 # meaning the size of the snapshot is up-to-date.
1821 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the attached disk, either SCRATCH orPERSISTENT.
1822 },
1823 ],
1824 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
1825 # created from this machine image.
1826 { # A specification of the type and number of accelerator cards attached to the
1827 # instance.
1828 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
1829 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
1830 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
1831 # If you are creating an instance template, specify only the
1832 # accelerator name.
1833 # See GPUs on Compute Engine
1834 # for a full list of accelerator types.
1835 },
1836 ],
1837 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
1838 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
1839 &quot;labels&quot;: { # Labels to apply to instances that are created from this machine image.
1840 &quot;a_key&quot;: &quot;A String&quot;,
1841 },
1842 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from this machine
1843 # image.
1844 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
1845 # this machine image. These pairs can consist of custom metadata or
1846 # predefined keys. SeeProject and
1847 # instance metadata for more information.
1848 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
1849 # the metadata&#x27;s contents and used for optimistic locking. The
1850 # fingerprint is initially generated by Compute Engine and changes after
1851 # every request to modify or update metadata. You must always provide an
1852 # up-to-date fingerprint hash in order to update or change metadata,
1853 # otherwise the request will fail with error412 conditionNotMet.
1854 #
1855 # To see the latest fingerprint, make a get() request to
1856 # retrieve the resource.
1857 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
1858 # less than 512 KB.
1859 { # Metadata
1860 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
1861 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
1862 # This is reflected as part of a URL in the metadata server. Additionally, to
1863 # avoid ambiguity, keys must not conflict with any other metadata keys
1864 # for the project.
1865 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
1866 # have meaning as interpreted by the image running in the instance. The
1867 # only restriction placed on values is that their size must be less than
1868 # or equal to 262144 bytes (256 KiB).
1869 },
1870 ],
1871 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
1872 # for metadata.
1873 },
1874 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances created from this machine
1875 # image. The instance may be scheduled on the specified or newer
1876 # cpu/platform. Applicable values are the friendly names of CPU platforms,
1877 # such as minCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
1878 # information, read Specifying a
1879 # Minimum CPU Platform.
1880 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
1881 { # A network interface resource attached to an instance.
1882 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
1883 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
1884 # no external internet access.
1885 { # An access configuration attached to an instance&#x27;s network interface.
1886 # Only one access config per instance is supported.
1887 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1888 # The first IPv6 address of the external IPv6 range associated
1889 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1890 # use a static external IP address, it must be unused and in the same region
1891 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1892 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1893 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1894 # external IPv6 range.
1895 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1896 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1897 # (IPv4), the default and recommended name is External NAT, but
1898 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1899 # recommend name is External IPv6.
1900 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1901 # address associated with this instance. Specify an unused static
1902 # external IP address available to the project or leave this field undefined
1903 # to use an IP from a shared ephemeral IP address pool. If you specify a
1904 # static external IP address, it must live in the same region as the zone of
1905 # the instance.
1906 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1907 # configuration and can only take the following values: PREMIUM,STANDARD.
1908 #
1909 # If an AccessConfig is specified without a valid external IP address, an
1910 # ephemeral IP will be created with this networkTier.
1911 #
1912 # If an AccessConfig with a valid external IP address is specified, it must
1913 # match that of the networkTier associated with the Address resource owning
1914 # that IP.
1915 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
1916 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
1917 #
1918 # 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
1919 # first IP in associated external IPv6 range.
1920 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
1921 # config.
1922 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
1923 # external IP address of this access configuration.
1924 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
1925 # external IP address of the instance to a DNS domain name.
1926 #
1927 # This field is not used in ipv6AccessConfig. A default PTR
1928 # record will be created if the VM has external IPv6 range associated.
1929 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
1930 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
1931 },
1932 ],
1933 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
1934 # You can only specify this field for network interfaces in VPC networks.
1935 { # An alias IP range attached to an instance&#x27;s network interface.
1936 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1937 # must belong to the specified subnetwork and cannot contain IP addresses
1938 # reserved by system or used by other network interfaces. This range may be
1939 # 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).
1940 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1941 # alias range. If not specified, the primary range of the subnetwork is used.
1942 },
1943 ],
1944 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
1945 # You can only specify this field for network interfaces in VPC networks.
1946 { # An alias IP range attached to an instance&#x27;s network interface.
1947 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
1948 # must belong to the specified subnetwork and cannot contain IP addresses
1949 # reserved by system or used by other network interfaces. This range may be
1950 # 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).
1951 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
1952 # alias range. If not specified, the primary range of the subnetwork is used.
1953 },
1954 ],
1955 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
1956 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
1957 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
1958 # with network_attachment.
1959 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
1960 # This field will be ignored when inserting an Instance or
1961 # adding a NetworkInterface. An up-to-date
1962 # 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.
1963 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
1964 # or not. If enabled, also indicates the version of IGMP supported.
1965 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
1966 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
1967 # one IPv6 access config, DIRECT_IPV6, is supported. If there
1968 # is no ipv6AccessConfig specified, then this instance will
1969 # have no external IPv6 Internet access.
1970 { # An access configuration attached to an instance&#x27;s network interface.
1971 # Only one access config per instance is supported.
1972 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
1973 # The first IPv6 address of the external IPv6 range associated
1974 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
1975 # use a static external IP address, it must be unused and in the same region
1976 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
1977 # assign an external IPv6 address from the instance&#x27;s subnetwork.
1978 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
1979 # external IPv6 range.
1980 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
1981 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
1982 # (IPv4), the default and recommended name is External NAT, but
1983 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
1984 # recommend name is External IPv6.
1985 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
1986 # address associated with this instance. Specify an unused static
1987 # external IP address available to the project or leave this field undefined
1988 # to use an IP from a shared ephemeral IP address pool. If you specify a
1989 # static external IP address, it must live in the same region as the zone of
1990 # the instance.
1991 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
1992 # configuration and can only take the following values: PREMIUM,STANDARD.
1993 #
1994 # If an AccessConfig is specified without a valid external IP address, an
1995 # ephemeral IP will be created with this networkTier.
1996 #
1997 # If an AccessConfig with a valid external IP address is specified, it must
1998 # match that of the networkTier associated with the Address resource owning
1999 # that IP.
2000 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
2001 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
2002 #
2003 # 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
2004 # first IP in associated external IPv6 range.
2005 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
2006 # config.
2007 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
2008 # external IP address of this access configuration.
2009 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
2010 # external IP address of the instance to a DNS domain name.
2011 #
2012 # This field is not used in ipv6AccessConfig. A default PTR
2013 # record will be created if the VM has external IPv6 range associated.
2014 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
2015 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
2016 },
2017 ],
2018 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
2019 # accessed from the Internet. This field is always inherited from its
2020 # subnetwork.
2021 #
2022 # Valid only if stackType is IPV4_IPV6.
2023 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
2024 # use a static internal IP address, it must be unused and in the same region
2025 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
2026 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
2027 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
2028 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
2029 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
2030 # server. For a VM, the network interface uses the nicN naming
2031 # format. Where N is a value between 0 and7. The default interface value is nic0.
2032 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
2033 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
2034 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
2035 # instance, if neither the network nor the subnetwork is specified, the
2036 # default network global/networks/default is used. If the
2037 # selected project doesn&#x27;t have the default network, you must specify a
2038 # network or subnet. If the network is not specified but the subnetwork is
2039 # specified, the network is inferred.
2040 #
2041 # If you specify this property, you can specify the network as
2042 # a full or partial URL. For example, the following are all valid URLs:
2043 #
2044 #
2045 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
2046 # - projects/project/global/networks/network
2047 # - global/networks/default
2048 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
2049 # to in the following format:
2050 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
2051 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
2052 # interface. If not specified by the user, an unused internal IP is
2053 # assigned by the system.
2054 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
2055 # VirtioNet.
2056 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
2057 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
2058 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
2059 # if not specified by the users.
2060 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
2061 # interface. Can only be used with network_attachment. It is not possible to
2062 # use on its own however, network_attachment can be used without
2063 # service_class_id.
2064 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
2065 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
2066 #
2067 # This field can be both set at instance creation and update network
2068 # interface operations.
2069 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
2070 # subnetworks that support L2. Every network interface will get a default
2071 # untagged (vlan not specified) subinterface. Users can specify additional
2072 # tagged subinterfaces which are sub-fields to the Network Interface.
2073 {
2074 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
2075 # subinterface. If specified, ip_allocation_mode should be set to
2076 # ALLOCATE_IP.
2077 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
2078 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
2079 # as that of the network interface.
2080 # If not specified the subnet of network interface will be used.
2081 # If you specify this property, you can specify the subnetwork as a full
2082 # or partial URL. For example, the following are all valid URLs:
2083 #
2084 #
2085 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
2086 # - regions/region/subnetworks/subnetwork
2087 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
2088 # this subinterface is connecting.
2089 },
2090 ],
2091 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
2092 # resource is inlegacy
2093 # mode, do not specify this field. If the network is in auto subnet
2094 # mode, specifying the subnetwork is optional. If the network is in custom
2095 # subnet mode, specifying the subnetwork is required. If you specify this
2096 # field, you can specify the subnetwork as a full or partial URL. For
2097 # example, the following are all valid URLs:
2098 #
2099 #
2100 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
2101 # - regions/region/subnetworks/subnetwork
2102 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
2103 # from 2 to 255 inclusively.
2104 },
2105 ],
2106 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
2107 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
2108 # this machine image.
2109 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
2110 # terminated by Compute Engine (not terminated by a user). You can only set
2111 # the automatic restart option for standard instances.Preemptible instances
2112 # cannot be automatically restarted.
2113 #
2114 # By default, this is set to true so an instance is
2115 # automatically restarted if it is terminated by Compute Engine.
2116 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
2117 # must be a number between 1 and the number of availability domains
2118 # specified in the spread placement policy attached to the instance.
2119 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
2120 # 0 or unset means default vCPUs of the current machine type.
2121 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
2122 # 0 or unset means default amount of memory of the current machine type.
2123 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
2124 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
2125 &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
2126 # graceful shutdown isn&#x27;t complete after this time, then the instance
2127 # transitions to the STOPPING state.
2128 # as a count of seconds and fractions of seconds at nanosecond
2129 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2130 # or &quot;month&quot;. Range is approximately 10,000 years.
2131 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2132 # Durations less than one second are represented with a 0
2133 # `seconds` field and a positive `nanos` field. Must be from 0
2134 # to 999,999,999 inclusive.
2135 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2136 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2137 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2138 },
2139 },
2140 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
2141 # within the range of [90, 330] with the increment of 30, if unset, the
2142 # default behavior of host error recovery will be used.
2143 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
2144 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
2145 # only be set during instance creation, or when the instance is not currently
2146 # running. It must not be set if thepreemptible option is
2147 # also set.
2148 &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
2149 # recovery of the Local Ssd state is attempted. Its value should be in
2150 # between 0 and 168 hours with hour granularity and the default value being 1
2151 # hour.
2152 # as a count of seconds and fractions of seconds at nanosecond
2153 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2154 # or &quot;month&quot;. Range is approximately 10,000 years.
2155 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2156 # Durations less than one second are represented with a 0
2157 # `seconds` field and a positive `nanos` field. Must be from 0
2158 # to 999,999,999 inclusive.
2159 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2160 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2161 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2162 },
2163 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
2164 # resources.
2165 # This field is for use by internal tools that use the public API.
2166 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
2167 # be scheduled for maintenance.
2168 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
2169 # are: `PERIODIC`.
2170 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
2171 # the instance termination action will be performed at the end of the run
2172 # duration.
2173 # as a count of seconds and fractions of seconds at nanosecond
2174 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2175 # or &quot;month&quot;. Range is approximately 10,000 years.
2176 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2177 # Durations less than one second are represented with a 0
2178 # `seconds` field and a positive `nanos` field. Must be from 0
2179 # to 999,999,999 inclusive.
2180 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2181 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2182 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2183 },
2184 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
2185 # on a sole-tenant node.
2186 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
2187 # affinity for more information.
2188 # Overrides reservationAffinity.
2189 { # Node Affinity: the configuration of desired nodes onto which this Instance
2190 # could be scheduled.
2191 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
2192 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
2193 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
2194 &quot;A String&quot;,
2195 ],
2196 },
2197 ],
2198 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
2199 # the default behavior is MIGRATE. Forpreemptible instances,
2200 # the default and only possible behavior is TERMINATE. For more
2201 # information, see
2202 # Set
2203 # VM host maintenance policy.
2204 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
2205 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
2206 # else, the Local SSD data will be preserved when the instance is stopped
2207 # at the end of the run duration/termination time.
2208 },
2209 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
2210 # instance creation or while the instance isstopped and
2211 # therefore, in a `TERMINATED` state. SeeInstance Life
2212 # Cycle for more information on the possible instance states.
2213 &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
2214 # Off signal is triggered for Spot
2215 # VMs only. If not specified, there will be no wait before the G2 Soft
2216 # Off signal is triggered.
2217 # as a count of seconds and fractions of seconds at nanosecond
2218 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2219 # or &quot;month&quot;. Range is approximately 10,000 years.
2220 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2221 # Durations less than one second are represented with a 0
2222 # `seconds` field and a positive `nanos` field. Must be from 0
2223 # to 999,999,999 inclusive.
2224 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2225 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2226 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2227 },
2228 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
2229 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
2230 # Timeout between GCE ACPI G2 Soft
2231 # Off and ACPI G3 Mechanical
2232 # Off during shutdown operation of VM.
2233 #
2234 # For Standard VMs values between 0s and 120s are allowed. For Spot and
2235 # Preemptible VMs supported values are between 0s and 30s.
2236 #
2237 # If no value is specified for shutdownDuration, default values are 90s for
2238 # Standard VMs and 30s for Spot/Preemptible VMs.
2239 # as a count of seconds and fractions of seconds at nanosecond
2240 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
2241 # or &quot;month&quot;. Range is approximately 10,000 years.
2242 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
2243 # Durations less than one second are represented with a 0
2244 # `seconds` field and a positive `nanos` field. Must be from 0
2245 # to 999,999,999 inclusive.
2246 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
2247 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
2248 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
2249 },
2250 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
2251 # Off and ACPI G3 Mechanical
2252 # Off for Standard VMs and 30 seconds for Spot VMs.
2253 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
2254 # termination action will be performed at the termination time.
2255 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
2256 &quot;mode&quot;: &quot;A String&quot;,
2257 },
2258 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
2259 # unspecified, the default mode is `OFF`.
2260 },
2261 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
2262 # service accounts are available to the instances that are created from this
2263 # machine image. Use metadata queries to obtain the access tokens for these
2264 # instances.
2265 { # A service account.
2266 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
2267 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
2268 &quot;A String&quot;,
2269 ],
2270 },
2271 ],
2272 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from this machine
2273 # image. The tags identify valid sources or targets for network firewalls.
2274 # The setTags method can modify this list of tags. Each tag within the list
2275 # must comply withRFC1035.
2276 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
2277 # the tags&#x27; contents and used for optimistic locking. The
2278 # fingerprint is initially generated by Compute Engine and changes after
2279 # every request to modify or update tags. You must always provide an
2280 # up-to-date fingerprint hash in order to update or change tags.
2281 #
2282 # To see the latest fingerprint, make get() request to the
2283 # instance.
2284 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
2285 # with RFC1035.
2286 &quot;A String&quot;,
2287 ],
2288 },
2289 },
2290 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING.
2291 &quot;storageLocations&quot;: [ # The regional or multi-regional Cloud Storage bucket location where themachine image is
2292 # stored.
2293 &quot;A String&quot;,
2294 ],
2295 &quot;totalStorageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Total size of the storage used by the machine image.
2296 }</pre>
2297 </div>
2298
2299 <div class="method">
2300 <code class="details" id="getIamPolicy">getIamPolicy(project, resource, optionsRequestedPolicyVersion=None, x__xgafv=None)</code>
2301 <pre>Gets the access control policy for a resource. May be empty if no such
2302 policy or resource exists.
2303
2304 Args:
2305 project: string, Project ID for this request. (required)
2306 resource: string, Name or id of the resource for this request. (required)
2307 optionsRequestedPolicyVersion: integer, Requested IAM Policy version.
2308 x__xgafv: string, V1 error format.
2309 Allowed values
2310 1 - v1 error format
2311 2 - v2 error format
2312
2313 Returns:
2314 An object of the form:
2315
2316 { # An Identity and Access Management (IAM) policy, which specifies access
2317 # controls for Google Cloud resources.
2318 #
2319 #
2320 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
2321 # `members`, or principals, to a single `role`. Principals can be user
2322 # accounts, service accounts, Google groups, and domains (such as G Suite). A
2323 # `role` is a named list of permissions; each `role` can be an IAM predefined
2324 # role or a user-created custom role.
2325 #
2326 # For some types of Google Cloud resources, a `binding` can also specify a
2327 # `condition`, which is a logical expression that allows access to a resource
2328 # only if the expression evaluates to `true`. A condition can add constraints
2329 # based on attributes of the request, the resource, or both. To learn which
2330 # resources support conditions in their IAM policies, see the
2331 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2332 #
2333 # **JSON example:**
2334 #
2335 # ```
2336 # {
2337 # &quot;bindings&quot;: [
2338 # {
2339 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
2340 # &quot;members&quot;: [
2341 # &quot;user:[email protected]&quot;,
2342 # &quot;group:[email protected]&quot;,
2343 # &quot;domain:google.com&quot;,
2344 # &quot;serviceAccount:[email protected]&quot;
2345 # ]
2346 # },
2347 # {
2348 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
2349 # &quot;members&quot;: [
2350 # &quot;user:[email protected]&quot;
2351 # ],
2352 # &quot;condition&quot;: {
2353 # &quot;title&quot;: &quot;expirable access&quot;,
2354 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
2355 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
2356 # }
2357 # }
2358 # ],
2359 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
2360 # &quot;version&quot;: 3
2361 # }
2362 # ```
2363 #
2364 # **YAML example:**
2365 #
2366 # ```
2367 # bindings:
2368 # - members:
2369 # - user:[email protected]
2370 # - group:[email protected]
2371 # - domain:google.com
2372 # - serviceAccount:[email protected]
2373 # role: roles/resourcemanager.organizationAdmin
2374 # - members:
2375 # - user:[email protected]
2376 # role: roles/resourcemanager.organizationViewer
2377 # condition:
2378 # title: expirable access
2379 # description: Does not grant access after Sep 2020
2380 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
2381 # etag: BwWWja0YfJA=
2382 # version: 3
2383 # ```
2384 #
2385 # For a description of IAM and its features, see the
2386 # [IAM documentation](https://cloud.google.com/iam/docs/).
2387 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
2388 { # Specifies the audit configuration for a service.
2389 # The configuration determines which permission types are logged, and what
2390 # identities, if any, are exempted from logging.
2391 # An AuditConfig must have one or more AuditLogConfigs.
2392 #
2393 # If there are AuditConfigs for both `allServices` and a specific service,
2394 # the union of the two AuditConfigs is used for that service: the log_types
2395 # specified in each AuditConfig are enabled, and the exempted_members in each
2396 # AuditLogConfig are exempted.
2397 #
2398 # Example Policy with multiple AuditConfigs:
2399 #
2400 # {
2401 # &quot;audit_configs&quot;: [
2402 # {
2403 # &quot;service&quot;: &quot;allServices&quot;,
2404 # &quot;audit_log_configs&quot;: [
2405 # {
2406 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
2407 # &quot;exempted_members&quot;: [
2408 # &quot;user:[email protected]&quot;
2409 # ]
2410 # },
2411 # {
2412 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
2413 # },
2414 # {
2415 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
2416 # }
2417 # ]
2418 # },
2419 # {
2420 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
2421 # &quot;audit_log_configs&quot;: [
2422 # {
2423 # &quot;log_type&quot;: &quot;DATA_READ&quot;
2424 # },
2425 # {
2426 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
2427 # &quot;exempted_members&quot;: [
2428 # &quot;user:[email protected]&quot;
2429 # ]
2430 # }
2431 # ]
2432 # }
2433 # ]
2434 # }
2435 #
2436 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
2437 # logging. It also exempts `[email protected]` from DATA_READ logging, and
2438 # `[email protected]` from DATA_WRITE logging.
2439 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
2440 { # Provides the configuration for logging a type of permissions.
2441 # Example:
2442 #
2443 # {
2444 # &quot;audit_log_configs&quot;: [
2445 # {
2446 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
2447 # &quot;exempted_members&quot;: [
2448 # &quot;user:[email protected]&quot;
2449 # ]
2450 # },
2451 # {
2452 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
2453 # }
2454 # ]
2455 # }
2456 #
2457 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
2458 # [email protected] from DATA_READ logging.
2459 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
2460 # permission.
2461 # Follows the same format of Binding.members.
2462 &quot;A String&quot;,
2463 ],
2464 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
2465 },
2466 ],
2467 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
2468 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
2469 # `allServices` is a special value that covers all services.
2470 },
2471 ],
2472 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
2473 # may specify a `condition` that determines how and when the `bindings` are
2474 # applied. Each of the `bindings` must contain at least one principal.
2475 #
2476 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
2477 # of these principals can be Google groups. Each occurrence of a principal
2478 # counts towards these limits. For example, if the `bindings` grant 50
2479 # different roles to `user:[email protected]`, and not to any other
2480 # principal, then you can add another 1,450 principals to the `bindings` in
2481 # the `Policy`.
2482 { # Associates `members`, or principals, with a `role`.
2483 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
2484 #
2485 # If the condition evaluates to `true`, then this binding applies to the
2486 # current request.
2487 #
2488 # If the condition evaluates to `false`, then this binding does not apply to
2489 # the current request. However, a different role binding might grant the same
2490 # role to one or more of the principals in this binding.
2491 #
2492 # To learn which resources support conditions in their IAM policies, see the
2493 # [IAM
2494 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2495 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
2496 # are documented at https://github.com/google/cel-spec.
2497 #
2498 # Example (Comparison):
2499 #
2500 # title: &quot;Summary size limit&quot;
2501 # description: &quot;Determines if a summary is less than 100 chars&quot;
2502 # expression: &quot;document.summary.size() &lt; 100&quot;
2503 #
2504 # Example (Equality):
2505 #
2506 # title: &quot;Requestor is owner&quot;
2507 # description: &quot;Determines if requestor is the document owner&quot;
2508 # expression: &quot;document.owner == request.auth.claims.email&quot;
2509 #
2510 # Example (Logic):
2511 #
2512 # title: &quot;Public documents&quot;
2513 # description: &quot;Determine whether the document should be publicly visible&quot;
2514 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
2515 #
2516 # Example (Data Manipulation):
2517 #
2518 # title: &quot;Notification string&quot;
2519 # description: &quot;Create a notification string with a timestamp.&quot;
2520 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
2521 #
2522 # The exact variables and functions that may be referenced within an expression
2523 # are determined by the service that evaluates it. See the service
2524 # documentation for additional information.
2525 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
2526 # describes the expression, e.g. when hovered over it in a UI.
2527 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
2528 # syntax.
2529 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
2530 # reporting, e.g. a file name and a position in the file.
2531 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
2532 # its purpose. This can be used e.g. in UIs which allow to enter the
2533 # expression.
2534 },
2535 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
2536 # `members` can have the following values:
2537 #
2538 # * `allUsers`: A special identifier that represents anyone who is
2539 # on the internet; with or without a Google account.
2540 #
2541 # * `allAuthenticatedUsers`: A special identifier that represents anyone
2542 # who is authenticated with a Google account or a service account.
2543 # Does not include identities that come from external identity providers
2544 # (IdPs) through identity federation.
2545 #
2546 # * `user:{emailid}`: An email address that represents a specific Google
2547 # account. For example, `[email protected]` .
2548 #
2549 #
2550 # * `serviceAccount:{emailid}`: An email address that represents a Google
2551 # service account. For example,
2552 # `[email protected]`.
2553 #
2554 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
2555 # identifier for a
2556 # [Kubernetes service
2557 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
2558 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
2559 #
2560 # * `group:{emailid}`: An email address that represents a Google group.
2561 # For example, `[email protected]`.
2562 #
2563 #
2564 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
2565 # users of that domain. For example, `google.com` or `example.com`.
2566 #
2567 #
2568 #
2569 #
2570 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
2571 # A single identity in a workforce identity pool.
2572 #
2573 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
2574 # All workforce identities in a group.
2575 #
2576 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
2577 # All workforce identities with a specific attribute value.
2578 #
2579 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
2580 # All identities in a workforce identity pool.
2581 #
2582 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
2583 # A single identity in a workload identity pool.
2584 #
2585 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
2586 # A workload identity pool group.
2587 #
2588 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
2589 # All identities in a workload identity pool with a certain attribute.
2590 #
2591 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
2592 # All identities in a workload identity pool.
2593 #
2594 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
2595 # identifier) representing a user that has been recently deleted. For
2596 # example, `[email protected]?uid=123456789012345678901`. If the user is
2597 # recovered, this value reverts to `user:{emailid}` and the recovered user
2598 # retains the role in the binding.
2599 #
2600 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
2601 # unique identifier) representing a service account that has been recently
2602 # deleted. For example,
2603 # `[email protected]?uid=123456789012345678901`.
2604 # If the service account is undeleted, this value reverts to
2605 # `serviceAccount:{emailid}` and the undeleted service account retains the
2606 # role in the binding.
2607 #
2608 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
2609 # identifier) representing a Google group that has been recently
2610 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
2611 # the group is recovered, this value reverts to `group:{emailid}` and the
2612 # recovered group retains the role in the binding.
2613 #
2614 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
2615 # Deleted single identity in a workforce identity pool. For example,
2616 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
2617 &quot;A String&quot;,
2618 ],
2619 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
2620 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
2621 #
2622 # For an overview of the IAM roles and permissions, see the
2623 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
2624 # a list of the available pre-defined roles, see
2625 # [here](https://cloud.google.com/iam/docs/understanding-roles).
2626 },
2627 ],
2628 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
2629 # prevent simultaneous updates of a policy from overwriting each other.
2630 # It is strongly suggested that systems make use of the `etag` in the
2631 # read-modify-write cycle to perform policy updates in order to avoid race
2632 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
2633 # systems are expected to put that etag in the request to `setIamPolicy` to
2634 # ensure that their change will be applied to the same version of the policy.
2635 #
2636 # **Important:** If you use IAM Conditions, you must include the `etag` field
2637 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
2638 # you to overwrite a version `3` policy with a version `1` policy, and all of
2639 # the conditions in the version `3` policy are lost.
2640 &quot;version&quot;: 42, # Specifies the format of the policy.
2641 #
2642 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
2643 # are rejected.
2644 #
2645 # Any operation that affects conditional role bindings must specify version
2646 # `3`. This requirement applies to the following operations:
2647 #
2648 # * Getting a policy that includes a conditional role binding
2649 # * Adding a conditional role binding to a policy
2650 # * Changing a conditional role binding in a policy
2651 # * Removing any role binding, with or without a condition, from a policy
2652 # that includes conditions
2653 #
2654 # **Important:** If you use IAM Conditions, you must include the `etag` field
2655 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
2656 # you to overwrite a version `3` policy with a version `1` policy, and all of
2657 # the conditions in the version `3` policy are lost.
2658 #
2659 # If a policy does not include any conditions, operations on that policy may
2660 # specify any valid version or leave the field unset.
2661 #
2662 # To learn which resources support conditions in their IAM policies, see the
2663 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
2664 }</pre>
2665 </div>
2666
2667 <div class="method">
2668 <code class="details" id="insert">insert(project, body=None, requestId=None, sourceInstance=None, x__xgafv=None)</code>
2669 <pre>Creates a machine image in the specified project using the
2670 data that is included in the request. If you are creating a new machine
2671 image to update an existing instance, your new machine image should use the
2672 same network or, if applicable, the same subnetwork as the original
2673 instance.
2674
2675 Args:
2676 project: string, Project ID for this request. (required)
2677 body: object, The request body.
2678 The object takes the form of:
2679
2680 { # Represents a machine image resource.
2681 #
2682 # A machine image is a Compute Engine resource that stores all the
2683 # configuration, metadata, permissions, and data from one or more disks
2684 # required to create a Virtual machine (VM) instance. For more information, seeMachine images.
2685 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this machine image inRFC3339
2686 # text format.
2687 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
2688 # create the resource.
2689 &quot;guestFlush&quot;: True or False, # [Input Only] Whether to attempt an application consistent machine image by
2690 # informing the OS to prepare for the snapshot process.
2691 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this machine image. The server
2692 # defines this identifier.
2693 &quot;instanceProperties&quot;: { # [Output Only] Properties of source instance
2694 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
2695 # Note that for MachineImage, this is not supported yet.
2696 # Options that would traditionally be configured in a BIOS belong
2697 # here. Features that require operating system support may have
2698 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
2699 # disabled).
2700 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
2701 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
2702 &quot;enableWatchdogTimer&quot;: True or False, # Whether to enable the watchdog timer.
2703 &quot;numaNodeCount&quot;: 42, # The number of vNUMA nodes.
2704 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
2705 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
2706 # multithreading (SMT) set this to 1. If unset, the maximum number
2707 # of threads supported per core by the underlying processor is
2708 # assumed.
2709 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
2710 # Supported modes include:
2711 # * ALL_CORE_MAX
2712 #
2713 # Using empty string or not setting this field will use the platform-specific
2714 # default turbo mode.
2715 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
2716 # the number of threads per core to compute the total number of virtual
2717 # CPUs to expose to the instance. If unset, the number of cores is
2718 # inferred from the instance&#x27;s nominal CPU count and the underlying
2719 # platform&#x27;s SMT width.
2720 },
2721 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
2722 # source IP addresses other than their own and receive packets with
2723 # destination IP addresses other than their own. If these instances will be
2724 # used as an IP gateway or it will be set as the next-hop in a Route
2725 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
2726 # documentation for more information.
2727 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
2728 # Note that for MachineImage, this is not supported yet.
2729 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
2730 &quot;confidentialParavisorConfig&quot;: { # A set of Confidential Paravisor (SVSM) options. # Defines a set of Confidential Paravisor (SVSM) options.
2731 &quot;confidentialTpmType&quot;: &quot;A String&quot;,
2732 &quot;sevSnpIrqMode&quot;: &quot;A String&quot;,
2733 },
2734 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
2735 },
2736 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
2737 # properties.
2738 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
2739 # from these properties.
2740 { # An instance-attached disk resource.
2741 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
2742 # or X86_64.
2743 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
2744 # deleted (but not when the disk is detached from the instance).
2745 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
2746 # partition of the disk for its root filesystem.
2747 &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
2748 # running within the instance. This name can be used to reference the device
2749 # for mounting, resizing, and so on, from within the instance.
2750 #
2751 # If not specified, the server chooses a default device name to apply to this
2752 # disk, in the form persistent-disk-x, where x is a number
2753 # assigned by Google Compute Engine. This field is only applicable for
2754 # persistent disks.
2755 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
2756 # encryption key.
2757 #
2758 # If you are creating a new disk, this field encrypts the new disk using
2759 # an encryption key that you provide. If you are attaching an existing
2760 # disk that is already encrypted, this field decrypts the disk using
2761 # the customer-supplied encryption key.
2762 #
2763 # If you encrypt a disk using a customer-supplied key, you must provide the
2764 # same key again when you attempt to use this resource at a later time. For
2765 # example, you must provide the key when you create a snapshot or an image
2766 # from the disk or when you attach the disk to a virtual machine instance.
2767 #
2768 # If you do not provide an encryption key, then the disk will be encrypted
2769 # using an automatically generated key and you do not need to provide a key
2770 # to use the disk later.
2771 #
2772 # Note:
2773 #
2774 # Instance templates do not storecustomer-supplied
2775 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
2776 #
2777 # You cannot create VMs that have disks with customer-supplied keys using
2778 # the bulk
2779 # insert method.
2780 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2781 # For example:
2782 #
2783 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2784 # key_region/cryptoKeys/key
2785 #
2786 # The fully-qualifed key name may be returned for resource GET requests. For
2787 # example:
2788 #
2789 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2790 # key_region/cryptoKeys/key
2791 # /cryptoKeyVersions/1
2792 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2793 # key. If absent, the Compute Engine default service account is used.
2794 # For example:
2795 #
2796 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2797 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2798 # encryption key, encoded in RFC
2799 # 4648 base64 to either encrypt or decrypt this resource. You can
2800 # provide either the rawKey or thersaEncryptedKey.
2801 # For example:
2802 #
2803 # &quot;rawKey&quot;:
2804 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2805 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2806 # customer-supplied encryption key to either encrypt or decrypt this
2807 # resource. You can provide either the rawKey or thersaEncryptedKey.
2808 # For example:
2809 #
2810 # &quot;rsaEncryptedKey&quot;:
2811 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2812 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2813 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2814 #
2815 # The key must meet the following requirements before you can provide it to
2816 # Compute Engine:
2817 #
2818 # 1. The key is wrapped using a RSA public key certificate provided by
2819 # Google.
2820 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2821 # encoding.
2822 #
2823 # Gets the RSA public key certificate provided by Google at:
2824 #
2825 #
2826 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2827 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2828 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2829 # encryption key that protects this resource.
2830 },
2831 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
2832 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
2833 # currently attached to another instance. If you try to force attach a zonal
2834 # disk to an instance, you will receive an error.
2835 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2836 # only for bootable images. Read
2837 # Enabling guest operating system features to see a list of available
2838 # options.
2839 { # Guest OS features.
2840 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2841 # separate values. Set to one or more of the following values:
2842 #
2843 # - VIRTIO_SCSI_MULTIQUEUE
2844 # - WINDOWS
2845 # - MULTI_IP_SUBNET
2846 # - UEFI_COMPATIBLE
2847 # - GVNIC
2848 # - SEV_CAPABLE
2849 # - SUSPEND_RESUME_COMPATIBLE
2850 # - SEV_LIVE_MIGRATABLE_V2
2851 # - SEV_SNP_CAPABLE
2852 # - TDX_CAPABLE
2853 # - IDPF
2854 # - SNP_SVSM_CAPABLE
2855 # - CCA_CAPABLE
2856 #
2857 #
2858 # For more information, see
2859 # Enabling guest operating system features.
2860 },
2861 ],
2862 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
2863 # boot disk. If you have many disks attached to an instance, each
2864 # disk would have a unique index number.
2865 &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
2866 # alongside the new instance. Use initialization parameters to create boot
2867 # disks or local SSDs attached to the new instance.
2868 #
2869 # This property is mutually exclusive with the source property;
2870 # you can only define one or the other, but not both.
2871 # alongside the new instance. Use initialization parameters to create boot
2872 # disks or local SSDs attached to the new instance.
2873 #
2874 # This field is persisted and returned for instanceTemplate and not returned
2875 # in the context of instance.
2876 #
2877 # This property is mutually exclusive with the source property;
2878 # you can only define one or the other, but not both.
2879 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
2880 # arm64 or x86_64.
2881 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
2882 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
2883 # of the instance. If a disk with the same name already exists in the given
2884 # region, the existing disk is attached to the new instance and the
2885 # new disk is not created.
2886 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
2887 # 10 GB. If you specify a sourceImage, which is required for
2888 # boot disks, the default size is the size of the sourceImage.
2889 # If you do not specify a sourceImage, the default disk size
2890 # is 500 GB.
2891 &quot;diskType&quot;: &quot;A String&quot;,
2892 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
2893 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2894 # only for bootable images. Read
2895 # Enabling guest operating system features to see a list of available
2896 # options.
2897 #
2898 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
2899 { # Guest OS features.
2900 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2901 # separate values. Set to one or more of the following values:
2902 #
2903 # - VIRTIO_SCSI_MULTIQUEUE
2904 # - WINDOWS
2905 # - MULTI_IP_SUBNET
2906 # - UEFI_COMPATIBLE
2907 # - GVNIC
2908 # - SEV_CAPABLE
2909 # - SUSPEND_RESUME_COMPATIBLE
2910 # - SEV_LIVE_MIGRATABLE_V2
2911 # - SEV_SNP_CAPABLE
2912 # - TDX_CAPABLE
2913 # - IDPF
2914 # - SNP_SVSM_CAPABLE
2915 # - CCA_CAPABLE
2916 #
2917 #
2918 # For more information, see
2919 # Enabling guest operating system features.
2920 },
2921 ],
2922 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
2923 # which is either SCSI or NVME. The default isSCSI.
2924 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
2925 # persistent disks.
2926 &quot;a_key&quot;: &quot;A String&quot;,
2927 },
2928 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
2929 # disk.
2930 &quot;A String&quot;,
2931 ],
2932 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
2933 &quot;A String&quot;,
2934 ],
2935 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
2936 # more than one instance.
2937 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
2938 # is to use the existing disk.
2939 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
2940 # of I/O operations per second that the disk can handle. Values must be
2941 # between 10,000 and 120,000. For more details, see theExtreme persistent
2942 # disk documentation.
2943 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
2944 # number of throughput mb per second that the disk can handle. Values must
2945 # greater than or equal to 1.
2946 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
2947 # the URLs of the zones where the disk should be replicated to.
2948 # You must provide exactly two replica zones, and one zone must be the same
2949 # as the instance zone.
2950 &quot;A String&quot;,
2951 ],
2952 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
2953 # have the same definition as resource
2954 # manager tags. Keys and values can be either in numeric format,
2955 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
2956 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
2957 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
2958 # empty.
2959 &quot;a_key&quot;: &quot;A String&quot;,
2960 },
2961 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
2962 # Specified using the full or partial URL. For instance template, specify
2963 # only the resource policy name.
2964 &quot;A String&quot;,
2965 ],
2966 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
2967 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
2968 # is required.
2969 #
2970 # To create a disk with one of the public operating system
2971 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
2972 #
2973 # projects/debian-cloud/global/images/family/debian-9
2974 #
2975 #
2976 # Alternatively, use a specific version of a public operating system image:
2977 #
2978 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
2979 #
2980 #
2981 # To create a disk with a custom image that you created, specify the
2982 # image name in the following format:
2983 #
2984 # global/images/my-custom-image
2985 #
2986 #
2987 # You can also specify a custom image by its image family, which returns
2988 # the latest version of the image in that family. Replace the image name
2989 # with family/family-name:
2990 #
2991 # global/images/family/my-image-family
2992 #
2993 #
2994 # If the source image is deleted later, this field will not be set.
2995 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
2996 # encryption key of the source image. Required if the source image is
2997 # protected by a customer-supplied encryption key.
2998 #
2999 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
3000 # encryption keys, so you cannot create disks for instances in a managed instance group if the
3001 # source images are encrypted with your own keys.
3002 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3003 # For example:
3004 #
3005 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3006 # key_region/cryptoKeys/key
3007 #
3008 # The fully-qualifed key name may be returned for resource GET requests. For
3009 # example:
3010 #
3011 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3012 # key_region/cryptoKeys/key
3013 # /cryptoKeyVersions/1
3014 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3015 # key. If absent, the Compute Engine default service account is used.
3016 # For example:
3017 #
3018 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3019 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3020 # encryption key, encoded in RFC
3021 # 4648 base64 to either encrypt or decrypt this resource. You can
3022 # provide either the rawKey or thersaEncryptedKey.
3023 # For example:
3024 #
3025 # &quot;rawKey&quot;:
3026 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3027 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3028 # customer-supplied encryption key to either encrypt or decrypt this
3029 # resource. You can provide either the rawKey or thersaEncryptedKey.
3030 # For example:
3031 #
3032 # &quot;rsaEncryptedKey&quot;:
3033 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3034 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3035 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3036 #
3037 # The key must meet the following requirements before you can provide it to
3038 # Compute Engine:
3039 #
3040 # 1. The key is wrapped using a RSA public key certificate provided by
3041 # Google.
3042 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3043 # encoding.
3044 #
3045 # Gets the RSA public key certificate provided by Google at:
3046 #
3047 #
3048 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3049 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3050 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3051 # encryption key that protects this resource.
3052 },
3053 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
3054 # instance boot disk, one of initializeParams.sourceSnapshot
3055 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
3056 # is required.
3057 #
3058 # To create a disk with a snapshot that you created, specify the
3059 # snapshot name in the following format:
3060 #
3061 # us-central1-a/instantSnapshots/my-backup
3062 #
3063 #
3064 # If the source instant-snapshot is deleted later, this field will not be
3065 # set.
3066 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
3067 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
3068 # is required.
3069 #
3070 # To create a disk with a snapshot that you created, specify the
3071 # snapshot name in the following format:
3072 #
3073 # global/snapshots/my-backup
3074 #
3075 #
3076 # If the source snapshot is deleted later, this field will not be set.
3077 #
3078 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
3079 # an image instead when you create VMs using
3080 # the bulk
3081 # insert method.
3082 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3083 # encryption key of the source snapshot.
3084 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3085 # For example:
3086 #
3087 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3088 # key_region/cryptoKeys/key
3089 #
3090 # The fully-qualifed key name may be returned for resource GET requests. For
3091 # example:
3092 #
3093 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3094 # key_region/cryptoKeys/key
3095 # /cryptoKeyVersions/1
3096 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3097 # key. If absent, the Compute Engine default service account is used.
3098 # For example:
3099 #
3100 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3101 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3102 # encryption key, encoded in RFC
3103 # 4648 base64 to either encrypt or decrypt this resource. You can
3104 # provide either the rawKey or thersaEncryptedKey.
3105 # For example:
3106 #
3107 # &quot;rawKey&quot;:
3108 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3109 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3110 # customer-supplied encryption key to either encrypt or decrypt this
3111 # resource. You can provide either the rawKey or thersaEncryptedKey.
3112 # For example:
3113 #
3114 # &quot;rsaEncryptedKey&quot;:
3115 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3116 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3117 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3118 #
3119 # The key must meet the following requirements before you can provide it to
3120 # Compute Engine:
3121 #
3122 # 1. The key is wrapped using a RSA public key certificate provided by
3123 # Google.
3124 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3125 # encoding.
3126 #
3127 # Gets the RSA public key certificate provided by Google at:
3128 #
3129 #
3130 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3131 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3132 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3133 # encryption key that protects this resource.
3134 },
3135 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3136 # this as a partial or full URL to the resource. For example, the following
3137 # are valid values:
3138 #
3139 #
3140 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3141 # - projects/project/zones/zone/storagePools/storagePool
3142 # - zones/zone/storagePools/storagePool
3143 },
3144 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
3145 # either SCSI or NVME. For most machine types, the
3146 # default is SCSI. Local SSDs can use either NVME or SCSI.
3147 # In certain configurations, persistent disks can use NVMe. For more
3148 # information, seeAbout
3149 # persistent disks.
3150 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
3151 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
3152 &quot;A String&quot;,
3153 ],
3154 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
3155 # disk is not allowed to be detached from the instance, or to be used as the
3156 # source of the snapshot creation, and the image creation. The instance with
3157 # at least one locked attached disk is not allow to be used as source of
3158 # machine image creation, instant snapshot creation, and not allowed to be
3159 # deleted with --keep-disk parameter set to true for locked disks.
3160 &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
3161 # in READ_WRITE mode.
3162 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
3163 # field is set to PRESERVED if the LocalSSD data has been saved
3164 # to a persistent location by customer request. (see the
3165 # discard_local_ssd option on Stop/Suspend).
3166 # Read-only in the api.
3167 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
3168 # these are public keys which are safe to store in public
3169 &quot;dbs&quot;: [ # The Key Database (db).
3170 {
3171 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3172 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3173 },
3174 ],
3175 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
3176 {
3177 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3178 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3179 },
3180 ],
3181 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
3182 {
3183 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3184 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3185 },
3186 ],
3187 &quot;pk&quot;: { # The Platform Key (PK).
3188 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3189 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3190 },
3191 },
3192 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
3193 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3194 # is required.
3195 #
3196 # If desired, you can also attach existing non-root persistent disks using
3197 # this property. This field is only applicable for persistent disks.
3198 #
3199 # Note that for InstanceTemplate, specify the disk name for zonal disk,
3200 # and the URL for regional disk.
3201 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
3202 },
3203 ],
3204 &quot;displayDevice&quot;: { # A set of Display Device options # Display Device properties to enable support
3205 # for remote display products like: Teradici,
3206 # VNC and TeamViewer
3207 # Note that for MachineImage, this is not supported yet.
3208 &quot;enableDisplay&quot;: True or False, # Defines whether the instance has Display enabled.
3209 },
3210 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
3211 # created from these properties.
3212 { # A specification of the type and number of accelerator cards attached to the
3213 # instance.
3214 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
3215 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
3216 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
3217 # If you are creating an instance template, specify only the
3218 # accelerator name.
3219 # See GPUs on Compute Engine
3220 # for a full list of accelerator types.
3221 },
3222 ],
3223 &quot;identity&quot;: &quot;A String&quot;,
3224 &quot;identityCertificate&quot;: True or False,
3225 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
3226 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
3227 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
3228 &quot;a_key&quot;: &quot;A String&quot;,
3229 },
3230 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
3231 # properties.
3232 # This field only accepts a machine type name, for example `n2-standard-4`.
3233 # If you use the machine type full or partial URL, for example
3234 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
3235 # the request will result in an `INTERNAL_ERROR`.
3236 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
3237 # these properties. These pairs can consist of custom metadata or predefined
3238 # keys. SeeProject and
3239 # instance metadata for more information.
3240 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
3241 # the metadata&#x27;s contents and used for optimistic locking. The
3242 # fingerprint is initially generated by Compute Engine and changes after
3243 # every request to modify or update metadata. You must always provide an
3244 # up-to-date fingerprint hash in order to update or change metadata,
3245 # otherwise the request will fail with error412 conditionNotMet.
3246 #
3247 # To see the latest fingerprint, make a get() request to
3248 # retrieve the resource.
3249 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
3250 # less than 512 KB.
3251 { # Metadata
3252 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
3253 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
3254 # This is reflected as part of a URL in the metadata server. Additionally, to
3255 # avoid ambiguity, keys must not conflict with any other metadata keys
3256 # for the project.
3257 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
3258 # have meaning as interpreted by the image running in the instance. The
3259 # only restriction placed on values is that their size must be less than
3260 # or equal to 262144 bytes (256 KiB).
3261 },
3262 ],
3263 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
3264 # for metadata.
3265 },
3266 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
3267 # scheduled on the specified or newer cpu/platform. Applicable values are the
3268 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
3269 # information, read Specifying a
3270 # Minimum CPU Platform.
3271 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
3272 { # A network interface resource attached to an instance.
3273 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
3274 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
3275 # no external internet access.
3276 { # An access configuration attached to an instance&#x27;s network interface.
3277 # Only one access config per instance is supported.
3278 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
3279 # The first IPv6 address of the external IPv6 range associated
3280 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
3281 # use a static external IP address, it must be unused and in the same region
3282 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3283 # assign an external IPv6 address from the instance&#x27;s subnetwork.
3284 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
3285 # external IPv6 range.
3286 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
3287 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
3288 # (IPv4), the default and recommended name is External NAT, but
3289 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
3290 # recommend name is External IPv6.
3291 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
3292 # address associated with this instance. Specify an unused static
3293 # external IP address available to the project or leave this field undefined
3294 # to use an IP from a shared ephemeral IP address pool. If you specify a
3295 # static external IP address, it must live in the same region as the zone of
3296 # the instance.
3297 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
3298 # configuration and can only take the following values: PREMIUM,STANDARD.
3299 #
3300 # If an AccessConfig is specified without a valid external IP address, an
3301 # ephemeral IP will be created with this networkTier.
3302 #
3303 # If an AccessConfig with a valid external IP address is specified, it must
3304 # match that of the networkTier associated with the Address resource owning
3305 # that IP.
3306 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
3307 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
3308 #
3309 # 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
3310 # first IP in associated external IPv6 range.
3311 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
3312 # config.
3313 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
3314 # external IP address of this access configuration.
3315 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
3316 # external IP address of the instance to a DNS domain name.
3317 #
3318 # This field is not used in ipv6AccessConfig. A default PTR
3319 # record will be created if the VM has external IPv6 range associated.
3320 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
3321 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
3322 },
3323 ],
3324 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
3325 # You can only specify this field for network interfaces in VPC networks.
3326 { # An alias IP range attached to an instance&#x27;s network interface.
3327 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
3328 # must belong to the specified subnetwork and cannot contain IP addresses
3329 # reserved by system or used by other network interfaces. This range may be
3330 # 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).
3331 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
3332 # alias range. If not specified, the primary range of the subnetwork is used.
3333 },
3334 ],
3335 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
3336 # You can only specify this field for network interfaces in VPC networks.
3337 { # An alias IP range attached to an instance&#x27;s network interface.
3338 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
3339 # must belong to the specified subnetwork and cannot contain IP addresses
3340 # reserved by system or used by other network interfaces. This range may be
3341 # 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).
3342 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
3343 # alias range. If not specified, the primary range of the subnetwork is used.
3344 },
3345 ],
3346 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
3347 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
3348 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
3349 # with network_attachment.
3350 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
3351 # This field will be ignored when inserting an Instance or
3352 # adding a NetworkInterface. An up-to-date
3353 # 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.
3354 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
3355 # or not. If enabled, also indicates the version of IGMP supported.
3356 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
3357 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
3358 # one IPv6 access config, DIRECT_IPV6, is supported. If there
3359 # is no ipv6AccessConfig specified, then this instance will
3360 # have no external IPv6 Internet access.
3361 { # An access configuration attached to an instance&#x27;s network interface.
3362 # Only one access config per instance is supported.
3363 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
3364 # The first IPv6 address of the external IPv6 range associated
3365 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
3366 # use a static external IP address, it must be unused and in the same region
3367 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3368 # assign an external IPv6 address from the instance&#x27;s subnetwork.
3369 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
3370 # external IPv6 range.
3371 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
3372 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
3373 # (IPv4), the default and recommended name is External NAT, but
3374 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
3375 # recommend name is External IPv6.
3376 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
3377 # address associated with this instance. Specify an unused static
3378 # external IP address available to the project or leave this field undefined
3379 # to use an IP from a shared ephemeral IP address pool. If you specify a
3380 # static external IP address, it must live in the same region as the zone of
3381 # the instance.
3382 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
3383 # configuration and can only take the following values: PREMIUM,STANDARD.
3384 #
3385 # If an AccessConfig is specified without a valid external IP address, an
3386 # ephemeral IP will be created with this networkTier.
3387 #
3388 # If an AccessConfig with a valid external IP address is specified, it must
3389 # match that of the networkTier associated with the Address resource owning
3390 # that IP.
3391 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
3392 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
3393 #
3394 # 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
3395 # first IP in associated external IPv6 range.
3396 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
3397 # config.
3398 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
3399 # external IP address of this access configuration.
3400 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
3401 # external IP address of the instance to a DNS domain name.
3402 #
3403 # This field is not used in ipv6AccessConfig. A default PTR
3404 # record will be created if the VM has external IPv6 range associated.
3405 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
3406 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
3407 },
3408 ],
3409 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
3410 # accessed from the Internet. This field is always inherited from its
3411 # subnetwork.
3412 #
3413 # Valid only if stackType is IPV4_IPV6.
3414 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
3415 # use a static internal IP address, it must be unused and in the same region
3416 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
3417 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
3418 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
3419 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
3420 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
3421 # server. For a VM, the network interface uses the nicN naming
3422 # format. Where N is a value between 0 and7. The default interface value is nic0.
3423 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
3424 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
3425 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
3426 # instance, if neither the network nor the subnetwork is specified, the
3427 # default network global/networks/default is used. If the
3428 # selected project doesn&#x27;t have the default network, you must specify a
3429 # network or subnet. If the network is not specified but the subnetwork is
3430 # specified, the network is inferred.
3431 #
3432 # If you specify this property, you can specify the network as
3433 # a full or partial URL. For example, the following are all valid URLs:
3434 #
3435 #
3436 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
3437 # - projects/project/global/networks/network
3438 # - global/networks/default
3439 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
3440 # to in the following format:
3441 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
3442 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
3443 # interface. If not specified by the user, an unused internal IP is
3444 # assigned by the system.
3445 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
3446 # VirtioNet.
3447 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
3448 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
3449 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
3450 # if not specified by the users.
3451 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
3452 # interface. Can only be used with network_attachment. It is not possible to
3453 # use on its own however, network_attachment can be used without
3454 # service_class_id.
3455 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
3456 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
3457 #
3458 # This field can be both set at instance creation and update network
3459 # interface operations.
3460 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
3461 # subnetworks that support L2. Every network interface will get a default
3462 # untagged (vlan not specified) subinterface. Users can specify additional
3463 # tagged subinterfaces which are sub-fields to the Network Interface.
3464 {
3465 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
3466 # subinterface. If specified, ip_allocation_mode should be set to
3467 # ALLOCATE_IP.
3468 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
3469 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
3470 # as that of the network interface.
3471 # If not specified the subnet of network interface will be used.
3472 # If you specify this property, you can specify the subnetwork as a full
3473 # or partial URL. For example, the following are all valid URLs:
3474 #
3475 #
3476 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
3477 # - regions/region/subnetworks/subnetwork
3478 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
3479 # this subinterface is connecting.
3480 },
3481 ],
3482 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
3483 # resource is inlegacy
3484 # mode, do not specify this field. If the network is in auto subnet
3485 # mode, specifying the subnetwork is optional. If the network is in custom
3486 # subnet mode, specifying the subnetwork is required. If you specify this
3487 # field, you can specify the subnetwork as a full or partial URL. For
3488 # example, the following are all valid URLs:
3489 #
3490 #
3491 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
3492 # - regions/region/subnetworks/subnetwork
3493 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
3494 # from 2 to 255 inclusively.
3495 },
3496 ],
3497 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
3498 &quot;externalIpEgressBandwidthTier&quot;: &quot;A String&quot;,
3499 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
3500 },
3501 &quot;partnerMetadata&quot;: { # Partner Metadata assigned to the instance properties. A map from a
3502 # subdomain (namespace) to entries map.
3503 &quot;a_key&quot;: {
3504 &quot;entries&quot;: { # Map of a partner metadata that belong to the same subdomain.
3505 # It accepts any value including google.protobuf.Struct.
3506 &quot;a_key&quot;: &quot;&quot;,
3507 },
3508 },
3509 },
3510 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
3511 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
3512 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
3513 # Note that for MachineImage, this is not supported yet.
3514 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
3515 # Note that for MachineImage, this is not supported yet.
3516 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
3517 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
3518 # Consuming reserved instances for examples.
3519 &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
3520 # the name of your reservation as its value.
3521 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
3522 # either a name to a reservation in the same project or
3523 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
3524 # shared reservation in the same zone but in a different project.
3525 &quot;A String&quot;,
3526 ],
3527 },
3528 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
3529 # have the same definition as resource
3530 # manager tags. Keys and values can be either in numeric format,
3531 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3532 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3533 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
3534 # PATCH) when empty.
3535 &quot;a_key&quot;: &quot;A String&quot;,
3536 },
3537 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
3538 # these properties.
3539 # Note that for MachineImage, this is not supported yet.
3540 &quot;A String&quot;,
3541 ],
3542 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
3543 # these properties.
3544 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
3545 # terminated by Compute Engine (not terminated by a user). You can only set
3546 # the automatic restart option for standard instances.Preemptible instances
3547 # cannot be automatically restarted.
3548 #
3549 # By default, this is set to true so an instance is
3550 # automatically restarted if it is terminated by Compute Engine.
3551 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
3552 # must be a number between 1 and the number of availability domains
3553 # specified in the spread placement policy attached to the instance.
3554 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
3555 # 0 or unset means default vCPUs of the current machine type.
3556 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
3557 # 0 or unset means default amount of memory of the current machine type.
3558 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
3559 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
3560 &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
3561 # graceful shutdown isn&#x27;t complete after this time, then the instance
3562 # transitions to the STOPPING state.
3563 # as a count of seconds and fractions of seconds at nanosecond
3564 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3565 # or &quot;month&quot;. Range is approximately 10,000 years.
3566 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3567 # Durations less than one second are represented with a 0
3568 # `seconds` field and a positive `nanos` field. Must be from 0
3569 # to 999,999,999 inclusive.
3570 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3571 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3572 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3573 },
3574 },
3575 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
3576 # within the range of [90, 330] with the increment of 30, if unset, the
3577 # default behavior of host error recovery will be used.
3578 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
3579 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
3580 # only be set during instance creation, or when the instance is not currently
3581 # running. It must not be set if thepreemptible option is
3582 # also set.
3583 &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
3584 # recovery of the Local Ssd state is attempted. Its value should be in
3585 # between 0 and 168 hours with hour granularity and the default value being 1
3586 # hour.
3587 # as a count of seconds and fractions of seconds at nanosecond
3588 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3589 # or &quot;month&quot;. Range is approximately 10,000 years.
3590 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3591 # Durations less than one second are represented with a 0
3592 # `seconds` field and a positive `nanos` field. Must be from 0
3593 # to 999,999,999 inclusive.
3594 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3595 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3596 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3597 },
3598 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
3599 # resources.
3600 # This field is for use by internal tools that use the public API.
3601 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
3602 # be scheduled for maintenance.
3603 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
3604 # are: `PERIODIC`.
3605 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
3606 # the instance termination action will be performed at the end of the run
3607 # duration.
3608 # as a count of seconds and fractions of seconds at nanosecond
3609 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3610 # or &quot;month&quot;. Range is approximately 10,000 years.
3611 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3612 # Durations less than one second are represented with a 0
3613 # `seconds` field and a positive `nanos` field. Must be from 0
3614 # to 999,999,999 inclusive.
3615 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3616 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3617 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3618 },
3619 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
3620 # on a sole-tenant node.
3621 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
3622 # affinity for more information.
3623 # Overrides reservationAffinity.
3624 { # Node Affinity: the configuration of desired nodes onto which this Instance
3625 # could be scheduled.
3626 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
3627 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
3628 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
3629 &quot;A String&quot;,
3630 ],
3631 },
3632 ],
3633 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
3634 # the default behavior is MIGRATE. Forpreemptible instances,
3635 # the default and only possible behavior is TERMINATE. For more
3636 # information, see
3637 # Set
3638 # VM host maintenance policy.
3639 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
3640 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
3641 # else, the Local SSD data will be preserved when the instance is stopped
3642 # at the end of the run duration/termination time.
3643 },
3644 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
3645 # instance creation or while the instance isstopped and
3646 # therefore, in a `TERMINATED` state. SeeInstance Life
3647 # Cycle for more information on the possible instance states.
3648 &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
3649 # Off signal is triggered for Spot
3650 # VMs only. If not specified, there will be no wait before the G2 Soft
3651 # Off signal is triggered.
3652 # as a count of seconds and fractions of seconds at nanosecond
3653 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3654 # or &quot;month&quot;. Range is approximately 10,000 years.
3655 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3656 # Durations less than one second are represented with a 0
3657 # `seconds` field and a positive `nanos` field. Must be from 0
3658 # to 999,999,999 inclusive.
3659 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3660 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3661 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3662 },
3663 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
3664 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
3665 # Timeout between GCE ACPI G2 Soft
3666 # Off and ACPI G3 Mechanical
3667 # Off during shutdown operation of VM.
3668 #
3669 # For Standard VMs values between 0s and 120s are allowed. For Spot and
3670 # Preemptible VMs supported values are between 0s and 30s.
3671 #
3672 # If no value is specified for shutdownDuration, default values are 90s for
3673 # Standard VMs and 30s for Spot/Preemptible VMs.
3674 # as a count of seconds and fractions of seconds at nanosecond
3675 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
3676 # or &quot;month&quot;. Range is approximately 10,000 years.
3677 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
3678 # Durations less than one second are represented with a 0
3679 # `seconds` field and a positive `nanos` field. Must be from 0
3680 # to 999,999,999 inclusive.
3681 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
3682 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
3683 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
3684 },
3685 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
3686 # Off and ACPI G3 Mechanical
3687 # Off for Standard VMs and 30 seconds for Spot VMs.
3688 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
3689 # termination action will be performed at the termination time.
3690 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
3691 &quot;mode&quot;: &quot;A String&quot;,
3692 },
3693 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
3694 # unspecified, the default mode is `OFF`.
3695 },
3696 &quot;secureTags&quot;: [ # [Input Only] Secure tags to apply to this instance.
3697 # Maximum number of secure tags allowed is 50.
3698 # Note that for MachineImage, this is not supported yet.
3699 &quot;A String&quot;,
3700 ],
3701 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
3702 # service accounts are available to the instances that are created from
3703 # these properties. Use metadata queries to obtain the access tokens for
3704 # these instances.
3705 { # A service account.
3706 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
3707 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
3708 &quot;A String&quot;,
3709 ],
3710 },
3711 ],
3712 &quot;serviceIntegrationSpecs&quot;: { # Mapping of user defined keys to ServiceIntegrationSpec.
3713 &quot;a_key&quot;: { # Specifies the parameters to configure an integration with instances.
3714 &quot;backupDr&quot;: { # Specifies parameters to Backup and DR to attach a BackupPlan to a compute
3715 # instance for managed VM backup.
3716 &quot;plan&quot;: &quot;A String&quot;, # The BackupPlan resource to attach to the instance. Specified as a
3717 # resource reference in instances, and regional instance templates, and as
3718 # just the plan name in global instance templates
3719 },
3720 },
3721 },
3722 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
3723 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
3724 # default.
3725 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
3726 # default.
3727 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
3728 # default.
3729 },
3730 &quot;shieldedVmConfig&quot;: { # A set of Shielded VM options. # Specifies the Shielded VM options for the instances that are created from
3731 # these properties.
3732 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.
3733 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.
3734 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.
3735 },
3736 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
3737 # properties. The tags identify valid sources or targets for network
3738 # firewalls. The setTags method can modify this list of tags. Each tag within
3739 # the list must comply with RFC1035.
3740 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
3741 # the tags&#x27; contents and used for optimistic locking. The
3742 # fingerprint is initially generated by Compute Engine and changes after
3743 # every request to modify or update tags. You must always provide an
3744 # up-to-date fingerprint hash in order to update or change tags.
3745 #
3746 # To see the latest fingerprint, make get() request to the
3747 # instance.
3748 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
3749 # with RFC1035.
3750 &quot;A String&quot;,
3751 ],
3752 },
3753 &quot;workloadIdentityConfig&quot;: {
3754 &quot;identity&quot;: &quot;A String&quot;,
3755 &quot;identityCertificateEnabled&quot;: True or False,
3756 },
3757 },
3758 &quot;kind&quot;: &quot;compute#machineImage&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.
3759 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this machine image, which is
3760 # essentially a hash of the labels set used for optimistic locking. The
3761 # fingerprint is initially generated by Compute Engine and changes after
3762 # every request to modify or update labels. You must always provide an
3763 # up-to-date fingerprint hash in order to update or change labels.
3764 #
3765 # To see the latest fingerprint, make get() request to the
3766 # machine image.
3767 &quot;labels&quot;: { # Labels to apply to this machine image. These can be later modified by
3768 # the setLabels method.
3769 &quot;a_key&quot;: &quot;A String&quot;,
3770 },
3771 &quot;machineImageEncryptionKey&quot;: { # Encrypts the machine image using acustomer-supplied
3772 # encryption key.
3773 #
3774 # After you encrypt a machine image using a customer-supplied key, you must
3775 # provide the same key if you use the machine image later. For example, you
3776 # must provide the encryption key when you create an instance from the
3777 # encrypted machine image in a future request.
3778 #
3779 # Customer-supplied encryption keys do not protect access to metadata of the
3780 # machine image.
3781 #
3782 # If you do not provide an encryption key when creating the machine image,
3783 # then the machine image will be encrypted using an automatically generated
3784 # key and you do not need to provide a key to use the machine image later.
3785 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3786 # For example:
3787 #
3788 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3789 # key_region/cryptoKeys/key
3790 #
3791 # The fully-qualifed key name may be returned for resource GET requests. For
3792 # example:
3793 #
3794 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3795 # key_region/cryptoKeys/key
3796 # /cryptoKeyVersions/1
3797 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3798 # key. If absent, the Compute Engine default service account is used.
3799 # For example:
3800 #
3801 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3802 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3803 # encryption key, encoded in RFC
3804 # 4648 base64 to either encrypt or decrypt this resource. You can
3805 # provide either the rawKey or thersaEncryptedKey.
3806 # For example:
3807 #
3808 # &quot;rawKey&quot;:
3809 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3810 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3811 # customer-supplied encryption key to either encrypt or decrypt this
3812 # resource. You can provide either the rawKey or thersaEncryptedKey.
3813 # For example:
3814 #
3815 # &quot;rsaEncryptedKey&quot;:
3816 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3817 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3818 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3819 #
3820 # The key must meet the following requirements before you can provide it to
3821 # Compute Engine:
3822 #
3823 # 1. The key is wrapped using a RSA public key certificate provided by
3824 # Google.
3825 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3826 # encoding.
3827 #
3828 # Gets the RSA public key certificate provided by Google at:
3829 #
3830 #
3831 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3832 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3833 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3834 # encryption key that protects this resource.
3835 },
3836 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
3837 # The name must be 1-63 characters long, and comply withRFC1035.
3838 # Specifically, the name must be 1-63 characters long and match the regular
3839 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
3840 # character must be a lowercase letter, and all following characters must be
3841 # a dash, lowercase letter, or digit, except the last character, which cannot
3842 # be a dash.
3843 &quot;params&quot;: { # Machine Image parameters # Input only. [Input Only] Additional parameters that are passed in the request, but are
3844 # not persisted in the resource.
3845 &quot;excludedDisks&quot;: [ # Input only. [Input Only] Specifies the list of disk device names that must be
3846 # excluded from the new machine image.
3847 &quot;A String&quot;,
3848 ],
3849 &quot;includedDisks&quot;: [ # Input only. [Input Only] Specifies the list of disk device names that must be
3850 # included with the new machine image.
3851 &quot;A String&quot;,
3852 ],
3853 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the machine image. Tag keys and values
3854 # have the same definition as resource
3855 # manager tags. Keys and values can be either in numeric format,
3856 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3857 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3858 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
3859 # PATCH) when empty.
3860 &quot;a_key&quot;: &quot;A String&quot;,
3861 },
3862 },
3863 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
3864 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
3865 &quot;savedDisks&quot;: [ # Output only. An array of Machine Image specific properties for disks attached to the
3866 # source instance
3867 { # An instance-attached disk resource.
3868 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk.
3869 &quot;kind&quot;: &quot;compute#savedDisk&quot;, # Output only. [Output Only] Type of the resource. Always compute#savedDisk
3870 # for attached disks.
3871 &quot;sourceDisk&quot;: &quot;A String&quot;, # Output only. Specifies a URL of the disk attached to the source instance.
3872 &quot;storageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Size of the individual disk snapshot used by this machine
3873 # image.
3874 &quot;storageBytesStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] An indicator whether storageBytes is in a
3875 # stable state or it is being adjusted as a result of shared storage
3876 # reallocation. This status can either be UPDATING, meaning
3877 # the size of the snapshot is being updated, or UP_TO_DATE,
3878 # meaning the size of the snapshot is up-to-date.
3879 },
3880 ],
3881 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this machine image. The server defines this URL.
3882 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
3883 &quot;sourceDiskEncryptionKeys&quot;: [ # [Input Only] Thecustomer-supplied
3884 # encryption key of the disks attached to the source instance. Required
3885 # if the source disk is protected by a customer-supplied encryption key.
3886 {
3887 &quot;diskEncryptionKey&quot;: { # Thecustomer-supplied
3888 # encryption key of the source disk. Required if the source disk is
3889 # protected by a customer-supplied encryption key.
3890 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3891 # For example:
3892 #
3893 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3894 # key_region/cryptoKeys/key
3895 #
3896 # The fully-qualifed key name may be returned for resource GET requests. For
3897 # example:
3898 #
3899 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3900 # key_region/cryptoKeys/key
3901 # /cryptoKeyVersions/1
3902 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3903 # key. If absent, the Compute Engine default service account is used.
3904 # For example:
3905 #
3906 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3907 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3908 # encryption key, encoded in RFC
3909 # 4648 base64 to either encrypt or decrypt this resource. You can
3910 # provide either the rawKey or thersaEncryptedKey.
3911 # For example:
3912 #
3913 # &quot;rawKey&quot;:
3914 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3915 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3916 # customer-supplied encryption key to either encrypt or decrypt this
3917 # resource. You can provide either the rawKey or thersaEncryptedKey.
3918 # For example:
3919 #
3920 # &quot;rsaEncryptedKey&quot;:
3921 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3922 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3923 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3924 #
3925 # The key must meet the following requirements before you can provide it to
3926 # Compute Engine:
3927 #
3928 # 1. The key is wrapped using a RSA public key certificate provided by
3929 # Google.
3930 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3931 # encoding.
3932 #
3933 # Gets the RSA public key certificate provided by Google at:
3934 #
3935 #
3936 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3937 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3938 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3939 # encryption key that protects this resource.
3940 },
3941 &quot;sourceDisk&quot;: &quot;A String&quot;, # URL of the disk attached to the source instance. This can be a full or
3942 # valid partial URL. For example, the following are valid values:
3943 #
3944 #
3945 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
3946 # - projects/project/zones/zone/disks/disk
3947 # - zones/zone/disks/disk
3948 },
3949 ],
3950 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the machine image. You can provide this
3951 # as a partial or full URL to the resource. For example, the following are
3952 # valid values:
3953 #
3954 #
3955 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
3956 # - projects/project/zones/zone/instances/instance
3957 &quot;sourceInstanceProperties&quot;: { # DEPRECATED: Please use compute#instanceProperties instead. # Output only. [Output Only] DEPRECATED: Please use instance_properties
3958 # instead for source instance related properties. New properties will not be
3959 # added to this field.
3960 # New properties will not be added to this field.
3961 &quot;canIpForward&quot;: True or False, # Enables instances created based on this machine image to send packets with
3962 # source IP addresses other than their own and receive packets with
3963 # destination IP addresses other than their own. If these instances will be
3964 # used as an IP gateway or it will be set as the next-hop in a Route
3965 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
3966 # documentation for more information.
3967 &quot;deletionProtection&quot;: True or False, # Whether the instance created from this machine image should be protected
3968 # against deletion.
3969 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from this
3970 # machine image.
3971 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
3972 # from this machine image.
3973 { # DEPRECATED: Please use compute#savedDisk instead.
3974 # An instance-attached disk resource.
3975 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
3976 # deleted (but not when the disk is detached from the instance).
3977 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
3978 # partition of the disk for its root filesystem.
3979 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the name of the disk attached to the source instance.
3980 &quot;diskEncryptionKey&quot;: { # The encryption key for the disk.
3981 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3982 # For example:
3983 #
3984 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3985 # key_region/cryptoKeys/key
3986 #
3987 # The fully-qualifed key name may be returned for resource GET requests. For
3988 # example:
3989 #
3990 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3991 # key_region/cryptoKeys/key
3992 # /cryptoKeyVersions/1
3993 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3994 # key. If absent, the Compute Engine default service account is used.
3995 # For example:
3996 #
3997 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3998 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3999 # encryption key, encoded in RFC
4000 # 4648 base64 to either encrypt or decrypt this resource. You can
4001 # provide either the rawKey or thersaEncryptedKey.
4002 # For example:
4003 #
4004 # &quot;rawKey&quot;:
4005 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4006 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4007 # customer-supplied encryption key to either encrypt or decrypt this
4008 # resource. You can provide either the rawKey or thersaEncryptedKey.
4009 # For example:
4010 #
4011 # &quot;rsaEncryptedKey&quot;:
4012 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4013 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4014 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4015 #
4016 # The key must meet the following requirements before you can provide it to
4017 # Compute Engine:
4018 #
4019 # 1. The key is wrapped using a RSA public key certificate provided by
4020 # Google.
4021 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4022 # encoding.
4023 #
4024 # Gets the RSA public key certificate provided by Google at:
4025 #
4026 #
4027 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4028 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4029 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4030 # encryption key that protects this resource.
4031 },
4032 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in base-2 GB.
4033 &quot;diskType&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or
4034 # pd-ssd
4035 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable only
4036 # for bootable images. Read
4037 # Enabling guest operating system features to see a list of available
4038 # options.
4039 { # Guest OS features.
4040 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4041 # separate values. Set to one or more of the following values:
4042 #
4043 # - VIRTIO_SCSI_MULTIQUEUE
4044 # - WINDOWS
4045 # - MULTI_IP_SUBNET
4046 # - UEFI_COMPATIBLE
4047 # - GVNIC
4048 # - SEV_CAPABLE
4049 # - SUSPEND_RESUME_COMPATIBLE
4050 # - SEV_LIVE_MIGRATABLE_V2
4051 # - SEV_SNP_CAPABLE
4052 # - TDX_CAPABLE
4053 # - IDPF
4054 # - SNP_SVSM_CAPABLE
4055 # - CCA_CAPABLE
4056 #
4057 #
4058 # For more information, see
4059 # Enabling guest operating system features.
4060 },
4061 ],
4062 &quot;index&quot;: 42, # Output only. Specifies zero-based index of the disk that is attached to the source
4063 # instance.
4064 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
4065 # either SCSI or NVME.
4066 &quot;kind&quot;: &quot;compute#savedAttachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
4067 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
4068 &quot;A String&quot;,
4069 ],
4070 &quot;mode&quot;: &quot;A String&quot;, # The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY.
4071 &quot;source&quot;: &quot;A String&quot;, # Specifies a URL of the disk attached to the source instance.
4072 &quot;storageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] A size of the storage used by the disk&#x27;s snapshot by this
4073 # machine image.
4074 &quot;storageBytesStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] An indicator whether storageBytes is in a
4075 # stable state or it is being adjusted as a result of shared storage
4076 # reallocation. This status can either be UPDATING, meaning
4077 # the size of the snapshot is being updated, or UP_TO_DATE,
4078 # meaning the size of the snapshot is up-to-date.
4079 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the attached disk, either SCRATCH orPERSISTENT.
4080 },
4081 ],
4082 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
4083 # created from this machine image.
4084 { # A specification of the type and number of accelerator cards attached to the
4085 # instance.
4086 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
4087 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
4088 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
4089 # If you are creating an instance template, specify only the
4090 # accelerator name.
4091 # See GPUs on Compute Engine
4092 # for a full list of accelerator types.
4093 },
4094 ],
4095 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
4096 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
4097 &quot;labels&quot;: { # Labels to apply to instances that are created from this machine image.
4098 &quot;a_key&quot;: &quot;A String&quot;,
4099 },
4100 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from this machine
4101 # image.
4102 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
4103 # this machine image. These pairs can consist of custom metadata or
4104 # predefined keys. SeeProject and
4105 # instance metadata for more information.
4106 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
4107 # the metadata&#x27;s contents and used for optimistic locking. The
4108 # fingerprint is initially generated by Compute Engine and changes after
4109 # every request to modify or update metadata. You must always provide an
4110 # up-to-date fingerprint hash in order to update or change metadata,
4111 # otherwise the request will fail with error412 conditionNotMet.
4112 #
4113 # To see the latest fingerprint, make a get() request to
4114 # retrieve the resource.
4115 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
4116 # less than 512 KB.
4117 { # Metadata
4118 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
4119 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
4120 # This is reflected as part of a URL in the metadata server. Additionally, to
4121 # avoid ambiguity, keys must not conflict with any other metadata keys
4122 # for the project.
4123 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
4124 # have meaning as interpreted by the image running in the instance. The
4125 # only restriction placed on values is that their size must be less than
4126 # or equal to 262144 bytes (256 KiB).
4127 },
4128 ],
4129 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
4130 # for metadata.
4131 },
4132 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances created from this machine
4133 # image. The instance may be scheduled on the specified or newer
4134 # cpu/platform. Applicable values are the friendly names of CPU platforms,
4135 # such as minCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
4136 # information, read Specifying a
4137 # Minimum CPU Platform.
4138 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
4139 { # A network interface resource attached to an instance.
4140 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
4141 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
4142 # no external internet access.
4143 { # An access configuration attached to an instance&#x27;s network interface.
4144 # Only one access config per instance is supported.
4145 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
4146 # The first IPv6 address of the external IPv6 range associated
4147 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
4148 # use a static external IP address, it must be unused and in the same region
4149 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
4150 # assign an external IPv6 address from the instance&#x27;s subnetwork.
4151 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
4152 # external IPv6 range.
4153 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
4154 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
4155 # (IPv4), the default and recommended name is External NAT, but
4156 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
4157 # recommend name is External IPv6.
4158 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
4159 # address associated with this instance. Specify an unused static
4160 # external IP address available to the project or leave this field undefined
4161 # to use an IP from a shared ephemeral IP address pool. If you specify a
4162 # static external IP address, it must live in the same region as the zone of
4163 # the instance.
4164 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
4165 # configuration and can only take the following values: PREMIUM,STANDARD.
4166 #
4167 # If an AccessConfig is specified without a valid external IP address, an
4168 # ephemeral IP will be created with this networkTier.
4169 #
4170 # If an AccessConfig with a valid external IP address is specified, it must
4171 # match that of the networkTier associated with the Address resource owning
4172 # that IP.
4173 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
4174 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
4175 #
4176 # 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
4177 # first IP in associated external IPv6 range.
4178 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
4179 # config.
4180 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
4181 # external IP address of this access configuration.
4182 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
4183 # external IP address of the instance to a DNS domain name.
4184 #
4185 # This field is not used in ipv6AccessConfig. A default PTR
4186 # record will be created if the VM has external IPv6 range associated.
4187 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
4188 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
4189 },
4190 ],
4191 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
4192 # You can only specify this field for network interfaces in VPC networks.
4193 { # An alias IP range attached to an instance&#x27;s network interface.
4194 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
4195 # must belong to the specified subnetwork and cannot contain IP addresses
4196 # reserved by system or used by other network interfaces. This range may be
4197 # 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).
4198 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
4199 # alias range. If not specified, the primary range of the subnetwork is used.
4200 },
4201 ],
4202 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
4203 # You can only specify this field for network interfaces in VPC networks.
4204 { # An alias IP range attached to an instance&#x27;s network interface.
4205 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
4206 # must belong to the specified subnetwork and cannot contain IP addresses
4207 # reserved by system or used by other network interfaces. This range may be
4208 # 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).
4209 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
4210 # alias range. If not specified, the primary range of the subnetwork is used.
4211 },
4212 ],
4213 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
4214 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
4215 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
4216 # with network_attachment.
4217 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
4218 # This field will be ignored when inserting an Instance or
4219 # adding a NetworkInterface. An up-to-date
4220 # 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.
4221 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
4222 # or not. If enabled, also indicates the version of IGMP supported.
4223 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
4224 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
4225 # one IPv6 access config, DIRECT_IPV6, is supported. If there
4226 # is no ipv6AccessConfig specified, then this instance will
4227 # have no external IPv6 Internet access.
4228 { # An access configuration attached to an instance&#x27;s network interface.
4229 # Only one access config per instance is supported.
4230 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
4231 # The first IPv6 address of the external IPv6 range associated
4232 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
4233 # use a static external IP address, it must be unused and in the same region
4234 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
4235 # assign an external IPv6 address from the instance&#x27;s subnetwork.
4236 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
4237 # external IPv6 range.
4238 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
4239 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
4240 # (IPv4), the default and recommended name is External NAT, but
4241 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
4242 # recommend name is External IPv6.
4243 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
4244 # address associated with this instance. Specify an unused static
4245 # external IP address available to the project or leave this field undefined
4246 # to use an IP from a shared ephemeral IP address pool. If you specify a
4247 # static external IP address, it must live in the same region as the zone of
4248 # the instance.
4249 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
4250 # configuration and can only take the following values: PREMIUM,STANDARD.
4251 #
4252 # If an AccessConfig is specified without a valid external IP address, an
4253 # ephemeral IP will be created with this networkTier.
4254 #
4255 # If an AccessConfig with a valid external IP address is specified, it must
4256 # match that of the networkTier associated with the Address resource owning
4257 # that IP.
4258 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
4259 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
4260 #
4261 # 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
4262 # first IP in associated external IPv6 range.
4263 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
4264 # config.
4265 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
4266 # external IP address of this access configuration.
4267 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
4268 # external IP address of the instance to a DNS domain name.
4269 #
4270 # This field is not used in ipv6AccessConfig. A default PTR
4271 # record will be created if the VM has external IPv6 range associated.
4272 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
4273 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
4274 },
4275 ],
4276 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
4277 # accessed from the Internet. This field is always inherited from its
4278 # subnetwork.
4279 #
4280 # Valid only if stackType is IPV4_IPV6.
4281 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
4282 # use a static internal IP address, it must be unused and in the same region
4283 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
4284 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
4285 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
4286 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
4287 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
4288 # server. For a VM, the network interface uses the nicN naming
4289 # format. Where N is a value between 0 and7. The default interface value is nic0.
4290 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
4291 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
4292 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
4293 # instance, if neither the network nor the subnetwork is specified, the
4294 # default network global/networks/default is used. If the
4295 # selected project doesn&#x27;t have the default network, you must specify a
4296 # network or subnet. If the network is not specified but the subnetwork is
4297 # specified, the network is inferred.
4298 #
4299 # If you specify this property, you can specify the network as
4300 # a full or partial URL. For example, the following are all valid URLs:
4301 #
4302 #
4303 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
4304 # - projects/project/global/networks/network
4305 # - global/networks/default
4306 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
4307 # to in the following format:
4308 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
4309 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
4310 # interface. If not specified by the user, an unused internal IP is
4311 # assigned by the system.
4312 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
4313 # VirtioNet.
4314 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
4315 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
4316 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
4317 # if not specified by the users.
4318 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
4319 # interface. Can only be used with network_attachment. It is not possible to
4320 # use on its own however, network_attachment can be used without
4321 # service_class_id.
4322 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
4323 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
4324 #
4325 # This field can be both set at instance creation and update network
4326 # interface operations.
4327 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
4328 # subnetworks that support L2. Every network interface will get a default
4329 # untagged (vlan not specified) subinterface. Users can specify additional
4330 # tagged subinterfaces which are sub-fields to the Network Interface.
4331 {
4332 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
4333 # subinterface. If specified, ip_allocation_mode should be set to
4334 # ALLOCATE_IP.
4335 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
4336 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
4337 # as that of the network interface.
4338 # If not specified the subnet of network interface will be used.
4339 # If you specify this property, you can specify the subnetwork as a full
4340 # or partial URL. For example, the following are all valid URLs:
4341 #
4342 #
4343 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
4344 # - regions/region/subnetworks/subnetwork
4345 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
4346 # this subinterface is connecting.
4347 },
4348 ],
4349 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
4350 # resource is inlegacy
4351 # mode, do not specify this field. If the network is in auto subnet
4352 # mode, specifying the subnetwork is optional. If the network is in custom
4353 # subnet mode, specifying the subnetwork is required. If you specify this
4354 # field, you can specify the subnetwork as a full or partial URL. For
4355 # example, the following are all valid URLs:
4356 #
4357 #
4358 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
4359 # - regions/region/subnetworks/subnetwork
4360 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
4361 # from 2 to 255 inclusively.
4362 },
4363 ],
4364 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
4365 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
4366 # this machine image.
4367 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
4368 # terminated by Compute Engine (not terminated by a user). You can only set
4369 # the automatic restart option for standard instances.Preemptible instances
4370 # cannot be automatically restarted.
4371 #
4372 # By default, this is set to true so an instance is
4373 # automatically restarted if it is terminated by Compute Engine.
4374 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
4375 # must be a number between 1 and the number of availability domains
4376 # specified in the spread placement policy attached to the instance.
4377 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
4378 # 0 or unset means default vCPUs of the current machine type.
4379 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
4380 # 0 or unset means default amount of memory of the current machine type.
4381 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
4382 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
4383 &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
4384 # graceful shutdown isn&#x27;t complete after this time, then the instance
4385 # transitions to the STOPPING state.
4386 # as a count of seconds and fractions of seconds at nanosecond
4387 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4388 # or &quot;month&quot;. Range is approximately 10,000 years.
4389 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4390 # Durations less than one second are represented with a 0
4391 # `seconds` field and a positive `nanos` field. Must be from 0
4392 # to 999,999,999 inclusive.
4393 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4394 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4395 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4396 },
4397 },
4398 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
4399 # within the range of [90, 330] with the increment of 30, if unset, the
4400 # default behavior of host error recovery will be used.
4401 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
4402 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
4403 # only be set during instance creation, or when the instance is not currently
4404 # running. It must not be set if thepreemptible option is
4405 # also set.
4406 &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
4407 # recovery of the Local Ssd state is attempted. Its value should be in
4408 # between 0 and 168 hours with hour granularity and the default value being 1
4409 # hour.
4410 # as a count of seconds and fractions of seconds at nanosecond
4411 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4412 # or &quot;month&quot;. Range is approximately 10,000 years.
4413 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4414 # Durations less than one second are represented with a 0
4415 # `seconds` field and a positive `nanos` field. Must be from 0
4416 # to 999,999,999 inclusive.
4417 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4418 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4419 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4420 },
4421 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
4422 # resources.
4423 # This field is for use by internal tools that use the public API.
4424 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
4425 # be scheduled for maintenance.
4426 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
4427 # are: `PERIODIC`.
4428 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
4429 # the instance termination action will be performed at the end of the run
4430 # duration.
4431 # as a count of seconds and fractions of seconds at nanosecond
4432 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4433 # or &quot;month&quot;. Range is approximately 10,000 years.
4434 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4435 # Durations less than one second are represented with a 0
4436 # `seconds` field and a positive `nanos` field. Must be from 0
4437 # to 999,999,999 inclusive.
4438 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4439 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4440 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4441 },
4442 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
4443 # on a sole-tenant node.
4444 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
4445 # affinity for more information.
4446 # Overrides reservationAffinity.
4447 { # Node Affinity: the configuration of desired nodes onto which this Instance
4448 # could be scheduled.
4449 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
4450 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
4451 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
4452 &quot;A String&quot;,
4453 ],
4454 },
4455 ],
4456 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
4457 # the default behavior is MIGRATE. Forpreemptible instances,
4458 # the default and only possible behavior is TERMINATE. For more
4459 # information, see
4460 # Set
4461 # VM host maintenance policy.
4462 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
4463 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
4464 # else, the Local SSD data will be preserved when the instance is stopped
4465 # at the end of the run duration/termination time.
4466 },
4467 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
4468 # instance creation or while the instance isstopped and
4469 # therefore, in a `TERMINATED` state. SeeInstance Life
4470 # Cycle for more information on the possible instance states.
4471 &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
4472 # Off signal is triggered for Spot
4473 # VMs only. If not specified, there will be no wait before the G2 Soft
4474 # Off signal is triggered.
4475 # as a count of seconds and fractions of seconds at nanosecond
4476 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4477 # or &quot;month&quot;. Range is approximately 10,000 years.
4478 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4479 # Durations less than one second are represented with a 0
4480 # `seconds` field and a positive `nanos` field. Must be from 0
4481 # to 999,999,999 inclusive.
4482 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4483 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4484 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4485 },
4486 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
4487 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
4488 # Timeout between GCE ACPI G2 Soft
4489 # Off and ACPI G3 Mechanical
4490 # Off during shutdown operation of VM.
4491 #
4492 # For Standard VMs values between 0s and 120s are allowed. For Spot and
4493 # Preemptible VMs supported values are between 0s and 30s.
4494 #
4495 # If no value is specified for shutdownDuration, default values are 90s for
4496 # Standard VMs and 30s for Spot/Preemptible VMs.
4497 # as a count of seconds and fractions of seconds at nanosecond
4498 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
4499 # or &quot;month&quot;. Range is approximately 10,000 years.
4500 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
4501 # Durations less than one second are represented with a 0
4502 # `seconds` field and a positive `nanos` field. Must be from 0
4503 # to 999,999,999 inclusive.
4504 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
4505 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
4506 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
4507 },
4508 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
4509 # Off and ACPI G3 Mechanical
4510 # Off for Standard VMs and 30 seconds for Spot VMs.
4511 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
4512 # termination action will be performed at the termination time.
4513 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
4514 &quot;mode&quot;: &quot;A String&quot;,
4515 },
4516 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
4517 # unspecified, the default mode is `OFF`.
4518 },
4519 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
4520 # service accounts are available to the instances that are created from this
4521 # machine image. Use metadata queries to obtain the access tokens for these
4522 # instances.
4523 { # A service account.
4524 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
4525 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
4526 &quot;A String&quot;,
4527 ],
4528 },
4529 ],
4530 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from this machine
4531 # image. The tags identify valid sources or targets for network firewalls.
4532 # The setTags method can modify this list of tags. Each tag within the list
4533 # must comply withRFC1035.
4534 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
4535 # the tags&#x27; contents and used for optimistic locking. The
4536 # fingerprint is initially generated by Compute Engine and changes after
4537 # every request to modify or update tags. You must always provide an
4538 # up-to-date fingerprint hash in order to update or change tags.
4539 #
4540 # To see the latest fingerprint, make get() request to the
4541 # instance.
4542 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
4543 # with RFC1035.
4544 &quot;A String&quot;,
4545 ],
4546 },
4547 },
4548 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING.
4549 &quot;storageLocations&quot;: [ # The regional or multi-regional Cloud Storage bucket location where themachine image is
4550 # stored.
4551 &quot;A String&quot;,
4552 ],
4553 &quot;totalStorageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Total size of the storage used by the machine image.
4554 }
4555
4556 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
4557 that if you must retry your request, the server will know to ignore the
4558 request if it has already been completed.
4559
4560 For example, consider a situation where you make an initial request and
4561 the request times out. If you make the request again with the same
4562 request ID, the server can check if original operation with the same
4563 request ID was received, and if so, will ignore the second request. This
4564 prevents clients from accidentally creating duplicate commitments.
4565
4566 The request ID must be
4567 a valid UUID with the exception that zero UUID is not supported
4568 (00000000-0000-0000-0000-000000000000).
4569 sourceInstance: string, Required. Source instance that is used to create the machine image from.
4570 x__xgafv: string, V1 error format.
4571 Allowed values
4572 1 - v1 error format
4573 2 - v2 error format
4574
4575 Returns:
4576 An object of the form:
4577
4578 { # Represents an Operation resource.
4579 #
4580 # Google Compute Engine has three Operation resources:
4581 #
4582 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
4583 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
4584 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
4585 #
4586 # You can use an operation resource to manage asynchronous API requests.
4587 # For more information, readHandling
4588 # API responses.
4589 #
4590 # Operations can be global, regional or zonal.
4591 #
4592 # - For global operations, use the `globalOperations`
4593 # resource.
4594 # - For regional operations, use the
4595 # `regionOperations` resource.
4596 # - For zonal operations, use
4597 # the `zoneOperations` resource.
4598 #
4599 #
4600 #
4601 # For more information, read
4602 # Global, Regional, and Zonal Resources.
4603 #
4604 # Note that completed Operation resources have a limited
4605 # retention period.
4606 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4607 # Not present otherwise.
4608 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4609 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4610 # set when the operation is created.
4611 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4612 # text format.
4613 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4614 # this field will be populated.
4615 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4616 # operation.
4617 {
4618 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4619 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4620 # details. There is a set of defined message types to use for providing
4621 # details.The syntax depends on the error code. For example,
4622 # QuotaExceededInfo will have details when the error code is
4623 # QUOTA_EXCEEDED.
4624 {
4625 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4626 #
4627 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4628 # is not enabled:
4629 #
4630 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4631 # &quot;domain&quot;: &quot;googleapis.com&quot;
4632 # &quot;metadata&quot;: {
4633 # &quot;resource&quot;: &quot;projects/123&quot;,
4634 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4635 # }
4636 # }
4637 #
4638 # This response indicates that the pubsub.googleapis.com API is not enabled.
4639 #
4640 # Example of an error that is returned when attempting to create a Spanner
4641 # instance in a region that is out of stock:
4642 #
4643 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4644 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4645 # &quot;metadata&quot;: {
4646 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4647 # }
4648 # }
4649 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4650 # is typically the registered service name of the tool or product that
4651 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4652 # generated by some common infrastructure, the error domain must be a
4653 # globally unique value that identifies the infrastructure. For Google API
4654 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4655 &quot;metadatas&quot;: { # Additional structured details about this error.
4656 #
4657 # Keys must match a regular expression of `a-z+` but should
4658 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4659 # length. When identifying the current value of an exceeded limit, the units
4660 # should be contained in the key, not the value. For example, rather than
4661 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4662 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4663 # instances that can be created in a single (batch) request.
4664 &quot;a_key&quot;: &quot;A String&quot;,
4665 },
4666 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4667 # proximate cause of the error. Error reasons are unique within a particular
4668 # domain of errors. This should be at most 63 characters and match a
4669 # regular expression of `A-Z+[A-Z0-9]`, which represents
4670 # UPPER_SNAKE_CASE.
4671 },
4672 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4673 #
4674 # For example, if a quota check failed with an error indicating the calling
4675 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4676 # directly to the right place in the developer console to flip the bit.
4677 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4678 { # Describes a URL link.
4679 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4680 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4681 },
4682 ],
4683 },
4684 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4685 # which can be attached to an RPC error.
4686 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4687 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4688 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4689 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4690 },
4691 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4692 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4693 &quot;a_key&quot;: &quot;A String&quot;,
4694 },
4695 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4696 # type or metric.
4697 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4698 # or metric.
4699 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4700 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4701 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4702 },
4703 },
4704 ],
4705 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4706 # This property is optional.
4707 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4708 },
4709 ],
4710 },
4711 &quot;getVersionOperationMetadata&quot;: {
4712 &quot;inlineSbomInfo&quot;: {
4713 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4714 # appropriate identifiers.
4715 &quot;a_key&quot;: &quot;A String&quot;,
4716 },
4717 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4718 # identifiers.
4719 &quot;a_key&quot;: &quot;A String&quot;,
4720 },
4721 },
4722 },
4723 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4724 # message that was returned, such as `NOT FOUND`.
4725 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4726 # status code that was returned. For example, a `404` means the
4727 # resource was not found.
4728 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4729 # defined by the server.
4730 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4731 # This value is inRFC3339
4732 # text format.
4733 &quot;instancesBulkInsertOperationMetadata&quot;: {
4734 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4735 # Example key: zones/us-central1-a
4736 &quot;a_key&quot;: {
4737 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4738 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4739 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4740 # error.
4741 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4742 # if the flow is rolling forward or rolling back.
4743 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4744 },
4745 },
4746 },
4747 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4748 # Operation resources.
4749 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4750 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4751 # group of operations results from a `bulkInsert` API request.
4752 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4753 # `update`, or `delete`, and so on.
4754 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4755 # There is no requirement that this be linear or support any granularity of
4756 # operations. This should not be used to guess when the operation will be
4757 # complete. This number should monotonically increase as the operation
4758 # progresses.
4759 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4760 # applicable when performing regional operations.
4761 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4762 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
4763 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4764 # this field will contain information on all underlying zonal actions and
4765 # their state.
4766 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4767 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4768 # Example key: zones/us-central1-a
4769 &quot;a_key&quot;: {
4770 &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
4771 # populated.
4772 # different programming environments, including REST APIs and RPC APIs. It is
4773 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4774 # three pieces of data: error code, error message, and error details.
4775 #
4776 # You can find out more about this error model and how to work with it in the
4777 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4778 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4779 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4780 # message types for APIs to use.
4781 {
4782 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4783 },
4784 ],
4785 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4786 # user-facing error message should be localized and sent in the
4787 # google.rpc.Status.details field, or localized by the client.
4788 },
4789 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4790 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4791 },
4792 },
4793 },
4794 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4795 # This value is inRFC3339
4796 # text format.
4797 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4798 # following:
4799 # `PENDING`, `RUNNING`, or `DONE`.
4800 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4801 # operation.
4802 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4803 # of the target resource.
4804 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4805 # operations related to creating a snapshot, this points to the disk
4806 # that the snapshot was created from.
4807 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4808 # `[email protected]` or
4809 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4810 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4811 # operation, this field will be populated.
4812 {
4813 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4814 # Engine returns NO_RESULTS_ON_PAGE if there
4815 # are no results in the response.
4816 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4817 # value format. For example:
4818 #
4819 # &quot;data&quot;: [
4820 # {
4821 # &quot;key&quot;: &quot;scope&quot;,
4822 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4823 # }
4824 {
4825 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4826 # returned. For example, for warnings where there are no results in a list
4827 # request for a particular zone, this key might be scope and
4828 # the key value might be the zone name. Other examples might be a key
4829 # indicating a deprecated resource and a suggested replacement, or a
4830 # warning about invalid network settings (for example, if an instance
4831 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4832 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4833 },
4834 ],
4835 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4836 },
4837 ],
4838 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4839 # applicable when performing per-zone operations.
4840 }</pre>
4841 </div>
4842
4843 <div class="method">
4844 <code class="details" id="list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
4845 <pre>Retrieves a list of machine images that are contained within
4846 the specified project.
4847
4848 Args:
4849 project: string, Project ID for this request. (required)
4850 filter: string, A filter expression that filters resources listed in the response. Most
4851 Compute resources support two types of filter expressions:
4852 expressions that support regular expressions and expressions that follow
4853 API improvement proposal AIP-160.
4854 These two types of filter expressions cannot be mixed in one request.
4855
4856 If you want to use AIP-160, your expression must specify the field name, an
4857 operator, and the value that you want to use for filtering. The value
4858 must be a string, a number, or a boolean. The operator
4859 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
4860
4861 For example, if you are filtering Compute Engine instances, you can
4862 exclude instances named `example-instance` by specifying
4863 `name != example-instance`.
4864
4865 The `:*` comparison can be used to test whether a key has been defined.
4866 For example, to find all objects with `owner` label use:
4867 ```
4868 labels.owner:*
4869 ```
4870
4871 You can also filter nested fields. For example, you could specify
4872 `scheduling.automaticRestart = false` to include instances only
4873 if they are not scheduled for automatic restarts. You can use filtering
4874 on nested fields to filter based onresource labels.
4875
4876 To filter on multiple expressions, provide each separate expression within
4877 parentheses. For example:
4878 ```
4879 (scheduling.automaticRestart = true)
4880 (cpuPlatform = &quot;Intel Skylake&quot;)
4881 ```
4882 By default, each expression is an `AND` expression. However, you
4883 can include `AND` and `OR` expressions explicitly.
4884 For example:
4885 ```
4886 (cpuPlatform = &quot;Intel Skylake&quot;) OR
4887 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
4888 (scheduling.automaticRestart = true)
4889 ```
4890
4891 If you want to use a regular expression, use the `eq` (equal) or `ne`
4892 (not equal) operator against a single un-parenthesized expression with or
4893 without quotes or against multiple parenthesized expressions. Examples:
4894
4895 `fieldname eq unquoted literal`
4896 `fieldname eq &#x27;single quoted literal&#x27;`
4897 `fieldname eq &quot;double quoted literal&quot;`
4898 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
4899
4900 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
4901 The literal value must match the entire field.
4902
4903 For example, to filter for instances that do not end with name &quot;instance&quot;,
4904 you would use `name ne .*instance`.
4905
4906 You cannot combine constraints on multiple fields using regular
4907 expressions.
4908 maxResults: integer, The maximum number of results per page that should be returned.
4909 If the number of available results is larger than `maxResults`,
4910 Compute Engine returns a `nextPageToken` that can be used to get
4911 the next page of results in subsequent list requests. Acceptable values are
4912 `0` to `500`, inclusive. (Default: `500`)
4913 orderBy: string, Sorts list results by a certain order. By default, results
4914 are returned in alphanumerical order based on the resource name.
4915
4916 You can also sort results in descending order based on the creation
4917 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
4918 results based on the `creationTimestamp` field in
4919 reverse chronological order (newest result first). Use this to sort
4920 resources like operations so that the newest operation is returned first.
4921
4922 Currently, only sorting by `name` or
4923 `creationTimestamp desc` is supported.
4924 pageToken: string, Specifies a page token to use. Set `pageToken` to the
4925 `nextPageToken` returned by a previous list request to get
4926 the next page of results.
4927 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
4928 of failure. The default value is false.
4929
4930 For example, when partial success behavior is enabled, aggregatedList for a
4931 single zone scope either returns all resources in the zone or no resources,
4932 with an error code.
4933 x__xgafv: string, V1 error format.
4934 Allowed values
4935 1 - v1 error format
4936 2 - v2 error format
4937
4938 Returns:
4939 An object of the form:
4940
4941 { # A list of machine images.
4942 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
4943 &quot;items&quot;: [ # A list of MachineImage resources.
4944 { # Represents a machine image resource.
4945 #
4946 # A machine image is a Compute Engine resource that stores all the
4947 # configuration, metadata, permissions, and data from one or more disks
4948 # required to create a Virtual machine (VM) instance. For more information, seeMachine images.
4949 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The creation timestamp for this machine image inRFC3339
4950 # text format.
4951 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you
4952 # create the resource.
4953 &quot;guestFlush&quot;: True or False, # [Input Only] Whether to attempt an application consistent machine image by
4954 # informing the OS to prepare for the snapshot process.
4955 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] A unique identifier for this machine image. The server
4956 # defines this identifier.
4957 &quot;instanceProperties&quot;: { # [Output Only] Properties of source instance
4958 &quot;advancedMachineFeatures&quot;: { # Specifies options for controlling advanced machine features. # Controls for advanced machine-related behavior features.
4959 # Note that for MachineImage, this is not supported yet.
4960 # Options that would traditionally be configured in a BIOS belong
4961 # here. Features that require operating system support may have
4962 # corresponding entries in the GuestOsFeatures of anImage (e.g., whether or not the OS in theImage supports nested virtualization being enabled or
4963 # disabled).
4964 &quot;enableNestedVirtualization&quot;: True or False, # Whether to enable nested virtualization or not (default is false).
4965 &quot;enableUefiNetworking&quot;: True or False, # Whether to enable UEFI networking for instance creation.
4966 &quot;enableWatchdogTimer&quot;: True or False, # Whether to enable the watchdog timer.
4967 &quot;numaNodeCount&quot;: 42, # The number of vNUMA nodes.
4968 &quot;performanceMonitoringUnit&quot;: &quot;A String&quot;, # Type of Performance Monitoring Unit requested on instance.
4969 &quot;threadsPerCore&quot;: 42, # The number of threads per physical core. To disable simultaneous
4970 # multithreading (SMT) set this to 1. If unset, the maximum number
4971 # of threads supported per core by the underlying processor is
4972 # assumed.
4973 &quot;turboMode&quot;: &quot;A String&quot;, # Turbo frequency mode to use for the instance.
4974 # Supported modes include:
4975 # * ALL_CORE_MAX
4976 #
4977 # Using empty string or not setting this field will use the platform-specific
4978 # default turbo mode.
4979 &quot;visibleCoreCount&quot;: 42, # The number of physical cores to expose to an instance. Multiply by
4980 # the number of threads per core to compute the total number of virtual
4981 # CPUs to expose to the instance. If unset, the number of cores is
4982 # inferred from the instance&#x27;s nominal CPU count and the underlying
4983 # platform&#x27;s SMT width.
4984 },
4985 &quot;canIpForward&quot;: True or False, # Enables instances created based on these properties to send packets with
4986 # source IP addresses other than their own and receive packets with
4987 # destination IP addresses other than their own. If these instances will be
4988 # used as an IP gateway or it will be set as the next-hop in a Route
4989 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
4990 # documentation for more information.
4991 &quot;confidentialInstanceConfig&quot;: { # A set of Confidential Instance options. # Specifies the Confidential Instance options.
4992 # Note that for MachineImage, this is not supported yet.
4993 &quot;confidentialInstanceType&quot;: &quot;A String&quot;, # Defines the type of technology used by the confidential instance.
4994 &quot;confidentialParavisorConfig&quot;: { # A set of Confidential Paravisor (SVSM) options. # Defines a set of Confidential Paravisor (SVSM) options.
4995 &quot;confidentialTpmType&quot;: &quot;A String&quot;,
4996 &quot;sevSnpIrqMode&quot;: &quot;A String&quot;,
4997 },
4998 &quot;enableConfidentialCompute&quot;: True or False, # Defines whether the instance should have confidential compute enabled.
4999 },
5000 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from these
5001 # properties.
5002 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
5003 # from these properties.
5004 { # An instance-attached disk resource.
5005 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
5006 # or X86_64.
5007 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
5008 # deleted (but not when the disk is detached from the instance).
5009 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
5010 # partition of the disk for its root filesystem.
5011 &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
5012 # running within the instance. This name can be used to reference the device
5013 # for mounting, resizing, and so on, from within the instance.
5014 #
5015 # If not specified, the server chooses a default device name to apply to this
5016 # disk, in the form persistent-disk-x, where x is a number
5017 # assigned by Google Compute Engine. This field is only applicable for
5018 # persistent disks.
5019 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
5020 # encryption key.
5021 #
5022 # If you are creating a new disk, this field encrypts the new disk using
5023 # an encryption key that you provide. If you are attaching an existing
5024 # disk that is already encrypted, this field decrypts the disk using
5025 # the customer-supplied encryption key.
5026 #
5027 # If you encrypt a disk using a customer-supplied key, you must provide the
5028 # same key again when you attempt to use this resource at a later time. For
5029 # example, you must provide the key when you create a snapshot or an image
5030 # from the disk or when you attach the disk to a virtual machine instance.
5031 #
5032 # If you do not provide an encryption key, then the disk will be encrypted
5033 # using an automatically generated key and you do not need to provide a key
5034 # to use the disk later.
5035 #
5036 # Note:
5037 #
5038 # Instance templates do not storecustomer-supplied
5039 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
5040 #
5041 # You cannot create VMs that have disks with customer-supplied keys using
5042 # the bulk
5043 # insert method.
5044 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5045 # For example:
5046 #
5047 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5048 # key_region/cryptoKeys/key
5049 #
5050 # The fully-qualifed key name may be returned for resource GET requests. For
5051 # example:
5052 #
5053 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5054 # key_region/cryptoKeys/key
5055 # /cryptoKeyVersions/1
5056 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5057 # key. If absent, the Compute Engine default service account is used.
5058 # For example:
5059 #
5060 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5061 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5062 # encryption key, encoded in RFC
5063 # 4648 base64 to either encrypt or decrypt this resource. You can
5064 # provide either the rawKey or thersaEncryptedKey.
5065 # For example:
5066 #
5067 # &quot;rawKey&quot;:
5068 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5069 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5070 # customer-supplied encryption key to either encrypt or decrypt this
5071 # resource. You can provide either the rawKey or thersaEncryptedKey.
5072 # For example:
5073 #
5074 # &quot;rsaEncryptedKey&quot;:
5075 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5076 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5077 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5078 #
5079 # The key must meet the following requirements before you can provide it to
5080 # Compute Engine:
5081 #
5082 # 1. The key is wrapped using a RSA public key certificate provided by
5083 # Google.
5084 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5085 # encoding.
5086 #
5087 # Gets the RSA public key certificate provided by Google at:
5088 #
5089 #
5090 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5091 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5092 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5093 # encryption key that protects this resource.
5094 },
5095 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
5096 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
5097 # currently attached to another instance. If you try to force attach a zonal
5098 # disk to an instance, you will receive an error.
5099 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5100 # only for bootable images. Read
5101 # Enabling guest operating system features to see a list of available
5102 # options.
5103 { # Guest OS features.
5104 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5105 # separate values. Set to one or more of the following values:
5106 #
5107 # - VIRTIO_SCSI_MULTIQUEUE
5108 # - WINDOWS
5109 # - MULTI_IP_SUBNET
5110 # - UEFI_COMPATIBLE
5111 # - GVNIC
5112 # - SEV_CAPABLE
5113 # - SUSPEND_RESUME_COMPATIBLE
5114 # - SEV_LIVE_MIGRATABLE_V2
5115 # - SEV_SNP_CAPABLE
5116 # - TDX_CAPABLE
5117 # - IDPF
5118 # - SNP_SVSM_CAPABLE
5119 # - CCA_CAPABLE
5120 #
5121 #
5122 # For more information, see
5123 # Enabling guest operating system features.
5124 },
5125 ],
5126 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
5127 # boot disk. If you have many disks attached to an instance, each
5128 # disk would have a unique index number.
5129 &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
5130 # alongside the new instance. Use initialization parameters to create boot
5131 # disks or local SSDs attached to the new instance.
5132 #
5133 # This property is mutually exclusive with the source property;
5134 # you can only define one or the other, but not both.
5135 # alongside the new instance. Use initialization parameters to create boot
5136 # disks or local SSDs attached to the new instance.
5137 #
5138 # This field is persisted and returned for instanceTemplate and not returned
5139 # in the context of instance.
5140 #
5141 # This property is mutually exclusive with the source property;
5142 # you can only define one or the other, but not both.
5143 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
5144 # arm64 or x86_64.
5145 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
5146 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
5147 # of the instance. If a disk with the same name already exists in the given
5148 # region, the existing disk is attached to the new instance and the
5149 # new disk is not created.
5150 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
5151 # 10 GB. If you specify a sourceImage, which is required for
5152 # boot disks, the default size is the size of the sourceImage.
5153 # If you do not specify a sourceImage, the default disk size
5154 # is 500 GB.
5155 &quot;diskType&quot;: &quot;A String&quot;,
5156 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
5157 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5158 # only for bootable images. Read
5159 # Enabling guest operating system features to see a list of available
5160 # options.
5161 #
5162 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
5163 { # Guest OS features.
5164 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5165 # separate values. Set to one or more of the following values:
5166 #
5167 # - VIRTIO_SCSI_MULTIQUEUE
5168 # - WINDOWS
5169 # - MULTI_IP_SUBNET
5170 # - UEFI_COMPATIBLE
5171 # - GVNIC
5172 # - SEV_CAPABLE
5173 # - SUSPEND_RESUME_COMPATIBLE
5174 # - SEV_LIVE_MIGRATABLE_V2
5175 # - SEV_SNP_CAPABLE
5176 # - TDX_CAPABLE
5177 # - IDPF
5178 # - SNP_SVSM_CAPABLE
5179 # - CCA_CAPABLE
5180 #
5181 #
5182 # For more information, see
5183 # Enabling guest operating system features.
5184 },
5185 ],
5186 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
5187 # which is either SCSI or NVME. The default isSCSI.
5188 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
5189 # persistent disks.
5190 &quot;a_key&quot;: &quot;A String&quot;,
5191 },
5192 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
5193 # disk.
5194 &quot;A String&quot;,
5195 ],
5196 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
5197 &quot;A String&quot;,
5198 ],
5199 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
5200 # more than one instance.
5201 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
5202 # is to use the existing disk.
5203 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
5204 # of I/O operations per second that the disk can handle. Values must be
5205 # between 10,000 and 120,000. For more details, see theExtreme persistent
5206 # disk documentation.
5207 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
5208 # number of throughput mb per second that the disk can handle. Values must
5209 # greater than or equal to 1.
5210 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
5211 # the URLs of the zones where the disk should be replicated to.
5212 # You must provide exactly two replica zones, and one zone must be the same
5213 # as the instance zone.
5214 &quot;A String&quot;,
5215 ],
5216 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
5217 # have the same definition as resource
5218 # manager tags. Keys and values can be either in numeric format,
5219 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
5220 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
5221 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
5222 # empty.
5223 &quot;a_key&quot;: &quot;A String&quot;,
5224 },
5225 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
5226 # Specified using the full or partial URL. For instance template, specify
5227 # only the resource policy name.
5228 &quot;A String&quot;,
5229 ],
5230 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
5231 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5232 # is required.
5233 #
5234 # To create a disk with one of the public operating system
5235 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
5236 #
5237 # projects/debian-cloud/global/images/family/debian-9
5238 #
5239 #
5240 # Alternatively, use a specific version of a public operating system image:
5241 #
5242 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
5243 #
5244 #
5245 # To create a disk with a custom image that you created, specify the
5246 # image name in the following format:
5247 #
5248 # global/images/my-custom-image
5249 #
5250 #
5251 # You can also specify a custom image by its image family, which returns
5252 # the latest version of the image in that family. Replace the image name
5253 # with family/family-name:
5254 #
5255 # global/images/family/my-image-family
5256 #
5257 #
5258 # If the source image is deleted later, this field will not be set.
5259 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
5260 # encryption key of the source image. Required if the source image is
5261 # protected by a customer-supplied encryption key.
5262 #
5263 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
5264 # encryption keys, so you cannot create disks for instances in a managed instance group if the
5265 # source images are encrypted with your own keys.
5266 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5267 # For example:
5268 #
5269 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5270 # key_region/cryptoKeys/key
5271 #
5272 # The fully-qualifed key name may be returned for resource GET requests. For
5273 # example:
5274 #
5275 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5276 # key_region/cryptoKeys/key
5277 # /cryptoKeyVersions/1
5278 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5279 # key. If absent, the Compute Engine default service account is used.
5280 # For example:
5281 #
5282 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5283 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5284 # encryption key, encoded in RFC
5285 # 4648 base64 to either encrypt or decrypt this resource. You can
5286 # provide either the rawKey or thersaEncryptedKey.
5287 # For example:
5288 #
5289 # &quot;rawKey&quot;:
5290 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5291 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5292 # customer-supplied encryption key to either encrypt or decrypt this
5293 # resource. You can provide either the rawKey or thersaEncryptedKey.
5294 # For example:
5295 #
5296 # &quot;rsaEncryptedKey&quot;:
5297 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5298 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5299 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5300 #
5301 # The key must meet the following requirements before you can provide it to
5302 # Compute Engine:
5303 #
5304 # 1. The key is wrapped using a RSA public key certificate provided by
5305 # Google.
5306 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5307 # encoding.
5308 #
5309 # Gets the RSA public key certificate provided by Google at:
5310 #
5311 #
5312 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5313 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5314 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5315 # encryption key that protects this resource.
5316 },
5317 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
5318 # instance boot disk, one of initializeParams.sourceSnapshot
5319 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
5320 # is required.
5321 #
5322 # To create a disk with a snapshot that you created, specify the
5323 # snapshot name in the following format:
5324 #
5325 # us-central1-a/instantSnapshots/my-backup
5326 #
5327 #
5328 # If the source instant-snapshot is deleted later, this field will not be
5329 # set.
5330 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
5331 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
5332 # is required.
5333 #
5334 # To create a disk with a snapshot that you created, specify the
5335 # snapshot name in the following format:
5336 #
5337 # global/snapshots/my-backup
5338 #
5339 #
5340 # If the source snapshot is deleted later, this field will not be set.
5341 #
5342 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
5343 # an image instead when you create VMs using
5344 # the bulk
5345 # insert method.
5346 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
5347 # encryption key of the source snapshot.
5348 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5349 # For example:
5350 #
5351 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5352 # key_region/cryptoKeys/key
5353 #
5354 # The fully-qualifed key name may be returned for resource GET requests. For
5355 # example:
5356 #
5357 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5358 # key_region/cryptoKeys/key
5359 # /cryptoKeyVersions/1
5360 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5361 # key. If absent, the Compute Engine default service account is used.
5362 # For example:
5363 #
5364 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5365 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5366 # encryption key, encoded in RFC
5367 # 4648 base64 to either encrypt or decrypt this resource. You can
5368 # provide either the rawKey or thersaEncryptedKey.
5369 # For example:
5370 #
5371 # &quot;rawKey&quot;:
5372 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5373 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5374 # customer-supplied encryption key to either encrypt or decrypt this
5375 # resource. You can provide either the rawKey or thersaEncryptedKey.
5376 # For example:
5377 #
5378 # &quot;rsaEncryptedKey&quot;:
5379 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5380 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5381 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5382 #
5383 # The key must meet the following requirements before you can provide it to
5384 # Compute Engine:
5385 #
5386 # 1. The key is wrapped using a RSA public key certificate provided by
5387 # Google.
5388 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5389 # encoding.
5390 #
5391 # Gets the RSA public key certificate provided by Google at:
5392 #
5393 #
5394 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5395 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5396 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5397 # encryption key that protects this resource.
5398 },
5399 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
5400 # this as a partial or full URL to the resource. For example, the following
5401 # are valid values:
5402 #
5403 #
5404 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
5405 # - projects/project/zones/zone/storagePools/storagePool
5406 # - zones/zone/storagePools/storagePool
5407 },
5408 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
5409 # either SCSI or NVME. For most machine types, the
5410 # default is SCSI. Local SSDs can use either NVME or SCSI.
5411 # In certain configurations, persistent disks can use NVMe. For more
5412 # information, seeAbout
5413 # persistent disks.
5414 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
5415 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
5416 &quot;A String&quot;,
5417 ],
5418 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
5419 # disk is not allowed to be detached from the instance, or to be used as the
5420 # source of the snapshot creation, and the image creation. The instance with
5421 # at least one locked attached disk is not allow to be used as source of
5422 # machine image creation, instant snapshot creation, and not allowed to be
5423 # deleted with --keep-disk parameter set to true for locked disks.
5424 &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
5425 # in READ_WRITE mode.
5426 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
5427 # field is set to PRESERVED if the LocalSSD data has been saved
5428 # to a persistent location by customer request. (see the
5429 # discard_local_ssd option on Stop/Suspend).
5430 # Read-only in the api.
5431 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
5432 # these are public keys which are safe to store in public
5433 &quot;dbs&quot;: [ # The Key Database (db).
5434 {
5435 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5436 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5437 },
5438 ],
5439 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
5440 {
5441 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5442 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5443 },
5444 ],
5445 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
5446 {
5447 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5448 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5449 },
5450 ],
5451 &quot;pk&quot;: { # The Platform Key (PK).
5452 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5453 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5454 },
5455 },
5456 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
5457 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5458 # is required.
5459 #
5460 # If desired, you can also attach existing non-root persistent disks using
5461 # this property. This field is only applicable for persistent disks.
5462 #
5463 # Note that for InstanceTemplate, specify the disk name for zonal disk,
5464 # and the URL for regional disk.
5465 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
5466 },
5467 ],
5468 &quot;displayDevice&quot;: { # A set of Display Device options # Display Device properties to enable support
5469 # for remote display products like: Teradici,
5470 # VNC and TeamViewer
5471 # Note that for MachineImage, this is not supported yet.
5472 &quot;enableDisplay&quot;: True or False, # Defines whether the instance has Display enabled.
5473 },
5474 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
5475 # created from these properties.
5476 { # A specification of the type and number of accelerator cards attached to the
5477 # instance.
5478 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
5479 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
5480 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
5481 # If you are creating an instance template, specify only the
5482 # accelerator name.
5483 # See GPUs on Compute Engine
5484 # for a full list of accelerator types.
5485 },
5486 ],
5487 &quot;identity&quot;: &quot;A String&quot;,
5488 &quot;identityCertificate&quot;: True or False,
5489 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
5490 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
5491 &quot;labels&quot;: { # Labels to apply to instances that are created from these properties.
5492 &quot;a_key&quot;: &quot;A String&quot;,
5493 },
5494 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from these
5495 # properties.
5496 # This field only accepts a machine type name, for example `n2-standard-4`.
5497 # If you use the machine type full or partial URL, for example
5498 # `projects/my-l7ilb-project/zones/us-central1-a/machineTypes/n2-standard-4`,
5499 # the request will result in an `INTERNAL_ERROR`.
5500 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
5501 # these properties. These pairs can consist of custom metadata or predefined
5502 # keys. SeeProject and
5503 # instance metadata for more information.
5504 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
5505 # the metadata&#x27;s contents and used for optimistic locking. The
5506 # fingerprint is initially generated by Compute Engine and changes after
5507 # every request to modify or update metadata. You must always provide an
5508 # up-to-date fingerprint hash in order to update or change metadata,
5509 # otherwise the request will fail with error412 conditionNotMet.
5510 #
5511 # To see the latest fingerprint, make a get() request to
5512 # retrieve the resource.
5513 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
5514 # less than 512 KB.
5515 { # Metadata
5516 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
5517 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
5518 # This is reflected as part of a URL in the metadata server. Additionally, to
5519 # avoid ambiguity, keys must not conflict with any other metadata keys
5520 # for the project.
5521 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
5522 # have meaning as interpreted by the image running in the instance. The
5523 # only restriction placed on values is that their size must be less than
5524 # or equal to 262144 bytes (256 KiB).
5525 },
5526 ],
5527 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
5528 # for metadata.
5529 },
5530 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances. The instance may be
5531 # scheduled on the specified or newer cpu/platform. Applicable values are the
5532 # friendly names of CPU platforms, such asminCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
5533 # information, read Specifying a
5534 # Minimum CPU Platform.
5535 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
5536 { # A network interface resource attached to an instance.
5537 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
5538 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
5539 # no external internet access.
5540 { # An access configuration attached to an instance&#x27;s network interface.
5541 # Only one access config per instance is supported.
5542 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
5543 # The first IPv6 address of the external IPv6 range associated
5544 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
5545 # use a static external IP address, it must be unused and in the same region
5546 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
5547 # assign an external IPv6 address from the instance&#x27;s subnetwork.
5548 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
5549 # external IPv6 range.
5550 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
5551 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
5552 # (IPv4), the default and recommended name is External NAT, but
5553 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
5554 # recommend name is External IPv6.
5555 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
5556 # address associated with this instance. Specify an unused static
5557 # external IP address available to the project or leave this field undefined
5558 # to use an IP from a shared ephemeral IP address pool. If you specify a
5559 # static external IP address, it must live in the same region as the zone of
5560 # the instance.
5561 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
5562 # configuration and can only take the following values: PREMIUM,STANDARD.
5563 #
5564 # If an AccessConfig is specified without a valid external IP address, an
5565 # ephemeral IP will be created with this networkTier.
5566 #
5567 # If an AccessConfig with a valid external IP address is specified, it must
5568 # match that of the networkTier associated with the Address resource owning
5569 # that IP.
5570 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
5571 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
5572 #
5573 # 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
5574 # first IP in associated external IPv6 range.
5575 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
5576 # config.
5577 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
5578 # external IP address of this access configuration.
5579 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
5580 # external IP address of the instance to a DNS domain name.
5581 #
5582 # This field is not used in ipv6AccessConfig. A default PTR
5583 # record will be created if the VM has external IPv6 range associated.
5584 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
5585 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
5586 },
5587 ],
5588 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
5589 # You can only specify this field for network interfaces in VPC networks.
5590 { # An alias IP range attached to an instance&#x27;s network interface.
5591 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
5592 # must belong to the specified subnetwork and cannot contain IP addresses
5593 # reserved by system or used by other network interfaces. This range may be
5594 # 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).
5595 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
5596 # alias range. If not specified, the primary range of the subnetwork is used.
5597 },
5598 ],
5599 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
5600 # You can only specify this field for network interfaces in VPC networks.
5601 { # An alias IP range attached to an instance&#x27;s network interface.
5602 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
5603 # must belong to the specified subnetwork and cannot contain IP addresses
5604 # reserved by system or used by other network interfaces. This range may be
5605 # 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).
5606 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
5607 # alias range. If not specified, the primary range of the subnetwork is used.
5608 },
5609 ],
5610 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
5611 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
5612 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
5613 # with network_attachment.
5614 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
5615 # This field will be ignored when inserting an Instance or
5616 # adding a NetworkInterface. An up-to-date
5617 # 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.
5618 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
5619 # or not. If enabled, also indicates the version of IGMP supported.
5620 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
5621 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
5622 # one IPv6 access config, DIRECT_IPV6, is supported. If there
5623 # is no ipv6AccessConfig specified, then this instance will
5624 # have no external IPv6 Internet access.
5625 { # An access configuration attached to an instance&#x27;s network interface.
5626 # Only one access config per instance is supported.
5627 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
5628 # The first IPv6 address of the external IPv6 range associated
5629 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
5630 # use a static external IP address, it must be unused and in the same region
5631 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
5632 # assign an external IPv6 address from the instance&#x27;s subnetwork.
5633 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
5634 # external IPv6 range.
5635 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
5636 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
5637 # (IPv4), the default and recommended name is External NAT, but
5638 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
5639 # recommend name is External IPv6.
5640 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
5641 # address associated with this instance. Specify an unused static
5642 # external IP address available to the project or leave this field undefined
5643 # to use an IP from a shared ephemeral IP address pool. If you specify a
5644 # static external IP address, it must live in the same region as the zone of
5645 # the instance.
5646 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
5647 # configuration and can only take the following values: PREMIUM,STANDARD.
5648 #
5649 # If an AccessConfig is specified without a valid external IP address, an
5650 # ephemeral IP will be created with this networkTier.
5651 #
5652 # If an AccessConfig with a valid external IP address is specified, it must
5653 # match that of the networkTier associated with the Address resource owning
5654 # that IP.
5655 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
5656 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
5657 #
5658 # 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
5659 # first IP in associated external IPv6 range.
5660 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
5661 # config.
5662 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
5663 # external IP address of this access configuration.
5664 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
5665 # external IP address of the instance to a DNS domain name.
5666 #
5667 # This field is not used in ipv6AccessConfig. A default PTR
5668 # record will be created if the VM has external IPv6 range associated.
5669 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
5670 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
5671 },
5672 ],
5673 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
5674 # accessed from the Internet. This field is always inherited from its
5675 # subnetwork.
5676 #
5677 # Valid only if stackType is IPV4_IPV6.
5678 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
5679 # use a static internal IP address, it must be unused and in the same region
5680 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
5681 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
5682 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
5683 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
5684 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
5685 # server. For a VM, the network interface uses the nicN naming
5686 # format. Where N is a value between 0 and7. The default interface value is nic0.
5687 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
5688 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
5689 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
5690 # instance, if neither the network nor the subnetwork is specified, the
5691 # default network global/networks/default is used. If the
5692 # selected project doesn&#x27;t have the default network, you must specify a
5693 # network or subnet. If the network is not specified but the subnetwork is
5694 # specified, the network is inferred.
5695 #
5696 # If you specify this property, you can specify the network as
5697 # a full or partial URL. For example, the following are all valid URLs:
5698 #
5699 #
5700 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
5701 # - projects/project/global/networks/network
5702 # - global/networks/default
5703 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
5704 # to in the following format:
5705 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
5706 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
5707 # interface. If not specified by the user, an unused internal IP is
5708 # assigned by the system.
5709 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
5710 # VirtioNet.
5711 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
5712 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
5713 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
5714 # if not specified by the users.
5715 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
5716 # interface. Can only be used with network_attachment. It is not possible to
5717 # use on its own however, network_attachment can be used without
5718 # service_class_id.
5719 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
5720 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
5721 #
5722 # This field can be both set at instance creation and update network
5723 # interface operations.
5724 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
5725 # subnetworks that support L2. Every network interface will get a default
5726 # untagged (vlan not specified) subinterface. Users can specify additional
5727 # tagged subinterfaces which are sub-fields to the Network Interface.
5728 {
5729 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
5730 # subinterface. If specified, ip_allocation_mode should be set to
5731 # ALLOCATE_IP.
5732 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
5733 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
5734 # as that of the network interface.
5735 # If not specified the subnet of network interface will be used.
5736 # If you specify this property, you can specify the subnetwork as a full
5737 # or partial URL. For example, the following are all valid URLs:
5738 #
5739 #
5740 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
5741 # - regions/region/subnetworks/subnetwork
5742 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
5743 # this subinterface is connecting.
5744 },
5745 ],
5746 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
5747 # resource is inlegacy
5748 # mode, do not specify this field. If the network is in auto subnet
5749 # mode, specifying the subnetwork is optional. If the network is in custom
5750 # subnet mode, specifying the subnetwork is required. If you specify this
5751 # field, you can specify the subnetwork as a full or partial URL. For
5752 # example, the following are all valid URLs:
5753 #
5754 #
5755 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
5756 # - regions/region/subnetworks/subnetwork
5757 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
5758 # from 2 to 255 inclusively.
5759 },
5760 ],
5761 &quot;networkPerformanceConfig&quot;: { # Note that for MachineImage, this is not supported yet.
5762 &quot;externalIpEgressBandwidthTier&quot;: &quot;A String&quot;,
5763 &quot;totalEgressBandwidthTier&quot;: &quot;A String&quot;,
5764 },
5765 &quot;partnerMetadata&quot;: { # Partner Metadata assigned to the instance properties. A map from a
5766 # subdomain (namespace) to entries map.
5767 &quot;a_key&quot;: {
5768 &quot;entries&quot;: { # Map of a partner metadata that belong to the same subdomain.
5769 # It accepts any value including google.protobuf.Struct.
5770 &quot;a_key&quot;: &quot;&quot;,
5771 },
5772 },
5773 },
5774 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
5775 &quot;privateIpv6GoogleAccess&quot;: &quot;A String&quot;, # The private IPv6 google access type for VMs.
5776 # If not specified, use INHERIT_FROM_SUBNETWORK as default.
5777 # Note that for MachineImage, this is not supported yet.
5778 &quot;reservationAffinity&quot;: { # Specifies the reservations that this instance can consume from. # Specifies the reservations that instances can consume from.
5779 # Note that for MachineImage, this is not supported yet.
5780 &quot;consumeReservationType&quot;: &quot;A String&quot;, # Specifies the type of reservation from which this instance can consume
5781 # resources: ANY_RESERVATION (default),SPECIFIC_RESERVATION, or NO_RESERVATION. See
5782 # Consuming reserved instances for examples.
5783 &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
5784 # the name of your reservation as its value.
5785 &quot;values&quot;: [ # Corresponds to the label values of a reservation resource. This can be
5786 # either a name to a reservation in the same project or
5787 # &quot;projects/different-project/reservations/some-reservation-name&quot; to target a
5788 # shared reservation in the same zone but in a different project.
5789 &quot;A String&quot;,
5790 ],
5791 },
5792 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the instance. Tag keys and values
5793 # have the same definition as resource
5794 # manager tags. Keys and values can be either in numeric format,
5795 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
5796 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
5797 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
5798 # PATCH) when empty.
5799 &quot;a_key&quot;: &quot;A String&quot;,
5800 },
5801 &quot;resourcePolicies&quot;: [ # Resource policies (names, not URLs) applied to instances created from
5802 # these properties.
5803 # Note that for MachineImage, this is not supported yet.
5804 &quot;A String&quot;,
5805 ],
5806 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
5807 # these properties.
5808 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
5809 # terminated by Compute Engine (not terminated by a user). You can only set
5810 # the automatic restart option for standard instances.Preemptible instances
5811 # cannot be automatically restarted.
5812 #
5813 # By default, this is set to true so an instance is
5814 # automatically restarted if it is terminated by Compute Engine.
5815 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
5816 # must be a number between 1 and the number of availability domains
5817 # specified in the spread placement policy attached to the instance.
5818 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
5819 # 0 or unset means default vCPUs of the current machine type.
5820 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
5821 # 0 or unset means default amount of memory of the current machine type.
5822 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
5823 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
5824 &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
5825 # graceful shutdown isn&#x27;t complete after this time, then the instance
5826 # transitions to the STOPPING state.
5827 # as a count of seconds and fractions of seconds at nanosecond
5828 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5829 # or &quot;month&quot;. Range is approximately 10,000 years.
5830 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5831 # Durations less than one second are represented with a 0
5832 # `seconds` field and a positive `nanos` field. Must be from 0
5833 # to 999,999,999 inclusive.
5834 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5835 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5836 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5837 },
5838 },
5839 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
5840 # within the range of [90, 330] with the increment of 30, if unset, the
5841 # default behavior of host error recovery will be used.
5842 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
5843 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
5844 # only be set during instance creation, or when the instance is not currently
5845 # running. It must not be set if thepreemptible option is
5846 # also set.
5847 &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
5848 # recovery of the Local Ssd state is attempted. Its value should be in
5849 # between 0 and 168 hours with hour granularity and the default value being 1
5850 # hour.
5851 # as a count of seconds and fractions of seconds at nanosecond
5852 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5853 # or &quot;month&quot;. Range is approximately 10,000 years.
5854 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5855 # Durations less than one second are represented with a 0
5856 # `seconds` field and a positive `nanos` field. Must be from 0
5857 # to 999,999,999 inclusive.
5858 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5859 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5860 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5861 },
5862 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
5863 # resources.
5864 # This field is for use by internal tools that use the public API.
5865 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
5866 # be scheduled for maintenance.
5867 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
5868 # are: `PERIODIC`.
5869 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
5870 # the instance termination action will be performed at the end of the run
5871 # duration.
5872 # as a count of seconds and fractions of seconds at nanosecond
5873 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5874 # or &quot;month&quot;. Range is approximately 10,000 years.
5875 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5876 # Durations less than one second are represented with a 0
5877 # `seconds` field and a positive `nanos` field. Must be from 0
5878 # to 999,999,999 inclusive.
5879 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5880 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5881 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5882 },
5883 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
5884 # on a sole-tenant node.
5885 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
5886 # affinity for more information.
5887 # Overrides reservationAffinity.
5888 { # Node Affinity: the configuration of desired nodes onto which this Instance
5889 # could be scheduled.
5890 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
5891 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
5892 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
5893 &quot;A String&quot;,
5894 ],
5895 },
5896 ],
5897 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
5898 # the default behavior is MIGRATE. Forpreemptible instances,
5899 # the default and only possible behavior is TERMINATE. For more
5900 # information, see
5901 # Set
5902 # VM host maintenance policy.
5903 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
5904 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
5905 # else, the Local SSD data will be preserved when the instance is stopped
5906 # at the end of the run duration/termination time.
5907 },
5908 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
5909 # instance creation or while the instance isstopped and
5910 # therefore, in a `TERMINATED` state. SeeInstance Life
5911 # Cycle for more information on the possible instance states.
5912 &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
5913 # Off signal is triggered for Spot
5914 # VMs only. If not specified, there will be no wait before the G2 Soft
5915 # Off signal is triggered.
5916 # as a count of seconds and fractions of seconds at nanosecond
5917 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5918 # or &quot;month&quot;. Range is approximately 10,000 years.
5919 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5920 # Durations less than one second are represented with a 0
5921 # `seconds` field and a positive `nanos` field. Must be from 0
5922 # to 999,999,999 inclusive.
5923 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5924 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5925 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5926 },
5927 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
5928 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
5929 # Timeout between GCE ACPI G2 Soft
5930 # Off and ACPI G3 Mechanical
5931 # Off during shutdown operation of VM.
5932 #
5933 # For Standard VMs values between 0s and 120s are allowed. For Spot and
5934 # Preemptible VMs supported values are between 0s and 30s.
5935 #
5936 # If no value is specified for shutdownDuration, default values are 90s for
5937 # Standard VMs and 30s for Spot/Preemptible VMs.
5938 # as a count of seconds and fractions of seconds at nanosecond
5939 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
5940 # or &quot;month&quot;. Range is approximately 10,000 years.
5941 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
5942 # Durations less than one second are represented with a 0
5943 # `seconds` field and a positive `nanos` field. Must be from 0
5944 # to 999,999,999 inclusive.
5945 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
5946 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
5947 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
5948 },
5949 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
5950 # Off and ACPI G3 Mechanical
5951 # Off for Standard VMs and 30 seconds for Spot VMs.
5952 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
5953 # termination action will be performed at the termination time.
5954 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
5955 &quot;mode&quot;: &quot;A String&quot;,
5956 },
5957 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
5958 # unspecified, the default mode is `OFF`.
5959 },
5960 &quot;secureTags&quot;: [ # [Input Only] Secure tags to apply to this instance.
5961 # Maximum number of secure tags allowed is 50.
5962 # Note that for MachineImage, this is not supported yet.
5963 &quot;A String&quot;,
5964 ],
5965 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
5966 # service accounts are available to the instances that are created from
5967 # these properties. Use metadata queries to obtain the access tokens for
5968 # these instances.
5969 { # A service account.
5970 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
5971 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
5972 &quot;A String&quot;,
5973 ],
5974 },
5975 ],
5976 &quot;serviceIntegrationSpecs&quot;: { # Mapping of user defined keys to ServiceIntegrationSpec.
5977 &quot;a_key&quot;: { # Specifies the parameters to configure an integration with instances.
5978 &quot;backupDr&quot;: { # Specifies parameters to Backup and DR to attach a BackupPlan to a compute
5979 # instance for managed VM backup.
5980 &quot;plan&quot;: &quot;A String&quot;, # The BackupPlan resource to attach to the instance. Specified as a
5981 # resource reference in instances, and regional instance templates, and as
5982 # just the plan name in global instance templates
5983 },
5984 },
5985 },
5986 &quot;shieldedInstanceConfig&quot;: { # A set of Shielded Instance options. # Note that for MachineImage, this is not supported yet.
5987 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.Enabled by
5988 # default.
5989 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.Disabled by
5990 # default.
5991 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.Enabled by
5992 # default.
5993 },
5994 &quot;shieldedVmConfig&quot;: { # A set of Shielded VM options. # Specifies the Shielded VM options for the instances that are created from
5995 # these properties.
5996 &quot;enableIntegrityMonitoring&quot;: True or False, # Defines whether the instance has integrity monitoring enabled.
5997 &quot;enableSecureBoot&quot;: True or False, # Defines whether the instance has Secure Boot enabled.
5998 &quot;enableVtpm&quot;: True or False, # Defines whether the instance has the vTPM enabled.
5999 },
6000 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from these
6001 # properties. The tags identify valid sources or targets for network
6002 # firewalls. The setTags method can modify this list of tags. Each tag within
6003 # the list must comply with RFC1035.
6004 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
6005 # the tags&#x27; contents and used for optimistic locking. The
6006 # fingerprint is initially generated by Compute Engine and changes after
6007 # every request to modify or update tags. You must always provide an
6008 # up-to-date fingerprint hash in order to update or change tags.
6009 #
6010 # To see the latest fingerprint, make get() request to the
6011 # instance.
6012 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
6013 # with RFC1035.
6014 &quot;A String&quot;,
6015 ],
6016 },
6017 &quot;workloadIdentityConfig&quot;: {
6018 &quot;identity&quot;: &quot;A String&quot;,
6019 &quot;identityCertificateEnabled&quot;: True or False,
6020 },
6021 },
6022 &quot;kind&quot;: &quot;compute#machineImage&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#machineImage for machine image.
6023 &quot;labelFingerprint&quot;: &quot;A String&quot;, # A fingerprint for the labels being applied to this machine image, which is
6024 # essentially a hash of the labels set used for optimistic locking. The
6025 # fingerprint is initially generated by Compute Engine and changes after
6026 # every request to modify or update labels. You must always provide an
6027 # up-to-date fingerprint hash in order to update or change labels.
6028 #
6029 # To see the latest fingerprint, make get() request to the
6030 # machine image.
6031 &quot;labels&quot;: { # Labels to apply to this machine image. These can be later modified by
6032 # the setLabels method.
6033 &quot;a_key&quot;: &quot;A String&quot;,
6034 },
6035 &quot;machineImageEncryptionKey&quot;: { # Encrypts the machine image using acustomer-supplied
6036 # encryption key.
6037 #
6038 # After you encrypt a machine image using a customer-supplied key, you must
6039 # provide the same key if you use the machine image later. For example, you
6040 # must provide the encryption key when you create an instance from the
6041 # encrypted machine image in a future request.
6042 #
6043 # Customer-supplied encryption keys do not protect access to metadata of the
6044 # machine image.
6045 #
6046 # If you do not provide an encryption key when creating the machine image,
6047 # then the machine image will be encrypted using an automatically generated
6048 # key and you do not need to provide a key to use the machine image later.
6049 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
6050 # For example:
6051 #
6052 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6053 # key_region/cryptoKeys/key
6054 #
6055 # The fully-qualifed key name may be returned for resource GET requests. For
6056 # example:
6057 #
6058 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6059 # key_region/cryptoKeys/key
6060 # /cryptoKeyVersions/1
6061 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
6062 # key. If absent, the Compute Engine default service account is used.
6063 # For example:
6064 #
6065 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
6066 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
6067 # encryption key, encoded in RFC
6068 # 4648 base64 to either encrypt or decrypt this resource. You can
6069 # provide either the rawKey or thersaEncryptedKey.
6070 # For example:
6071 #
6072 # &quot;rawKey&quot;:
6073 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
6074 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
6075 # customer-supplied encryption key to either encrypt or decrypt this
6076 # resource. You can provide either the rawKey or thersaEncryptedKey.
6077 # For example:
6078 #
6079 # &quot;rsaEncryptedKey&quot;:
6080 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
6081 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
6082 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
6083 #
6084 # The key must meet the following requirements before you can provide it to
6085 # Compute Engine:
6086 #
6087 # 1. The key is wrapped using a RSA public key certificate provided by
6088 # Google.
6089 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
6090 # encoding.
6091 #
6092 # Gets the RSA public key certificate provided by Google at:
6093 #
6094 #
6095 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
6096 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
6097 # 4648 base64 encoded SHA-256 hash of the customer-supplied
6098 # encryption key that protects this resource.
6099 },
6100 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
6101 # The name must be 1-63 characters long, and comply withRFC1035.
6102 # Specifically, the name must be 1-63 characters long and match the regular
6103 # expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first
6104 # character must be a lowercase letter, and all following characters must be
6105 # a dash, lowercase letter, or digit, except the last character, which cannot
6106 # be a dash.
6107 &quot;params&quot;: { # Machine Image parameters # Input only. [Input Only] Additional parameters that are passed in the request, but are
6108 # not persisted in the resource.
6109 &quot;excludedDisks&quot;: [ # Input only. [Input Only] Specifies the list of disk device names that must be
6110 # excluded from the new machine image.
6111 &quot;A String&quot;,
6112 ],
6113 &quot;includedDisks&quot;: [ # Input only. [Input Only] Specifies the list of disk device names that must be
6114 # included with the new machine image.
6115 &quot;A String&quot;,
6116 ],
6117 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the machine image. Tag keys and values
6118 # have the same definition as resource
6119 # manager tags. Keys and values can be either in numeric format,
6120 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
6121 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
6122 # `{tag_value_short_name}`. The field is ignored (both PUT &amp;
6123 # PATCH) when empty.
6124 &quot;a_key&quot;: &quot;A String&quot;,
6125 },
6126 },
6127 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
6128 &quot;satisfiesPzs&quot;: True or False, # Output only. [Output Only] Reserved for future use.
6129 &quot;savedDisks&quot;: [ # Output only. An array of Machine Image specific properties for disks attached to the
6130 # source instance
6131 { # An instance-attached disk resource.
6132 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk.
6133 &quot;kind&quot;: &quot;compute#savedDisk&quot;, # Output only. [Output Only] Type of the resource. Always compute#savedDisk
6134 # for attached disks.
6135 &quot;sourceDisk&quot;: &quot;A String&quot;, # Output only. Specifies a URL of the disk attached to the source instance.
6136 &quot;storageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Size of the individual disk snapshot used by this machine
6137 # image.
6138 &quot;storageBytesStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] An indicator whether storageBytes is in a
6139 # stable state or it is being adjusted as a result of shared storage
6140 # reallocation. This status can either be UPDATING, meaning
6141 # the size of the snapshot is being updated, or UP_TO_DATE,
6142 # meaning the size of the snapshot is up-to-date.
6143 },
6144 ],
6145 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for this machine image. The server defines this URL.
6146 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
6147 &quot;sourceDiskEncryptionKeys&quot;: [ # [Input Only] Thecustomer-supplied
6148 # encryption key of the disks attached to the source instance. Required
6149 # if the source disk is protected by a customer-supplied encryption key.
6150 {
6151 &quot;diskEncryptionKey&quot;: { # Thecustomer-supplied
6152 # encryption key of the source disk. Required if the source disk is
6153 # protected by a customer-supplied encryption key.
6154 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
6155 # For example:
6156 #
6157 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6158 # key_region/cryptoKeys/key
6159 #
6160 # The fully-qualifed key name may be returned for resource GET requests. For
6161 # example:
6162 #
6163 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6164 # key_region/cryptoKeys/key
6165 # /cryptoKeyVersions/1
6166 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
6167 # key. If absent, the Compute Engine default service account is used.
6168 # For example:
6169 #
6170 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
6171 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
6172 # encryption key, encoded in RFC
6173 # 4648 base64 to either encrypt or decrypt this resource. You can
6174 # provide either the rawKey or thersaEncryptedKey.
6175 # For example:
6176 #
6177 # &quot;rawKey&quot;:
6178 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
6179 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
6180 # customer-supplied encryption key to either encrypt or decrypt this
6181 # resource. You can provide either the rawKey or thersaEncryptedKey.
6182 # For example:
6183 #
6184 # &quot;rsaEncryptedKey&quot;:
6185 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
6186 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
6187 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
6188 #
6189 # The key must meet the following requirements before you can provide it to
6190 # Compute Engine:
6191 #
6192 # 1. The key is wrapped using a RSA public key certificate provided by
6193 # Google.
6194 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
6195 # encoding.
6196 #
6197 # Gets the RSA public key certificate provided by Google at:
6198 #
6199 #
6200 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
6201 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
6202 # 4648 base64 encoded SHA-256 hash of the customer-supplied
6203 # encryption key that protects this resource.
6204 },
6205 &quot;sourceDisk&quot;: &quot;A String&quot;, # URL of the disk attached to the source instance. This can be a full or
6206 # valid partial URL. For example, the following are valid values:
6207 #
6208 #
6209 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/disks/disk
6210 # - projects/project/zones/zone/disks/disk
6211 # - zones/zone/disks/disk
6212 },
6213 ],
6214 &quot;sourceInstance&quot;: &quot;A String&quot;, # The source instance used to create the machine image. You can provide this
6215 # as a partial or full URL to the resource. For example, the following are
6216 # valid values:
6217 #
6218 #
6219 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/instances/instance
6220 # - projects/project/zones/zone/instances/instance
6221 &quot;sourceInstanceProperties&quot;: { # DEPRECATED: Please use compute#instanceProperties instead. # Output only. [Output Only] DEPRECATED: Please use instance_properties
6222 # instead for source instance related properties. New properties will not be
6223 # added to this field.
6224 # New properties will not be added to this field.
6225 &quot;canIpForward&quot;: True or False, # Enables instances created based on this machine image to send packets with
6226 # source IP addresses other than their own and receive packets with
6227 # destination IP addresses other than their own. If these instances will be
6228 # used as an IP gateway or it will be set as the next-hop in a Route
6229 # resource, specify true. If unsure, leave this set tofalse. See theEnable IP forwarding
6230 # documentation for more information.
6231 &quot;deletionProtection&quot;: True or False, # Whether the instance created from this machine image should be protected
6232 # against deletion.
6233 &quot;description&quot;: &quot;A String&quot;, # An optional text description for the instances that are created from this
6234 # machine image.
6235 &quot;disks&quot;: [ # An array of disks that are associated with the instances that are created
6236 # from this machine image.
6237 { # DEPRECATED: Please use compute#savedDisk instead.
6238 # An instance-attached disk resource.
6239 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
6240 # deleted (but not when the disk is detached from the instance).
6241 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
6242 # partition of the disk for its root filesystem.
6243 &quot;deviceName&quot;: &quot;A String&quot;, # Specifies the name of the disk attached to the source instance.
6244 &quot;diskEncryptionKey&quot;: { # The encryption key for the disk.
6245 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
6246 # For example:
6247 #
6248 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6249 # key_region/cryptoKeys/key
6250 #
6251 # The fully-qualifed key name may be returned for resource GET requests. For
6252 # example:
6253 #
6254 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6255 # key_region/cryptoKeys/key
6256 # /cryptoKeyVersions/1
6257 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
6258 # key. If absent, the Compute Engine default service account is used.
6259 # For example:
6260 #
6261 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
6262 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
6263 # encryption key, encoded in RFC
6264 # 4648 base64 to either encrypt or decrypt this resource. You can
6265 # provide either the rawKey or thersaEncryptedKey.
6266 # For example:
6267 #
6268 # &quot;rawKey&quot;:
6269 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
6270 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
6271 # customer-supplied encryption key to either encrypt or decrypt this
6272 # resource. You can provide either the rawKey or thersaEncryptedKey.
6273 # For example:
6274 #
6275 # &quot;rsaEncryptedKey&quot;:
6276 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
6277 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
6278 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
6279 #
6280 # The key must meet the following requirements before you can provide it to
6281 # Compute Engine:
6282 #
6283 # 1. The key is wrapped using a RSA public key certificate provided by
6284 # Google.
6285 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
6286 # encoding.
6287 #
6288 # Gets the RSA public key certificate provided by Google at:
6289 #
6290 #
6291 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
6292 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
6293 # 4648 base64 encoded SHA-256 hash of the customer-supplied
6294 # encryption key that protects this resource.
6295 },
6296 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in base-2 GB.
6297 &quot;diskType&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the disk type resource. For example:projects/project/zones/zone/diskTypes/pd-standard or
6298 # pd-ssd
6299 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable only
6300 # for bootable images. Read
6301 # Enabling guest operating system features to see a list of available
6302 # options.
6303 { # Guest OS features.
6304 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
6305 # separate values. Set to one or more of the following values:
6306 #
6307 # - VIRTIO_SCSI_MULTIQUEUE
6308 # - WINDOWS
6309 # - MULTI_IP_SUBNET
6310 # - UEFI_COMPATIBLE
6311 # - GVNIC
6312 # - SEV_CAPABLE
6313 # - SUSPEND_RESUME_COMPATIBLE
6314 # - SEV_LIVE_MIGRATABLE_V2
6315 # - SEV_SNP_CAPABLE
6316 # - TDX_CAPABLE
6317 # - IDPF
6318 # - SNP_SVSM_CAPABLE
6319 # - CCA_CAPABLE
6320 #
6321 #
6322 # For more information, see
6323 # Enabling guest operating system features.
6324 },
6325 ],
6326 &quot;index&quot;: 42, # Output only. Specifies zero-based index of the disk that is attached to the source
6327 # instance.
6328 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
6329 # either SCSI or NVME.
6330 &quot;kind&quot;: &quot;compute#savedAttachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
6331 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
6332 &quot;A String&quot;,
6333 ],
6334 &quot;mode&quot;: &quot;A String&quot;, # The mode in which this disk is attached to the source instance, eitherREAD_WRITE or READ_ONLY.
6335 &quot;source&quot;: &quot;A String&quot;, # Specifies a URL of the disk attached to the source instance.
6336 &quot;storageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] A size of the storage used by the disk&#x27;s snapshot by this
6337 # machine image.
6338 &quot;storageBytesStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] An indicator whether storageBytes is in a
6339 # stable state or it is being adjusted as a result of shared storage
6340 # reallocation. This status can either be UPDATING, meaning
6341 # the size of the snapshot is being updated, or UP_TO_DATE,
6342 # meaning the size of the snapshot is up-to-date.
6343 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the attached disk, either SCRATCH orPERSISTENT.
6344 },
6345 ],
6346 &quot;guestAccelerators&quot;: [ # A list of guest accelerator cards&#x27; type and count to use for instances
6347 # created from this machine image.
6348 { # A specification of the type and number of accelerator cards attached to the
6349 # instance.
6350 &quot;acceleratorCount&quot;: 42, # The number of the guest accelerator cards exposed to this instance.
6351 &quot;acceleratorType&quot;: &quot;A String&quot;, # Full or partial URL of the accelerator type resource to attach to this
6352 # instance. For example:projects/my-project/zones/us-central1-c/acceleratorTypes/nvidia-tesla-p100
6353 # If you are creating an instance template, specify only the
6354 # accelerator name.
6355 # See GPUs on Compute Engine
6356 # for a full list of accelerator types.
6357 },
6358 ],
6359 &quot;keyRevocationActionType&quot;: &quot;A String&quot;, # KeyRevocationActionType of the instance. Supported options are &quot;STOP&quot; and
6360 # &quot;NONE&quot;. The default value is &quot;NONE&quot; if it is not specified.
6361 &quot;labels&quot;: { # Labels to apply to instances that are created from this machine image.
6362 &quot;a_key&quot;: &quot;A String&quot;,
6363 },
6364 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to use for instances that are created from this machine
6365 # image.
6366 &quot;metadata&quot;: { # A metadata key/value entry. # The metadata key/value pairs to assign to instances that are created from
6367 # this machine image. These pairs can consist of custom metadata or
6368 # predefined keys. SeeProject and
6369 # instance metadata for more information.
6370 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
6371 # the metadata&#x27;s contents and used for optimistic locking. The
6372 # fingerprint is initially generated by Compute Engine and changes after
6373 # every request to modify or update metadata. You must always provide an
6374 # up-to-date fingerprint hash in order to update or change metadata,
6375 # otherwise the request will fail with error412 conditionNotMet.
6376 #
6377 # To see the latest fingerprint, make a get() request to
6378 # retrieve the resource.
6379 &quot;items&quot;: [ # Array of key/value pairs. The total size of all keys and values must be
6380 # less than 512 KB.
6381 { # Metadata
6382 &quot;key&quot;: &quot;A String&quot;, # Key for the metadata entry. Keys must conform to the following
6383 # regexp: [a-zA-Z0-9-_]+, and be less than 128 bytes in length.
6384 # This is reflected as part of a URL in the metadata server. Additionally, to
6385 # avoid ambiguity, keys must not conflict with any other metadata keys
6386 # for the project.
6387 &quot;value&quot;: &quot;A String&quot;, # Value for the metadata entry. These are free-form strings, and only
6388 # have meaning as interpreted by the image running in the instance. The
6389 # only restriction placed on values is that their size must be less than
6390 # or equal to 262144 bytes (256 KiB).
6391 },
6392 ],
6393 &quot;kind&quot;: &quot;compute#metadata&quot;, # Output only. [Output Only] Type of the resource. Always compute#metadata
6394 # for metadata.
6395 },
6396 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Minimum cpu/platform to be used by instances created from this machine
6397 # image. The instance may be scheduled on the specified or newer
6398 # cpu/platform. Applicable values are the friendly names of CPU platforms,
6399 # such as minCpuPlatform: &quot;Intel Haswell&quot; orminCpuPlatform: &quot;Intel Sandy Bridge&quot;. For more
6400 # information, read Specifying a
6401 # Minimum CPU Platform.
6402 &quot;networkInterfaces&quot;: [ # An array of network access configurations for this interface.
6403 { # A network interface resource attached to an instance.
6404 &quot;accessConfigs&quot;: [ # An array of configurations for this interface. Currently, only one access
6405 # config, ONE_TO_ONE_NAT, is supported. If there are noaccessConfigs specified, then this instance will have
6406 # no external internet access.
6407 { # An access configuration attached to an instance&#x27;s network interface.
6408 # Only one access config per instance is supported.
6409 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
6410 # The first IPv6 address of the external IPv6 range associated
6411 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
6412 # use a static external IP address, it must be unused and in the same region
6413 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
6414 # assign an external IPv6 address from the instance&#x27;s subnetwork.
6415 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
6416 # external IPv6 range.
6417 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
6418 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
6419 # (IPv4), the default and recommended name is External NAT, but
6420 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
6421 # recommend name is External IPv6.
6422 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
6423 # address associated with this instance. Specify an unused static
6424 # external IP address available to the project or leave this field undefined
6425 # to use an IP from a shared ephemeral IP address pool. If you specify a
6426 # static external IP address, it must live in the same region as the zone of
6427 # the instance.
6428 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
6429 # configuration and can only take the following values: PREMIUM,STANDARD.
6430 #
6431 # If an AccessConfig is specified without a valid external IP address, an
6432 # ephemeral IP will be created with this networkTier.
6433 #
6434 # If an AccessConfig with a valid external IP address is specified, it must
6435 # match that of the networkTier associated with the Address resource owning
6436 # that IP.
6437 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
6438 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
6439 #
6440 # 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
6441 # first IP in associated external IPv6 range.
6442 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
6443 # config.
6444 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
6445 # external IP address of this access configuration.
6446 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
6447 # external IP address of the instance to a DNS domain name.
6448 #
6449 # This field is not used in ipv6AccessConfig. A default PTR
6450 # record will be created if the VM has external IPv6 range associated.
6451 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
6452 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
6453 },
6454 ],
6455 &quot;aliasIpRanges&quot;: [ # An array of alias IP ranges for this network interface.
6456 # You can only specify this field for network interfaces in VPC networks.
6457 { # An alias IP range attached to an instance&#x27;s network interface.
6458 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
6459 # must belong to the specified subnetwork and cannot contain IP addresses
6460 # reserved by system or used by other network interfaces. This range may be
6461 # 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).
6462 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
6463 # alias range. If not specified, the primary range of the subnetwork is used.
6464 },
6465 ],
6466 &quot;aliasIpv6Ranges&quot;: [ # An array of alias IPv6 ranges for this network interface.
6467 # You can only specify this field for network interfaces in VPC networks.
6468 { # An alias IP range attached to an instance&#x27;s network interface.
6469 &quot;ipCidrRange&quot;: &quot;A String&quot;, # The IP alias ranges to allocate for this interface. This IP CIDR range
6470 # must belong to the specified subnetwork and cannot contain IP addresses
6471 # reserved by system or used by other network interfaces. This range may be
6472 # 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).
6473 &quot;subnetworkRangeName&quot;: &quot;A String&quot;, # The name of a subnetwork secondary IP range from which to allocate an IP
6474 # alias range. If not specified, the primary range of the subnetwork is used.
6475 },
6476 ],
6477 &quot;dns64Eligible&quot;: True or False, # If true, this network interface is eligible for DNS64.
6478 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
6479 &quot;enableVpcScopedDns&quot;: True or False, # Optional. If true, DNS resolution will be enabled over this interface. Only valid
6480 # with network_attachment.
6481 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint hash of contents stored in this network interface.
6482 # This field will be ignored when inserting an Instance or
6483 # adding a NetworkInterface. An up-to-date
6484 # 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.
6485 &quot;igmpQuery&quot;: &quot;A String&quot;, # Indicate whether igmp query is enabled on the network interface
6486 # or not. If enabled, also indicates the version of IGMP supported.
6487 &quot;internalIpv6PrefixLength&quot;: 42, # The prefix length of the primary internal IPv6 range.
6488 &quot;ipv6AccessConfigs&quot;: [ # An array of IPv6 access configurations for this interface. Currently, only
6489 # one IPv6 access config, DIRECT_IPV6, is supported. If there
6490 # is no ipv6AccessConfig specified, then this instance will
6491 # have no external IPv6 Internet access.
6492 { # An access configuration attached to an instance&#x27;s network interface.
6493 # Only one access config per instance is supported.
6494 &quot;externalIpv6&quot;: &quot;A String&quot;, # Applies to ipv6AccessConfigs only.
6495 # The first IPv6 address of the external IPv6 range associated
6496 # with this instance, prefix length is stored inexternalIpv6PrefixLength in ipv6AccessConfig. To
6497 # use a static external IP address, it must be unused and in the same region
6498 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
6499 # assign an external IPv6 address from the instance&#x27;s subnetwork.
6500 &quot;externalIpv6PrefixLength&quot;: 42, # Applies to ipv6AccessConfigs only. The prefix length of the
6501 # external IPv6 range.
6502 &quot;kind&quot;: &quot;compute#accessConfig&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#accessConfig for access configs.
6503 &quot;name&quot;: &quot;A String&quot;, # The name of this access configuration. In accessConfigs
6504 # (IPv4), the default and recommended name is External NAT, but
6505 # you can use any arbitrary string, such as My external IP orNetwork Access. In ipv6AccessConfigs, the
6506 # recommend name is External IPv6.
6507 &quot;natIP&quot;: &quot;A String&quot;, # Applies to accessConfigs (IPv4) only. Anexternal IP
6508 # address associated with this instance. Specify an unused static
6509 # external IP address available to the project or leave this field undefined
6510 # to use an IP from a shared ephemeral IP address pool. If you specify a
6511 # static external IP address, it must live in the same region as the zone of
6512 # the instance.
6513 &quot;networkTier&quot;: &quot;A String&quot;, # This signifies the networking tier used for configuring this access
6514 # configuration and can only take the following values: PREMIUM,STANDARD.
6515 #
6516 # If an AccessConfig is specified without a valid external IP address, an
6517 # ephemeral IP will be created with this networkTier.
6518 #
6519 # If an AccessConfig with a valid external IP address is specified, it must
6520 # match that of the networkTier associated with the Address resource owning
6521 # that IP.
6522 &quot;publicDnsName&quot;: &quot;A String&quot;, # Output only. [Output Only] The public DNS domain name for the instance.
6523 &quot;publicPtrDomainName&quot;: &quot;A String&quot;, # The DNS domain name for the public PTR record.
6524 #
6525 # 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
6526 # first IP in associated external IPv6 range.
6527 &quot;securityPolicy&quot;: &quot;A String&quot;, # The resource URL for the security policy associated with this access
6528 # config.
6529 &quot;setPublicDns&quot;: True or False, # Specifies whether a public DNS &#x27;A&#x27; record should be created for the
6530 # external IP address of this access configuration.
6531 &quot;setPublicPtr&quot;: True or False, # Specifies whether a public DNS &#x27;PTR&#x27; record should be created to map the
6532 # external IP address of the instance to a DNS domain name.
6533 #
6534 # This field is not used in ipv6AccessConfig. A default PTR
6535 # record will be created if the VM has external IPv6 range associated.
6536 &quot;type&quot;: &quot;A String&quot;, # The type of configuration. In accessConfigs (IPv4), the
6537 # default and only option is ONE_TO_ONE_NAT. Inipv6AccessConfigs, the default and only option isDIRECT_IPV6.
6538 },
6539 ],
6540 &quot;ipv6AccessType&quot;: &quot;A String&quot;, # Output only. [Output Only] One of EXTERNAL, INTERNAL to indicate whether the IP can be
6541 # accessed from the Internet. This field is always inherited from its
6542 # subnetwork.
6543 #
6544 # Valid only if stackType is IPV4_IPV6.
6545 &quot;ipv6Address&quot;: &quot;A String&quot;, # An IPv6 internal network address for this network interface. To
6546 # use a static internal IP address, it must be unused and in the same region
6547 # as the instance&#x27;s zone. If not specified, Google Cloud will automatically
6548 # assign an internal IPv6 address from the instance&#x27;s subnetwork.
6549 &quot;kind&quot;: &quot;compute#networkInterface&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#networkInterface for network interfaces.
6550 &quot;macAddress&quot;: &quot;A String&quot;, # Output only. [Output Only] MAC address assigned to this network interface.
6551 &quot;name&quot;: &quot;A String&quot;, # [Output Only] The name of the network interface, which is generated by the
6552 # server. For a VM, the network interface uses the nicN naming
6553 # format. Where N is a value between 0 and7. The default interface value is nic0.
6554 &quot;nat64Eligible&quot;: True or False, # If true, this network interface is eligible for NAT64.
6555 # This field is only supported for dual-stack (IPV4_IPV6) network interfaces.
6556 &quot;network&quot;: &quot;A String&quot;, # URL of the VPC network resource for this instance. When creating an
6557 # instance, if neither the network nor the subnetwork is specified, the
6558 # default network global/networks/default is used. If the
6559 # selected project doesn&#x27;t have the default network, you must specify a
6560 # network or subnet. If the network is not specified but the subnetwork is
6561 # specified, the network is inferred.
6562 #
6563 # If you specify this property, you can specify the network as
6564 # a full or partial URL. For example, the following are all valid URLs:
6565 #
6566 #
6567 # - https://www.googleapis.com/compute/v1/projects/project/global/networks/network
6568 # - projects/project/global/networks/network
6569 # - global/networks/default
6570 &quot;networkAttachment&quot;: &quot;A String&quot;, # The URL of the network attachment that this interface should connect
6571 # to in the following format:
6572 # projects/{project_number}/regions/{region_name}/networkAttachments/{network_attachment_name}.
6573 &quot;networkIP&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this network
6574 # interface. If not specified by the user, an unused internal IP is
6575 # assigned by the system.
6576 &quot;nicType&quot;: &quot;A String&quot;, # The type of vNIC to be used on this interface. This may be gVNIC or
6577 # VirtioNet.
6578 &quot;parentNicName&quot;: &quot;A String&quot;, # Name of the parent network interface of a dynamic network interface.
6579 &quot;queueCount&quot;: 42, # The networking queue count that&#x27;s specified by users for the network
6580 # interface. Both Rx and Tx queues will be set to this number. It&#x27;ll be empty
6581 # if not specified by the users.
6582 &quot;serviceClassId&quot;: &quot;A String&quot;, # Optional. Producer Service&#x27;s Service class Id for the region of this network
6583 # interface. Can only be used with network_attachment. It is not possible to
6584 # use on its own however, network_attachment can be used without
6585 # service_class_id.
6586 &quot;stackType&quot;: &quot;A String&quot;, # The stack type for this network interface. To assign only IPv4 addresses,
6587 # use IPV4_ONLY. To assign both IPv4 and IPv6 addresses, useIPV4_IPV6. If not specified, IPV4_ONLY is used.
6588 #
6589 # This field can be both set at instance creation and update network
6590 # interface operations.
6591 &quot;subinterfaces&quot;: [ # SubInterfaces help enable L2 communication for the instance over
6592 # subnetworks that support L2. Every network interface will get a default
6593 # untagged (vlan not specified) subinterface. Users can specify additional
6594 # tagged subinterfaces which are sub-fields to the Network Interface.
6595 {
6596 &quot;ipAddress&quot;: &quot;A String&quot;, # An IPv4 internal IP address to assign to the instance for this
6597 # subinterface. If specified, ip_allocation_mode should be set to
6598 # ALLOCATE_IP.
6599 &quot;ipAllocationMode&quot;: &quot;A String&quot;,
6600 &quot;subnetwork&quot;: &quot;A String&quot;, # If specified, this subnetwork must belong to the same network
6601 # as that of the network interface.
6602 # If not specified the subnet of network interface will be used.
6603 # If you specify this property, you can specify the subnetwork as a full
6604 # or partial URL. For example, the following are all valid URLs:
6605 #
6606 #
6607 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
6608 # - regions/region/subnetworks/subnetwork
6609 &quot;vlan&quot;: 42, # VLAN tag. Should match the VLAN(s) supported by the subnetwork to which
6610 # this subinterface is connecting.
6611 },
6612 ],
6613 &quot;subnetwork&quot;: &quot;A String&quot;, # The URL of the Subnetwork resource for this instance. If the network
6614 # resource is inlegacy
6615 # mode, do not specify this field. If the network is in auto subnet
6616 # mode, specifying the subnetwork is optional. If the network is in custom
6617 # subnet mode, specifying the subnetwork is required. If you specify this
6618 # field, you can specify the subnetwork as a full or partial URL. For
6619 # example, the following are all valid URLs:
6620 #
6621 #
6622 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/subnetworks/subnetwork
6623 # - regions/region/subnetworks/subnetwork
6624 &quot;vlan&quot;: 42, # VLAN tag of a dynamic network interface, must be an integer in the range
6625 # from 2 to 255 inclusively.
6626 },
6627 ],
6628 &quot;postKeyRevocationActionType&quot;: &quot;A String&quot;, # PostKeyRevocationActionType of the instance.
6629 &quot;scheduling&quot;: { # Sets the scheduling options for an Instance. # Specifies the scheduling options for the instances that are created from
6630 # this machine image.
6631 &quot;automaticRestart&quot;: True or False, # Specifies whether the instance should be automatically restarted if it is
6632 # terminated by Compute Engine (not terminated by a user). You can only set
6633 # the automatic restart option for standard instances.Preemptible instances
6634 # cannot be automatically restarted.
6635 #
6636 # By default, this is set to true so an instance is
6637 # automatically restarted if it is terminated by Compute Engine.
6638 &quot;availabilityDomain&quot;: 42, # Specifies the availability domain to place the instance in. The value
6639 # must be a number between 1 and the number of availability domains
6640 # specified in the spread placement policy attached to the instance.
6641 &quot;currentCpus&quot;: 42, # Current number of vCPUs available for VM.
6642 # 0 or unset means default vCPUs of the current machine type.
6643 &quot;currentMemoryMb&quot;: &quot;A String&quot;, # Current amount of memory (in MB) available for VM.
6644 # 0 or unset means default amount of memory of the current machine type.
6645 &quot;gracefulShutdown&quot;: { # The configuration for gracefully shutting down the instance.
6646 &quot;enabled&quot;: True or False, # Opts-in for graceful shutdown.
6647 &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
6648 # graceful shutdown isn&#x27;t complete after this time, then the instance
6649 # transitions to the STOPPING state.
6650 # as a count of seconds and fractions of seconds at nanosecond
6651 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6652 # or &quot;month&quot;. Range is approximately 10,000 years.
6653 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6654 # Durations less than one second are represented with a 0
6655 # `seconds` field and a positive `nanos` field. Must be from 0
6656 # to 999,999,999 inclusive.
6657 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6658 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6659 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6660 },
6661 },
6662 &quot;hostErrorTimeoutSeconds&quot;: 42, # Specify the time in seconds for host error detection, the value must be
6663 # within the range of [90, 330] with the increment of 30, if unset, the
6664 # default behavior of host error recovery will be used.
6665 &quot;instanceTerminationAction&quot;: &quot;A String&quot;, # Specifies the termination action for the instance.
6666 &quot;latencyTolerant&quot;: True or False, # Defines whether the instance is tolerant of higher cpu latency. This can
6667 # only be set during instance creation, or when the instance is not currently
6668 # running. It must not be set if thepreemptible option is
6669 # also set.
6670 &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
6671 # recovery of the Local Ssd state is attempted. Its value should be in
6672 # between 0 and 168 hours with hour granularity and the default value being 1
6673 # hour.
6674 # as a count of seconds and fractions of seconds at nanosecond
6675 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6676 # or &quot;month&quot;. Range is approximately 10,000 years.
6677 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6678 # Durations less than one second are represented with a 0
6679 # `seconds` field and a positive `nanos` field. Must be from 0
6680 # to 999,999,999 inclusive.
6681 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6682 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6683 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6684 },
6685 &quot;locationHint&quot;: &quot;A String&quot;, # An opaque location hint used to place the instance close to other
6686 # resources.
6687 # This field is for use by internal tools that use the public API.
6688 &quot;maintenanceFreezeDurationHours&quot;: 42, # Specifies the number of hours after VM instance creation where the VM won&#x27;t
6689 # be scheduled for maintenance.
6690 &quot;maintenanceInterval&quot;: &quot;A String&quot;, # Specifies the frequency of planned maintenance events. The accepted values
6691 # are: `PERIODIC`.
6692 &quot;maxRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Specifies the max run duration for the given instance. If specified,
6693 # the instance termination action will be performed at the end of the run
6694 # duration.
6695 # as a count of seconds and fractions of seconds at nanosecond
6696 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6697 # or &quot;month&quot;. Range is approximately 10,000 years.
6698 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6699 # Durations less than one second are represented with a 0
6700 # `seconds` field and a positive `nanos` field. Must be from 0
6701 # to 999,999,999 inclusive.
6702 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6703 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6704 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6705 },
6706 &quot;minNodeCpus&quot;: 42, # The minimum number of virtual CPUs this instance will consume when running
6707 # on a sole-tenant node.
6708 &quot;nodeAffinities&quot;: [ # A set of node affinity and anti-affinity configurations. Refer toConfiguring node
6709 # affinity for more information.
6710 # Overrides reservationAffinity.
6711 { # Node Affinity: the configuration of desired nodes onto which this Instance
6712 # could be scheduled.
6713 &quot;key&quot;: &quot;A String&quot;, # Corresponds to the label key of Node resource.
6714 &quot;operator&quot;: &quot;A String&quot;, # Defines the operation of node selection. Valid operators areIN for affinity and NOT_IN for anti-affinity.
6715 &quot;values&quot;: [ # Corresponds to the label values of Node resource.
6716 &quot;A String&quot;,
6717 ],
6718 },
6719 ],
6720 &quot;onHostMaintenance&quot;: &quot;A String&quot;, # Defines the maintenance behavior for this instance. For standard instances,
6721 # the default behavior is MIGRATE. Forpreemptible instances,
6722 # the default and only possible behavior is TERMINATE. For more
6723 # information, see
6724 # Set
6725 # VM host maintenance policy.
6726 &quot;onInstanceStopAction&quot;: { # Defines the behaviour for instances with the instance_termination_actionSTOP.
6727 &quot;discardLocalSsd&quot;: True or False, # If true, the contents of any attached Local SSD disks will be discarded
6728 # else, the Local SSD data will be preserved when the instance is stopped
6729 # at the end of the run duration/termination time.
6730 },
6731 &quot;preemptible&quot;: True or False, # Defines whether the instance is preemptible. This can only be set during
6732 # instance creation or while the instance isstopped and
6733 # therefore, in a `TERMINATED` state. SeeInstance Life
6734 # Cycle for more information on the possible instance states.
6735 &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
6736 # Off signal is triggered for Spot
6737 # VMs only. If not specified, there will be no wait before the G2 Soft
6738 # Off signal is triggered.
6739 # as a count of seconds and fractions of seconds at nanosecond
6740 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6741 # or &quot;month&quot;. Range is approximately 10,000 years.
6742 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6743 # Durations less than one second are represented with a 0
6744 # `seconds` field and a positive `nanos` field. Must be from 0
6745 # to 999,999,999 inclusive.
6746 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6747 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6748 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6749 },
6750 &quot;provisioningModel&quot;: &quot;A String&quot;, # Specifies the provisioning model of the instance.
6751 &quot;shutdownTimeout&quot;: { # A Duration represents a fixed-length span of time represented # DEPRECATED: please use skipGuestOsShutdown.
6752 # Timeout between GCE ACPI G2 Soft
6753 # Off and ACPI G3 Mechanical
6754 # Off during shutdown operation of VM.
6755 #
6756 # For Standard VMs values between 0s and 120s are allowed. For Spot and
6757 # Preemptible VMs supported values are between 0s and 30s.
6758 #
6759 # If no value is specified for shutdownDuration, default values are 90s for
6760 # Standard VMs and 30s for Spot/Preemptible VMs.
6761 # as a count of seconds and fractions of seconds at nanosecond
6762 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
6763 # or &quot;month&quot;. Range is approximately 10,000 years.
6764 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
6765 # Durations less than one second are represented with a 0
6766 # `seconds` field and a positive `nanos` field. Must be from 0
6767 # to 999,999,999 inclusive.
6768 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
6769 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
6770 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
6771 },
6772 &quot;skipGuestOsShutdown&quot;: True or False, # Default is false and there will be 120 seconds between GCE ACPI G2 Soft
6773 # Off and ACPI G3 Mechanical
6774 # Off for Standard VMs and 30 seconds for Spot VMs.
6775 &quot;terminationTime&quot;: &quot;A String&quot;, # Specifies the timestamp, when the instance will be terminated, inRFC3339 text format. If specified, the instance
6776 # termination action will be performed at the termination time.
6777 &quot;vsockMode&quot;: { # Message to control the enablement of the vsock device. # The vsock mode of the instance.
6778 &quot;mode&quot;: &quot;A String&quot;,
6779 },
6780 &quot;windowsLicenseOptimizationMode&quot;: &quot;A String&quot;, # Represents the Windows Server License Optimization Mode of the VM. If
6781 # unspecified, the default mode is `OFF`.
6782 },
6783 &quot;serviceAccounts&quot;: [ # A list of service accounts with specified scopes. Access tokens for these
6784 # service accounts are available to the instances that are created from this
6785 # machine image. Use metadata queries to obtain the access tokens for these
6786 # instances.
6787 { # A service account.
6788 &quot;email&quot;: &quot;A String&quot;, # Email address of the service account.
6789 &quot;scopes&quot;: [ # The list of scopes to be made available for this service account.
6790 &quot;A String&quot;,
6791 ],
6792 },
6793 ],
6794 &quot;tags&quot;: { # A set of instance tags. # A list of tags to apply to the instances that are created from this machine
6795 # image. The tags identify valid sources or targets for network firewalls.
6796 # The setTags method can modify this list of tags. Each tag within the list
6797 # must comply withRFC1035.
6798 &quot;fingerprint&quot;: &quot;A String&quot;, # Specifies a fingerprint for this request, which is essentially a hash of
6799 # the tags&#x27; contents and used for optimistic locking. The
6800 # fingerprint is initially generated by Compute Engine and changes after
6801 # every request to modify or update tags. You must always provide an
6802 # up-to-date fingerprint hash in order to update or change tags.
6803 #
6804 # To see the latest fingerprint, make get() request to the
6805 # instance.
6806 &quot;items&quot;: [ # An array of tags. Each tag must be 1-63 characters long, and comply
6807 # with RFC1035.
6808 &quot;A String&quot;,
6809 ],
6810 },
6811 },
6812 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the machine image. One of the following values:INVALID, CREATING, READY,DELETING, and UPLOADING.
6813 &quot;storageLocations&quot;: [ # The regional or multi-regional Cloud Storage bucket location where themachine image is
6814 # stored.
6815 &quot;A String&quot;,
6816 ],
6817 &quot;totalStorageBytes&quot;: &quot;A String&quot;, # Output only. [Output Only] Total size of the storage used by the machine image.
6818 },
6819 ],
6820 &quot;kind&quot;: &quot;compute#machineImageList&quot;, # Output only. [Output Only] The resource type, which is alwayscompute#machineImagesListResponse for machine image lists.
6821 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
6822 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
6823 # the query parameter pageToken in the next list request.
6824 # Subsequent list requests will have their own nextPageToken to
6825 # continue paging through the results.
6826 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
6827 &quot;warning&quot;: { # [Output Only] Informational warning message.
6828 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6829 # Engine returns NO_RESULTS_ON_PAGE if there
6830 # are no results in the response.
6831 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6832 # value format. For example:
6833 #
6834 # &quot;data&quot;: [
6835 # {
6836 # &quot;key&quot;: &quot;scope&quot;,
6837 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6838 # }
6839 {
6840 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6841 # returned. For example, for warnings where there are no results in a list
6842 # request for a particular zone, this key might be scope and
6843 # the key value might be the zone name. Other examples might be a key
6844 # indicating a deprecated resource and a suggested replacement, or a
6845 # warning about invalid network settings (for example, if an instance
6846 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6847 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6848 },
6849 ],
6850 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6851 },
6852 }</pre>
6853 </div>
6854
6855 <div class="method">
6856 <code class="details" id="list_next">list_next()</code>
6857 <pre>Retrieves the next page of results.
6858
6859 Args:
6860 previous_request: The request for the previous page. (required)
6861 previous_response: The response from the request for the previous page. (required)
6862
6863 Returns:
6864 A request object that you can call &#x27;execute()&#x27; on to request the next
6865 page. Returns None if there are no more items in the collection.
6866 </pre>
6867 </div>
6868
6869 <div class="method">
6870 <code class="details" id="setIamPolicy">setIamPolicy(project, resource, body=None, x__xgafv=None)</code>
6871 <pre>Sets the access control policy on the specified resource.
6872 Replaces any existing policy.
6873
6874 Args:
6875 project: string, Project ID for this request. (required)
6876 resource: string, Name or id of the resource for this request. (required)
6877 body: object, The request body.
6878 The object takes the form of:
6879
6880 {
6881 &quot;bindings&quot;: [ # Flatten Policy to create a backward compatible wire-format.
6882 # Deprecated. Use &#x27;policy&#x27; to specify bindings.
6883 { # Associates `members`, or principals, with a `role`.
6884 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
6885 #
6886 # If the condition evaluates to `true`, then this binding applies to the
6887 # current request.
6888 #
6889 # If the condition evaluates to `false`, then this binding does not apply to
6890 # the current request. However, a different role binding might grant the same
6891 # role to one or more of the principals in this binding.
6892 #
6893 # To learn which resources support conditions in their IAM policies, see the
6894 # [IAM
6895 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
6896 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
6897 # are documented at https://github.com/google/cel-spec.
6898 #
6899 # Example (Comparison):
6900 #
6901 # title: &quot;Summary size limit&quot;
6902 # description: &quot;Determines if a summary is less than 100 chars&quot;
6903 # expression: &quot;document.summary.size() &lt; 100&quot;
6904 #
6905 # Example (Equality):
6906 #
6907 # title: &quot;Requestor is owner&quot;
6908 # description: &quot;Determines if requestor is the document owner&quot;
6909 # expression: &quot;document.owner == request.auth.claims.email&quot;
6910 #
6911 # Example (Logic):
6912 #
6913 # title: &quot;Public documents&quot;
6914 # description: &quot;Determine whether the document should be publicly visible&quot;
6915 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
6916 #
6917 # Example (Data Manipulation):
6918 #
6919 # title: &quot;Notification string&quot;
6920 # description: &quot;Create a notification string with a timestamp.&quot;
6921 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
6922 #
6923 # The exact variables and functions that may be referenced within an expression
6924 # are determined by the service that evaluates it. See the service
6925 # documentation for additional information.
6926 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
6927 # describes the expression, e.g. when hovered over it in a UI.
6928 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
6929 # syntax.
6930 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
6931 # reporting, e.g. a file name and a position in the file.
6932 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
6933 # its purpose. This can be used e.g. in UIs which allow to enter the
6934 # expression.
6935 },
6936 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
6937 # `members` can have the following values:
6938 #
6939 # * `allUsers`: A special identifier that represents anyone who is
6940 # on the internet; with or without a Google account.
6941 #
6942 # * `allAuthenticatedUsers`: A special identifier that represents anyone
6943 # who is authenticated with a Google account or a service account.
6944 # Does not include identities that come from external identity providers
6945 # (IdPs) through identity federation.
6946 #
6947 # * `user:{emailid}`: An email address that represents a specific Google
6948 # account. For example, `[email protected]` .
6949 #
6950 #
6951 # * `serviceAccount:{emailid}`: An email address that represents a Google
6952 # service account. For example,
6953 # `[email protected]`.
6954 #
6955 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
6956 # identifier for a
6957 # [Kubernetes service
6958 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
6959 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
6960 #
6961 # * `group:{emailid}`: An email address that represents a Google group.
6962 # For example, `[email protected]`.
6963 #
6964 #
6965 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
6966 # users of that domain. For example, `google.com` or `example.com`.
6967 #
6968 #
6969 #
6970 #
6971 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
6972 # A single identity in a workforce identity pool.
6973 #
6974 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
6975 # All workforce identities in a group.
6976 #
6977 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
6978 # All workforce identities with a specific attribute value.
6979 #
6980 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
6981 # All identities in a workforce identity pool.
6982 #
6983 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
6984 # A single identity in a workload identity pool.
6985 #
6986 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
6987 # A workload identity pool group.
6988 #
6989 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
6990 # All identities in a workload identity pool with a certain attribute.
6991 #
6992 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
6993 # All identities in a workload identity pool.
6994 #
6995 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
6996 # identifier) representing a user that has been recently deleted. For
6997 # example, `[email protected]?uid=123456789012345678901`. If the user is
6998 # recovered, this value reverts to `user:{emailid}` and the recovered user
6999 # retains the role in the binding.
7000 #
7001 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
7002 # unique identifier) representing a service account that has been recently
7003 # deleted. For example,
7004 # `[email protected]?uid=123456789012345678901`.
7005 # If the service account is undeleted, this value reverts to
7006 # `serviceAccount:{emailid}` and the undeleted service account retains the
7007 # role in the binding.
7008 #
7009 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
7010 # identifier) representing a Google group that has been recently
7011 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
7012 # the group is recovered, this value reverts to `group:{emailid}` and the
7013 # recovered group retains the role in the binding.
7014 #
7015 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
7016 # Deleted single identity in a workforce identity pool. For example,
7017 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
7018 &quot;A String&quot;,
7019 ],
7020 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
7021 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
7022 #
7023 # For an overview of the IAM roles and permissions, see the
7024 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
7025 # a list of the available pre-defined roles, see
7026 # [here](https://cloud.google.com/iam/docs/understanding-roles).
7027 },
7028 ],
7029 &quot;etag&quot;: &quot;A String&quot;, # Flatten Policy to create a backward compatible wire-format.
7030 # Deprecated. Use &#x27;policy&#x27; to specify the etag.
7031 &quot;policy&quot;: { # An Identity and Access Management (IAM) policy, which specifies access # REQUIRED: The complete policy to be applied to the &#x27;resource&#x27;. The size of
7032 # the policy is limited to a few 10s of KB. An empty policy is in general a
7033 # valid policy but certain services (like Projects) might reject them.
7034 # controls for Google Cloud resources.
7035 #
7036 #
7037 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
7038 # `members`, or principals, to a single `role`. Principals can be user
7039 # accounts, service accounts, Google groups, and domains (such as G Suite). A
7040 # `role` is a named list of permissions; each `role` can be an IAM predefined
7041 # role or a user-created custom role.
7042 #
7043 # For some types of Google Cloud resources, a `binding` can also specify a
7044 # `condition`, which is a logical expression that allows access to a resource
7045 # only if the expression evaluates to `true`. A condition can add constraints
7046 # based on attributes of the request, the resource, or both. To learn which
7047 # resources support conditions in their IAM policies, see the
7048 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7049 #
7050 # **JSON example:**
7051 #
7052 # ```
7053 # {
7054 # &quot;bindings&quot;: [
7055 # {
7056 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
7057 # &quot;members&quot;: [
7058 # &quot;user:[email protected]&quot;,
7059 # &quot;group:[email protected]&quot;,
7060 # &quot;domain:google.com&quot;,
7061 # &quot;serviceAccount:[email protected]&quot;
7062 # ]
7063 # },
7064 # {
7065 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
7066 # &quot;members&quot;: [
7067 # &quot;user:[email protected]&quot;
7068 # ],
7069 # &quot;condition&quot;: {
7070 # &quot;title&quot;: &quot;expirable access&quot;,
7071 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
7072 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
7073 # }
7074 # }
7075 # ],
7076 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
7077 # &quot;version&quot;: 3
7078 # }
7079 # ```
7080 #
7081 # **YAML example:**
7082 #
7083 # ```
7084 # bindings:
7085 # - members:
7086 # - user:[email protected]
7087 # - group:[email protected]
7088 # - domain:google.com
7089 # - serviceAccount:[email protected]
7090 # role: roles/resourcemanager.organizationAdmin
7091 # - members:
7092 # - user:[email protected]
7093 # role: roles/resourcemanager.organizationViewer
7094 # condition:
7095 # title: expirable access
7096 # description: Does not grant access after Sep 2020
7097 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
7098 # etag: BwWWja0YfJA=
7099 # version: 3
7100 # ```
7101 #
7102 # For a description of IAM and its features, see the
7103 # [IAM documentation](https://cloud.google.com/iam/docs/).
7104 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
7105 { # Specifies the audit configuration for a service.
7106 # The configuration determines which permission types are logged, and what
7107 # identities, if any, are exempted from logging.
7108 # An AuditConfig must have one or more AuditLogConfigs.
7109 #
7110 # If there are AuditConfigs for both `allServices` and a specific service,
7111 # the union of the two AuditConfigs is used for that service: the log_types
7112 # specified in each AuditConfig are enabled, and the exempted_members in each
7113 # AuditLogConfig are exempted.
7114 #
7115 # Example Policy with multiple AuditConfigs:
7116 #
7117 # {
7118 # &quot;audit_configs&quot;: [
7119 # {
7120 # &quot;service&quot;: &quot;allServices&quot;,
7121 # &quot;audit_log_configs&quot;: [
7122 # {
7123 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
7124 # &quot;exempted_members&quot;: [
7125 # &quot;user:[email protected]&quot;
7126 # ]
7127 # },
7128 # {
7129 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
7130 # },
7131 # {
7132 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
7133 # }
7134 # ]
7135 # },
7136 # {
7137 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
7138 # &quot;audit_log_configs&quot;: [
7139 # {
7140 # &quot;log_type&quot;: &quot;DATA_READ&quot;
7141 # },
7142 # {
7143 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
7144 # &quot;exempted_members&quot;: [
7145 # &quot;user:[email protected]&quot;
7146 # ]
7147 # }
7148 # ]
7149 # }
7150 # ]
7151 # }
7152 #
7153 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
7154 # logging. It also exempts `[email protected]` from DATA_READ logging, and
7155 # `[email protected]` from DATA_WRITE logging.
7156 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
7157 { # Provides the configuration for logging a type of permissions.
7158 # Example:
7159 #
7160 # {
7161 # &quot;audit_log_configs&quot;: [
7162 # {
7163 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
7164 # &quot;exempted_members&quot;: [
7165 # &quot;user:[email protected]&quot;
7166 # ]
7167 # },
7168 # {
7169 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
7170 # }
7171 # ]
7172 # }
7173 #
7174 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
7175 # [email protected] from DATA_READ logging.
7176 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
7177 # permission.
7178 # Follows the same format of Binding.members.
7179 &quot;A String&quot;,
7180 ],
7181 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
7182 },
7183 ],
7184 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
7185 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
7186 # `allServices` is a special value that covers all services.
7187 },
7188 ],
7189 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
7190 # may specify a `condition` that determines how and when the `bindings` are
7191 # applied. Each of the `bindings` must contain at least one principal.
7192 #
7193 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
7194 # of these principals can be Google groups. Each occurrence of a principal
7195 # counts towards these limits. For example, if the `bindings` grant 50
7196 # different roles to `user:[email protected]`, and not to any other
7197 # principal, then you can add another 1,450 principals to the `bindings` in
7198 # the `Policy`.
7199 { # Associates `members`, or principals, with a `role`.
7200 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
7201 #
7202 # If the condition evaluates to `true`, then this binding applies to the
7203 # current request.
7204 #
7205 # If the condition evaluates to `false`, then this binding does not apply to
7206 # the current request. However, a different role binding might grant the same
7207 # role to one or more of the principals in this binding.
7208 #
7209 # To learn which resources support conditions in their IAM policies, see the
7210 # [IAM
7211 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7212 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
7213 # are documented at https://github.com/google/cel-spec.
7214 #
7215 # Example (Comparison):
7216 #
7217 # title: &quot;Summary size limit&quot;
7218 # description: &quot;Determines if a summary is less than 100 chars&quot;
7219 # expression: &quot;document.summary.size() &lt; 100&quot;
7220 #
7221 # Example (Equality):
7222 #
7223 # title: &quot;Requestor is owner&quot;
7224 # description: &quot;Determines if requestor is the document owner&quot;
7225 # expression: &quot;document.owner == request.auth.claims.email&quot;
7226 #
7227 # Example (Logic):
7228 #
7229 # title: &quot;Public documents&quot;
7230 # description: &quot;Determine whether the document should be publicly visible&quot;
7231 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
7232 #
7233 # Example (Data Manipulation):
7234 #
7235 # title: &quot;Notification string&quot;
7236 # description: &quot;Create a notification string with a timestamp.&quot;
7237 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
7238 #
7239 # The exact variables and functions that may be referenced within an expression
7240 # are determined by the service that evaluates it. See the service
7241 # documentation for additional information.
7242 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
7243 # describes the expression, e.g. when hovered over it in a UI.
7244 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
7245 # syntax.
7246 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
7247 # reporting, e.g. a file name and a position in the file.
7248 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
7249 # its purpose. This can be used e.g. in UIs which allow to enter the
7250 # expression.
7251 },
7252 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
7253 # `members` can have the following values:
7254 #
7255 # * `allUsers`: A special identifier that represents anyone who is
7256 # on the internet; with or without a Google account.
7257 #
7258 # * `allAuthenticatedUsers`: A special identifier that represents anyone
7259 # who is authenticated with a Google account or a service account.
7260 # Does not include identities that come from external identity providers
7261 # (IdPs) through identity federation.
7262 #
7263 # * `user:{emailid}`: An email address that represents a specific Google
7264 # account. For example, `[email protected]` .
7265 #
7266 #
7267 # * `serviceAccount:{emailid}`: An email address that represents a Google
7268 # service account. For example,
7269 # `[email protected]`.
7270 #
7271 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
7272 # identifier for a
7273 # [Kubernetes service
7274 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
7275 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
7276 #
7277 # * `group:{emailid}`: An email address that represents a Google group.
7278 # For example, `[email protected]`.
7279 #
7280 #
7281 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
7282 # users of that domain. For example, `google.com` or `example.com`.
7283 #
7284 #
7285 #
7286 #
7287 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
7288 # A single identity in a workforce identity pool.
7289 #
7290 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
7291 # All workforce identities in a group.
7292 #
7293 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
7294 # All workforce identities with a specific attribute value.
7295 #
7296 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
7297 # All identities in a workforce identity pool.
7298 #
7299 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
7300 # A single identity in a workload identity pool.
7301 #
7302 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
7303 # A workload identity pool group.
7304 #
7305 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
7306 # All identities in a workload identity pool with a certain attribute.
7307 #
7308 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
7309 # All identities in a workload identity pool.
7310 #
7311 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
7312 # identifier) representing a user that has been recently deleted. For
7313 # example, `[email protected]?uid=123456789012345678901`. If the user is
7314 # recovered, this value reverts to `user:{emailid}` and the recovered user
7315 # retains the role in the binding.
7316 #
7317 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
7318 # unique identifier) representing a service account that has been recently
7319 # deleted. For example,
7320 # `[email protected]?uid=123456789012345678901`.
7321 # If the service account is undeleted, this value reverts to
7322 # `serviceAccount:{emailid}` and the undeleted service account retains the
7323 # role in the binding.
7324 #
7325 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
7326 # identifier) representing a Google group that has been recently
7327 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
7328 # the group is recovered, this value reverts to `group:{emailid}` and the
7329 # recovered group retains the role in the binding.
7330 #
7331 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
7332 # Deleted single identity in a workforce identity pool. For example,
7333 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
7334 &quot;A String&quot;,
7335 ],
7336 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
7337 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
7338 #
7339 # For an overview of the IAM roles and permissions, see the
7340 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
7341 # a list of the available pre-defined roles, see
7342 # [here](https://cloud.google.com/iam/docs/understanding-roles).
7343 },
7344 ],
7345 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
7346 # prevent simultaneous updates of a policy from overwriting each other.
7347 # It is strongly suggested that systems make use of the `etag` in the
7348 # read-modify-write cycle to perform policy updates in order to avoid race
7349 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
7350 # systems are expected to put that etag in the request to `setIamPolicy` to
7351 # ensure that their change will be applied to the same version of the policy.
7352 #
7353 # **Important:** If you use IAM Conditions, you must include the `etag` field
7354 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
7355 # you to overwrite a version `3` policy with a version `1` policy, and all of
7356 # the conditions in the version `3` policy are lost.
7357 &quot;version&quot;: 42, # Specifies the format of the policy.
7358 #
7359 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
7360 # are rejected.
7361 #
7362 # Any operation that affects conditional role bindings must specify version
7363 # `3`. This requirement applies to the following operations:
7364 #
7365 # * Getting a policy that includes a conditional role binding
7366 # * Adding a conditional role binding to a policy
7367 # * Changing a conditional role binding in a policy
7368 # * Removing any role binding, with or without a condition, from a policy
7369 # that includes conditions
7370 #
7371 # **Important:** If you use IAM Conditions, you must include the `etag` field
7372 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
7373 # you to overwrite a version `3` policy with a version `1` policy, and all of
7374 # the conditions in the version `3` policy are lost.
7375 #
7376 # If a policy does not include any conditions, operations on that policy may
7377 # specify any valid version or leave the field unset.
7378 #
7379 # To learn which resources support conditions in their IAM policies, see the
7380 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7381 },
7382 }
7383
7384 x__xgafv: string, V1 error format.
7385 Allowed values
7386 1 - v1 error format
7387 2 - v2 error format
7388
7389 Returns:
7390 An object of the form:
7391
7392 { # An Identity and Access Management (IAM) policy, which specifies access
7393 # controls for Google Cloud resources.
7394 #
7395 #
7396 # A `Policy` is a collection of `bindings`. A `binding` binds one or more
7397 # `members`, or principals, to a single `role`. Principals can be user
7398 # accounts, service accounts, Google groups, and domains (such as G Suite). A
7399 # `role` is a named list of permissions; each `role` can be an IAM predefined
7400 # role or a user-created custom role.
7401 #
7402 # For some types of Google Cloud resources, a `binding` can also specify a
7403 # `condition`, which is a logical expression that allows access to a resource
7404 # only if the expression evaluates to `true`. A condition can add constraints
7405 # based on attributes of the request, the resource, or both. To learn which
7406 # resources support conditions in their IAM policies, see the
7407 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7408 #
7409 # **JSON example:**
7410 #
7411 # ```
7412 # {
7413 # &quot;bindings&quot;: [
7414 # {
7415 # &quot;role&quot;: &quot;roles/resourcemanager.organizationAdmin&quot;,
7416 # &quot;members&quot;: [
7417 # &quot;user:[email protected]&quot;,
7418 # &quot;group:[email protected]&quot;,
7419 # &quot;domain:google.com&quot;,
7420 # &quot;serviceAccount:[email protected]&quot;
7421 # ]
7422 # },
7423 # {
7424 # &quot;role&quot;: &quot;roles/resourcemanager.organizationViewer&quot;,
7425 # &quot;members&quot;: [
7426 # &quot;user:[email protected]&quot;
7427 # ],
7428 # &quot;condition&quot;: {
7429 # &quot;title&quot;: &quot;expirable access&quot;,
7430 # &quot;description&quot;: &quot;Does not grant access after Sep 2020&quot;,
7431 # &quot;expression&quot;: &quot;request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)&quot;,
7432 # }
7433 # }
7434 # ],
7435 # &quot;etag&quot;: &quot;BwWWja0YfJA=&quot;,
7436 # &quot;version&quot;: 3
7437 # }
7438 # ```
7439 #
7440 # **YAML example:**
7441 #
7442 # ```
7443 # bindings:
7444 # - members:
7445 # - user:[email protected]
7446 # - group:[email protected]
7447 # - domain:google.com
7448 # - serviceAccount:[email protected]
7449 # role: roles/resourcemanager.organizationAdmin
7450 # - members:
7451 # - user:[email protected]
7452 # role: roles/resourcemanager.organizationViewer
7453 # condition:
7454 # title: expirable access
7455 # description: Does not grant access after Sep 2020
7456 # expression: request.time &lt; timestamp(&#x27;2020-10-01T00:00:00.000Z&#x27;)
7457 # etag: BwWWja0YfJA=
7458 # version: 3
7459 # ```
7460 #
7461 # For a description of IAM and its features, see the
7462 # [IAM documentation](https://cloud.google.com/iam/docs/).
7463 &quot;auditConfigs&quot;: [ # Specifies cloud audit logging configuration for this policy.
7464 { # Specifies the audit configuration for a service.
7465 # The configuration determines which permission types are logged, and what
7466 # identities, if any, are exempted from logging.
7467 # An AuditConfig must have one or more AuditLogConfigs.
7468 #
7469 # If there are AuditConfigs for both `allServices` and a specific service,
7470 # the union of the two AuditConfigs is used for that service: the log_types
7471 # specified in each AuditConfig are enabled, and the exempted_members in each
7472 # AuditLogConfig are exempted.
7473 #
7474 # Example Policy with multiple AuditConfigs:
7475 #
7476 # {
7477 # &quot;audit_configs&quot;: [
7478 # {
7479 # &quot;service&quot;: &quot;allServices&quot;,
7480 # &quot;audit_log_configs&quot;: [
7481 # {
7482 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
7483 # &quot;exempted_members&quot;: [
7484 # &quot;user:[email protected]&quot;
7485 # ]
7486 # },
7487 # {
7488 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
7489 # },
7490 # {
7491 # &quot;log_type&quot;: &quot;ADMIN_READ&quot;
7492 # }
7493 # ]
7494 # },
7495 # {
7496 # &quot;service&quot;: &quot;sampleservice.googleapis.com&quot;,
7497 # &quot;audit_log_configs&quot;: [
7498 # {
7499 # &quot;log_type&quot;: &quot;DATA_READ&quot;
7500 # },
7501 # {
7502 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;,
7503 # &quot;exempted_members&quot;: [
7504 # &quot;user:[email protected]&quot;
7505 # ]
7506 # }
7507 # ]
7508 # }
7509 # ]
7510 # }
7511 #
7512 # For sampleservice, this policy enables DATA_READ, DATA_WRITE and ADMIN_READ
7513 # logging. It also exempts `[email protected]` from DATA_READ logging, and
7514 # `[email protected]` from DATA_WRITE logging.
7515 &quot;auditLogConfigs&quot;: [ # The configuration for logging of each type of permission.
7516 { # Provides the configuration for logging a type of permissions.
7517 # Example:
7518 #
7519 # {
7520 # &quot;audit_log_configs&quot;: [
7521 # {
7522 # &quot;log_type&quot;: &quot;DATA_READ&quot;,
7523 # &quot;exempted_members&quot;: [
7524 # &quot;user:[email protected]&quot;
7525 # ]
7526 # },
7527 # {
7528 # &quot;log_type&quot;: &quot;DATA_WRITE&quot;
7529 # }
7530 # ]
7531 # }
7532 #
7533 # This enables &#x27;DATA_READ&#x27; and &#x27;DATA_WRITE&#x27; logging, while exempting
7534 # [email protected] from DATA_READ logging.
7535 &quot;exemptedMembers&quot;: [ # Specifies the identities that do not cause logging for this type of
7536 # permission.
7537 # Follows the same format of Binding.members.
7538 &quot;A String&quot;,
7539 ],
7540 &quot;logType&quot;: &quot;A String&quot;, # The log type that this config enables.
7541 },
7542 ],
7543 &quot;service&quot;: &quot;A String&quot;, # Specifies a service that will be enabled for audit logging.
7544 # For example, `storage.googleapis.com`, `cloudsql.googleapis.com`.
7545 # `allServices` is a special value that covers all services.
7546 },
7547 ],
7548 &quot;bindings&quot;: [ # Associates a list of `members`, or principals, with a `role`. Optionally,
7549 # may specify a `condition` that determines how and when the `bindings` are
7550 # applied. Each of the `bindings` must contain at least one principal.
7551 #
7552 # The `bindings` in a `Policy` can refer to up to 1,500 principals; up to 250
7553 # of these principals can be Google groups. Each occurrence of a principal
7554 # counts towards these limits. For example, if the `bindings` grant 50
7555 # different roles to `user:[email protected]`, and not to any other
7556 # principal, then you can add another 1,450 principals to the `bindings` in
7557 # the `Policy`.
7558 { # Associates `members`, or principals, with a `role`.
7559 &quot;condition&quot;: { # Represents a textual expression in the Common Expression Language (CEL) # The condition that is associated with this binding.
7560 #
7561 # If the condition evaluates to `true`, then this binding applies to the
7562 # current request.
7563 #
7564 # If the condition evaluates to `false`, then this binding does not apply to
7565 # the current request. However, a different role binding might grant the same
7566 # role to one or more of the principals in this binding.
7567 #
7568 # To learn which resources support conditions in their IAM policies, see the
7569 # [IAM
7570 # documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7571 # syntax. CEL is a C-like expression language. The syntax and semantics of CEL
7572 # are documented at https://github.com/google/cel-spec.
7573 #
7574 # Example (Comparison):
7575 #
7576 # title: &quot;Summary size limit&quot;
7577 # description: &quot;Determines if a summary is less than 100 chars&quot;
7578 # expression: &quot;document.summary.size() &lt; 100&quot;
7579 #
7580 # Example (Equality):
7581 #
7582 # title: &quot;Requestor is owner&quot;
7583 # description: &quot;Determines if requestor is the document owner&quot;
7584 # expression: &quot;document.owner == request.auth.claims.email&quot;
7585 #
7586 # Example (Logic):
7587 #
7588 # title: &quot;Public documents&quot;
7589 # description: &quot;Determine whether the document should be publicly visible&quot;
7590 # expression: &quot;document.type != &#x27;private&#x27; &amp;&amp; document.type != &#x27;internal&#x27;&quot;
7591 #
7592 # Example (Data Manipulation):
7593 #
7594 # title: &quot;Notification string&quot;
7595 # description: &quot;Create a notification string with a timestamp.&quot;
7596 # expression: &quot;&#x27;New message received at &#x27; + string(document.create_time)&quot;
7597 #
7598 # The exact variables and functions that may be referenced within an expression
7599 # are determined by the service that evaluates it. See the service
7600 # documentation for additional information.
7601 &quot;description&quot;: &quot;A String&quot;, # Optional. Description of the expression. This is a longer text which
7602 # describes the expression, e.g. when hovered over it in a UI.
7603 &quot;expression&quot;: &quot;A String&quot;, # Textual representation of an expression in Common Expression Language
7604 # syntax.
7605 &quot;location&quot;: &quot;A String&quot;, # Optional. String indicating the location of the expression for error
7606 # reporting, e.g. a file name and a position in the file.
7607 &quot;title&quot;: &quot;A String&quot;, # Optional. Title for the expression, i.e. a short string describing
7608 # its purpose. This can be used e.g. in UIs which allow to enter the
7609 # expression.
7610 },
7611 &quot;members&quot;: [ # Specifies the principals requesting access for a Google Cloud resource.
7612 # `members` can have the following values:
7613 #
7614 # * `allUsers`: A special identifier that represents anyone who is
7615 # on the internet; with or without a Google account.
7616 #
7617 # * `allAuthenticatedUsers`: A special identifier that represents anyone
7618 # who is authenticated with a Google account or a service account.
7619 # Does not include identities that come from external identity providers
7620 # (IdPs) through identity federation.
7621 #
7622 # * `user:{emailid}`: An email address that represents a specific Google
7623 # account. For example, `[email protected]` .
7624 #
7625 #
7626 # * `serviceAccount:{emailid}`: An email address that represents a Google
7627 # service account. For example,
7628 # `[email protected]`.
7629 #
7630 # * `serviceAccount:{projectid}.svc.id.goog[{namespace}/{kubernetes-sa}]`: An
7631 # identifier for a
7632 # [Kubernetes service
7633 # account](https://cloud.google.com/kubernetes-engine/docs/how-to/kubernetes-service-accounts).
7634 # For example, `my-project.svc.id.goog[my-namespace/my-kubernetes-sa]`.
7635 #
7636 # * `group:{emailid}`: An email address that represents a Google group.
7637 # For example, `[email protected]`.
7638 #
7639 #
7640 # * `domain:{domain}`: The G Suite domain (primary) that represents all the
7641 # users of that domain. For example, `google.com` or `example.com`.
7642 #
7643 #
7644 #
7645 #
7646 # * `principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
7647 # A single identity in a workforce identity pool.
7648 #
7649 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/group/{group_id}`:
7650 # All workforce identities in a group.
7651 #
7652 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
7653 # All workforce identities with a specific attribute value.
7654 #
7655 # * `principalSet://iam.googleapis.com/locations/global/workforcePools/{pool_id}/*`:
7656 # All identities in a workforce identity pool.
7657 #
7658 # * `principal://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/subject/{subject_attribute_value}`:
7659 # A single identity in a workload identity pool.
7660 #
7661 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/group/{group_id}`:
7662 # A workload identity pool group.
7663 #
7664 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/attribute.{attribute_name}/{attribute_value}`:
7665 # All identities in a workload identity pool with a certain attribute.
7666 #
7667 # * `principalSet://iam.googleapis.com/projects/{project_number}/locations/global/workloadIdentityPools/{pool_id}/*`:
7668 # All identities in a workload identity pool.
7669 #
7670 # * `deleted:user:{emailid}?uid={uniqueid}`: An email address (plus unique
7671 # identifier) representing a user that has been recently deleted. For
7672 # example, `[email protected]?uid=123456789012345678901`. If the user is
7673 # recovered, this value reverts to `user:{emailid}` and the recovered user
7674 # retains the role in the binding.
7675 #
7676 # * `deleted:serviceAccount:{emailid}?uid={uniqueid}`: An email address (plus
7677 # unique identifier) representing a service account that has been recently
7678 # deleted. For example,
7679 # `[email protected]?uid=123456789012345678901`.
7680 # If the service account is undeleted, this value reverts to
7681 # `serviceAccount:{emailid}` and the undeleted service account retains the
7682 # role in the binding.
7683 #
7684 # * `deleted:group:{emailid}?uid={uniqueid}`: An email address (plus unique
7685 # identifier) representing a Google group that has been recently
7686 # deleted. For example, `[email protected]?uid=123456789012345678901`. If
7687 # the group is recovered, this value reverts to `group:{emailid}` and the
7688 # recovered group retains the role in the binding.
7689 #
7690 # * `deleted:principal://iam.googleapis.com/locations/global/workforcePools/{pool_id}/subject/{subject_attribute_value}`:
7691 # Deleted single identity in a workforce identity pool. For example,
7692 # `deleted:principal://iam.googleapis.com/locations/global/workforcePools/my-pool-id/subject/my-subject-attribute-value`.
7693 &quot;A String&quot;,
7694 ],
7695 &quot;role&quot;: &quot;A String&quot;, # Role that is assigned to the list of `members`, or principals.
7696 # For example, `roles/viewer`, `roles/editor`, or `roles/owner`.
7697 #
7698 # For an overview of the IAM roles and permissions, see the
7699 # [IAM documentation](https://cloud.google.com/iam/docs/roles-overview). For
7700 # a list of the available pre-defined roles, see
7701 # [here](https://cloud.google.com/iam/docs/understanding-roles).
7702 },
7703 ],
7704 &quot;etag&quot;: &quot;A String&quot;, # `etag` is used for optimistic concurrency control as a way to help
7705 # prevent simultaneous updates of a policy from overwriting each other.
7706 # It is strongly suggested that systems make use of the `etag` in the
7707 # read-modify-write cycle to perform policy updates in order to avoid race
7708 # conditions: An `etag` is returned in the response to `getIamPolicy`, and
7709 # systems are expected to put that etag in the request to `setIamPolicy` to
7710 # ensure that their change will be applied to the same version of the policy.
7711 #
7712 # **Important:** If you use IAM Conditions, you must include the `etag` field
7713 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
7714 # you to overwrite a version `3` policy with a version `1` policy, and all of
7715 # the conditions in the version `3` policy are lost.
7716 &quot;version&quot;: 42, # Specifies the format of the policy.
7717 #
7718 # Valid values are `0`, `1`, and `3`. Requests that specify an invalid value
7719 # are rejected.
7720 #
7721 # Any operation that affects conditional role bindings must specify version
7722 # `3`. This requirement applies to the following operations:
7723 #
7724 # * Getting a policy that includes a conditional role binding
7725 # * Adding a conditional role binding to a policy
7726 # * Changing a conditional role binding in a policy
7727 # * Removing any role binding, with or without a condition, from a policy
7728 # that includes conditions
7729 #
7730 # **Important:** If you use IAM Conditions, you must include the `etag` field
7731 # whenever you call `setIamPolicy`. If you omit this field, then IAM allows
7732 # you to overwrite a version `3` policy with a version `1` policy, and all of
7733 # the conditions in the version `3` policy are lost.
7734 #
7735 # If a policy does not include any conditions, operations on that policy may
7736 # specify any valid version or leave the field unset.
7737 #
7738 # To learn which resources support conditions in their IAM policies, see the
7739 # [IAM documentation](https://cloud.google.com/iam/help/conditions/resource-policies).
7740 }</pre>
7741 </div>
7742
7743 <div class="method">
7744 <code class="details" id="setLabels">setLabels(project, resource, body=None, x__xgafv=None)</code>
7745 <pre>Sets the labels on a machine image. To learn more about labels, read theLabeling
7746 Resources documentation.
7747
7748 Args:
7749 project: string, Project ID for this request. (required)
7750 resource: string, Name or id of the resource for this request. (required)
7751 body: object, The request body.
7752 The object takes the form of:
7753
7754 {
7755 &quot;labelFingerprint&quot;: &quot;A String&quot;, # The fingerprint of the previous set of labels for this resource,
7756 # used to detect conflicts. The fingerprint is initially generated by Compute
7757 # Engine and changes after every request to modify or update labels. You must
7758 # always provide an up-to-date fingerprint hash when updating or changing
7759 # labels, otherwise the request will fail with error412 conditionNotMet. Make a get() request to the
7760 # resource to get the latest fingerprint.
7761 &quot;labels&quot;: { # A list of labels to apply for this resource. Each label must comply with
7762 # the
7763 # requirements for labels. For example,&quot;webserver-frontend&quot;: &quot;images&quot;. A label value can also be
7764 # empty (e.g. &quot;my-label&quot;: &quot;&quot;).
7765 &quot;a_key&quot;: &quot;A String&quot;,
7766 },
7767 }
7768
7769 x__xgafv: string, V1 error format.
7770 Allowed values
7771 1 - v1 error format
7772 2 - v2 error format
7773
7774 Returns:
7775 An object of the form:
7776
7777 { # Represents an Operation resource.
7778 #
7779 # Google Compute Engine has three Operation resources:
7780 #
7781 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
7782 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
7783 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
7784 #
7785 # You can use an operation resource to manage asynchronous API requests.
7786 # For more information, readHandling
7787 # API responses.
7788 #
7789 # Operations can be global, regional or zonal.
7790 #
7791 # - For global operations, use the `globalOperations`
7792 # resource.
7793 # - For regional operations, use the
7794 # `regionOperations` resource.
7795 # - For zonal operations, use
7796 # the `zoneOperations` resource.
7797 #
7798 #
7799 #
7800 # For more information, read
7801 # Global, Regional, and Zonal Resources.
7802 #
7803 # Note that completed Operation resources have a limited
7804 # retention period.
7805 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
7806 # Not present otherwise.
7807 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
7808 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
7809 # set when the operation is created.
7810 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
7811 # text format.
7812 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
7813 # this field will be populated.
7814 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7815 # operation.
7816 {
7817 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7818 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7819 # details. There is a set of defined message types to use for providing
7820 # details.The syntax depends on the error code. For example,
7821 # QuotaExceededInfo will have details when the error code is
7822 # QUOTA_EXCEEDED.
7823 {
7824 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7825 #
7826 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7827 # is not enabled:
7828 #
7829 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7830 # &quot;domain&quot;: &quot;googleapis.com&quot;
7831 # &quot;metadata&quot;: {
7832 # &quot;resource&quot;: &quot;projects/123&quot;,
7833 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7834 # }
7835 # }
7836 #
7837 # This response indicates that the pubsub.googleapis.com API is not enabled.
7838 #
7839 # Example of an error that is returned when attempting to create a Spanner
7840 # instance in a region that is out of stock:
7841 #
7842 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7843 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7844 # &quot;metadata&quot;: {
7845 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7846 # }
7847 # }
7848 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7849 # is typically the registered service name of the tool or product that
7850 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7851 # generated by some common infrastructure, the error domain must be a
7852 # globally unique value that identifies the infrastructure. For Google API
7853 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7854 &quot;metadatas&quot;: { # Additional structured details about this error.
7855 #
7856 # Keys must match a regular expression of `a-z+` but should
7857 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7858 # length. When identifying the current value of an exceeded limit, the units
7859 # should be contained in the key, not the value. For example, rather than
7860 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7861 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7862 # instances that can be created in a single (batch) request.
7863 &quot;a_key&quot;: &quot;A String&quot;,
7864 },
7865 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7866 # proximate cause of the error. Error reasons are unique within a particular
7867 # domain of errors. This should be at most 63 characters and match a
7868 # regular expression of `A-Z+[A-Z0-9]`, which represents
7869 # UPPER_SNAKE_CASE.
7870 },
7871 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7872 #
7873 # For example, if a quota check failed with an error indicating the calling
7874 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7875 # directly to the right place in the developer console to flip the bit.
7876 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7877 { # Describes a URL link.
7878 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7879 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7880 },
7881 ],
7882 },
7883 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7884 # which can be attached to an RPC error.
7885 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7886 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7887 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7888 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7889 },
7890 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7891 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7892 &quot;a_key&quot;: &quot;A String&quot;,
7893 },
7894 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7895 # type or metric.
7896 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7897 # or metric.
7898 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7899 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7900 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7901 },
7902 },
7903 ],
7904 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7905 # This property is optional.
7906 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7907 },
7908 ],
7909 },
7910 &quot;getVersionOperationMetadata&quot;: {
7911 &quot;inlineSbomInfo&quot;: {
7912 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
7913 # appropriate identifiers.
7914 &quot;a_key&quot;: &quot;A String&quot;,
7915 },
7916 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
7917 # identifiers.
7918 &quot;a_key&quot;: &quot;A String&quot;,
7919 },
7920 },
7921 },
7922 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
7923 # message that was returned, such as `NOT FOUND`.
7924 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
7925 # status code that was returned. For example, a `404` means the
7926 # resource was not found.
7927 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
7928 # defined by the server.
7929 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
7930 # This value is inRFC3339
7931 # text format.
7932 &quot;instancesBulkInsertOperationMetadata&quot;: {
7933 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
7934 # Example key: zones/us-central1-a
7935 &quot;a_key&quot;: {
7936 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
7937 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
7938 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
7939 # error.
7940 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
7941 # if the flow is rolling forward or rolling back.
7942 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
7943 },
7944 },
7945 },
7946 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
7947 # Operation resources.
7948 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
7949 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
7950 # group of operations results from a `bulkInsert` API request.
7951 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
7952 # `update`, or `delete`, and so on.
7953 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
7954 # There is no requirement that this be linear or support any granularity of
7955 # operations. This should not be used to guess when the operation will be
7956 # complete. This number should monotonically increase as the operation
7957 # progresses.
7958 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
7959 # applicable when performing regional operations.
7960 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
7961 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
7962 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
7963 # this field will contain information on all underlying zonal actions and
7964 # their state.
7965 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
7966 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
7967 # Example key: zones/us-central1-a
7968 &quot;a_key&quot;: {
7969 &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
7970 # populated.
7971 # different programming environments, including REST APIs and RPC APIs. It is
7972 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
7973 # three pieces of data: error code, error message, and error details.
7974 #
7975 # You can find out more about this error model and how to work with it in the
7976 # [API Design Guide](https://cloud.google.com/apis/design/errors).
7977 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
7978 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
7979 # message types for APIs to use.
7980 {
7981 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
7982 },
7983 ],
7984 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
7985 # user-facing error message should be localized and sent in the
7986 # google.rpc.Status.details field, or localized by the client.
7987 },
7988 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
7989 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
7990 },
7991 },
7992 },
7993 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
7994 # This value is inRFC3339
7995 # text format.
7996 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
7997 # following:
7998 # `PENDING`, `RUNNING`, or `DONE`.
7999 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
8000 # operation.
8001 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
8002 # of the target resource.
8003 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
8004 # operations related to creating a snapshot, this points to the disk
8005 # that the snapshot was created from.
8006 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
8007 # `[email protected]` or
8008 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
8009 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
8010 # operation, this field will be populated.
8011 {
8012 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8013 # Engine returns NO_RESULTS_ON_PAGE if there
8014 # are no results in the response.
8015 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8016 # value format. For example:
8017 #
8018 # &quot;data&quot;: [
8019 # {
8020 # &quot;key&quot;: &quot;scope&quot;,
8021 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8022 # }
8023 {
8024 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8025 # returned. For example, for warnings where there are no results in a list
8026 # request for a particular zone, this key might be scope and
8027 # the key value might be the zone name. Other examples might be a key
8028 # indicating a deprecated resource and a suggested replacement, or a
8029 # warning about invalid network settings (for example, if an instance
8030 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8031 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8032 },
8033 ],
8034 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8035 },
8036 ],
8037 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
8038 # applicable when performing per-zone operations.
8039 }</pre>
8040 </div>
8041
8042 <div class="method">
8043 <code class="details" id="testIamPermissions">testIamPermissions(project, resource, body=None, x__xgafv=None)</code>
8044 <pre>Returns permissions that a caller has on the specified resource.
8045
8046 Args:
8047 project: string, Project ID for this request. (required)
8048 resource: string, Name or id of the resource for this request. (required)
8049 body: object, The request body.
8050 The object takes the form of:
8051
8052 {
8053 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
8054 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
8055 &quot;A String&quot;,
8056 ],
8057 }
8058
8059 x__xgafv: string, V1 error format.
8060 Allowed values
8061 1 - v1 error format
8062 2 - v2 error format
8063
8064 Returns:
8065 An object of the form:
8066
8067 {
8068 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
8069 # allowed.
8070 &quot;A String&quot;,
8071 ],
8072 }</pre>
8073 </div>
8074
8075 </body></html>