Debian Codegraph @

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