Debian Codegraph @

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