Debian Codegraph @

docs/dyn/compute_alpha.regionInstanceGroupManagers.html

raw
1 <html><body>
2 <style>
3
4 body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13 }
14
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51 }
52
53 .toc_element {
54 margin-top: 0.5em;
55 }
56
57 .firstline {
58 margin-left: 2 em;
59 }
60
61 .method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66 }
67
68 .details {
69 font-weight: bold;
70 font-size: 14px;
71 }
72
73 </style>
74
75 <h1><a href="compute_alpha.html">Compute Engine API</a> . <a href="compute_alpha.regionInstanceGroupManagers.html">regionInstanceGroupManagers</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#abandonInstances">abandonInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Flags the specified instances to be immediately removed from the managed</p>
80 <p class="toc_element">
81 <code><a href="#adoptInstances">adoptInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Flags the specified instances to be adopted to the managed instance</p>
83 <p class="toc_element">
84 <code><a href="#applyUpdatesToInstances">applyUpdatesToInstances(project, region, instanceGroupManager, body=None, x__xgafv=None)</a></code></p>
85 <p class="firstline">Apply updates to selected instances the managed instance group.</p>
86 <p class="toc_element">
87 <code><a href="#close">close()</a></code></p>
88 <p class="firstline">Close httplib2 connections.</p>
89 <p class="toc_element">
90 <code><a href="#createInstances">createInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Creates instances with per-instance configurations in this regional managed</p>
92 <p class="toc_element">
93 <code><a href="#delete">delete(project, region, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
94 <p class="firstline">Deletes the specified managed instance group and all of the instances</p>
95 <p class="toc_element">
96 <code><a href="#deleteInstances">deleteInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
98 <p class="toc_element">
99 <code><a href="#deletePerInstanceConfigs">deletePerInstanceConfigs(project, region, instanceGroupManager, body=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Deletes selected per-instance configurations for the managed instance</p>
101 <p class="toc_element">
102 <code><a href="#get">get(project, region, instanceGroupManager, x__xgafv=None)</a></code></p>
103 <p class="firstline">Returns all of the details about the specified managed instance group.</p>
104 <p class="toc_element">
105 <code><a href="#insert">insert(project, region, body=None, requestId=None, x__xgafv=None)</a></code></p>
106 <p class="firstline">Creates a managed instance group using the information that you specify</p>
107 <p class="toc_element">
108 <code><a href="#list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
109 <p class="firstline">Retrieves the list of managed instance groups that are contained</p>
110 <p class="toc_element">
111 <code><a href="#listErrors">listErrors(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
112 <p class="firstline">Lists all errors thrown by actions on instances for a given regional</p>
113 <p class="toc_element">
114 <code><a href="#listErrors_next">listErrors_next()</a></code></p>
115 <p class="firstline">Retrieves the next page of results.</p>
116 <p class="toc_element">
117 <code><a href="#listManagedInstances">listManagedInstances(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
118 <p class="firstline">Lists the instances in the managed instance group and instances that are</p>
119 <p class="toc_element">
120 <code><a href="#listManagedInstances_next">listManagedInstances_next()</a></code></p>
121 <p class="firstline">Retrieves the next page of results.</p>
122 <p class="toc_element">
123 <code><a href="#listPerInstanceConfigs">listPerInstanceConfigs(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
124 <p class="firstline">Lists all of the per-instance configurations defined for the managed</p>
125 <p class="toc_element">
126 <code><a href="#listPerInstanceConfigs_next">listPerInstanceConfigs_next()</a></code></p>
127 <p class="firstline">Retrieves the next page of results.</p>
128 <p class="toc_element">
129 <code><a href="#list_next">list_next()</a></code></p>
130 <p class="firstline">Retrieves the next page of results.</p>
131 <p class="toc_element">
132 <code><a href="#patch">patch(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
133 <p class="firstline">Updates a managed instance group using the information that you specify</p>
134 <p class="toc_element">
135 <code><a href="#patchPerInstanceConfigs">patchPerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
136 <p class="firstline">Inserts or patches per-instance configurations for the managed instance</p>
137 <p class="toc_element">
138 <code><a href="#recreateInstances">recreateInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
139 <p class="firstline">Flags the specified VM instances in the managed instance group to be</p>
140 <p class="toc_element">
141 <code><a href="#resize">resize(project, region, instanceGroupManager, size, requestId=None, x__xgafv=None)</a></code></p>
142 <p class="firstline">Changes the intended size of the managed instance group. If you increase</p>
143 <p class="toc_element">
144 <code><a href="#resizeAdvanced">resizeAdvanced(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
145 <p class="firstline">Resizes the regional managed instance group with advanced configuration</p>
146 <p class="toc_element">
147 <code><a href="#resumeInstances">resumeInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
148 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
149 <p class="toc_element">
150 <code><a href="#setAutoHealingPolicies">setAutoHealingPolicies(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
151 <p class="firstline">Modifies the autohealing policy for the instances in this managed</p>
152 <p class="toc_element">
153 <code><a href="#setInstanceTemplate">setInstanceTemplate(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
154 <p class="firstline">Sets the instance template to use when creating new instances or recreating</p>
155 <p class="toc_element">
156 <code><a href="#setTargetPools">setTargetPools(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
157 <p class="firstline">Modifies the target pools to which all new instances in this group are</p>
158 <p class="toc_element">
159 <code><a href="#startInstances">startInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
160 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
161 <p class="toc_element">
162 <code><a href="#stopInstances">stopInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
163 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
164 <p class="toc_element">
165 <code><a href="#suspendInstances">suspendInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
166 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
167 <p class="toc_element">
168 <code><a href="#testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</a></code></p>
169 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
170 <p class="toc_element">
171 <code><a href="#update">update(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
172 <p class="firstline">Updates a managed instance group using the information that you specify</p>
173 <p class="toc_element">
174 <code><a href="#updatePerInstanceConfigs">updatePerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
175 <p class="firstline">Inserts or updates per-instance configurations for the managed instance</p>
176 <h3>Method Details</h3>
177 <div class="method">
178 <code class="details" id="abandonInstances">abandonInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
179 <pre>Flags the specified instances to be immediately removed from the managed
180 instance group. Abandoning an instance does not delete the
181 instance, but it does remove the instance from any target pools that are
182 applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the
183 number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have
184 not yet been removed from the group. You must separately verify the
185 status of the abandoning action with thelistmanagedinstances
186 method.
187
188 If the group is part of a backend
189 service that has enabled
190 connection draining, it can take up to 60 seconds after the connection
191 draining duration has elapsed before the VM instance is removed or deleted.
192
193 You can specify a maximum of 1000 instances with this method per request.
194
195 Args:
196 project: string, Project ID for this request. (required)
197 region: string, Name of the region scoping this request. (required)
198 instanceGroupManager: string, Name of the managed instance group. (required)
199 body: object, The request body.
200 The object takes the form of:
201
202 {
203 &quot;instances&quot;: [ # The URLs of one or more instances to abandon. This can be a full URL or
204 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
205 &quot;A String&quot;,
206 ],
207 }
208
209 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
210 that if you must retry your request, the server will know to ignore the
211 request if it has already been completed.
212
213 For example, consider a situation where you make an initial request and
214 the request times out. If you make the request again with the same
215 request ID, the server can check if original operation with the same
216 request ID was received, and if so, will ignore the second request. This
217 prevents clients from accidentally creating duplicate commitments.
218
219 The request ID must be
220 a valid UUID with the exception that zero UUID is not supported
221 (00000000-0000-0000-0000-000000000000).
222 x__xgafv: string, V1 error format.
223 Allowed values
224 1 - v1 error format
225 2 - v2 error format
226
227 Returns:
228 An object of the form:
229
230 { # Represents an Operation resource.
231 #
232 # Google Compute Engine has three Operation resources:
233 #
234 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
235 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
236 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
237 #
238 # You can use an operation resource to manage asynchronous API requests.
239 # For more information, readHandling
240 # API responses.
241 #
242 # Operations can be global, regional or zonal.
243 #
244 # - For global operations, use the `globalOperations`
245 # resource.
246 # - For regional operations, use the
247 # `regionOperations` resource.
248 # - For zonal operations, use
249 # the `zoneOperations` resource.
250 #
251 #
252 #
253 # For more information, read
254 # Global, Regional, and Zonal Resources.
255 #
256 # Note that completed Operation resources have a limited
257 # retention period.
258 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
259 # Not present otherwise.
260 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
261 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
262 # set when the operation is created.
263 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
264 # text format.
265 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
266 # this field will be populated.
267 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
268 # operation.
269 {
270 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
271 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
272 # details. There is a set of defined message types to use for providing
273 # details.The syntax depends on the error code. For example,
274 # QuotaExceededInfo will have details when the error code is
275 # QUOTA_EXCEEDED.
276 {
277 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
278 #
279 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
280 # is not enabled:
281 #
282 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
283 # &quot;domain&quot;: &quot;googleapis.com&quot;
284 # &quot;metadata&quot;: {
285 # &quot;resource&quot;: &quot;projects/123&quot;,
286 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
287 # }
288 # }
289 #
290 # This response indicates that the pubsub.googleapis.com API is not enabled.
291 #
292 # Example of an error that is returned when attempting to create a Spanner
293 # instance in a region that is out of stock:
294 #
295 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
296 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
297 # &quot;metadata&quot;: {
298 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
299 # }
300 # }
301 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
302 # is typically the registered service name of the tool or product that
303 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
304 # generated by some common infrastructure, the error domain must be a
305 # globally unique value that identifies the infrastructure. For Google API
306 # infrastructure, the error domain is &quot;googleapis.com&quot;.
307 &quot;metadatas&quot;: { # Additional structured details about this error.
308 #
309 # Keys must match a regular expression of `a-z+` but should
310 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
311 # length. When identifying the current value of an exceeded limit, the units
312 # should be contained in the key, not the value. For example, rather than
313 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
314 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
315 # instances that can be created in a single (batch) request.
316 &quot;a_key&quot;: &quot;A String&quot;,
317 },
318 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
319 # proximate cause of the error. Error reasons are unique within a particular
320 # domain of errors. This should be at most 63 characters and match a
321 # regular expression of `A-Z+[A-Z0-9]`, which represents
322 # UPPER_SNAKE_CASE.
323 },
324 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
325 #
326 # For example, if a quota check failed with an error indicating the calling
327 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
328 # directly to the right place in the developer console to flip the bit.
329 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
330 { # Describes a URL link.
331 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
332 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
333 },
334 ],
335 },
336 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
337 # which can be attached to an RPC error.
338 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
339 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
340 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
341 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
342 },
343 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
344 &quot;dimensions&quot;: { # The map holding related quota dimensions.
345 &quot;a_key&quot;: &quot;A String&quot;,
346 },
347 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
348 # type or metric.
349 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
350 # or metric.
351 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
352 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
353 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
354 },
355 },
356 ],
357 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
358 # This property is optional.
359 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
360 },
361 ],
362 },
363 &quot;getVersionOperationMetadata&quot;: {
364 &quot;inlineSbomInfo&quot;: {
365 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
366 # appropriate identifiers.
367 &quot;a_key&quot;: &quot;A String&quot;,
368 },
369 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
370 # identifiers.
371 &quot;a_key&quot;: &quot;A String&quot;,
372 },
373 },
374 },
375 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
376 # message that was returned, such as `NOT FOUND`.
377 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
378 # status code that was returned. For example, a `404` means the
379 # resource was not found.
380 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
381 # defined by the server.
382 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
383 # This value is inRFC3339
384 # text format.
385 &quot;instancesBulkInsertOperationMetadata&quot;: {
386 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
387 # Example key: zones/us-central1-a
388 &quot;a_key&quot;: {
389 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
390 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
391 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
392 # error.
393 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
394 # if the flow is rolling forward or rolling back.
395 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
396 },
397 },
398 },
399 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
400 # Operation resources.
401 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
402 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
403 # group of operations results from a `bulkInsert` API request.
404 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
405 # `update`, or `delete`, and so on.
406 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
407 # There is no requirement that this be linear or support any granularity of
408 # operations. This should not be used to guess when the operation will be
409 # complete. This number should monotonically increase as the operation
410 # progresses.
411 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
412 # applicable when performing regional operations.
413 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
414 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
415 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
416 # this field will contain information on all underlying zonal actions and
417 # their state.
418 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
419 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
420 # Example key: zones/us-central1-a
421 &quot;a_key&quot;: {
422 &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
423 # populated.
424 # different programming environments, including REST APIs and RPC APIs. It is
425 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
426 # three pieces of data: error code, error message, and error details.
427 #
428 # You can find out more about this error model and how to work with it in the
429 # [API Design Guide](https://cloud.google.com/apis/design/errors).
430 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
431 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
432 # message types for APIs to use.
433 {
434 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
435 },
436 ],
437 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
438 # user-facing error message should be localized and sent in the
439 # google.rpc.Status.details field, or localized by the client.
440 },
441 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
442 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
443 },
444 },
445 },
446 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
447 # This value is inRFC3339
448 # text format.
449 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
450 # following:
451 # `PENDING`, `RUNNING`, or `DONE`.
452 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
453 # operation.
454 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
455 # of the target resource.
456 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
457 # operations related to creating a snapshot, this points to the disk
458 # that the snapshot was created from.
459 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
460 # `[email protected]` or
461 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
462 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
463 # operation, this field will be populated.
464 {
465 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
466 # Engine returns NO_RESULTS_ON_PAGE if there
467 # are no results in the response.
468 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
469 # value format. For example:
470 #
471 # &quot;data&quot;: [
472 # {
473 # &quot;key&quot;: &quot;scope&quot;,
474 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
475 # }
476 {
477 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
478 # returned. For example, for warnings where there are no results in a list
479 # request for a particular zone, this key might be scope and
480 # the key value might be the zone name. Other examples might be a key
481 # indicating a deprecated resource and a suggested replacement, or a
482 # warning about invalid network settings (for example, if an instance
483 # attempts to perform IP forwarding but is not enabled for IP forwarding).
484 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
485 },
486 ],
487 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
488 },
489 ],
490 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
491 # applicable when performing per-zone operations.
492 }</pre>
493 </div>
494
495 <div class="method">
496 <code class="details" id="adoptInstances">adoptInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
497 <pre>Flags the specified instances to be adopted to the managed instance
498 group. Adopting an instance does not change the instance status, but it
499 adds the instance to any target pools that are applied by the managed
500 instance group. This method increases the targetSize of the managed
501 instance group by the number of instances that you adopt. This operation
502 is marked as DONE when the action is scheduled even if the instances have
503 not been adopted to the group yet. You must separately verify the status
504 of the adopting action with the listManagedInstances method.
505
506 Args:
507 project: string, Project ID for this request. (required)
508 region: string, Name of the region scoping this request. It should conform to RFC1035. (required)
509 instanceGroupManager: string, Name of the managed instance group. It should conform to RFC1035 or be a
510 resource ID. (required)
511 body: object, The request body.
512 The object takes the form of:
513
514 {
515 &quot;instances&quot;: [ # The list of per-instance configs specifying instances to adopt.
516 {
517 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
518 # optimistic locking. It is ignored when inserting a per-instance
519 # config. An up-to-date fingerprint must be provided in order to update an
520 # existing per-instance configuration or the field needs to be unset.
521 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
522 # Serves as a merge key during UpdatePerInstanceConfigs
523 # operations, that is, if a per-instance configuration with the same name
524 # exists then it will be updated, otherwise a new one will be created for the
525 # VM instance with the same name. An attempt to create a per-instance
526 # configuration for a VM instance that either doesn&#x27;t exist or is not part
527 # of the group will result in an error.
528 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
529 # preserved state generated from a stateful policy.
530 &quot;disks&quot;: { # Preserved disks defined for this instance.
531 # This map is keyed with the device names of the disks.
532 &quot;a_key&quot;: {
533 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
534 # update, instance recreate operations. This flag is used to configure
535 # if the disk should be deleted after it is no longer used by the group,
536 # e.g. when the given instance or the whole MIG is deleted.
537 # Note: disks attached in READ_ONLY mode cannot be
538 # auto-deleted.
539 &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
540 # disk in READ_WRITE mode.
541 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
542 # to the VM instance.
543 },
544 },
545 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
546 # This map is keyed with the name of the network interface.
547 &quot;a_key&quot;: {
548 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
549 # update or VM instance recreate operations.
550 # This flag is used to configure if the IP reservation should be deleted
551 # after it is no longer used by the group, e.g. when the given instance
552 # or the whole group is deleted.
553 &quot;ipAddress&quot;: { # Ip address representation
554 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
555 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
556 # network interface.
557 },
558 },
559 },
560 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
561 # This map is keyed with the name of the network interface.
562 &quot;a_key&quot;: {
563 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
564 # update or VM instance recreate operations.
565 # This flag is used to configure if the IP reservation should be deleted
566 # after it is no longer used by the group, e.g. when the given instance
567 # or the whole group is deleted.
568 &quot;ipAddress&quot;: { # Ip address representation
569 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
570 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
571 # network interface.
572 },
573 },
574 },
575 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
576 &quot;a_key&quot;: &quot;A String&quot;,
577 },
578 },
579 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
580 # managed instance.
581 },
582 ],
583 }
584
585 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
586 that if you must retry your request, the server will know to ignore the
587 request if it has already been completed.
588
589 For example, consider a situation where you make an initial request and
590 the request times out. If you make the request again with the same
591 request ID, the server can check if original operation with the same
592 request ID was received, and if so, will ignore the second request. This
593 prevents clients from accidentally creating duplicate commitments.
594
595 The request ID must be
596 a valid UUID with the exception that zero UUID is not supported
597 (00000000-0000-0000-0000-000000000000).
598 x__xgafv: string, V1 error format.
599 Allowed values
600 1 - v1 error format
601 2 - v2 error format
602
603 Returns:
604 An object of the form:
605
606 { # Represents an Operation resource.
607 #
608 # Google Compute Engine has three Operation resources:
609 #
610 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
611 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
612 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
613 #
614 # You can use an operation resource to manage asynchronous API requests.
615 # For more information, readHandling
616 # API responses.
617 #
618 # Operations can be global, regional or zonal.
619 #
620 # - For global operations, use the `globalOperations`
621 # resource.
622 # - For regional operations, use the
623 # `regionOperations` resource.
624 # - For zonal operations, use
625 # the `zoneOperations` resource.
626 #
627 #
628 #
629 # For more information, read
630 # Global, Regional, and Zonal Resources.
631 #
632 # Note that completed Operation resources have a limited
633 # retention period.
634 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
635 # Not present otherwise.
636 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
637 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
638 # set when the operation is created.
639 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
640 # text format.
641 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
642 # this field will be populated.
643 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
644 # operation.
645 {
646 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
647 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
648 # details. There is a set of defined message types to use for providing
649 # details.The syntax depends on the error code. For example,
650 # QuotaExceededInfo will have details when the error code is
651 # QUOTA_EXCEEDED.
652 {
653 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
654 #
655 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
656 # is not enabled:
657 #
658 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
659 # &quot;domain&quot;: &quot;googleapis.com&quot;
660 # &quot;metadata&quot;: {
661 # &quot;resource&quot;: &quot;projects/123&quot;,
662 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
663 # }
664 # }
665 #
666 # This response indicates that the pubsub.googleapis.com API is not enabled.
667 #
668 # Example of an error that is returned when attempting to create a Spanner
669 # instance in a region that is out of stock:
670 #
671 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
672 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
673 # &quot;metadata&quot;: {
674 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
675 # }
676 # }
677 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
678 # is typically the registered service name of the tool or product that
679 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
680 # generated by some common infrastructure, the error domain must be a
681 # globally unique value that identifies the infrastructure. For Google API
682 # infrastructure, the error domain is &quot;googleapis.com&quot;.
683 &quot;metadatas&quot;: { # Additional structured details about this error.
684 #
685 # Keys must match a regular expression of `a-z+` but should
686 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
687 # length. When identifying the current value of an exceeded limit, the units
688 # should be contained in the key, not the value. For example, rather than
689 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
690 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
691 # instances that can be created in a single (batch) request.
692 &quot;a_key&quot;: &quot;A String&quot;,
693 },
694 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
695 # proximate cause of the error. Error reasons are unique within a particular
696 # domain of errors. This should be at most 63 characters and match a
697 # regular expression of `A-Z+[A-Z0-9]`, which represents
698 # UPPER_SNAKE_CASE.
699 },
700 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
701 #
702 # For example, if a quota check failed with an error indicating the calling
703 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
704 # directly to the right place in the developer console to flip the bit.
705 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
706 { # Describes a URL link.
707 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
708 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
709 },
710 ],
711 },
712 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
713 # which can be attached to an RPC error.
714 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
715 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
716 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
717 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
718 },
719 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
720 &quot;dimensions&quot;: { # The map holding related quota dimensions.
721 &quot;a_key&quot;: &quot;A String&quot;,
722 },
723 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
724 # type or metric.
725 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
726 # or metric.
727 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
728 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
729 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
730 },
731 },
732 ],
733 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
734 # This property is optional.
735 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
736 },
737 ],
738 },
739 &quot;getVersionOperationMetadata&quot;: {
740 &quot;inlineSbomInfo&quot;: {
741 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
742 # appropriate identifiers.
743 &quot;a_key&quot;: &quot;A String&quot;,
744 },
745 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
746 # identifiers.
747 &quot;a_key&quot;: &quot;A String&quot;,
748 },
749 },
750 },
751 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
752 # message that was returned, such as `NOT FOUND`.
753 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
754 # status code that was returned. For example, a `404` means the
755 # resource was not found.
756 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
757 # defined by the server.
758 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
759 # This value is inRFC3339
760 # text format.
761 &quot;instancesBulkInsertOperationMetadata&quot;: {
762 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
763 # Example key: zones/us-central1-a
764 &quot;a_key&quot;: {
765 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
766 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
767 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
768 # error.
769 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
770 # if the flow is rolling forward or rolling back.
771 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
772 },
773 },
774 },
775 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
776 # Operation resources.
777 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
778 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
779 # group of operations results from a `bulkInsert` API request.
780 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
781 # `update`, or `delete`, and so on.
782 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
783 # There is no requirement that this be linear or support any granularity of
784 # operations. This should not be used to guess when the operation will be
785 # complete. This number should monotonically increase as the operation
786 # progresses.
787 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
788 # applicable when performing regional operations.
789 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
790 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
791 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
792 # this field will contain information on all underlying zonal actions and
793 # their state.
794 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
795 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
796 # Example key: zones/us-central1-a
797 &quot;a_key&quot;: {
798 &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
799 # populated.
800 # different programming environments, including REST APIs and RPC APIs. It is
801 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
802 # three pieces of data: error code, error message, and error details.
803 #
804 # You can find out more about this error model and how to work with it in the
805 # [API Design Guide](https://cloud.google.com/apis/design/errors).
806 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
807 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
808 # message types for APIs to use.
809 {
810 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
811 },
812 ],
813 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
814 # user-facing error message should be localized and sent in the
815 # google.rpc.Status.details field, or localized by the client.
816 },
817 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
818 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
819 },
820 },
821 },
822 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
823 # This value is inRFC3339
824 # text format.
825 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
826 # following:
827 # `PENDING`, `RUNNING`, or `DONE`.
828 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
829 # operation.
830 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
831 # of the target resource.
832 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
833 # operations related to creating a snapshot, this points to the disk
834 # that the snapshot was created from.
835 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
836 # `[email protected]` or
837 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
838 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
839 # operation, this field will be populated.
840 {
841 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
842 # Engine returns NO_RESULTS_ON_PAGE if there
843 # are no results in the response.
844 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
845 # value format. For example:
846 #
847 # &quot;data&quot;: [
848 # {
849 # &quot;key&quot;: &quot;scope&quot;,
850 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
851 # }
852 {
853 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
854 # returned. For example, for warnings where there are no results in a list
855 # request for a particular zone, this key might be scope and
856 # the key value might be the zone name. Other examples might be a key
857 # indicating a deprecated resource and a suggested replacement, or a
858 # warning about invalid network settings (for example, if an instance
859 # attempts to perform IP forwarding but is not enabled for IP forwarding).
860 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
861 },
862 ],
863 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
864 },
865 ],
866 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
867 # applicable when performing per-zone operations.
868 }</pre>
869 </div>
870
871 <div class="method">
872 <code class="details" id="applyUpdatesToInstances">applyUpdatesToInstances(project, region, instanceGroupManager, body=None, x__xgafv=None)</code>
873 <pre>Apply updates to selected instances the managed instance group.
874
875 Args:
876 project: string, Project ID for this request. (required)
877 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
878 instanceGroupManager: string, The name of the managed instance group, should conform to RFC1035. (required)
879 body: object, The request body.
880 The object takes the form of:
881
882 { # RegionInstanceGroupManagers.applyUpdatesToInstances
883 &quot;allInstances&quot;: True or False, # Flag to update all instances instead of specified list of “instances”.
884 # If the flag is set to true then the instances may not be specified
885 # in the request.
886 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
887 &quot;A String&quot;,
888 ],
889 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
890 &quot;instances&quot;: [ # The list of URLs of one or more instances for which you want to apply
891 # updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].
892 &quot;A String&quot;,
893 ],
894 &quot;maximalAction&quot;: &quot;A String&quot;, # The maximal action that should be performed on the instances.
895 # By default REPLACE.
896 # This field is deprecated, please use most_disruptive_allowed_action.
897 &quot;minimalAction&quot;: &quot;A String&quot;, # The minimal action that you want to perform on each instance during the
898 # update:
899 #
900 #
901 # - REPLACE: At minimum, delete the instance and create it
902 # again.
903 # - RESTART: Stop the instance and start it
904 # again.
905 # - REFRESH: Do not stop the instance and limit
906 # disruption as much as possible.
907 # - NONE: Do not
908 # disrupt the instance at all.
909 #
910 #
911 # By default, the minimum action is NONE. If your update
912 # requires a more disruptive action than you set with this flag, the
913 # necessary action is performed to execute the update.
914 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # The most disruptive action that you want to perform on each instance during
915 # the update:
916 #
917 #
918 # - REPLACE: Delete the instance and create it again.
919 # - RESTART: Stop the instance and start it again.
920 # - REFRESH: Do not stop the instance and limit disruption
921 # as much as possible.
922 # - NONE: Do not disrupt the
923 # instance at all.
924 #
925 #
926 # By default, the most disruptive allowed action is REPLACE. If
927 # your update requires a more disruptive action than you set with this flag,
928 # the update request will fail.
929 }
930
931 x__xgafv: string, V1 error format.
932 Allowed values
933 1 - v1 error format
934 2 - v2 error format
935
936 Returns:
937 An object of the form:
938
939 { # Represents an Operation resource.
940 #
941 # Google Compute Engine has three Operation resources:
942 #
943 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
944 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
945 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
946 #
947 # You can use an operation resource to manage asynchronous API requests.
948 # For more information, readHandling
949 # API responses.
950 #
951 # Operations can be global, regional or zonal.
952 #
953 # - For global operations, use the `globalOperations`
954 # resource.
955 # - For regional operations, use the
956 # `regionOperations` resource.
957 # - For zonal operations, use
958 # the `zoneOperations` resource.
959 #
960 #
961 #
962 # For more information, read
963 # Global, Regional, and Zonal Resources.
964 #
965 # Note that completed Operation resources have a limited
966 # retention period.
967 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
968 # Not present otherwise.
969 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
970 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
971 # set when the operation is created.
972 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
973 # text format.
974 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
975 # this field will be populated.
976 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
977 # operation.
978 {
979 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
980 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
981 # details. There is a set of defined message types to use for providing
982 # details.The syntax depends on the error code. For example,
983 # QuotaExceededInfo will have details when the error code is
984 # QUOTA_EXCEEDED.
985 {
986 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
987 #
988 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
989 # is not enabled:
990 #
991 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
992 # &quot;domain&quot;: &quot;googleapis.com&quot;
993 # &quot;metadata&quot;: {
994 # &quot;resource&quot;: &quot;projects/123&quot;,
995 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
996 # }
997 # }
998 #
999 # This response indicates that the pubsub.googleapis.com API is not enabled.
1000 #
1001 # Example of an error that is returned when attempting to create a Spanner
1002 # instance in a region that is out of stock:
1003 #
1004 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1005 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1006 # &quot;metadata&quot;: {
1007 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1008 # }
1009 # }
1010 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1011 # is typically the registered service name of the tool or product that
1012 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1013 # generated by some common infrastructure, the error domain must be a
1014 # globally unique value that identifies the infrastructure. For Google API
1015 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1016 &quot;metadatas&quot;: { # Additional structured details about this error.
1017 #
1018 # Keys must match a regular expression of `a-z+` but should
1019 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1020 # length. When identifying the current value of an exceeded limit, the units
1021 # should be contained in the key, not the value. For example, rather than
1022 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1023 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1024 # instances that can be created in a single (batch) request.
1025 &quot;a_key&quot;: &quot;A String&quot;,
1026 },
1027 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1028 # proximate cause of the error. Error reasons are unique within a particular
1029 # domain of errors. This should be at most 63 characters and match a
1030 # regular expression of `A-Z+[A-Z0-9]`, which represents
1031 # UPPER_SNAKE_CASE.
1032 },
1033 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1034 #
1035 # For example, if a quota check failed with an error indicating the calling
1036 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1037 # directly to the right place in the developer console to flip the bit.
1038 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1039 { # Describes a URL link.
1040 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1041 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1042 },
1043 ],
1044 },
1045 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1046 # which can be attached to an RPC error.
1047 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1048 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1049 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1050 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1051 },
1052 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1053 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1054 &quot;a_key&quot;: &quot;A String&quot;,
1055 },
1056 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1057 # type or metric.
1058 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1059 # or metric.
1060 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1061 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1062 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1063 },
1064 },
1065 ],
1066 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1067 # This property is optional.
1068 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1069 },
1070 ],
1071 },
1072 &quot;getVersionOperationMetadata&quot;: {
1073 &quot;inlineSbomInfo&quot;: {
1074 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1075 # appropriate identifiers.
1076 &quot;a_key&quot;: &quot;A String&quot;,
1077 },
1078 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1079 # identifiers.
1080 &quot;a_key&quot;: &quot;A String&quot;,
1081 },
1082 },
1083 },
1084 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1085 # message that was returned, such as `NOT FOUND`.
1086 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1087 # status code that was returned. For example, a `404` means the
1088 # resource was not found.
1089 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1090 # defined by the server.
1091 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1092 # This value is inRFC3339
1093 # text format.
1094 &quot;instancesBulkInsertOperationMetadata&quot;: {
1095 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1096 # Example key: zones/us-central1-a
1097 &quot;a_key&quot;: {
1098 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1099 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1100 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1101 # error.
1102 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1103 # if the flow is rolling forward or rolling back.
1104 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1105 },
1106 },
1107 },
1108 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1109 # Operation resources.
1110 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1111 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1112 # group of operations results from a `bulkInsert` API request.
1113 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1114 # `update`, or `delete`, and so on.
1115 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1116 # There is no requirement that this be linear or support any granularity of
1117 # operations. This should not be used to guess when the operation will be
1118 # complete. This number should monotonically increase as the operation
1119 # progresses.
1120 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1121 # applicable when performing regional operations.
1122 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1123 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1124 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1125 # this field will contain information on all underlying zonal actions and
1126 # their state.
1127 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1128 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1129 # Example key: zones/us-central1-a
1130 &quot;a_key&quot;: {
1131 &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
1132 # populated.
1133 # different programming environments, including REST APIs and RPC APIs. It is
1134 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1135 # three pieces of data: error code, error message, and error details.
1136 #
1137 # You can find out more about this error model and how to work with it in the
1138 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1139 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1140 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1141 # message types for APIs to use.
1142 {
1143 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1144 },
1145 ],
1146 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1147 # user-facing error message should be localized and sent in the
1148 # google.rpc.Status.details field, or localized by the client.
1149 },
1150 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1151 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1152 },
1153 },
1154 },
1155 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1156 # This value is inRFC3339
1157 # text format.
1158 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1159 # following:
1160 # `PENDING`, `RUNNING`, or `DONE`.
1161 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1162 # operation.
1163 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1164 # of the target resource.
1165 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1166 # operations related to creating a snapshot, this points to the disk
1167 # that the snapshot was created from.
1168 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1169 # `[email protected]` or
1170 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1171 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1172 # operation, this field will be populated.
1173 {
1174 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1175 # Engine returns NO_RESULTS_ON_PAGE if there
1176 # are no results in the response.
1177 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1178 # value format. For example:
1179 #
1180 # &quot;data&quot;: [
1181 # {
1182 # &quot;key&quot;: &quot;scope&quot;,
1183 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1184 # }
1185 {
1186 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1187 # returned. For example, for warnings where there are no results in a list
1188 # request for a particular zone, this key might be scope and
1189 # the key value might be the zone name. Other examples might be a key
1190 # indicating a deprecated resource and a suggested replacement, or a
1191 # warning about invalid network settings (for example, if an instance
1192 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1193 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1194 },
1195 ],
1196 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1197 },
1198 ],
1199 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1200 # applicable when performing per-zone operations.
1201 }</pre>
1202 </div>
1203
1204 <div class="method">
1205 <code class="details" id="close">close()</code>
1206 <pre>Close httplib2 connections.</pre>
1207 </div>
1208
1209 <div class="method">
1210 <code class="details" id="createInstances">createInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
1211 <pre>Creates instances with per-instance configurations in this regional managed
1212 instance group. Instances are created using the current instance template.
1213 The create instances operation is marked DONE if
1214 the createInstances request is successful. The underlying
1215 actions take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances
1216 method.
1217
1218 Args:
1219 project: string, Project ID for this request. (required)
1220 region: string, The name of theregion
1221 where the managed instance group is located.
1222 It should conform to RFC1035. (required)
1223 instanceGroupManager: string, The name of the managed instance group.
1224 It should conform to RFC1035. (required)
1225 body: object, The request body.
1226 The object takes the form of:
1227
1228 { # RegionInstanceGroupManagers.createInstances
1229 &quot;instances&quot;: [ # [Required] List of specifications of per-instance configs.
1230 {
1231 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
1232 # optimistic locking. It is ignored when inserting a per-instance
1233 # config. An up-to-date fingerprint must be provided in order to update an
1234 # existing per-instance configuration or the field needs to be unset.
1235 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
1236 # Serves as a merge key during UpdatePerInstanceConfigs
1237 # operations, that is, if a per-instance configuration with the same name
1238 # exists then it will be updated, otherwise a new one will be created for the
1239 # VM instance with the same name. An attempt to create a per-instance
1240 # configuration for a VM instance that either doesn&#x27;t exist or is not part
1241 # of the group will result in an error.
1242 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
1243 # preserved state generated from a stateful policy.
1244 &quot;disks&quot;: { # Preserved disks defined for this instance.
1245 # This map is keyed with the device names of the disks.
1246 &quot;a_key&quot;: {
1247 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
1248 # update, instance recreate operations. This flag is used to configure
1249 # if the disk should be deleted after it is no longer used by the group,
1250 # e.g. when the given instance or the whole MIG is deleted.
1251 # Note: disks attached in READ_ONLY mode cannot be
1252 # auto-deleted.
1253 &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
1254 # disk in READ_WRITE mode.
1255 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
1256 # to the VM instance.
1257 },
1258 },
1259 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
1260 # This map is keyed with the name of the network interface.
1261 &quot;a_key&quot;: {
1262 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1263 # update or VM instance recreate operations.
1264 # This flag is used to configure if the IP reservation should be deleted
1265 # after it is no longer used by the group, e.g. when the given instance
1266 # or the whole group is deleted.
1267 &quot;ipAddress&quot;: { # Ip address representation
1268 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1269 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1270 # network interface.
1271 },
1272 },
1273 },
1274 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
1275 # This map is keyed with the name of the network interface.
1276 &quot;a_key&quot;: {
1277 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1278 # update or VM instance recreate operations.
1279 # This flag is used to configure if the IP reservation should be deleted
1280 # after it is no longer used by the group, e.g. when the given instance
1281 # or the whole group is deleted.
1282 &quot;ipAddress&quot;: { # Ip address representation
1283 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1284 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1285 # network interface.
1286 },
1287 },
1288 },
1289 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
1290 &quot;a_key&quot;: &quot;A String&quot;,
1291 },
1292 },
1293 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
1294 # managed instance.
1295 },
1296 ],
1297 }
1298
1299 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1300 that if you must retry your request, the server will know to ignore the
1301 request if it has already been completed.
1302
1303 For example, consider a situation where you make an initial request and
1304 the request times out. If you make the request again with the same
1305 request ID, the server can check if original operation with the same
1306 request ID was received, and if so, will ignore the second request.
1307
1308 The request ID must be
1309 a valid UUID with the exception that zero UUID is not supported
1310 (00000000-0000-0000-0000-000000000000).
1311 x__xgafv: string, V1 error format.
1312 Allowed values
1313 1 - v1 error format
1314 2 - v2 error format
1315
1316 Returns:
1317 An object of the form:
1318
1319 { # Represents an Operation resource.
1320 #
1321 # Google Compute Engine has three Operation resources:
1322 #
1323 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1324 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1325 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1326 #
1327 # You can use an operation resource to manage asynchronous API requests.
1328 # For more information, readHandling
1329 # API responses.
1330 #
1331 # Operations can be global, regional or zonal.
1332 #
1333 # - For global operations, use the `globalOperations`
1334 # resource.
1335 # - For regional operations, use the
1336 # `regionOperations` resource.
1337 # - For zonal operations, use
1338 # the `zoneOperations` resource.
1339 #
1340 #
1341 #
1342 # For more information, read
1343 # Global, Regional, and Zonal Resources.
1344 #
1345 # Note that completed Operation resources have a limited
1346 # retention period.
1347 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1348 # Not present otherwise.
1349 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1350 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1351 # set when the operation is created.
1352 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1353 # text format.
1354 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1355 # this field will be populated.
1356 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1357 # operation.
1358 {
1359 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1360 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1361 # details. There is a set of defined message types to use for providing
1362 # details.The syntax depends on the error code. For example,
1363 # QuotaExceededInfo will have details when the error code is
1364 # QUOTA_EXCEEDED.
1365 {
1366 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1367 #
1368 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1369 # is not enabled:
1370 #
1371 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1372 # &quot;domain&quot;: &quot;googleapis.com&quot;
1373 # &quot;metadata&quot;: {
1374 # &quot;resource&quot;: &quot;projects/123&quot;,
1375 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1376 # }
1377 # }
1378 #
1379 # This response indicates that the pubsub.googleapis.com API is not enabled.
1380 #
1381 # Example of an error that is returned when attempting to create a Spanner
1382 # instance in a region that is out of stock:
1383 #
1384 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1385 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1386 # &quot;metadata&quot;: {
1387 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1388 # }
1389 # }
1390 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1391 # is typically the registered service name of the tool or product that
1392 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1393 # generated by some common infrastructure, the error domain must be a
1394 # globally unique value that identifies the infrastructure. For Google API
1395 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1396 &quot;metadatas&quot;: { # Additional structured details about this error.
1397 #
1398 # Keys must match a regular expression of `a-z+` but should
1399 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1400 # length. When identifying the current value of an exceeded limit, the units
1401 # should be contained in the key, not the value. For example, rather than
1402 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1403 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1404 # instances that can be created in a single (batch) request.
1405 &quot;a_key&quot;: &quot;A String&quot;,
1406 },
1407 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1408 # proximate cause of the error. Error reasons are unique within a particular
1409 # domain of errors. This should be at most 63 characters and match a
1410 # regular expression of `A-Z+[A-Z0-9]`, which represents
1411 # UPPER_SNAKE_CASE.
1412 },
1413 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1414 #
1415 # For example, if a quota check failed with an error indicating the calling
1416 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1417 # directly to the right place in the developer console to flip the bit.
1418 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1419 { # Describes a URL link.
1420 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1421 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1422 },
1423 ],
1424 },
1425 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1426 # which can be attached to an RPC error.
1427 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1428 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1429 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1430 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1431 },
1432 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1433 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1434 &quot;a_key&quot;: &quot;A String&quot;,
1435 },
1436 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1437 # type or metric.
1438 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1439 # or metric.
1440 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1441 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1442 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1443 },
1444 },
1445 ],
1446 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1447 # This property is optional.
1448 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1449 },
1450 ],
1451 },
1452 &quot;getVersionOperationMetadata&quot;: {
1453 &quot;inlineSbomInfo&quot;: {
1454 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1455 # appropriate identifiers.
1456 &quot;a_key&quot;: &quot;A String&quot;,
1457 },
1458 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1459 # identifiers.
1460 &quot;a_key&quot;: &quot;A String&quot;,
1461 },
1462 },
1463 },
1464 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1465 # message that was returned, such as `NOT FOUND`.
1466 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1467 # status code that was returned. For example, a `404` means the
1468 # resource was not found.
1469 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1470 # defined by the server.
1471 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1472 # This value is inRFC3339
1473 # text format.
1474 &quot;instancesBulkInsertOperationMetadata&quot;: {
1475 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1476 # Example key: zones/us-central1-a
1477 &quot;a_key&quot;: {
1478 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1479 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1480 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1481 # error.
1482 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1483 # if the flow is rolling forward or rolling back.
1484 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1485 },
1486 },
1487 },
1488 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1489 # Operation resources.
1490 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1491 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1492 # group of operations results from a `bulkInsert` API request.
1493 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1494 # `update`, or `delete`, and so on.
1495 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1496 # There is no requirement that this be linear or support any granularity of
1497 # operations. This should not be used to guess when the operation will be
1498 # complete. This number should monotonically increase as the operation
1499 # progresses.
1500 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1501 # applicable when performing regional operations.
1502 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1503 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1504 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1505 # this field will contain information on all underlying zonal actions and
1506 # their state.
1507 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1508 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1509 # Example key: zones/us-central1-a
1510 &quot;a_key&quot;: {
1511 &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
1512 # populated.
1513 # different programming environments, including REST APIs and RPC APIs. It is
1514 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1515 # three pieces of data: error code, error message, and error details.
1516 #
1517 # You can find out more about this error model and how to work with it in the
1518 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1519 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1520 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1521 # message types for APIs to use.
1522 {
1523 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1524 },
1525 ],
1526 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1527 # user-facing error message should be localized and sent in the
1528 # google.rpc.Status.details field, or localized by the client.
1529 },
1530 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1531 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1532 },
1533 },
1534 },
1535 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1536 # This value is inRFC3339
1537 # text format.
1538 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1539 # following:
1540 # `PENDING`, `RUNNING`, or `DONE`.
1541 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1542 # operation.
1543 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1544 # of the target resource.
1545 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1546 # operations related to creating a snapshot, this points to the disk
1547 # that the snapshot was created from.
1548 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1549 # `[email protected]` or
1550 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1551 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1552 # operation, this field will be populated.
1553 {
1554 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1555 # Engine returns NO_RESULTS_ON_PAGE if there
1556 # are no results in the response.
1557 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1558 # value format. For example:
1559 #
1560 # &quot;data&quot;: [
1561 # {
1562 # &quot;key&quot;: &quot;scope&quot;,
1563 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1564 # }
1565 {
1566 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1567 # returned. For example, for warnings where there are no results in a list
1568 # request for a particular zone, this key might be scope and
1569 # the key value might be the zone name. Other examples might be a key
1570 # indicating a deprecated resource and a suggested replacement, or a
1571 # warning about invalid network settings (for example, if an instance
1572 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1573 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1574 },
1575 ],
1576 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1577 },
1578 ],
1579 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1580 # applicable when performing per-zone operations.
1581 }</pre>
1582 </div>
1583
1584 <div class="method">
1585 <code class="details" id="delete">delete(project, region, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
1586 <pre>Deletes the specified managed instance group and all of the instances
1587 in that group.
1588
1589 Args:
1590 project: string, Project ID for this request. (required)
1591 region: string, Name of the region scoping this request. (required)
1592 instanceGroupManager: string, Name of the managed instance group to delete. (required)
1593 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it&#x27;s
1594 configured for the instances.
1595 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1596 that if you must retry your request, the server will know to ignore the
1597 request if it has already been completed.
1598
1599 For example, consider a situation where you make an initial request and
1600 the request times out. If you make the request again with the same
1601 request ID, the server can check if original operation with the same
1602 request ID was received, and if so, will ignore the second request. This
1603 prevents clients from accidentally creating duplicate commitments.
1604
1605 The request ID must be
1606 a valid UUID with the exception that zero UUID is not supported
1607 (00000000-0000-0000-0000-000000000000).
1608 x__xgafv: string, V1 error format.
1609 Allowed values
1610 1 - v1 error format
1611 2 - v2 error format
1612
1613 Returns:
1614 An object of the form:
1615
1616 { # Represents an Operation resource.
1617 #
1618 # Google Compute Engine has three Operation resources:
1619 #
1620 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1621 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1622 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1623 #
1624 # You can use an operation resource to manage asynchronous API requests.
1625 # For more information, readHandling
1626 # API responses.
1627 #
1628 # Operations can be global, regional or zonal.
1629 #
1630 # - For global operations, use the `globalOperations`
1631 # resource.
1632 # - For regional operations, use the
1633 # `regionOperations` resource.
1634 # - For zonal operations, use
1635 # the `zoneOperations` resource.
1636 #
1637 #
1638 #
1639 # For more information, read
1640 # Global, Regional, and Zonal Resources.
1641 #
1642 # Note that completed Operation resources have a limited
1643 # retention period.
1644 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1645 # Not present otherwise.
1646 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1647 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1648 # set when the operation is created.
1649 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1650 # text format.
1651 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1652 # this field will be populated.
1653 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1654 # operation.
1655 {
1656 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1657 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1658 # details. There is a set of defined message types to use for providing
1659 # details.The syntax depends on the error code. For example,
1660 # QuotaExceededInfo will have details when the error code is
1661 # QUOTA_EXCEEDED.
1662 {
1663 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1664 #
1665 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1666 # is not enabled:
1667 #
1668 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1669 # &quot;domain&quot;: &quot;googleapis.com&quot;
1670 # &quot;metadata&quot;: {
1671 # &quot;resource&quot;: &quot;projects/123&quot;,
1672 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1673 # }
1674 # }
1675 #
1676 # This response indicates that the pubsub.googleapis.com API is not enabled.
1677 #
1678 # Example of an error that is returned when attempting to create a Spanner
1679 # instance in a region that is out of stock:
1680 #
1681 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1682 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1683 # &quot;metadata&quot;: {
1684 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1685 # }
1686 # }
1687 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1688 # is typically the registered service name of the tool or product that
1689 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1690 # generated by some common infrastructure, the error domain must be a
1691 # globally unique value that identifies the infrastructure. For Google API
1692 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1693 &quot;metadatas&quot;: { # Additional structured details about this error.
1694 #
1695 # Keys must match a regular expression of `a-z+` but should
1696 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1697 # length. When identifying the current value of an exceeded limit, the units
1698 # should be contained in the key, not the value. For example, rather than
1699 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1700 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1701 # instances that can be created in a single (batch) request.
1702 &quot;a_key&quot;: &quot;A String&quot;,
1703 },
1704 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1705 # proximate cause of the error. Error reasons are unique within a particular
1706 # domain of errors. This should be at most 63 characters and match a
1707 # regular expression of `A-Z+[A-Z0-9]`, which represents
1708 # UPPER_SNAKE_CASE.
1709 },
1710 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1711 #
1712 # For example, if a quota check failed with an error indicating the calling
1713 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1714 # directly to the right place in the developer console to flip the bit.
1715 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1716 { # Describes a URL link.
1717 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1718 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1719 },
1720 ],
1721 },
1722 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1723 # which can be attached to an RPC error.
1724 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1725 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1726 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1727 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1728 },
1729 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1730 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1731 &quot;a_key&quot;: &quot;A String&quot;,
1732 },
1733 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1734 # type or metric.
1735 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1736 # or metric.
1737 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1738 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1739 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1740 },
1741 },
1742 ],
1743 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1744 # This property is optional.
1745 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1746 },
1747 ],
1748 },
1749 &quot;getVersionOperationMetadata&quot;: {
1750 &quot;inlineSbomInfo&quot;: {
1751 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1752 # appropriate identifiers.
1753 &quot;a_key&quot;: &quot;A String&quot;,
1754 },
1755 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1756 # identifiers.
1757 &quot;a_key&quot;: &quot;A String&quot;,
1758 },
1759 },
1760 },
1761 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1762 # message that was returned, such as `NOT FOUND`.
1763 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1764 # status code that was returned. For example, a `404` means the
1765 # resource was not found.
1766 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1767 # defined by the server.
1768 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1769 # This value is inRFC3339
1770 # text format.
1771 &quot;instancesBulkInsertOperationMetadata&quot;: {
1772 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1773 # Example key: zones/us-central1-a
1774 &quot;a_key&quot;: {
1775 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1776 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1777 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1778 # error.
1779 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1780 # if the flow is rolling forward or rolling back.
1781 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1782 },
1783 },
1784 },
1785 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1786 # Operation resources.
1787 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1788 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1789 # group of operations results from a `bulkInsert` API request.
1790 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1791 # `update`, or `delete`, and so on.
1792 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1793 # There is no requirement that this be linear or support any granularity of
1794 # operations. This should not be used to guess when the operation will be
1795 # complete. This number should monotonically increase as the operation
1796 # progresses.
1797 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1798 # applicable when performing regional operations.
1799 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1800 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1801 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1802 # this field will contain information on all underlying zonal actions and
1803 # their state.
1804 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1805 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1806 # Example key: zones/us-central1-a
1807 &quot;a_key&quot;: {
1808 &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
1809 # populated.
1810 # different programming environments, including REST APIs and RPC APIs. It is
1811 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1812 # three pieces of data: error code, error message, and error details.
1813 #
1814 # You can find out more about this error model and how to work with it in the
1815 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1816 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1817 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1818 # message types for APIs to use.
1819 {
1820 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1821 },
1822 ],
1823 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1824 # user-facing error message should be localized and sent in the
1825 # google.rpc.Status.details field, or localized by the client.
1826 },
1827 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1828 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1829 },
1830 },
1831 },
1832 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1833 # This value is inRFC3339
1834 # text format.
1835 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1836 # following:
1837 # `PENDING`, `RUNNING`, or `DONE`.
1838 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1839 # operation.
1840 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1841 # of the target resource.
1842 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1843 # operations related to creating a snapshot, this points to the disk
1844 # that the snapshot was created from.
1845 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1846 # `[email protected]` or
1847 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1848 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1849 # operation, this field will be populated.
1850 {
1851 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1852 # Engine returns NO_RESULTS_ON_PAGE if there
1853 # are no results in the response.
1854 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1855 # value format. For example:
1856 #
1857 # &quot;data&quot;: [
1858 # {
1859 # &quot;key&quot;: &quot;scope&quot;,
1860 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1861 # }
1862 {
1863 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1864 # returned. For example, for warnings where there are no results in a list
1865 # request for a particular zone, this key might be scope and
1866 # the key value might be the zone name. Other examples might be a key
1867 # indicating a deprecated resource and a suggested replacement, or a
1868 # warning about invalid network settings (for example, if an instance
1869 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1870 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1871 },
1872 ],
1873 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1874 },
1875 ],
1876 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1877 # applicable when performing per-zone operations.
1878 }</pre>
1879 </div>
1880
1881 <div class="method">
1882 <code class="details" id="deleteInstances">deleteInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
1883 <pre>Flags the specified instances in the managed instance group to be
1884 immediately deleted. The instances are also removed from any target
1885 pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of
1886 instances that you delete.
1887 The deleteInstances operation is marked DONE if
1888 the deleteInstances request is successful. The underlying
1889 actions take additional time. You must separately verify the status of thedeleting action with thelistmanagedinstances
1890 method.
1891
1892 If the group is part of a backend
1893 service that has enabled
1894 connection draining, it can take up to 60 seconds after the connection
1895 draining duration has elapsed before the VM instance is removed or deleted.
1896
1897 You can specify a maximum of 1000 instances with this method per request.
1898
1899 Args:
1900 project: string, Project ID for this request. (required)
1901 region: string, Name of the region scoping this request. (required)
1902 instanceGroupManager: string, Name of the managed instance group. (required)
1903 body: object, The request body.
1904 The object takes the form of:
1905
1906 {
1907 &quot;instances&quot;: [ # The URLs of one or more instances to delete. This can be a full URL or
1908 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
1909 &quot;A String&quot;,
1910 ],
1911 &quot;skipInstancesOnValidationError&quot;: True or False, # Specifies whether the request should proceed despite the inclusion of
1912 # instances that are not members of the group or that are already in the
1913 # process of being deleted or abandoned. If this field is set to `false` and
1914 # such an instance is specified in the request, the operation fails. The
1915 # operation always fails if the request contains a malformed instance URL or
1916 # a reference to an instance that exists in a zone or region other than the
1917 # group&#x27;s zone or region.
1918 }
1919
1920 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it&#x27;s
1921 configured for the instances.
1922 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1923 that if you must retry your request, the server will know to ignore the
1924 request if it has already been completed.
1925
1926 For example, consider a situation where you make an initial request and
1927 the request times out. If you make the request again with the same
1928 request ID, the server can check if original operation with the same
1929 request ID was received, and if so, will ignore the second request. This
1930 prevents clients from accidentally creating duplicate commitments.
1931
1932 The request ID must be
1933 a valid UUID with the exception that zero UUID is not supported
1934 (00000000-0000-0000-0000-000000000000).
1935 x__xgafv: string, V1 error format.
1936 Allowed values
1937 1 - v1 error format
1938 2 - v2 error format
1939
1940 Returns:
1941 An object of the form:
1942
1943 { # Represents an Operation resource.
1944 #
1945 # Google Compute Engine has three Operation resources:
1946 #
1947 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1948 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1949 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1950 #
1951 # You can use an operation resource to manage asynchronous API requests.
1952 # For more information, readHandling
1953 # API responses.
1954 #
1955 # Operations can be global, regional or zonal.
1956 #
1957 # - For global operations, use the `globalOperations`
1958 # resource.
1959 # - For regional operations, use the
1960 # `regionOperations` resource.
1961 # - For zonal operations, use
1962 # the `zoneOperations` resource.
1963 #
1964 #
1965 #
1966 # For more information, read
1967 # Global, Regional, and Zonal Resources.
1968 #
1969 # Note that completed Operation resources have a limited
1970 # retention period.
1971 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1972 # Not present otherwise.
1973 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1974 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1975 # set when the operation is created.
1976 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1977 # text format.
1978 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1979 # this field will be populated.
1980 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1981 # operation.
1982 {
1983 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1984 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1985 # details. There is a set of defined message types to use for providing
1986 # details.The syntax depends on the error code. For example,
1987 # QuotaExceededInfo will have details when the error code is
1988 # QUOTA_EXCEEDED.
1989 {
1990 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1991 #
1992 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1993 # is not enabled:
1994 #
1995 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1996 # &quot;domain&quot;: &quot;googleapis.com&quot;
1997 # &quot;metadata&quot;: {
1998 # &quot;resource&quot;: &quot;projects/123&quot;,
1999 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2000 # }
2001 # }
2002 #
2003 # This response indicates that the pubsub.googleapis.com API is not enabled.
2004 #
2005 # Example of an error that is returned when attempting to create a Spanner
2006 # instance in a region that is out of stock:
2007 #
2008 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2009 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2010 # &quot;metadata&quot;: {
2011 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2012 # }
2013 # }
2014 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2015 # is typically the registered service name of the tool or product that
2016 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2017 # generated by some common infrastructure, the error domain must be a
2018 # globally unique value that identifies the infrastructure. For Google API
2019 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2020 &quot;metadatas&quot;: { # Additional structured details about this error.
2021 #
2022 # Keys must match a regular expression of `a-z+` but should
2023 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2024 # length. When identifying the current value of an exceeded limit, the units
2025 # should be contained in the key, not the value. For example, rather than
2026 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2027 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2028 # instances that can be created in a single (batch) request.
2029 &quot;a_key&quot;: &quot;A String&quot;,
2030 },
2031 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2032 # proximate cause of the error. Error reasons are unique within a particular
2033 # domain of errors. This should be at most 63 characters and match a
2034 # regular expression of `A-Z+[A-Z0-9]`, which represents
2035 # UPPER_SNAKE_CASE.
2036 },
2037 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2038 #
2039 # For example, if a quota check failed with an error indicating the calling
2040 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2041 # directly to the right place in the developer console to flip the bit.
2042 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2043 { # Describes a URL link.
2044 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2045 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2046 },
2047 ],
2048 },
2049 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2050 # which can be attached to an RPC error.
2051 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2052 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2053 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2054 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2055 },
2056 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2057 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2058 &quot;a_key&quot;: &quot;A String&quot;,
2059 },
2060 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2061 # type or metric.
2062 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2063 # or metric.
2064 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2065 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2066 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2067 },
2068 },
2069 ],
2070 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2071 # This property is optional.
2072 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2073 },
2074 ],
2075 },
2076 &quot;getVersionOperationMetadata&quot;: {
2077 &quot;inlineSbomInfo&quot;: {
2078 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2079 # appropriate identifiers.
2080 &quot;a_key&quot;: &quot;A String&quot;,
2081 },
2082 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2083 # identifiers.
2084 &quot;a_key&quot;: &quot;A String&quot;,
2085 },
2086 },
2087 },
2088 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2089 # message that was returned, such as `NOT FOUND`.
2090 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2091 # status code that was returned. For example, a `404` means the
2092 # resource was not found.
2093 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2094 # defined by the server.
2095 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2096 # This value is inRFC3339
2097 # text format.
2098 &quot;instancesBulkInsertOperationMetadata&quot;: {
2099 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2100 # Example key: zones/us-central1-a
2101 &quot;a_key&quot;: {
2102 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2103 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2104 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2105 # error.
2106 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2107 # if the flow is rolling forward or rolling back.
2108 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2109 },
2110 },
2111 },
2112 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2113 # Operation resources.
2114 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2115 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2116 # group of operations results from a `bulkInsert` API request.
2117 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2118 # `update`, or `delete`, and so on.
2119 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2120 # There is no requirement that this be linear or support any granularity of
2121 # operations. This should not be used to guess when the operation will be
2122 # complete. This number should monotonically increase as the operation
2123 # progresses.
2124 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2125 # applicable when performing regional operations.
2126 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2127 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
2128 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2129 # this field will contain information on all underlying zonal actions and
2130 # their state.
2131 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2132 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2133 # Example key: zones/us-central1-a
2134 &quot;a_key&quot;: {
2135 &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
2136 # populated.
2137 # different programming environments, including REST APIs and RPC APIs. It is
2138 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2139 # three pieces of data: error code, error message, and error details.
2140 #
2141 # You can find out more about this error model and how to work with it in the
2142 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2143 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2144 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2145 # message types for APIs to use.
2146 {
2147 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2148 },
2149 ],
2150 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2151 # user-facing error message should be localized and sent in the
2152 # google.rpc.Status.details field, or localized by the client.
2153 },
2154 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2155 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2156 },
2157 },
2158 },
2159 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2160 # This value is inRFC3339
2161 # text format.
2162 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2163 # following:
2164 # `PENDING`, `RUNNING`, or `DONE`.
2165 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2166 # operation.
2167 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2168 # of the target resource.
2169 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2170 # operations related to creating a snapshot, this points to the disk
2171 # that the snapshot was created from.
2172 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2173 # `[email protected]` or
2174 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2175 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2176 # operation, this field will be populated.
2177 {
2178 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2179 # Engine returns NO_RESULTS_ON_PAGE if there
2180 # are no results in the response.
2181 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2182 # value format. For example:
2183 #
2184 # &quot;data&quot;: [
2185 # {
2186 # &quot;key&quot;: &quot;scope&quot;,
2187 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2188 # }
2189 {
2190 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2191 # returned. For example, for warnings where there are no results in a list
2192 # request for a particular zone, this key might be scope and
2193 # the key value might be the zone name. Other examples might be a key
2194 # indicating a deprecated resource and a suggested replacement, or a
2195 # warning about invalid network settings (for example, if an instance
2196 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2197 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2198 },
2199 ],
2200 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2201 },
2202 ],
2203 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2204 # applicable when performing per-zone operations.
2205 }</pre>
2206 </div>
2207
2208 <div class="method">
2209 <code class="details" id="deletePerInstanceConfigs">deletePerInstanceConfigs(project, region, instanceGroupManager, body=None, x__xgafv=None)</code>
2210 <pre>Deletes selected per-instance configurations for the managed instance
2211 group.
2212
2213 Args:
2214 project: string, Project ID for this request. (required)
2215 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
2216 instanceGroupManager: string, The name of the managed instance group. It should conform to RFC1035. (required)
2217 body: object, The request body.
2218 The object takes the form of:
2219
2220 { # RegionInstanceGroupManagers.deletePerInstanceConfigs
2221 &quot;names&quot;: [ # The list of instance names for which we want to delete per-instance configs
2222 # on this managed instance group.
2223 &quot;A String&quot;,
2224 ],
2225 }
2226
2227 x__xgafv: string, V1 error format.
2228 Allowed values
2229 1 - v1 error format
2230 2 - v2 error format
2231
2232 Returns:
2233 An object of the form:
2234
2235 { # Represents an Operation resource.
2236 #
2237 # Google Compute Engine has three Operation resources:
2238 #
2239 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
2240 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
2241 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
2242 #
2243 # You can use an operation resource to manage asynchronous API requests.
2244 # For more information, readHandling
2245 # API responses.
2246 #
2247 # Operations can be global, regional or zonal.
2248 #
2249 # - For global operations, use the `globalOperations`
2250 # resource.
2251 # - For regional operations, use the
2252 # `regionOperations` resource.
2253 # - For zonal operations, use
2254 # the `zoneOperations` resource.
2255 #
2256 #
2257 #
2258 # For more information, read
2259 # Global, Regional, and Zonal Resources.
2260 #
2261 # Note that completed Operation resources have a limited
2262 # retention period.
2263 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2264 # Not present otherwise.
2265 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2266 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2267 # set when the operation is created.
2268 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2269 # text format.
2270 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2271 # this field will be populated.
2272 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2273 # operation.
2274 {
2275 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2276 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2277 # details. There is a set of defined message types to use for providing
2278 # details.The syntax depends on the error code. For example,
2279 # QuotaExceededInfo will have details when the error code is
2280 # QUOTA_EXCEEDED.
2281 {
2282 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2283 #
2284 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2285 # is not enabled:
2286 #
2287 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2288 # &quot;domain&quot;: &quot;googleapis.com&quot;
2289 # &quot;metadata&quot;: {
2290 # &quot;resource&quot;: &quot;projects/123&quot;,
2291 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2292 # }
2293 # }
2294 #
2295 # This response indicates that the pubsub.googleapis.com API is not enabled.
2296 #
2297 # Example of an error that is returned when attempting to create a Spanner
2298 # instance in a region that is out of stock:
2299 #
2300 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2301 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2302 # &quot;metadata&quot;: {
2303 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2304 # }
2305 # }
2306 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2307 # is typically the registered service name of the tool or product that
2308 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2309 # generated by some common infrastructure, the error domain must be a
2310 # globally unique value that identifies the infrastructure. For Google API
2311 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2312 &quot;metadatas&quot;: { # Additional structured details about this error.
2313 #
2314 # Keys must match a regular expression of `a-z+` but should
2315 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2316 # length. When identifying the current value of an exceeded limit, the units
2317 # should be contained in the key, not the value. For example, rather than
2318 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2319 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2320 # instances that can be created in a single (batch) request.
2321 &quot;a_key&quot;: &quot;A String&quot;,
2322 },
2323 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2324 # proximate cause of the error. Error reasons are unique within a particular
2325 # domain of errors. This should be at most 63 characters and match a
2326 # regular expression of `A-Z+[A-Z0-9]`, which represents
2327 # UPPER_SNAKE_CASE.
2328 },
2329 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2330 #
2331 # For example, if a quota check failed with an error indicating the calling
2332 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2333 # directly to the right place in the developer console to flip the bit.
2334 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2335 { # Describes a URL link.
2336 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2337 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2338 },
2339 ],
2340 },
2341 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2342 # which can be attached to an RPC error.
2343 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2344 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2345 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2346 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2347 },
2348 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2349 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2350 &quot;a_key&quot;: &quot;A String&quot;,
2351 },
2352 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2353 # type or metric.
2354 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2355 # or metric.
2356 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2357 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2358 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2359 },
2360 },
2361 ],
2362 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2363 # This property is optional.
2364 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2365 },
2366 ],
2367 },
2368 &quot;getVersionOperationMetadata&quot;: {
2369 &quot;inlineSbomInfo&quot;: {
2370 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2371 # appropriate identifiers.
2372 &quot;a_key&quot;: &quot;A String&quot;,
2373 },
2374 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2375 # identifiers.
2376 &quot;a_key&quot;: &quot;A String&quot;,
2377 },
2378 },
2379 },
2380 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2381 # message that was returned, such as `NOT FOUND`.
2382 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2383 # status code that was returned. For example, a `404` means the
2384 # resource was not found.
2385 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2386 # defined by the server.
2387 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2388 # This value is inRFC3339
2389 # text format.
2390 &quot;instancesBulkInsertOperationMetadata&quot;: {
2391 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2392 # Example key: zones/us-central1-a
2393 &quot;a_key&quot;: {
2394 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2395 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2396 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2397 # error.
2398 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2399 # if the flow is rolling forward or rolling back.
2400 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2401 },
2402 },
2403 },
2404 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2405 # Operation resources.
2406 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2407 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2408 # group of operations results from a `bulkInsert` API request.
2409 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2410 # `update`, or `delete`, and so on.
2411 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2412 # There is no requirement that this be linear or support any granularity of
2413 # operations. This should not be used to guess when the operation will be
2414 # complete. This number should monotonically increase as the operation
2415 # progresses.
2416 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2417 # applicable when performing regional operations.
2418 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2419 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
2420 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2421 # this field will contain information on all underlying zonal actions and
2422 # their state.
2423 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2424 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2425 # Example key: zones/us-central1-a
2426 &quot;a_key&quot;: {
2427 &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
2428 # populated.
2429 # different programming environments, including REST APIs and RPC APIs. It is
2430 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2431 # three pieces of data: error code, error message, and error details.
2432 #
2433 # You can find out more about this error model and how to work with it in the
2434 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2435 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2436 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2437 # message types for APIs to use.
2438 {
2439 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2440 },
2441 ],
2442 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2443 # user-facing error message should be localized and sent in the
2444 # google.rpc.Status.details field, or localized by the client.
2445 },
2446 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2447 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2448 },
2449 },
2450 },
2451 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2452 # This value is inRFC3339
2453 # text format.
2454 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2455 # following:
2456 # `PENDING`, `RUNNING`, or `DONE`.
2457 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2458 # operation.
2459 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2460 # of the target resource.
2461 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2462 # operations related to creating a snapshot, this points to the disk
2463 # that the snapshot was created from.
2464 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2465 # `[email protected]` or
2466 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2467 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2468 # operation, this field will be populated.
2469 {
2470 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2471 # Engine returns NO_RESULTS_ON_PAGE if there
2472 # are no results in the response.
2473 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2474 # value format. For example:
2475 #
2476 # &quot;data&quot;: [
2477 # {
2478 # &quot;key&quot;: &quot;scope&quot;,
2479 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2480 # }
2481 {
2482 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2483 # returned. For example, for warnings where there are no results in a list
2484 # request for a particular zone, this key might be scope and
2485 # the key value might be the zone name. Other examples might be a key
2486 # indicating a deprecated resource and a suggested replacement, or a
2487 # warning about invalid network settings (for example, if an instance
2488 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2489 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2490 },
2491 ],
2492 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2493 },
2494 ],
2495 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2496 # applicable when performing per-zone operations.
2497 }</pre>
2498 </div>
2499
2500 <div class="method">
2501 <code class="details" id="get">get(project, region, instanceGroupManager, x__xgafv=None)</code>
2502 <pre>Returns all of the details about the specified managed instance group.
2503
2504 Args:
2505 project: string, Project ID for this request. (required)
2506 region: string, Name of the region scoping this request. (required)
2507 instanceGroupManager: string, Name of the managed instance group to return. (required)
2508 x__xgafv: string, V1 error format.
2509 Allowed values
2510 1 - v1 error format
2511 2 - v2 error format
2512
2513 Returns:
2514 An object of the form:
2515
2516 { # Represents a Managed Instance Group resource.
2517 #
2518 # An instance group is a collection of VM instances that you can manage as a
2519 # single entity. For more information, readInstance groups.
2520 #
2521 # For zonal Managed Instance Group, use the instanceGroupManagers
2522 # resource.
2523 #
2524 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
2525 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
2526 # for the group.
2527 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
2528 #
2529 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
2530 # instances to apply the configuration. To apply the configuration, set the
2531 # group&#x27;s updatePolicy.type field to use proactive updates or
2532 # use the applyUpdatesToInstances method.
2533 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
2534 &quot;a_key&quot;: &quot;A String&quot;,
2535 },
2536 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
2537 # more information, see Project and
2538 # instance metadata.
2539 &quot;a_key&quot;: &quot;A String&quot;,
2540 },
2541 },
2542 },
2543 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
2544 # only one value.
2545 {
2546 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
2547 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
2548 # this field controls whether to trigger VM autohealing based on a failed
2549 # health check. Valid values are:
2550 #
2551 # - ON (default): The group recreates running VMs that
2552 # fail the application-based health check.
2553 # - OFF: When set to OFF, you can still observe instance
2554 # health state, but the group does not recreate VMs that fail the
2555 # application-based health check. This is useful for troubleshooting and
2556 # setting up your health check configuration.
2557 },
2558 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
2559 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
2560 # initialize and run its startup script. During a VM&#x27;s initial delay
2561 # period, the MIG ignores unsuccessful health checks because the VM might
2562 # be in the startup process. This prevents the MIG from prematurely
2563 # recreating a VM. If the health check receives a healthy response during
2564 # the initial delay, it indicates that the startup process is complete and
2565 # the VM is ready. The value of initial delay must be between 0 and 3600
2566 # seconds. The default value is 0.
2567 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
2568 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
2569 # The instance is considered available if all of the following conditions
2570 # are satisfied:
2571 # 1. Instance&#x27;s status is RUNNING.
2572 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
2573 # check result was observed to be HEALTHY at least once as it passed
2574 # VERIFYING).
2575 # 3. There is no outgoing action on an instance triggered by IGM.
2576 #
2577 # By default, number of concurrently autohealed instances is smaller than
2578 # the managed instance group target size. However, if a zonal managed
2579 # instance group has only one instance, or a regional managed instance
2580 # group has only one instance per zone, autohealing will recreate these
2581 # instances when they become unhealthy.
2582 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
2583 #
2584 #
2585 #
2586 # - If the value is fixed, then the calculated
2587 # value is equal to the fixed value.
2588 # - If the value is a percent, then the
2589 # calculated
2590 # value is percent/100 * targetSize. For example,
2591 # the calculated value of a 80% of a managed instance group
2592 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
2593 # is a remainder, the number is rounded.
2594 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
2595 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
2596 # example, specify 80 for 80%.
2597 },
2598 },
2599 ],
2600 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
2601 # all VMs in a MIG. The maximum character length is 58 and the name must
2602 # comply with RFC1035 format.
2603 #
2604 # When a VM is created in the group, the MIG appends a hyphen and a random
2605 # four-character string to the base instance name. If you want the MIG to
2606 # assign sequential numbers instead of a random string, then end the base
2607 # instance name with a hyphen followed by one or more hash symbols. The hash
2608 # symbols indicate the number of digits. For example, a base instance name of
2609 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
2610 # @pattern
2611 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
2612 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
2613 # text format.
2614 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
2615 # in this managed instance group that are scheduled for each of those
2616 # actions.
2617 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
2618 # that are scheduled to be abandoned. Abandoning an instance removes it
2619 # from the managed instance group without deleting it.
2620 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
2621 # are scheduled to be adopted or are currently being adopted.
2622 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
2623 # are scheduled to be created or are currently being created. If the group
2624 # fails to create any of these instances, it tries again until it creates
2625 # the instance successfully.
2626 #
2627 # If you have disabled creation retries, this field will not be populated;
2628 # instead, the creatingWithoutRetries field will be populated.
2629 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
2630 # will attempt to create atomically, in a batch mode. If the desired count
2631 # of instances can not be created, entire batch will be deleted and the
2632 # group will decrease its targetSize value accordingly.
2633 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
2634 # will attempt to create. The group attempts to create each instance
2635 # only once. If the group fails to create any of these instances, it
2636 # decreases the group&#x27;s targetSize value accordingly.
2637 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
2638 # are scheduled to be deleted or are currently being deleted.
2639 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
2640 # are running and have no scheduled actions.
2641 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
2642 # is currently queuing.
2643 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
2644 # are scheduled to be recreated or are currently being being recreated.
2645 # Recreating an instance deletes the existing root persistent disk
2646 # and creates a new disk from the image that is defined in the
2647 # instance template.
2648 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
2649 # are being reconfigured with properties that do not require a restart
2650 # or a recreate action. For example, setting or removing target
2651 # pools for the instance.
2652 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
2653 # are scheduled to be restarted or are currently being restarted.
2654 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
2655 # are scheduled to be restarted or are currently being restarted.
2656 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
2657 # are scheduled to be resumed or are currently being resumed.
2658 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
2659 # are scheduled to be started or are currently being started.
2660 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
2661 # are scheduled to be stopped or are currently being stopped.
2662 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
2663 # are scheduled to be suspended or are currently being suspended.
2664 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
2665 # are being verified. See the managedInstances[].currentAction
2666 # property in the listManagedInstances method documentation.
2667 },
2668 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
2669 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
2670 # zones in a regional managed instance group.
2671 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
2672 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
2673 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
2674 # its instances.
2675 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
2676 # instances, even if an AI zone is available in the specified region. To
2677 # create instances in an AI zone in the selected region, you must explicitly
2678 # specify it in the distribution policy together with the other preferred
2679 # zones.
2680 {
2681 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
2682 # The zone must exist in the region where the managed instance group is
2683 # located.
2684 },
2685 ],
2686 },
2687 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
2688 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
2689 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
2690 # fingerprint must be provided in order to update the InstanceGroupManager,
2691 # otherwise the request will fail with error412 conditionNotMet.
2692 #
2693 # To see the latest fingerprint, make a get() request to
2694 # retrieve an InstanceGroupManager.
2695 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
2696 # generates this identifier.
2697 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
2698 # types of machines.
2699 # Instance flexibility configuration on MIG overrides instance
2700 # template configuration.
2701 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
2702 # when creating new VMs.
2703 &quot;a_key&quot;: {
2704 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
2705 # selection.
2706 { # An instance-attached disk resource.
2707 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
2708 # or X86_64.
2709 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
2710 # deleted (but not when the disk is detached from the instance).
2711 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
2712 # partition of the disk for its root filesystem.
2713 &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
2714 # running within the instance. This name can be used to reference the device
2715 # for mounting, resizing, and so on, from within the instance.
2716 #
2717 # If not specified, the server chooses a default device name to apply to this
2718 # disk, in the form persistent-disk-x, where x is a number
2719 # assigned by Google Compute Engine. This field is only applicable for
2720 # persistent disks.
2721 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
2722 # encryption key.
2723 #
2724 # If you are creating a new disk, this field encrypts the new disk using
2725 # an encryption key that you provide. If you are attaching an existing
2726 # disk that is already encrypted, this field decrypts the disk using
2727 # the customer-supplied encryption key.
2728 #
2729 # If you encrypt a disk using a customer-supplied key, you must provide the
2730 # same key again when you attempt to use this resource at a later time. For
2731 # example, you must provide the key when you create a snapshot or an image
2732 # from the disk or when you attach the disk to a virtual machine instance.
2733 #
2734 # If you do not provide an encryption key, then the disk will be encrypted
2735 # using an automatically generated key and you do not need to provide a key
2736 # to use the disk later.
2737 #
2738 # Note:
2739 #
2740 # Instance templates do not storecustomer-supplied
2741 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
2742 #
2743 # You cannot create VMs that have disks with customer-supplied keys using
2744 # the bulk
2745 # insert method.
2746 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2747 # For example:
2748 #
2749 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2750 # key_region/cryptoKeys/key
2751 #
2752 # The fully-qualifed key name may be returned for resource GET requests. For
2753 # example:
2754 #
2755 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2756 # key_region/cryptoKeys/key
2757 # /cryptoKeyVersions/1
2758 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2759 # key. If absent, the Compute Engine default service account is used.
2760 # For example:
2761 #
2762 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2763 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2764 # encryption key, encoded in RFC
2765 # 4648 base64 to either encrypt or decrypt this resource. You can
2766 # provide either the rawKey or thersaEncryptedKey.
2767 # For example:
2768 #
2769 # &quot;rawKey&quot;:
2770 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2771 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2772 # customer-supplied encryption key to either encrypt or decrypt this
2773 # resource. You can provide either the rawKey or thersaEncryptedKey.
2774 # For example:
2775 #
2776 # &quot;rsaEncryptedKey&quot;:
2777 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2778 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2779 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2780 #
2781 # The key must meet the following requirements before you can provide it to
2782 # Compute Engine:
2783 #
2784 # 1. The key is wrapped using a RSA public key certificate provided by
2785 # Google.
2786 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2787 # encoding.
2788 #
2789 # Gets the RSA public key certificate provided by Google at:
2790 #
2791 #
2792 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2793 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2794 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2795 # encryption key that protects this resource.
2796 },
2797 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
2798 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
2799 # currently attached to another instance. If you try to force attach a zonal
2800 # disk to an instance, you will receive an error.
2801 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2802 # only for bootable images. Read
2803 # Enabling guest operating system features to see a list of available
2804 # options.
2805 { # Guest OS features.
2806 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2807 # separate values. Set to one or more of the following values:
2808 #
2809 # - VIRTIO_SCSI_MULTIQUEUE
2810 # - WINDOWS
2811 # - MULTI_IP_SUBNET
2812 # - UEFI_COMPATIBLE
2813 # - GVNIC
2814 # - SEV_CAPABLE
2815 # - SUSPEND_RESUME_COMPATIBLE
2816 # - SEV_LIVE_MIGRATABLE_V2
2817 # - SEV_SNP_CAPABLE
2818 # - TDX_CAPABLE
2819 # - IDPF
2820 # - SNP_SVSM_CAPABLE
2821 # - CCA_CAPABLE
2822 #
2823 #
2824 # For more information, see
2825 # Enabling guest operating system features.
2826 },
2827 ],
2828 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
2829 # boot disk. If you have many disks attached to an instance, each
2830 # disk would have a unique index number.
2831 &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
2832 # alongside the new instance. Use initialization parameters to create boot
2833 # disks or local SSDs attached to the new instance.
2834 #
2835 # This property is mutually exclusive with the source property;
2836 # you can only define one or the other, but not both.
2837 # alongside the new instance. Use initialization parameters to create boot
2838 # disks or local SSDs attached to the new instance.
2839 #
2840 # This field is persisted and returned for instanceTemplate and not returned
2841 # in the context of instance.
2842 #
2843 # This property is mutually exclusive with the source property;
2844 # you can only define one or the other, but not both.
2845 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
2846 # arm64 or x86_64.
2847 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
2848 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
2849 # of the instance. If a disk with the same name already exists in the given
2850 # region, the existing disk is attached to the new instance and the
2851 # new disk is not created.
2852 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
2853 # 10 GB. If you specify a sourceImage, which is required for
2854 # boot disks, the default size is the size of the sourceImage.
2855 # If you do not specify a sourceImage, the default disk size
2856 # is 500 GB.
2857 &quot;diskType&quot;: &quot;A String&quot;,
2858 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
2859 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2860 # only for bootable images. Read
2861 # Enabling guest operating system features to see a list of available
2862 # options.
2863 #
2864 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
2865 { # Guest OS features.
2866 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2867 # separate values. Set to one or more of the following values:
2868 #
2869 # - VIRTIO_SCSI_MULTIQUEUE
2870 # - WINDOWS
2871 # - MULTI_IP_SUBNET
2872 # - UEFI_COMPATIBLE
2873 # - GVNIC
2874 # - SEV_CAPABLE
2875 # - SUSPEND_RESUME_COMPATIBLE
2876 # - SEV_LIVE_MIGRATABLE_V2
2877 # - SEV_SNP_CAPABLE
2878 # - TDX_CAPABLE
2879 # - IDPF
2880 # - SNP_SVSM_CAPABLE
2881 # - CCA_CAPABLE
2882 #
2883 #
2884 # For more information, see
2885 # Enabling guest operating system features.
2886 },
2887 ],
2888 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
2889 # which is either SCSI or NVME. The default isSCSI.
2890 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
2891 # persistent disks.
2892 &quot;a_key&quot;: &quot;A String&quot;,
2893 },
2894 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
2895 # disk.
2896 &quot;A String&quot;,
2897 ],
2898 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
2899 &quot;A String&quot;,
2900 ],
2901 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
2902 # more than one instance.
2903 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
2904 # is to use the existing disk.
2905 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
2906 # of I/O operations per second that the disk can handle. Values must be
2907 # between 10,000 and 120,000. For more details, see theExtreme persistent
2908 # disk documentation.
2909 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
2910 # number of throughput mb per second that the disk can handle. Values must
2911 # greater than or equal to 1.
2912 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
2913 # the URLs of the zones where the disk should be replicated to.
2914 # You must provide exactly two replica zones, and one zone must be the same
2915 # as the instance zone.
2916 &quot;A String&quot;,
2917 ],
2918 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
2919 # have the same definition as resource
2920 # manager tags. Keys and values can be either in numeric format,
2921 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
2922 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
2923 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
2924 # empty.
2925 &quot;a_key&quot;: &quot;A String&quot;,
2926 },
2927 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
2928 # Specified using the full or partial URL. For instance template, specify
2929 # only the resource policy name.
2930 &quot;A String&quot;,
2931 ],
2932 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
2933 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
2934 # is required.
2935 #
2936 # To create a disk with one of the public operating system
2937 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
2938 #
2939 # projects/debian-cloud/global/images/family/debian-9
2940 #
2941 #
2942 # Alternatively, use a specific version of a public operating system image:
2943 #
2944 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
2945 #
2946 #
2947 # To create a disk with a custom image that you created, specify the
2948 # image name in the following format:
2949 #
2950 # global/images/my-custom-image
2951 #
2952 #
2953 # You can also specify a custom image by its image family, which returns
2954 # the latest version of the image in that family. Replace the image name
2955 # with family/family-name:
2956 #
2957 # global/images/family/my-image-family
2958 #
2959 #
2960 # If the source image is deleted later, this field will not be set.
2961 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
2962 # encryption key of the source image. Required if the source image is
2963 # protected by a customer-supplied encryption key.
2964 #
2965 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
2966 # encryption keys, so you cannot create disks for instances in a managed instance group if the
2967 # source images are encrypted with your own keys.
2968 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2969 # For example:
2970 #
2971 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2972 # key_region/cryptoKeys/key
2973 #
2974 # The fully-qualifed key name may be returned for resource GET requests. For
2975 # example:
2976 #
2977 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2978 # key_region/cryptoKeys/key
2979 # /cryptoKeyVersions/1
2980 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2981 # key. If absent, the Compute Engine default service account is used.
2982 # For example:
2983 #
2984 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2985 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2986 # encryption key, encoded in RFC
2987 # 4648 base64 to either encrypt or decrypt this resource. You can
2988 # provide either the rawKey or thersaEncryptedKey.
2989 # For example:
2990 #
2991 # &quot;rawKey&quot;:
2992 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2993 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2994 # customer-supplied encryption key to either encrypt or decrypt this
2995 # resource. You can provide either the rawKey or thersaEncryptedKey.
2996 # For example:
2997 #
2998 # &quot;rsaEncryptedKey&quot;:
2999 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3000 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3001 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3002 #
3003 # The key must meet the following requirements before you can provide it to
3004 # Compute Engine:
3005 #
3006 # 1. The key is wrapped using a RSA public key certificate provided by
3007 # Google.
3008 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3009 # encoding.
3010 #
3011 # Gets the RSA public key certificate provided by Google at:
3012 #
3013 #
3014 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3015 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3016 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3017 # encryption key that protects this resource.
3018 },
3019 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
3020 # instance boot disk, one of initializeParams.sourceSnapshot
3021 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
3022 # is required.
3023 #
3024 # To create a disk with a snapshot that you created, specify the
3025 # snapshot name in the following format:
3026 #
3027 # us-central1-a/instantSnapshots/my-backup
3028 #
3029 #
3030 # If the source instant-snapshot is deleted later, this field will not be
3031 # set.
3032 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
3033 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
3034 # is required.
3035 #
3036 # To create a disk with a snapshot that you created, specify the
3037 # snapshot name in the following format:
3038 #
3039 # global/snapshots/my-backup
3040 #
3041 #
3042 # If the source snapshot is deleted later, this field will not be set.
3043 #
3044 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
3045 # an image instead when you create VMs using
3046 # the bulk
3047 # insert method.
3048 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3049 # encryption key of the source snapshot.
3050 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3051 # For example:
3052 #
3053 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3054 # key_region/cryptoKeys/key
3055 #
3056 # The fully-qualifed key name may be returned for resource GET requests. For
3057 # example:
3058 #
3059 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3060 # key_region/cryptoKeys/key
3061 # /cryptoKeyVersions/1
3062 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3063 # key. If absent, the Compute Engine default service account is used.
3064 # For example:
3065 #
3066 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3067 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3068 # encryption key, encoded in RFC
3069 # 4648 base64 to either encrypt or decrypt this resource. You can
3070 # provide either the rawKey or thersaEncryptedKey.
3071 # For example:
3072 #
3073 # &quot;rawKey&quot;:
3074 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3075 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3076 # customer-supplied encryption key to either encrypt or decrypt this
3077 # resource. You can provide either the rawKey or thersaEncryptedKey.
3078 # For example:
3079 #
3080 # &quot;rsaEncryptedKey&quot;:
3081 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3082 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3083 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3084 #
3085 # The key must meet the following requirements before you can provide it to
3086 # Compute Engine:
3087 #
3088 # 1. The key is wrapped using a RSA public key certificate provided by
3089 # Google.
3090 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3091 # encoding.
3092 #
3093 # Gets the RSA public key certificate provided by Google at:
3094 #
3095 #
3096 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3097 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3098 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3099 # encryption key that protects this resource.
3100 },
3101 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3102 # this as a partial or full URL to the resource. For example, the following
3103 # are valid values:
3104 #
3105 #
3106 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3107 # - projects/project/zones/zone/storagePools/storagePool
3108 # - zones/zone/storagePools/storagePool
3109 },
3110 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
3111 # either SCSI or NVME. For most machine types, the
3112 # default is SCSI. Local SSDs can use either NVME or SCSI.
3113 # In certain configurations, persistent disks can use NVMe. For more
3114 # information, seeAbout
3115 # persistent disks.
3116 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
3117 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
3118 &quot;A String&quot;,
3119 ],
3120 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
3121 # disk is not allowed to be detached from the instance, or to be used as the
3122 # source of the snapshot creation, and the image creation. The instance with
3123 # at least one locked attached disk is not allow to be used as source of
3124 # machine image creation, instant snapshot creation, and not allowed to be
3125 # deleted with --keep-disk parameter set to true for locked disks.
3126 &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
3127 # in READ_WRITE mode.
3128 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
3129 # field is set to PRESERVED if the LocalSSD data has been saved
3130 # to a persistent location by customer request. (see the
3131 # discard_local_ssd option on Stop/Suspend).
3132 # Read-only in the api.
3133 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
3134 # these are public keys which are safe to store in public
3135 &quot;dbs&quot;: [ # The Key Database (db).
3136 {
3137 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3138 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3139 },
3140 ],
3141 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
3142 {
3143 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3144 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3145 },
3146 ],
3147 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
3148 {
3149 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3150 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3151 },
3152 ],
3153 &quot;pk&quot;: { # The Platform Key (PK).
3154 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3155 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3156 },
3157 },
3158 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
3159 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3160 # is required.
3161 #
3162 # If desired, you can also attach existing non-root persistent disks using
3163 # this property. This field is only applicable for persistent disks.
3164 #
3165 # Note that for InstanceTemplate, specify the disk name for zonal disk,
3166 # and the URL for regional disk.
3167 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
3168 },
3169 ],
3170 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
3171 &quot;A String&quot;,
3172 ],
3173 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
3174 # e.g. &#x27;Intel Ice Lake&#x27;.
3175 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
3176 # preference. MIG will first try to create a VM based on the machine-type
3177 # with lowest rank and fallback to next rank based on availability.
3178 # Machine types and instance selections with the same rank have the same
3179 # preference.
3180 },
3181 },
3182 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
3183 # when creating new VMs.
3184 &quot;a_key&quot;: {
3185 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
3186 # selection.
3187 { # An instance-attached disk resource.
3188 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
3189 # or X86_64.
3190 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
3191 # deleted (but not when the disk is detached from the instance).
3192 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
3193 # partition of the disk for its root filesystem.
3194 &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
3195 # running within the instance. This name can be used to reference the device
3196 # for mounting, resizing, and so on, from within the instance.
3197 #
3198 # If not specified, the server chooses a default device name to apply to this
3199 # disk, in the form persistent-disk-x, where x is a number
3200 # assigned by Google Compute Engine. This field is only applicable for
3201 # persistent disks.
3202 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
3203 # encryption key.
3204 #
3205 # If you are creating a new disk, this field encrypts the new disk using
3206 # an encryption key that you provide. If you are attaching an existing
3207 # disk that is already encrypted, this field decrypts the disk using
3208 # the customer-supplied encryption key.
3209 #
3210 # If you encrypt a disk using a customer-supplied key, you must provide the
3211 # same key again when you attempt to use this resource at a later time. For
3212 # example, you must provide the key when you create a snapshot or an image
3213 # from the disk or when you attach the disk to a virtual machine instance.
3214 #
3215 # If you do not provide an encryption key, then the disk will be encrypted
3216 # using an automatically generated key and you do not need to provide a key
3217 # to use the disk later.
3218 #
3219 # Note:
3220 #
3221 # Instance templates do not storecustomer-supplied
3222 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
3223 #
3224 # You cannot create VMs that have disks with customer-supplied keys using
3225 # the bulk
3226 # insert method.
3227 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3228 # For example:
3229 #
3230 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3231 # key_region/cryptoKeys/key
3232 #
3233 # The fully-qualifed key name may be returned for resource GET requests. For
3234 # example:
3235 #
3236 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3237 # key_region/cryptoKeys/key
3238 # /cryptoKeyVersions/1
3239 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3240 # key. If absent, the Compute Engine default service account is used.
3241 # For example:
3242 #
3243 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3244 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3245 # encryption key, encoded in RFC
3246 # 4648 base64 to either encrypt or decrypt this resource. You can
3247 # provide either the rawKey or thersaEncryptedKey.
3248 # For example:
3249 #
3250 # &quot;rawKey&quot;:
3251 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3252 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3253 # customer-supplied encryption key to either encrypt or decrypt this
3254 # resource. You can provide either the rawKey or thersaEncryptedKey.
3255 # For example:
3256 #
3257 # &quot;rsaEncryptedKey&quot;:
3258 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3259 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3260 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3261 #
3262 # The key must meet the following requirements before you can provide it to
3263 # Compute Engine:
3264 #
3265 # 1. The key is wrapped using a RSA public key certificate provided by
3266 # Google.
3267 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3268 # encoding.
3269 #
3270 # Gets the RSA public key certificate provided by Google at:
3271 #
3272 #
3273 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3274 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3275 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3276 # encryption key that protects this resource.
3277 },
3278 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
3279 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
3280 # currently attached to another instance. If you try to force attach a zonal
3281 # disk to an instance, you will receive an error.
3282 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
3283 # only for bootable images. Read
3284 # Enabling guest operating system features to see a list of available
3285 # options.
3286 { # Guest OS features.
3287 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
3288 # separate values. Set to one or more of the following values:
3289 #
3290 # - VIRTIO_SCSI_MULTIQUEUE
3291 # - WINDOWS
3292 # - MULTI_IP_SUBNET
3293 # - UEFI_COMPATIBLE
3294 # - GVNIC
3295 # - SEV_CAPABLE
3296 # - SUSPEND_RESUME_COMPATIBLE
3297 # - SEV_LIVE_MIGRATABLE_V2
3298 # - SEV_SNP_CAPABLE
3299 # - TDX_CAPABLE
3300 # - IDPF
3301 # - SNP_SVSM_CAPABLE
3302 # - CCA_CAPABLE
3303 #
3304 #
3305 # For more information, see
3306 # Enabling guest operating system features.
3307 },
3308 ],
3309 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
3310 # boot disk. If you have many disks attached to an instance, each
3311 # disk would have a unique index number.
3312 &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
3313 # alongside the new instance. Use initialization parameters to create boot
3314 # disks or local SSDs attached to the new instance.
3315 #
3316 # This property is mutually exclusive with the source property;
3317 # you can only define one or the other, but not both.
3318 # alongside the new instance. Use initialization parameters to create boot
3319 # disks or local SSDs attached to the new instance.
3320 #
3321 # This field is persisted and returned for instanceTemplate and not returned
3322 # in the context of instance.
3323 #
3324 # This property is mutually exclusive with the source property;
3325 # you can only define one or the other, but not both.
3326 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
3327 # arm64 or x86_64.
3328 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
3329 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
3330 # of the instance. If a disk with the same name already exists in the given
3331 # region, the existing disk is attached to the new instance and the
3332 # new disk is not created.
3333 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
3334 # 10 GB. If you specify a sourceImage, which is required for
3335 # boot disks, the default size is the size of the sourceImage.
3336 # If you do not specify a sourceImage, the default disk size
3337 # is 500 GB.
3338 &quot;diskType&quot;: &quot;A String&quot;,
3339 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
3340 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
3341 # only for bootable images. Read
3342 # Enabling guest operating system features to see a list of available
3343 # options.
3344 #
3345 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
3346 { # Guest OS features.
3347 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
3348 # separate values. Set to one or more of the following values:
3349 #
3350 # - VIRTIO_SCSI_MULTIQUEUE
3351 # - WINDOWS
3352 # - MULTI_IP_SUBNET
3353 # - UEFI_COMPATIBLE
3354 # - GVNIC
3355 # - SEV_CAPABLE
3356 # - SUSPEND_RESUME_COMPATIBLE
3357 # - SEV_LIVE_MIGRATABLE_V2
3358 # - SEV_SNP_CAPABLE
3359 # - TDX_CAPABLE
3360 # - IDPF
3361 # - SNP_SVSM_CAPABLE
3362 # - CCA_CAPABLE
3363 #
3364 #
3365 # For more information, see
3366 # Enabling guest operating system features.
3367 },
3368 ],
3369 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
3370 # which is either SCSI or NVME. The default isSCSI.
3371 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
3372 # persistent disks.
3373 &quot;a_key&quot;: &quot;A String&quot;,
3374 },
3375 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
3376 # disk.
3377 &quot;A String&quot;,
3378 ],
3379 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
3380 &quot;A String&quot;,
3381 ],
3382 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
3383 # more than one instance.
3384 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
3385 # is to use the existing disk.
3386 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
3387 # of I/O operations per second that the disk can handle. Values must be
3388 # between 10,000 and 120,000. For more details, see theExtreme persistent
3389 # disk documentation.
3390 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
3391 # number of throughput mb per second that the disk can handle. Values must
3392 # greater than or equal to 1.
3393 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
3394 # the URLs of the zones where the disk should be replicated to.
3395 # You must provide exactly two replica zones, and one zone must be the same
3396 # as the instance zone.
3397 &quot;A String&quot;,
3398 ],
3399 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
3400 # have the same definition as resource
3401 # manager tags. Keys and values can be either in numeric format,
3402 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
3403 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
3404 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
3405 # empty.
3406 &quot;a_key&quot;: &quot;A String&quot;,
3407 },
3408 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
3409 # Specified using the full or partial URL. For instance template, specify
3410 # only the resource policy name.
3411 &quot;A String&quot;,
3412 ],
3413 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
3414 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3415 # is required.
3416 #
3417 # To create a disk with one of the public operating system
3418 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
3419 #
3420 # projects/debian-cloud/global/images/family/debian-9
3421 #
3422 #
3423 # Alternatively, use a specific version of a public operating system image:
3424 #
3425 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
3426 #
3427 #
3428 # To create a disk with a custom image that you created, specify the
3429 # image name in the following format:
3430 #
3431 # global/images/my-custom-image
3432 #
3433 #
3434 # You can also specify a custom image by its image family, which returns
3435 # the latest version of the image in that family. Replace the image name
3436 # with family/family-name:
3437 #
3438 # global/images/family/my-image-family
3439 #
3440 #
3441 # If the source image is deleted later, this field will not be set.
3442 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
3443 # encryption key of the source image. Required if the source image is
3444 # protected by a customer-supplied encryption key.
3445 #
3446 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
3447 # encryption keys, so you cannot create disks for instances in a managed instance group if the
3448 # source images are encrypted with your own keys.
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;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
3501 # instance boot disk, one of initializeParams.sourceSnapshot
3502 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
3503 # is required.
3504 #
3505 # To create a disk with a snapshot that you created, specify the
3506 # snapshot name in the following format:
3507 #
3508 # us-central1-a/instantSnapshots/my-backup
3509 #
3510 #
3511 # If the source instant-snapshot is deleted later, this field will not be
3512 # set.
3513 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
3514 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
3515 # is required.
3516 #
3517 # To create a disk with a snapshot that you created, specify the
3518 # snapshot name in the following format:
3519 #
3520 # global/snapshots/my-backup
3521 #
3522 #
3523 # If the source snapshot is deleted later, this field will not be set.
3524 #
3525 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
3526 # an image instead when you create VMs using
3527 # the bulk
3528 # insert method.
3529 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
3530 # encryption key of the source snapshot.
3531 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3532 # For example:
3533 #
3534 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3535 # key_region/cryptoKeys/key
3536 #
3537 # The fully-qualifed key name may be returned for resource GET requests. For
3538 # example:
3539 #
3540 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3541 # key_region/cryptoKeys/key
3542 # /cryptoKeyVersions/1
3543 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3544 # key. If absent, the Compute Engine default service account is used.
3545 # For example:
3546 #
3547 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3548 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3549 # encryption key, encoded in RFC
3550 # 4648 base64 to either encrypt or decrypt this resource. You can
3551 # provide either the rawKey or thersaEncryptedKey.
3552 # For example:
3553 #
3554 # &quot;rawKey&quot;:
3555 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3556 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3557 # customer-supplied encryption key to either encrypt or decrypt this
3558 # resource. You can provide either the rawKey or thersaEncryptedKey.
3559 # For example:
3560 #
3561 # &quot;rsaEncryptedKey&quot;:
3562 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3563 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3564 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3565 #
3566 # The key must meet the following requirements before you can provide it to
3567 # Compute Engine:
3568 #
3569 # 1. The key is wrapped using a RSA public key certificate provided by
3570 # Google.
3571 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3572 # encoding.
3573 #
3574 # Gets the RSA public key certificate provided by Google at:
3575 #
3576 #
3577 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3578 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3579 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3580 # encryption key that protects this resource.
3581 },
3582 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3583 # this as a partial or full URL to the resource. For example, the following
3584 # are valid values:
3585 #
3586 #
3587 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3588 # - projects/project/zones/zone/storagePools/storagePool
3589 # - zones/zone/storagePools/storagePool
3590 },
3591 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
3592 # either SCSI or NVME. For most machine types, the
3593 # default is SCSI. Local SSDs can use either NVME or SCSI.
3594 # In certain configurations, persistent disks can use NVMe. For more
3595 # information, seeAbout
3596 # persistent disks.
3597 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
3598 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
3599 &quot;A String&quot;,
3600 ],
3601 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
3602 # disk is not allowed to be detached from the instance, or to be used as the
3603 # source of the snapshot creation, and the image creation. The instance with
3604 # at least one locked attached disk is not allow to be used as source of
3605 # machine image creation, instant snapshot creation, and not allowed to be
3606 # deleted with --keep-disk parameter set to true for locked disks.
3607 &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
3608 # in READ_WRITE mode.
3609 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
3610 # field is set to PRESERVED if the LocalSSD data has been saved
3611 # to a persistent location by customer request. (see the
3612 # discard_local_ssd option on Stop/Suspend).
3613 # Read-only in the api.
3614 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
3615 # these are public keys which are safe to store in public
3616 &quot;dbs&quot;: [ # The Key Database (db).
3617 {
3618 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3619 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3620 },
3621 ],
3622 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
3623 {
3624 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3625 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3626 },
3627 ],
3628 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
3629 {
3630 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3631 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3632 },
3633 ],
3634 &quot;pk&quot;: { # The Platform Key (PK).
3635 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3636 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3637 },
3638 },
3639 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
3640 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3641 # is required.
3642 #
3643 # If desired, you can also attach existing non-root persistent disks using
3644 # this property. This field is only applicable for persistent disks.
3645 #
3646 # Note that for InstanceTemplate, specify the disk name for zonal disk,
3647 # and the URL for regional disk.
3648 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
3649 },
3650 ],
3651 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
3652 &quot;A String&quot;,
3653 ],
3654 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
3655 # e.g. &#x27;Intel Ice Lake&#x27;.
3656 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
3657 # preference. MIG will first try to create a VM based on the machine-type
3658 # with lowest rank and fallback to next rank based on availability.
3659 # Machine types and instance selections with the same rank have the same
3660 # preference.
3661 },
3662 },
3663 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
3664 # create instances.
3665 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
3666 # more preemption than the minimum capacity user needs. MIG will create
3667 # only Standard VMs until it reaches standard_capacity_base and only
3668 # then will start using standard_capacity_percent_above_base to mix Spot
3669 # with Standard VMs.
3670 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
3671 # remaining percentage will use Spot VMs. The percentage applies only to
3672 # the capacity above standard_capacity_base.
3673 },
3674 },
3675 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
3676 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
3677 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
3678 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
3679 # applies to the VMs on which your application fails a health check.
3680 # Valid values are
3681 #
3682 # - REPAIR (default): MIG automatically repairs a failed VM
3683 # by recreating it. For more information, see About
3684 # repairing VMs in a MIG.
3685 # - DO_NOTHING: MIG does not repair a failed VM.
3686 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
3687 # configuration when repairing a VM. Valid options are:
3688 #
3689 #
3690 #
3691 # - NO (default): If configuration updates are available, they are not
3692 # forcefully applied during repair. Instead, configuration updates are
3693 # applied according to the group&#x27;s update policy.
3694 #
3695 # - YES: If configuration updates are available, they are applied
3696 # during repair.
3697 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
3698 # instance during initialization when stopping / suspending an instance.
3699 # The Instance Group Manager will wait for a signal that indicates
3700 # successful initialization before stopping / suspending an instance.
3701 #
3702 # If a successful readiness signal is not sent before timeout, the
3703 # corresponding instance will not be stopped / suspended. Instead,
3704 # an error will be visible in the lastAttempt.errors field of
3705 # the managed instance in the listmanagedinstances
3706 # method.
3707 #
3708 # If metadataBasedReadinessSignal.timeoutSec is unset,
3709 # the Instance Group Manager will directly proceed to suspend / stop
3710 # instances, skipping initialization on them.
3711 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
3712 # initialization before timing out.
3713 },
3714 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
3715 # unhealthy when the application running on that VM fails a health check.
3716 # Valid values are:
3717 #
3718 # - DEFAULT_ACTION (default): MIG uses the same action
3719 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
3720 # - REPAIR: MIG automatically repairs an unhealthy VM by
3721 # recreating it.
3722 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
3723 # For more information, see
3724 # About repairing VMs in a MIG.
3725 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
3726 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
3727 # Valid values are:
3728 #
3729 # - NO (default): MIG cannot change a VM&#x27;s zone during a
3730 # repair.
3731 # - YES: MIG can select a different zone for the VM during
3732 # a repair.
3733 },
3734 },
3735 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
3736 # instance group. The group uses this template to create all new instances
3737 # in the managed instance group. The templates for existing instances in the
3738 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
3739 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
3740 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
3741 # this managed instance group.
3742 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
3743 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
3744 # long, and comply withRFC1035.
3745 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
3746 # to this Instance Group Manager.
3747 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
3748 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
3749 # The name must be 1-63 characters long, and comply withRFC1035.
3750 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
3751 },
3752 ],
3753 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
3754 # as part of resource payload.
3755 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
3756 # key-value pairs. Keys and values can be either in numeric format,
3757 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
3758 # format such as `{org_id|project_id}/{tag_key_short_name}` and
3759 # `{tag_value_short_name}`. For more information, seeManage tags
3760 # for resources.
3761 &quot;a_key&quot;: &quot;A String&quot;,
3762 },
3763 },
3764 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
3765 # where the managed instance group resides (for regional resources).
3766 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
3767 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
3768 # instance group.
3769 # It can be a full or partial URL. For example, the following are
3770 # all valid URLs to a workload policy:
3771 #
3772 #
3773 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
3774 # - projects/project/regions/region/resourcePolicies/resourcePolicy
3775 # - regions/region/resourcePolicies/resourcePolicy
3776 },
3777 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
3778 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
3779 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
3780 # this URL.
3781 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
3782 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
3783 # by the managed instance group on instances. The service accounts needs all
3784 # permissions required to create and delete instances.
3785 # By default, the service account
3786 # {projectNumber}@cloudservices.gserviceaccount.com is used.
3787 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
3788 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
3789 # stop a VM after that VM was created. The initial delay gives the
3790 # initialization script the time to prepare your VM for a quick scale out.
3791 # The value of initial delay must be between 0 and 3600 seconds. The
3792 # default value is 0.
3793 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
3794 # group scales out. The default mode is `MANUAL`.
3795 },
3796 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
3797 &quot;preservedState&quot;: { # Configuration of preserved resources.
3798 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
3799 # delete, update, etc. This map is keyed with the device names of
3800 # the disks.
3801 &quot;a_key&quot;: {
3802 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
3803 # update or VM instance recreate operations.
3804 # This flag is used to configure if the disk should be deleted after it
3805 # is no longer used by the group, e.g. when the given instance or
3806 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
3807 },
3808 },
3809 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
3810 # instance delete, update, etc. This map is keyed with the network
3811 # interface name.
3812 &quot;a_key&quot;: {
3813 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
3814 # update or VM instance recreate operations.
3815 # This flag is used to configure if the IP reservation should be deleted
3816 # after it is no longer used by the group, e.g. when the given instance
3817 # or the whole group is deleted.
3818 },
3819 },
3820 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
3821 # instance delete, update, etc. This map is keyed with the network
3822 # interface name.
3823 &quot;a_key&quot;: {
3824 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
3825 # update or VM instance recreate operations.
3826 # This flag is used to configure if the IP reservation should be deleted
3827 # after it is no longer used by the group, e.g. when the given instance
3828 # or the whole group is deleted.
3829 },
3830 },
3831 },
3832 },
3833 &quot;status&quot;: { # Output only. The status of this managed instance group.
3834 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
3835 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
3836 # This value is in RFC3339 text format.
3837 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
3838 # been applied to all managed instances in the group.
3839 },
3840 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
3841 # Currently only one accelerator topology is supported.
3842 {
3843 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
3844 # The value is the same as configured in the WorkloadPolicy.
3845 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
3846 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
3847 # check.
3848 &quot;error&quot;: { # Output only. Encountered errors.
3849 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3850 # operation.
3851 {
3852 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3853 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3854 # details. There is a set of defined message types to use for providing
3855 # details.The syntax depends on the error code. For example,
3856 # QuotaExceededInfo will have details when the error code is
3857 # QUOTA_EXCEEDED.
3858 {
3859 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3860 #
3861 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3862 # is not enabled:
3863 #
3864 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3865 # &quot;domain&quot;: &quot;googleapis.com&quot;
3866 # &quot;metadata&quot;: {
3867 # &quot;resource&quot;: &quot;projects/123&quot;,
3868 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3869 # }
3870 # }
3871 #
3872 # This response indicates that the pubsub.googleapis.com API is not enabled.
3873 #
3874 # Example of an error that is returned when attempting to create a Spanner
3875 # instance in a region that is out of stock:
3876 #
3877 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3878 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3879 # &quot;metadata&quot;: {
3880 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3881 # }
3882 # }
3883 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3884 # is typically the registered service name of the tool or product that
3885 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3886 # generated by some common infrastructure, the error domain must be a
3887 # globally unique value that identifies the infrastructure. For Google API
3888 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3889 &quot;metadatas&quot;: { # Additional structured details about this error.
3890 #
3891 # Keys must match a regular expression of `a-z+` but should
3892 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3893 # length. When identifying the current value of an exceeded limit, the units
3894 # should be contained in the key, not the value. For example, rather than
3895 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3896 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3897 # instances that can be created in a single (batch) request.
3898 &quot;a_key&quot;: &quot;A String&quot;,
3899 },
3900 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3901 # proximate cause of the error. Error reasons are unique within a particular
3902 # domain of errors. This should be at most 63 characters and match a
3903 # regular expression of `A-Z+[A-Z0-9]`, which represents
3904 # UPPER_SNAKE_CASE.
3905 },
3906 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3907 #
3908 # For example, if a quota check failed with an error indicating the calling
3909 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3910 # directly to the right place in the developer console to flip the bit.
3911 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3912 { # Describes a URL link.
3913 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3914 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3915 },
3916 ],
3917 },
3918 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3919 # which can be attached to an RPC error.
3920 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3921 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3922 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3923 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3924 },
3925 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3926 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3927 &quot;a_key&quot;: &quot;A String&quot;,
3928 },
3929 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3930 # type or metric.
3931 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3932 # or metric.
3933 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3934 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3935 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3936 },
3937 },
3938 ],
3939 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3940 # This property is optional.
3941 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3942 },
3943 ],
3944 },
3945 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
3946 # has // RFC3339 //
3947 # text format.
3948 },
3949 },
3950 ],
3951 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
3952 # that targets this instance group manager.
3953 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
3954 # targetSizePolicy.mode is set to BULK.
3955 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
3956 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
3957 # operation.
3958 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
3959 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3960 # operation.
3961 {
3962 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3963 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3964 # details. There is a set of defined message types to use for providing
3965 # details.The syntax depends on the error code. For example,
3966 # QuotaExceededInfo will have details when the error code is
3967 # QUOTA_EXCEEDED.
3968 {
3969 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3970 #
3971 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3972 # is not enabled:
3973 #
3974 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3975 # &quot;domain&quot;: &quot;googleapis.com&quot;
3976 # &quot;metadata&quot;: {
3977 # &quot;resource&quot;: &quot;projects/123&quot;,
3978 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3979 # }
3980 # }
3981 #
3982 # This response indicates that the pubsub.googleapis.com API is not enabled.
3983 #
3984 # Example of an error that is returned when attempting to create a Spanner
3985 # instance in a region that is out of stock:
3986 #
3987 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3988 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3989 # &quot;metadata&quot;: {
3990 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3991 # }
3992 # }
3993 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3994 # is typically the registered service name of the tool or product that
3995 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3996 # generated by some common infrastructure, the error domain must be a
3997 # globally unique value that identifies the infrastructure. For Google API
3998 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3999 &quot;metadatas&quot;: { # Additional structured details about this error.
4000 #
4001 # Keys must match a regular expression of `a-z+` but should
4002 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4003 # length. When identifying the current value of an exceeded limit, the units
4004 # should be contained in the key, not the value. For example, rather than
4005 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4006 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4007 # instances that can be created in a single (batch) request.
4008 &quot;a_key&quot;: &quot;A String&quot;,
4009 },
4010 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4011 # proximate cause of the error. Error reasons are unique within a particular
4012 # domain of errors. This should be at most 63 characters and match a
4013 # regular expression of `A-Z+[A-Z0-9]`, which represents
4014 # UPPER_SNAKE_CASE.
4015 },
4016 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4017 #
4018 # For example, if a quota check failed with an error indicating the calling
4019 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4020 # directly to the right place in the developer console to flip the bit.
4021 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4022 { # Describes a URL link.
4023 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4024 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4025 },
4026 ],
4027 },
4028 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4029 # which can be attached to an RPC error.
4030 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4031 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4032 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4033 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4034 },
4035 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4036 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4037 &quot;a_key&quot;: &quot;A String&quot;,
4038 },
4039 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4040 # type or metric.
4041 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4042 # or metric.
4043 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4044 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4045 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4046 },
4047 },
4048 ],
4049 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4050 # This property is optional.
4051 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4052 },
4053 ],
4054 },
4055 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
4056 # operation. Timestamp is in RFC3339 text format.
4057 },
4058 },
4059 &quot;currentInstanceStatuses&quot;: { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
4060 # in this managed instance group that have the status. Currently only shown
4061 # for TPU MIGs
4062 # instance group that have the status. For more information about how to
4063 # interpret each status check the instance lifecycle documentation.
4064 # Currently only shown for TPU MIGs.
4065 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
4066 # that have DEPROVISIONING status.
4067 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
4068 # have been deleted. Includes only instances that would be shown in the
4069 # listManagedInstances method and not all instances that have been
4070 # deleted in the lifetime of the MIG.
4071 # Does not include FlexStart instances that are waiting for the resources
4072 # availability, they are considered as &#x27;pending&#x27;.
4073 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
4074 # that have PENDING status, that is FlexStart instances that are waiting
4075 # for resources. Instances that do not exist because of the other reasons
4076 # are counted as &#x27;non_existent&#x27;.
4077 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
4078 # that have PENDING_STOP status.
4079 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
4080 # that have PROVISIONING status.
4081 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
4082 # that have REPAIRING status.
4083 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
4084 # that have RUNNING status.
4085 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
4086 # that have STAGING status.
4087 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
4088 # that have STOPPED status.
4089 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
4090 # that have STOPPING status.
4091 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
4092 # that have SUSPENDED status.
4093 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
4094 # that have SUSPENDING status.
4095 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
4096 # that have TERMINATED status.
4097 },
4098 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
4099 # stable state. A stable state means that: none of the instances in the
4100 # managed instance group is currently undergoing any type of change (for
4101 # example, creation, restart, or deletion); no future changes are scheduled
4102 # for instances in the managed instance group; and the managed instance
4103 # group itself is not being modified.
4104 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
4105 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
4106 # has stateful configuration, that is, if you have configured any items
4107 # in a stateful policy or in per-instance configs.
4108 # The group might report that it has no stateful configuration even when
4109 # there is still some preserved state on a managed instance, for example,
4110 # if you have deleted all PICs but not yet applied those deletions.
4111 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
4112 # has stateful configuration, that is, if you have configured any items
4113 # in a stateful policy or in per-instance configs.
4114 # The group might report that it has no stateful configuration even when
4115 # there is still some preserved state on a managed instance, for example,
4116 # if you have deleted all PICs but not yet applied those deletions. This
4117 # field is deprecated in favor of has_stateful_config.
4118 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
4119 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
4120 # (listed in the output of a listPerInstanceConfigs API call) have
4121 # status EFFECTIVE or there are no per-instance-configs.
4122 },
4123 },
4124 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
4125 # target version specified by version field on Instance Group
4126 # Manager.
4127 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
4128 # in this managed instance group, i.e. all instances are in their target
4129 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
4130 },
4131 },
4132 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
4133 # apply to all of the instances in the managed instance group.
4134 &quot;A String&quot;,
4135 ],
4136 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
4137 # You can reduce this number by using the instanceGroupManager
4138 # deleteInstances or abandonInstances methods. Resizing the group also
4139 # changes this number.
4140 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
4141 # size.
4142 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
4143 # individually or all at once.
4144 },
4145 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
4146 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
4147 # This number changes when you:
4148 #
4149 # - Stop instance using the stopInstances
4150 # method or start instances using the startInstances
4151 # method.
4152 # - Manually change the targetStoppedSize using the update
4153 # method.
4154 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
4155 # This number changes when you:
4156 #
4157 # - Suspend instance using the suspendInstances
4158 # method or resume instances using the resumeInstances
4159 # method.
4160 # - Manually change the targetSuspendedSize using the update
4161 # method.
4162 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
4163 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
4164 &quot;A String&quot;,
4165 ],
4166 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
4167 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
4168 # instance redistribution policy for regional managed instance groups.
4169 # Valid values are:
4170 #
4171 # - PROACTIVE (default): The group attempts to maintain an
4172 # even distribution of VM instances across zones in the region.
4173 # - NONE: For non-autoscaled groups, proactive
4174 # redistribution is disabled.
4175 &quot;maxSurge&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
4176 # either a fixed number or, if the group has 10 or more instances, a
4177 # percentage. If you set a percentage, the number of instances is rounded
4178 # if necessary. The default value for maxSurge is a fixed
4179 # value equal to the number of zones in which the managed instance group
4180 # operates.
4181 #
4182 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
4183 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
4184 #
4185 #
4186 #
4187 # - If the value is fixed, then the calculated
4188 # value is equal to the fixed value.
4189 # - If the value is a percent, then the
4190 # calculated
4191 # value is percent/100 * targetSize. For example,
4192 # the calculated value of a 80% of a managed instance group
4193 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
4194 # is a remainder, the number is rounded.
4195 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
4196 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
4197 # example, specify 80 for 80%.
4198 },
4199 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
4200 # process. An instance is considered available if all of the following
4201 # conditions are satisfied:
4202 #
4203 #
4204 #
4205 # - The instance&#x27;s status is
4206 # RUNNING.
4207 # - If there is a health
4208 # check on the instance group, the instance&#x27;s health check status
4209 # must be HEALTHY at least once. If there is no health check
4210 # on the group, then the instance only needs to have a status of
4211 # RUNNING to be considered available.
4212 #
4213 #
4214 # This value can be either a fixed number or, if the group has 10 or more
4215 # instances, a percentage. If you set a percentage, the number of instances
4216 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
4217 # in which the managed instance group operates.
4218 #
4219 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
4220 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
4221 #
4222 #
4223 #
4224 # - If the value is fixed, then the calculated
4225 # value is equal to the fixed value.
4226 # - If the value is a percent, then the
4227 # calculated
4228 # value is percent/100 * targetSize. For example,
4229 # the calculated value of a 80% of a managed instance group
4230 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
4231 # is a remainder, the number is rounded.
4232 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
4233 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
4234 # example, specify 80 for 80%.
4235 },
4236 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
4237 # becomes available. This value must be from range [0, 3600].
4238 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
4239 # disruption as much as possible or to apply a more disruptive action than
4240 # is necessary.
4241 #
4242 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
4243 # Compute Engine performs the necessary action to execute the update.
4244 # - To apply a more disruptive action than is strictly necessary, set the
4245 # minimal action to RESTART or REPLACE. For
4246 # example, Compute Engine does not need to restart a VM to change its
4247 # metadata. But if your application reads instance metadata only when a VM
4248 # is restarted, you can set the minimal action to RESTART in
4249 # order to pick up metadata changes.
4250 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
4251 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
4252 # as much as possible. RESTART to allow actions that can be
4253 # applied without instance replacing or REPLACE to allow all
4254 # possible actions. If the Updater determines that the minimal update
4255 # action needed is more disruptive than most disruptive allowed action you
4256 # specify it will not perform the update at all.
4257 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
4258 # See minimal_action.REPLACE
4259 &quot;type&quot;: &quot;A String&quot;, # The type
4260 # of update process. You can specify either PROACTIVE so
4261 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
4262 # to update.
4263 },
4264 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
4265 # create instances.
4266 #
4267 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
4268 # group. This field overrides the top-level instanceTemplate
4269 # field. Read more about therelationships
4270 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
4271 # remaining instances. For more information, read aboutcanary
4272 # updates.
4273 {
4274 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
4275 # instance group. The group uses this template to create new instances in
4276 # the managed instance group until the `targetSize` for this version is
4277 # reached. The templates for existing instances in the group do not change
4278 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
4279 # existing instances are updated until the `targetSize` for this version is
4280 # reached.
4281 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
4282 # managed instance group.
4283 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
4284 # even if instance_template remains unchanged.
4285 # Deprecated in favor of &#x27;name&#x27;.
4286 &quot;targetSize&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
4287 # from the template will be equal to:
4288 #
4289 #
4290 # - If expressed as a fixed number, the minimum of either
4291 # targetSize.fixed or
4292 # instanceGroupManager.targetSize is used.
4293 # - if expressed as a percent, the targetSize
4294 # would be (targetSize.percent/100 *
4295 # InstanceGroupManager.targetSize) If there is a remainder, the
4296 # number is rounded.
4297 #
4298 # If unset, this version will update any remaining instances not
4299 # updated by another version. ReadStarting
4300 # a canary update for more information.
4301 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
4302 #
4303 #
4304 #
4305 # - If the value is fixed, then the calculated
4306 # value is equal to the fixed value.
4307 # - If the value is a percent, then the
4308 # calculated
4309 # value is percent/100 * targetSize. For example,
4310 # the calculated value of a 80% of a managed instance group
4311 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
4312 # is a remainder, the number is rounded.
4313 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
4314 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
4315 # example, specify 80 for 80%.
4316 },
4317 },
4318 ],
4319 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
4320 # where the managed instance group is located (for zonal resources).
4321 }</pre>
4322 </div>
4323
4324 <div class="method">
4325 <code class="details" id="insert">insert(project, region, body=None, requestId=None, x__xgafv=None)</code>
4326 <pre>Creates a managed instance group using the information that you specify
4327 in the request. After the group is created, instances in the group are
4328 created using the specified instance template.
4329 This operation is marked as DONE when the group is created
4330 even if the instances in the group have not yet been created. You must
4331 separately verify the status of the individual instances with thelistmanagedinstances
4332 method.
4333
4334 A regional managed instance group can contain up to 2000 instances.
4335
4336 Args:
4337 project: string, Project ID for this request. (required)
4338 region: string, Name of the region scoping this request. (required)
4339 body: object, The request body.
4340 The object takes the form of:
4341
4342 { # Represents a Managed Instance Group resource.
4343 #
4344 # An instance group is a collection of VM instances that you can manage as a
4345 # single entity. For more information, readInstance groups.
4346 #
4347 # For zonal Managed Instance Group, use the instanceGroupManagers
4348 # resource.
4349 #
4350 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
4351 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
4352 # for the group.
4353 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
4354 #
4355 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
4356 # instances to apply the configuration. To apply the configuration, set the
4357 # group&#x27;s updatePolicy.type field to use proactive updates or
4358 # use the applyUpdatesToInstances method.
4359 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
4360 &quot;a_key&quot;: &quot;A String&quot;,
4361 },
4362 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
4363 # more information, see Project and
4364 # instance metadata.
4365 &quot;a_key&quot;: &quot;A String&quot;,
4366 },
4367 },
4368 },
4369 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
4370 # only one value.
4371 {
4372 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
4373 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
4374 # this field controls whether to trigger VM autohealing based on a failed
4375 # health check. Valid values are:
4376 #
4377 # - ON (default): The group recreates running VMs that
4378 # fail the application-based health check.
4379 # - OFF: When set to OFF, you can still observe instance
4380 # health state, but the group does not recreate VMs that fail the
4381 # application-based health check. This is useful for troubleshooting and
4382 # setting up your health check configuration.
4383 },
4384 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
4385 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
4386 # initialize and run its startup script. During a VM&#x27;s initial delay
4387 # period, the MIG ignores unsuccessful health checks because the VM might
4388 # be in the startup process. This prevents the MIG from prematurely
4389 # recreating a VM. If the health check receives a healthy response during
4390 # the initial delay, it indicates that the startup process is complete and
4391 # the VM is ready. The value of initial delay must be between 0 and 3600
4392 # seconds. The default value is 0.
4393 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
4394 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
4395 # The instance is considered available if all of the following conditions
4396 # are satisfied:
4397 # 1. Instance&#x27;s status is RUNNING.
4398 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
4399 # check result was observed to be HEALTHY at least once as it passed
4400 # VERIFYING).
4401 # 3. There is no outgoing action on an instance triggered by IGM.
4402 #
4403 # By default, number of concurrently autohealed instances is smaller than
4404 # the managed instance group target size. However, if a zonal managed
4405 # instance group has only one instance, or a regional managed instance
4406 # group has only one instance per zone, autohealing will recreate these
4407 # instances when they become unhealthy.
4408 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
4409 #
4410 #
4411 #
4412 # - If the value is fixed, then the calculated
4413 # value is equal to the fixed value.
4414 # - If the value is a percent, then the
4415 # calculated
4416 # value is percent/100 * targetSize. For example,
4417 # the calculated value of a 80% of a managed instance group
4418 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
4419 # is a remainder, the number is rounded.
4420 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
4421 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
4422 # example, specify 80 for 80%.
4423 },
4424 },
4425 ],
4426 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
4427 # all VMs in a MIG. The maximum character length is 58 and the name must
4428 # comply with RFC1035 format.
4429 #
4430 # When a VM is created in the group, the MIG appends a hyphen and a random
4431 # four-character string to the base instance name. If you want the MIG to
4432 # assign sequential numbers instead of a random string, then end the base
4433 # instance name with a hyphen followed by one or more hash symbols. The hash
4434 # symbols indicate the number of digits. For example, a base instance name of
4435 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
4436 # @pattern
4437 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
4438 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
4439 # text format.
4440 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
4441 # in this managed instance group that are scheduled for each of those
4442 # actions.
4443 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
4444 # that are scheduled to be abandoned. Abandoning an instance removes it
4445 # from the managed instance group without deleting it.
4446 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
4447 # are scheduled to be adopted or are currently being adopted.
4448 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
4449 # are scheduled to be created or are currently being created. If the group
4450 # fails to create any of these instances, it tries again until it creates
4451 # the instance successfully.
4452 #
4453 # If you have disabled creation retries, this field will not be populated;
4454 # instead, the creatingWithoutRetries field will be populated.
4455 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
4456 # will attempt to create atomically, in a batch mode. If the desired count
4457 # of instances can not be created, entire batch will be deleted and the
4458 # group will decrease its targetSize value accordingly.
4459 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
4460 # will attempt to create. The group attempts to create each instance
4461 # only once. If the group fails to create any of these instances, it
4462 # decreases the group&#x27;s targetSize value accordingly.
4463 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
4464 # are scheduled to be deleted or are currently being deleted.
4465 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
4466 # are running and have no scheduled actions.
4467 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
4468 # is currently queuing.
4469 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
4470 # are scheduled to be recreated or are currently being being recreated.
4471 # Recreating an instance deletes the existing root persistent disk
4472 # and creates a new disk from the image that is defined in the
4473 # instance template.
4474 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
4475 # are being reconfigured with properties that do not require a restart
4476 # or a recreate action. For example, setting or removing target
4477 # pools for the instance.
4478 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
4479 # are scheduled to be restarted or are currently being restarted.
4480 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
4481 # are scheduled to be restarted or are currently being restarted.
4482 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
4483 # are scheduled to be resumed or are currently being resumed.
4484 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
4485 # are scheduled to be started or are currently being started.
4486 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
4487 # are scheduled to be stopped or are currently being stopped.
4488 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
4489 # are scheduled to be suspended or are currently being suspended.
4490 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
4491 # are being verified. See the managedInstances[].currentAction
4492 # property in the listManagedInstances method documentation.
4493 },
4494 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
4495 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
4496 # zones in a regional managed instance group.
4497 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
4498 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
4499 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
4500 # its instances.
4501 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
4502 # instances, even if an AI zone is available in the specified region. To
4503 # create instances in an AI zone in the selected region, you must explicitly
4504 # specify it in the distribution policy together with the other preferred
4505 # zones.
4506 {
4507 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
4508 # The zone must exist in the region where the managed instance group is
4509 # located.
4510 },
4511 ],
4512 },
4513 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
4514 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
4515 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
4516 # fingerprint must be provided in order to update the InstanceGroupManager,
4517 # otherwise the request will fail with error412 conditionNotMet.
4518 #
4519 # To see the latest fingerprint, make a get() request to
4520 # retrieve an InstanceGroupManager.
4521 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
4522 # generates this identifier.
4523 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
4524 # types of machines.
4525 # Instance flexibility configuration on MIG overrides instance
4526 # template configuration.
4527 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
4528 # when creating new VMs.
4529 &quot;a_key&quot;: {
4530 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
4531 # selection.
4532 { # An instance-attached disk resource.
4533 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
4534 # or X86_64.
4535 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
4536 # deleted (but not when the disk is detached from the instance).
4537 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
4538 # partition of the disk for its root filesystem.
4539 &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
4540 # running within the instance. This name can be used to reference the device
4541 # for mounting, resizing, and so on, from within the instance.
4542 #
4543 # If not specified, the server chooses a default device name to apply to this
4544 # disk, in the form persistent-disk-x, where x is a number
4545 # assigned by Google Compute Engine. This field is only applicable for
4546 # persistent disks.
4547 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
4548 # encryption key.
4549 #
4550 # If you are creating a new disk, this field encrypts the new disk using
4551 # an encryption key that you provide. If you are attaching an existing
4552 # disk that is already encrypted, this field decrypts the disk using
4553 # the customer-supplied encryption key.
4554 #
4555 # If you encrypt a disk using a customer-supplied key, you must provide the
4556 # same key again when you attempt to use this resource at a later time. For
4557 # example, you must provide the key when you create a snapshot or an image
4558 # from the disk or when you attach the disk to a virtual machine instance.
4559 #
4560 # If you do not provide an encryption key, then the disk will be encrypted
4561 # using an automatically generated key and you do not need to provide a key
4562 # to use the disk later.
4563 #
4564 # Note:
4565 #
4566 # Instance templates do not storecustomer-supplied
4567 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
4568 #
4569 # You cannot create VMs that have disks with customer-supplied keys using
4570 # the bulk
4571 # insert method.
4572 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4573 # For example:
4574 #
4575 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4576 # key_region/cryptoKeys/key
4577 #
4578 # The fully-qualifed key name may be returned for resource GET requests. For
4579 # example:
4580 #
4581 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4582 # key_region/cryptoKeys/key
4583 # /cryptoKeyVersions/1
4584 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4585 # key. If absent, the Compute Engine default service account is used.
4586 # For example:
4587 #
4588 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4589 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4590 # encryption key, encoded in RFC
4591 # 4648 base64 to either encrypt or decrypt this resource. You can
4592 # provide either the rawKey or thersaEncryptedKey.
4593 # For example:
4594 #
4595 # &quot;rawKey&quot;:
4596 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4597 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4598 # customer-supplied encryption key to either encrypt or decrypt this
4599 # resource. You can provide either the rawKey or thersaEncryptedKey.
4600 # For example:
4601 #
4602 # &quot;rsaEncryptedKey&quot;:
4603 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4604 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4605 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4606 #
4607 # The key must meet the following requirements before you can provide it to
4608 # Compute Engine:
4609 #
4610 # 1. The key is wrapped using a RSA public key certificate provided by
4611 # Google.
4612 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4613 # encoding.
4614 #
4615 # Gets the RSA public key certificate provided by Google at:
4616 #
4617 #
4618 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4619 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4620 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4621 # encryption key that protects this resource.
4622 },
4623 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
4624 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
4625 # currently attached to another instance. If you try to force attach a zonal
4626 # disk to an instance, you will receive an error.
4627 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4628 # only for bootable images. Read
4629 # Enabling guest operating system features to see a list of available
4630 # options.
4631 { # Guest OS features.
4632 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4633 # separate values. Set to one or more of the following values:
4634 #
4635 # - VIRTIO_SCSI_MULTIQUEUE
4636 # - WINDOWS
4637 # - MULTI_IP_SUBNET
4638 # - UEFI_COMPATIBLE
4639 # - GVNIC
4640 # - SEV_CAPABLE
4641 # - SUSPEND_RESUME_COMPATIBLE
4642 # - SEV_LIVE_MIGRATABLE_V2
4643 # - SEV_SNP_CAPABLE
4644 # - TDX_CAPABLE
4645 # - IDPF
4646 # - SNP_SVSM_CAPABLE
4647 # - CCA_CAPABLE
4648 #
4649 #
4650 # For more information, see
4651 # Enabling guest operating system features.
4652 },
4653 ],
4654 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
4655 # boot disk. If you have many disks attached to an instance, each
4656 # disk would have a unique index number.
4657 &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
4658 # alongside the new instance. Use initialization parameters to create boot
4659 # disks or local SSDs attached to the new instance.
4660 #
4661 # This property is mutually exclusive with the source property;
4662 # you can only define one or the other, but not both.
4663 # alongside the new instance. Use initialization parameters to create boot
4664 # disks or local SSDs attached to the new instance.
4665 #
4666 # This field is persisted and returned for instanceTemplate and not returned
4667 # in the context of instance.
4668 #
4669 # This property is mutually exclusive with the source property;
4670 # you can only define one or the other, but not both.
4671 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
4672 # arm64 or x86_64.
4673 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
4674 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
4675 # of the instance. If a disk with the same name already exists in the given
4676 # region, the existing disk is attached to the new instance and the
4677 # new disk is not created.
4678 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
4679 # 10 GB. If you specify a sourceImage, which is required for
4680 # boot disks, the default size is the size of the sourceImage.
4681 # If you do not specify a sourceImage, the default disk size
4682 # is 500 GB.
4683 &quot;diskType&quot;: &quot;A String&quot;,
4684 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
4685 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4686 # only for bootable images. Read
4687 # Enabling guest operating system features to see a list of available
4688 # options.
4689 #
4690 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
4691 { # Guest OS features.
4692 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4693 # separate values. Set to one or more of the following values:
4694 #
4695 # - VIRTIO_SCSI_MULTIQUEUE
4696 # - WINDOWS
4697 # - MULTI_IP_SUBNET
4698 # - UEFI_COMPATIBLE
4699 # - GVNIC
4700 # - SEV_CAPABLE
4701 # - SUSPEND_RESUME_COMPATIBLE
4702 # - SEV_LIVE_MIGRATABLE_V2
4703 # - SEV_SNP_CAPABLE
4704 # - TDX_CAPABLE
4705 # - IDPF
4706 # - SNP_SVSM_CAPABLE
4707 # - CCA_CAPABLE
4708 #
4709 #
4710 # For more information, see
4711 # Enabling guest operating system features.
4712 },
4713 ],
4714 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
4715 # which is either SCSI or NVME. The default isSCSI.
4716 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
4717 # persistent disks.
4718 &quot;a_key&quot;: &quot;A String&quot;,
4719 },
4720 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
4721 # disk.
4722 &quot;A String&quot;,
4723 ],
4724 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
4725 &quot;A String&quot;,
4726 ],
4727 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
4728 # more than one instance.
4729 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
4730 # is to use the existing disk.
4731 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
4732 # of I/O operations per second that the disk can handle. Values must be
4733 # between 10,000 and 120,000. For more details, see theExtreme persistent
4734 # disk documentation.
4735 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
4736 # number of throughput mb per second that the disk can handle. Values must
4737 # greater than or equal to 1.
4738 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
4739 # the URLs of the zones where the disk should be replicated to.
4740 # You must provide exactly two replica zones, and one zone must be the same
4741 # as the instance zone.
4742 &quot;A String&quot;,
4743 ],
4744 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
4745 # have the same definition as resource
4746 # manager tags. Keys and values can be either in numeric format,
4747 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4748 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4749 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
4750 # empty.
4751 &quot;a_key&quot;: &quot;A String&quot;,
4752 },
4753 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
4754 # Specified using the full or partial URL. For instance template, specify
4755 # only the resource policy name.
4756 &quot;A String&quot;,
4757 ],
4758 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
4759 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4760 # is required.
4761 #
4762 # To create a disk with one of the public operating system
4763 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
4764 #
4765 # projects/debian-cloud/global/images/family/debian-9
4766 #
4767 #
4768 # Alternatively, use a specific version of a public operating system image:
4769 #
4770 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
4771 #
4772 #
4773 # To create a disk with a custom image that you created, specify the
4774 # image name in the following format:
4775 #
4776 # global/images/my-custom-image
4777 #
4778 #
4779 # You can also specify a custom image by its image family, which returns
4780 # the latest version of the image in that family. Replace the image name
4781 # with family/family-name:
4782 #
4783 # global/images/family/my-image-family
4784 #
4785 #
4786 # If the source image is deleted later, this field will not be set.
4787 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
4788 # encryption key of the source image. Required if the source image is
4789 # protected by a customer-supplied encryption key.
4790 #
4791 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
4792 # encryption keys, so you cannot create disks for instances in a managed instance group if the
4793 # source images are encrypted with your own keys.
4794 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4795 # For example:
4796 #
4797 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4798 # key_region/cryptoKeys/key
4799 #
4800 # The fully-qualifed key name may be returned for resource GET requests. For
4801 # example:
4802 #
4803 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4804 # key_region/cryptoKeys/key
4805 # /cryptoKeyVersions/1
4806 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4807 # key. If absent, the Compute Engine default service account is used.
4808 # For example:
4809 #
4810 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4811 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4812 # encryption key, encoded in RFC
4813 # 4648 base64 to either encrypt or decrypt this resource. You can
4814 # provide either the rawKey or thersaEncryptedKey.
4815 # For example:
4816 #
4817 # &quot;rawKey&quot;:
4818 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4819 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4820 # customer-supplied encryption key to either encrypt or decrypt this
4821 # resource. You can provide either the rawKey or thersaEncryptedKey.
4822 # For example:
4823 #
4824 # &quot;rsaEncryptedKey&quot;:
4825 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4826 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4827 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4828 #
4829 # The key must meet the following requirements before you can provide it to
4830 # Compute Engine:
4831 #
4832 # 1. The key is wrapped using a RSA public key certificate provided by
4833 # Google.
4834 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4835 # encoding.
4836 #
4837 # Gets the RSA public key certificate provided by Google at:
4838 #
4839 #
4840 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4841 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4842 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4843 # encryption key that protects this resource.
4844 },
4845 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
4846 # instance boot disk, one of initializeParams.sourceSnapshot
4847 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
4848 # is required.
4849 #
4850 # To create a disk with a snapshot that you created, specify the
4851 # snapshot name in the following format:
4852 #
4853 # us-central1-a/instantSnapshots/my-backup
4854 #
4855 #
4856 # If the source instant-snapshot is deleted later, this field will not be
4857 # set.
4858 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
4859 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
4860 # is required.
4861 #
4862 # To create a disk with a snapshot that you created, specify the
4863 # snapshot name in the following format:
4864 #
4865 # global/snapshots/my-backup
4866 #
4867 #
4868 # If the source snapshot is deleted later, this field will not be set.
4869 #
4870 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
4871 # an image instead when you create VMs using
4872 # the bulk
4873 # insert method.
4874 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
4875 # encryption key of the source snapshot.
4876 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4877 # For example:
4878 #
4879 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4880 # key_region/cryptoKeys/key
4881 #
4882 # The fully-qualifed key name may be returned for resource GET requests. For
4883 # example:
4884 #
4885 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4886 # key_region/cryptoKeys/key
4887 # /cryptoKeyVersions/1
4888 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4889 # key. If absent, the Compute Engine default service account is used.
4890 # For example:
4891 #
4892 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4893 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4894 # encryption key, encoded in RFC
4895 # 4648 base64 to either encrypt or decrypt this resource. You can
4896 # provide either the rawKey or thersaEncryptedKey.
4897 # For example:
4898 #
4899 # &quot;rawKey&quot;:
4900 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4901 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4902 # customer-supplied encryption key to either encrypt or decrypt this
4903 # resource. You can provide either the rawKey or thersaEncryptedKey.
4904 # For example:
4905 #
4906 # &quot;rsaEncryptedKey&quot;:
4907 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4908 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4909 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4910 #
4911 # The key must meet the following requirements before you can provide it to
4912 # Compute Engine:
4913 #
4914 # 1. The key is wrapped using a RSA public key certificate provided by
4915 # Google.
4916 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4917 # encoding.
4918 #
4919 # Gets the RSA public key certificate provided by Google at:
4920 #
4921 #
4922 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4923 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4924 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4925 # encryption key that protects this resource.
4926 },
4927 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
4928 # this as a partial or full URL to the resource. For example, the following
4929 # are valid values:
4930 #
4931 #
4932 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
4933 # - projects/project/zones/zone/storagePools/storagePool
4934 # - zones/zone/storagePools/storagePool
4935 },
4936 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
4937 # either SCSI or NVME. For most machine types, the
4938 # default is SCSI. Local SSDs can use either NVME or SCSI.
4939 # In certain configurations, persistent disks can use NVMe. For more
4940 # information, seeAbout
4941 # persistent disks.
4942 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
4943 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
4944 &quot;A String&quot;,
4945 ],
4946 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
4947 # disk is not allowed to be detached from the instance, or to be used as the
4948 # source of the snapshot creation, and the image creation. The instance with
4949 # at least one locked attached disk is not allow to be used as source of
4950 # machine image creation, instant snapshot creation, and not allowed to be
4951 # deleted with --keep-disk parameter set to true for locked disks.
4952 &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
4953 # in READ_WRITE mode.
4954 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
4955 # field is set to PRESERVED if the LocalSSD data has been saved
4956 # to a persistent location by customer request. (see the
4957 # discard_local_ssd option on Stop/Suspend).
4958 # Read-only in the api.
4959 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
4960 # these are public keys which are safe to store in public
4961 &quot;dbs&quot;: [ # The Key Database (db).
4962 {
4963 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4964 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4965 },
4966 ],
4967 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
4968 {
4969 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4970 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4971 },
4972 ],
4973 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
4974 {
4975 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4976 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4977 },
4978 ],
4979 &quot;pk&quot;: { # The Platform Key (PK).
4980 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4981 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4982 },
4983 },
4984 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
4985 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4986 # is required.
4987 #
4988 # If desired, you can also attach existing non-root persistent disks using
4989 # this property. This field is only applicable for persistent disks.
4990 #
4991 # Note that for InstanceTemplate, specify the disk name for zonal disk,
4992 # and the URL for regional disk.
4993 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
4994 },
4995 ],
4996 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
4997 &quot;A String&quot;,
4998 ],
4999 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
5000 # e.g. &#x27;Intel Ice Lake&#x27;.
5001 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
5002 # preference. MIG will first try to create a VM based on the machine-type
5003 # with lowest rank and fallback to next rank based on availability.
5004 # Machine types and instance selections with the same rank have the same
5005 # preference.
5006 },
5007 },
5008 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
5009 # when creating new VMs.
5010 &quot;a_key&quot;: {
5011 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
5012 # selection.
5013 { # An instance-attached disk resource.
5014 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
5015 # or X86_64.
5016 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
5017 # deleted (but not when the disk is detached from the instance).
5018 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
5019 # partition of the disk for its root filesystem.
5020 &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
5021 # running within the instance. This name can be used to reference the device
5022 # for mounting, resizing, and so on, from within the instance.
5023 #
5024 # If not specified, the server chooses a default device name to apply to this
5025 # disk, in the form persistent-disk-x, where x is a number
5026 # assigned by Google Compute Engine. This field is only applicable for
5027 # persistent disks.
5028 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
5029 # encryption key.
5030 #
5031 # If you are creating a new disk, this field encrypts the new disk using
5032 # an encryption key that you provide. If you are attaching an existing
5033 # disk that is already encrypted, this field decrypts the disk using
5034 # the customer-supplied encryption key.
5035 #
5036 # If you encrypt a disk using a customer-supplied key, you must provide the
5037 # same key again when you attempt to use this resource at a later time. For
5038 # example, you must provide the key when you create a snapshot or an image
5039 # from the disk or when you attach the disk to a virtual machine instance.
5040 #
5041 # If you do not provide an encryption key, then the disk will be encrypted
5042 # using an automatically generated key and you do not need to provide a key
5043 # to use the disk later.
5044 #
5045 # Note:
5046 #
5047 # Instance templates do not storecustomer-supplied
5048 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
5049 #
5050 # You cannot create VMs that have disks with customer-supplied keys using
5051 # the bulk
5052 # insert method.
5053 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5054 # For example:
5055 #
5056 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5057 # key_region/cryptoKeys/key
5058 #
5059 # The fully-qualifed key name may be returned for resource GET requests. For
5060 # example:
5061 #
5062 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5063 # key_region/cryptoKeys/key
5064 # /cryptoKeyVersions/1
5065 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5066 # key. If absent, the Compute Engine default service account is used.
5067 # For example:
5068 #
5069 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5070 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5071 # encryption key, encoded in RFC
5072 # 4648 base64 to either encrypt or decrypt this resource. You can
5073 # provide either the rawKey or thersaEncryptedKey.
5074 # For example:
5075 #
5076 # &quot;rawKey&quot;:
5077 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5078 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5079 # customer-supplied encryption key to either encrypt or decrypt this
5080 # resource. You can provide either the rawKey or thersaEncryptedKey.
5081 # For example:
5082 #
5083 # &quot;rsaEncryptedKey&quot;:
5084 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5085 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5086 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5087 #
5088 # The key must meet the following requirements before you can provide it to
5089 # Compute Engine:
5090 #
5091 # 1. The key is wrapped using a RSA public key certificate provided by
5092 # Google.
5093 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5094 # encoding.
5095 #
5096 # Gets the RSA public key certificate provided by Google at:
5097 #
5098 #
5099 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5100 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5101 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5102 # encryption key that protects this resource.
5103 },
5104 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
5105 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
5106 # currently attached to another instance. If you try to force attach a zonal
5107 # disk to an instance, you will receive an error.
5108 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5109 # only for bootable images. Read
5110 # Enabling guest operating system features to see a list of available
5111 # options.
5112 { # Guest OS features.
5113 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5114 # separate values. Set to one or more of the following values:
5115 #
5116 # - VIRTIO_SCSI_MULTIQUEUE
5117 # - WINDOWS
5118 # - MULTI_IP_SUBNET
5119 # - UEFI_COMPATIBLE
5120 # - GVNIC
5121 # - SEV_CAPABLE
5122 # - SUSPEND_RESUME_COMPATIBLE
5123 # - SEV_LIVE_MIGRATABLE_V2
5124 # - SEV_SNP_CAPABLE
5125 # - TDX_CAPABLE
5126 # - IDPF
5127 # - SNP_SVSM_CAPABLE
5128 # - CCA_CAPABLE
5129 #
5130 #
5131 # For more information, see
5132 # Enabling guest operating system features.
5133 },
5134 ],
5135 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
5136 # boot disk. If you have many disks attached to an instance, each
5137 # disk would have a unique index number.
5138 &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
5139 # alongside the new instance. Use initialization parameters to create boot
5140 # disks or local SSDs attached to the new instance.
5141 #
5142 # This property is mutually exclusive with the source property;
5143 # you can only define one or the other, but not both.
5144 # alongside the new instance. Use initialization parameters to create boot
5145 # disks or local SSDs attached to the new instance.
5146 #
5147 # This field is persisted and returned for instanceTemplate and not returned
5148 # in the context of instance.
5149 #
5150 # This property is mutually exclusive with the source property;
5151 # you can only define one or the other, but not both.
5152 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
5153 # arm64 or x86_64.
5154 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
5155 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
5156 # of the instance. If a disk with the same name already exists in the given
5157 # region, the existing disk is attached to the new instance and the
5158 # new disk is not created.
5159 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
5160 # 10 GB. If you specify a sourceImage, which is required for
5161 # boot disks, the default size is the size of the sourceImage.
5162 # If you do not specify a sourceImage, the default disk size
5163 # is 500 GB.
5164 &quot;diskType&quot;: &quot;A String&quot;,
5165 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
5166 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5167 # only for bootable images. Read
5168 # Enabling guest operating system features to see a list of available
5169 # options.
5170 #
5171 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
5172 { # Guest OS features.
5173 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5174 # separate values. Set to one or more of the following values:
5175 #
5176 # - VIRTIO_SCSI_MULTIQUEUE
5177 # - WINDOWS
5178 # - MULTI_IP_SUBNET
5179 # - UEFI_COMPATIBLE
5180 # - GVNIC
5181 # - SEV_CAPABLE
5182 # - SUSPEND_RESUME_COMPATIBLE
5183 # - SEV_LIVE_MIGRATABLE_V2
5184 # - SEV_SNP_CAPABLE
5185 # - TDX_CAPABLE
5186 # - IDPF
5187 # - SNP_SVSM_CAPABLE
5188 # - CCA_CAPABLE
5189 #
5190 #
5191 # For more information, see
5192 # Enabling guest operating system features.
5193 },
5194 ],
5195 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
5196 # which is either SCSI or NVME. The default isSCSI.
5197 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
5198 # persistent disks.
5199 &quot;a_key&quot;: &quot;A String&quot;,
5200 },
5201 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
5202 # disk.
5203 &quot;A String&quot;,
5204 ],
5205 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
5206 &quot;A String&quot;,
5207 ],
5208 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
5209 # more than one instance.
5210 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
5211 # is to use the existing disk.
5212 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
5213 # of I/O operations per second that the disk can handle. Values must be
5214 # between 10,000 and 120,000. For more details, see theExtreme persistent
5215 # disk documentation.
5216 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
5217 # number of throughput mb per second that the disk can handle. Values must
5218 # greater than or equal to 1.
5219 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
5220 # the URLs of the zones where the disk should be replicated to.
5221 # You must provide exactly two replica zones, and one zone must be the same
5222 # as the instance zone.
5223 &quot;A String&quot;,
5224 ],
5225 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
5226 # have the same definition as resource
5227 # manager tags. Keys and values can be either in numeric format,
5228 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
5229 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
5230 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
5231 # empty.
5232 &quot;a_key&quot;: &quot;A String&quot;,
5233 },
5234 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
5235 # Specified using the full or partial URL. For instance template, specify
5236 # only the resource policy name.
5237 &quot;A String&quot;,
5238 ],
5239 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
5240 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5241 # is required.
5242 #
5243 # To create a disk with one of the public operating system
5244 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
5245 #
5246 # projects/debian-cloud/global/images/family/debian-9
5247 #
5248 #
5249 # Alternatively, use a specific version of a public operating system image:
5250 #
5251 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
5252 #
5253 #
5254 # To create a disk with a custom image that you created, specify the
5255 # image name in the following format:
5256 #
5257 # global/images/my-custom-image
5258 #
5259 #
5260 # You can also specify a custom image by its image family, which returns
5261 # the latest version of the image in that family. Replace the image name
5262 # with family/family-name:
5263 #
5264 # global/images/family/my-image-family
5265 #
5266 #
5267 # If the source image is deleted later, this field will not be set.
5268 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
5269 # encryption key of the source image. Required if the source image is
5270 # protected by a customer-supplied encryption key.
5271 #
5272 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
5273 # encryption keys, so you cannot create disks for instances in a managed instance group if the
5274 # source images are encrypted with your own keys.
5275 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5276 # For example:
5277 #
5278 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5279 # key_region/cryptoKeys/key
5280 #
5281 # The fully-qualifed key name may be returned for resource GET requests. For
5282 # example:
5283 #
5284 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5285 # key_region/cryptoKeys/key
5286 # /cryptoKeyVersions/1
5287 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5288 # key. If absent, the Compute Engine default service account is used.
5289 # For example:
5290 #
5291 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5292 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5293 # encryption key, encoded in RFC
5294 # 4648 base64 to either encrypt or decrypt this resource. You can
5295 # provide either the rawKey or thersaEncryptedKey.
5296 # For example:
5297 #
5298 # &quot;rawKey&quot;:
5299 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5300 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5301 # customer-supplied encryption key to either encrypt or decrypt this
5302 # resource. You can provide either the rawKey or thersaEncryptedKey.
5303 # For example:
5304 #
5305 # &quot;rsaEncryptedKey&quot;:
5306 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5307 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5308 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5309 #
5310 # The key must meet the following requirements before you can provide it to
5311 # Compute Engine:
5312 #
5313 # 1. The key is wrapped using a RSA public key certificate provided by
5314 # Google.
5315 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5316 # encoding.
5317 #
5318 # Gets the RSA public key certificate provided by Google at:
5319 #
5320 #
5321 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5322 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5323 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5324 # encryption key that protects this resource.
5325 },
5326 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
5327 # instance boot disk, one of initializeParams.sourceSnapshot
5328 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
5329 # is required.
5330 #
5331 # To create a disk with a snapshot that you created, specify the
5332 # snapshot name in the following format:
5333 #
5334 # us-central1-a/instantSnapshots/my-backup
5335 #
5336 #
5337 # If the source instant-snapshot is deleted later, this field will not be
5338 # set.
5339 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
5340 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
5341 # is required.
5342 #
5343 # To create a disk with a snapshot that you created, specify the
5344 # snapshot name in the following format:
5345 #
5346 # global/snapshots/my-backup
5347 #
5348 #
5349 # If the source snapshot is deleted later, this field will not be set.
5350 #
5351 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
5352 # an image instead when you create VMs using
5353 # the bulk
5354 # insert method.
5355 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
5356 # encryption key of the source snapshot.
5357 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5358 # For example:
5359 #
5360 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5361 # key_region/cryptoKeys/key
5362 #
5363 # The fully-qualifed key name may be returned for resource GET requests. For
5364 # example:
5365 #
5366 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5367 # key_region/cryptoKeys/key
5368 # /cryptoKeyVersions/1
5369 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5370 # key. If absent, the Compute Engine default service account is used.
5371 # For example:
5372 #
5373 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5374 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5375 # encryption key, encoded in RFC
5376 # 4648 base64 to either encrypt or decrypt this resource. You can
5377 # provide either the rawKey or thersaEncryptedKey.
5378 # For example:
5379 #
5380 # &quot;rawKey&quot;:
5381 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5382 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5383 # customer-supplied encryption key to either encrypt or decrypt this
5384 # resource. You can provide either the rawKey or thersaEncryptedKey.
5385 # For example:
5386 #
5387 # &quot;rsaEncryptedKey&quot;:
5388 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5389 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5390 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5391 #
5392 # The key must meet the following requirements before you can provide it to
5393 # Compute Engine:
5394 #
5395 # 1. The key is wrapped using a RSA public key certificate provided by
5396 # Google.
5397 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5398 # encoding.
5399 #
5400 # Gets the RSA public key certificate provided by Google at:
5401 #
5402 #
5403 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5404 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5405 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5406 # encryption key that protects this resource.
5407 },
5408 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
5409 # this as a partial or full URL to the resource. For example, the following
5410 # are valid values:
5411 #
5412 #
5413 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
5414 # - projects/project/zones/zone/storagePools/storagePool
5415 # - zones/zone/storagePools/storagePool
5416 },
5417 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
5418 # either SCSI or NVME. For most machine types, the
5419 # default is SCSI. Local SSDs can use either NVME or SCSI.
5420 # In certain configurations, persistent disks can use NVMe. For more
5421 # information, seeAbout
5422 # persistent disks.
5423 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
5424 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
5425 &quot;A String&quot;,
5426 ],
5427 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
5428 # disk is not allowed to be detached from the instance, or to be used as the
5429 # source of the snapshot creation, and the image creation. The instance with
5430 # at least one locked attached disk is not allow to be used as source of
5431 # machine image creation, instant snapshot creation, and not allowed to be
5432 # deleted with --keep-disk parameter set to true for locked disks.
5433 &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
5434 # in READ_WRITE mode.
5435 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
5436 # field is set to PRESERVED if the LocalSSD data has been saved
5437 # to a persistent location by customer request. (see the
5438 # discard_local_ssd option on Stop/Suspend).
5439 # Read-only in the api.
5440 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
5441 # these are public keys which are safe to store in public
5442 &quot;dbs&quot;: [ # The Key Database (db).
5443 {
5444 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5445 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5446 },
5447 ],
5448 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
5449 {
5450 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5451 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5452 },
5453 ],
5454 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
5455 {
5456 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5457 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5458 },
5459 ],
5460 &quot;pk&quot;: { # The Platform Key (PK).
5461 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5462 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5463 },
5464 },
5465 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
5466 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5467 # is required.
5468 #
5469 # If desired, you can also attach existing non-root persistent disks using
5470 # this property. This field is only applicable for persistent disks.
5471 #
5472 # Note that for InstanceTemplate, specify the disk name for zonal disk,
5473 # and the URL for regional disk.
5474 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
5475 },
5476 ],
5477 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
5478 &quot;A String&quot;,
5479 ],
5480 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
5481 # e.g. &#x27;Intel Ice Lake&#x27;.
5482 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
5483 # preference. MIG will first try to create a VM based on the machine-type
5484 # with lowest rank and fallback to next rank based on availability.
5485 # Machine types and instance selections with the same rank have the same
5486 # preference.
5487 },
5488 },
5489 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
5490 # create instances.
5491 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
5492 # more preemption than the minimum capacity user needs. MIG will create
5493 # only Standard VMs until it reaches standard_capacity_base and only
5494 # then will start using standard_capacity_percent_above_base to mix Spot
5495 # with Standard VMs.
5496 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
5497 # remaining percentage will use Spot VMs. The percentage applies only to
5498 # the capacity above standard_capacity_base.
5499 },
5500 },
5501 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
5502 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
5503 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
5504 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
5505 # applies to the VMs on which your application fails a health check.
5506 # Valid values are
5507 #
5508 # - REPAIR (default): MIG automatically repairs a failed VM
5509 # by recreating it. For more information, see About
5510 # repairing VMs in a MIG.
5511 # - DO_NOTHING: MIG does not repair a failed VM.
5512 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
5513 # configuration when repairing a VM. Valid options are:
5514 #
5515 #
5516 #
5517 # - NO (default): If configuration updates are available, they are not
5518 # forcefully applied during repair. Instead, configuration updates are
5519 # applied according to the group&#x27;s update policy.
5520 #
5521 # - YES: If configuration updates are available, they are applied
5522 # during repair.
5523 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
5524 # instance during initialization when stopping / suspending an instance.
5525 # The Instance Group Manager will wait for a signal that indicates
5526 # successful initialization before stopping / suspending an instance.
5527 #
5528 # If a successful readiness signal is not sent before timeout, the
5529 # corresponding instance will not be stopped / suspended. Instead,
5530 # an error will be visible in the lastAttempt.errors field of
5531 # the managed instance in the listmanagedinstances
5532 # method.
5533 #
5534 # If metadataBasedReadinessSignal.timeoutSec is unset,
5535 # the Instance Group Manager will directly proceed to suspend / stop
5536 # instances, skipping initialization on them.
5537 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
5538 # initialization before timing out.
5539 },
5540 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
5541 # unhealthy when the application running on that VM fails a health check.
5542 # Valid values are:
5543 #
5544 # - DEFAULT_ACTION (default): MIG uses the same action
5545 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
5546 # - REPAIR: MIG automatically repairs an unhealthy VM by
5547 # recreating it.
5548 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
5549 # For more information, see
5550 # About repairing VMs in a MIG.
5551 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
5552 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
5553 # Valid values are:
5554 #
5555 # - NO (default): MIG cannot change a VM&#x27;s zone during a
5556 # repair.
5557 # - YES: MIG can select a different zone for the VM during
5558 # a repair.
5559 },
5560 },
5561 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
5562 # instance group. The group uses this template to create all new instances
5563 # in the managed instance group. The templates for existing instances in the
5564 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
5565 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
5566 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
5567 # this managed instance group.
5568 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
5569 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
5570 # long, and comply withRFC1035.
5571 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
5572 # to this Instance Group Manager.
5573 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
5574 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
5575 # The name must be 1-63 characters long, and comply withRFC1035.
5576 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
5577 },
5578 ],
5579 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
5580 # as part of resource payload.
5581 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
5582 # key-value pairs. Keys and values can be either in numeric format,
5583 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
5584 # format such as `{org_id|project_id}/{tag_key_short_name}` and
5585 # `{tag_value_short_name}`. For more information, seeManage tags
5586 # for resources.
5587 &quot;a_key&quot;: &quot;A String&quot;,
5588 },
5589 },
5590 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
5591 # where the managed instance group resides (for regional resources).
5592 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
5593 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
5594 # instance group.
5595 # It can be a full or partial URL. For example, the following are
5596 # all valid URLs to a workload policy:
5597 #
5598 #
5599 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
5600 # - projects/project/regions/region/resourcePolicies/resourcePolicy
5601 # - regions/region/resourcePolicies/resourcePolicy
5602 },
5603 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
5604 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
5605 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
5606 # this URL.
5607 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
5608 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
5609 # by the managed instance group on instances. The service accounts needs all
5610 # permissions required to create and delete instances.
5611 # By default, the service account
5612 # {projectNumber}@cloudservices.gserviceaccount.com is used.
5613 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
5614 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
5615 # stop a VM after that VM was created. The initial delay gives the
5616 # initialization script the time to prepare your VM for a quick scale out.
5617 # The value of initial delay must be between 0 and 3600 seconds. The
5618 # default value is 0.
5619 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
5620 # group scales out. The default mode is `MANUAL`.
5621 },
5622 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
5623 &quot;preservedState&quot;: { # Configuration of preserved resources.
5624 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
5625 # delete, update, etc. This map is keyed with the device names of
5626 # the disks.
5627 &quot;a_key&quot;: {
5628 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
5629 # update or VM instance recreate operations.
5630 # This flag is used to configure if the disk should be deleted after it
5631 # is no longer used by the group, e.g. when the given instance or
5632 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
5633 },
5634 },
5635 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
5636 # instance delete, update, etc. This map is keyed with the network
5637 # interface name.
5638 &quot;a_key&quot;: {
5639 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
5640 # update or VM instance recreate operations.
5641 # This flag is used to configure if the IP reservation should be deleted
5642 # after it is no longer used by the group, e.g. when the given instance
5643 # or the whole group is deleted.
5644 },
5645 },
5646 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
5647 # instance delete, update, etc. This map is keyed with the network
5648 # interface name.
5649 &quot;a_key&quot;: {
5650 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
5651 # update or VM instance recreate operations.
5652 # This flag is used to configure if the IP reservation should be deleted
5653 # after it is no longer used by the group, e.g. when the given instance
5654 # or the whole group is deleted.
5655 },
5656 },
5657 },
5658 },
5659 &quot;status&quot;: { # Output only. The status of this managed instance group.
5660 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
5661 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
5662 # This value is in RFC3339 text format.
5663 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
5664 # been applied to all managed instances in the group.
5665 },
5666 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
5667 # Currently only one accelerator topology is supported.
5668 {
5669 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
5670 # The value is the same as configured in the WorkloadPolicy.
5671 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
5672 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
5673 # check.
5674 &quot;error&quot;: { # Output only. Encountered errors.
5675 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
5676 # operation.
5677 {
5678 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
5679 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
5680 # details. There is a set of defined message types to use for providing
5681 # details.The syntax depends on the error code. For example,
5682 # QuotaExceededInfo will have details when the error code is
5683 # QUOTA_EXCEEDED.
5684 {
5685 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
5686 #
5687 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
5688 # is not enabled:
5689 #
5690 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
5691 # &quot;domain&quot;: &quot;googleapis.com&quot;
5692 # &quot;metadata&quot;: {
5693 # &quot;resource&quot;: &quot;projects/123&quot;,
5694 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
5695 # }
5696 # }
5697 #
5698 # This response indicates that the pubsub.googleapis.com API is not enabled.
5699 #
5700 # Example of an error that is returned when attempting to create a Spanner
5701 # instance in a region that is out of stock:
5702 #
5703 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
5704 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
5705 # &quot;metadata&quot;: {
5706 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
5707 # }
5708 # }
5709 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
5710 # is typically the registered service name of the tool or product that
5711 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
5712 # generated by some common infrastructure, the error domain must be a
5713 # globally unique value that identifies the infrastructure. For Google API
5714 # infrastructure, the error domain is &quot;googleapis.com&quot;.
5715 &quot;metadatas&quot;: { # Additional structured details about this error.
5716 #
5717 # Keys must match a regular expression of `a-z+` but should
5718 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
5719 # length. When identifying the current value of an exceeded limit, the units
5720 # should be contained in the key, not the value. For example, rather than
5721 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
5722 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
5723 # instances that can be created in a single (batch) request.
5724 &quot;a_key&quot;: &quot;A String&quot;,
5725 },
5726 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
5727 # proximate cause of the error. Error reasons are unique within a particular
5728 # domain of errors. This should be at most 63 characters and match a
5729 # regular expression of `A-Z+[A-Z0-9]`, which represents
5730 # UPPER_SNAKE_CASE.
5731 },
5732 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
5733 #
5734 # For example, if a quota check failed with an error indicating the calling
5735 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
5736 # directly to the right place in the developer console to flip the bit.
5737 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
5738 { # Describes a URL link.
5739 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
5740 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
5741 },
5742 ],
5743 },
5744 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
5745 # which can be attached to an RPC error.
5746 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
5747 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
5748 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
5749 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
5750 },
5751 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
5752 &quot;dimensions&quot;: { # The map holding related quota dimensions.
5753 &quot;a_key&quot;: &quot;A String&quot;,
5754 },
5755 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
5756 # type or metric.
5757 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
5758 # or metric.
5759 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
5760 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
5761 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
5762 },
5763 },
5764 ],
5765 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
5766 # This property is optional.
5767 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
5768 },
5769 ],
5770 },
5771 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
5772 # has // RFC3339 //
5773 # text format.
5774 },
5775 },
5776 ],
5777 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
5778 # that targets this instance group manager.
5779 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
5780 # targetSizePolicy.mode is set to BULK.
5781 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
5782 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
5783 # operation.
5784 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
5785 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
5786 # operation.
5787 {
5788 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
5789 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
5790 # details. There is a set of defined message types to use for providing
5791 # details.The syntax depends on the error code. For example,
5792 # QuotaExceededInfo will have details when the error code is
5793 # QUOTA_EXCEEDED.
5794 {
5795 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
5796 #
5797 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
5798 # is not enabled:
5799 #
5800 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
5801 # &quot;domain&quot;: &quot;googleapis.com&quot;
5802 # &quot;metadata&quot;: {
5803 # &quot;resource&quot;: &quot;projects/123&quot;,
5804 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
5805 # }
5806 # }
5807 #
5808 # This response indicates that the pubsub.googleapis.com API is not enabled.
5809 #
5810 # Example of an error that is returned when attempting to create a Spanner
5811 # instance in a region that is out of stock:
5812 #
5813 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
5814 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
5815 # &quot;metadata&quot;: {
5816 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
5817 # }
5818 # }
5819 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
5820 # is typically the registered service name of the tool or product that
5821 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
5822 # generated by some common infrastructure, the error domain must be a
5823 # globally unique value that identifies the infrastructure. For Google API
5824 # infrastructure, the error domain is &quot;googleapis.com&quot;.
5825 &quot;metadatas&quot;: { # Additional structured details about this error.
5826 #
5827 # Keys must match a regular expression of `a-z+` but should
5828 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
5829 # length. When identifying the current value of an exceeded limit, the units
5830 # should be contained in the key, not the value. For example, rather than
5831 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
5832 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
5833 # instances that can be created in a single (batch) request.
5834 &quot;a_key&quot;: &quot;A String&quot;,
5835 },
5836 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
5837 # proximate cause of the error. Error reasons are unique within a particular
5838 # domain of errors. This should be at most 63 characters and match a
5839 # regular expression of `A-Z+[A-Z0-9]`, which represents
5840 # UPPER_SNAKE_CASE.
5841 },
5842 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
5843 #
5844 # For example, if a quota check failed with an error indicating the calling
5845 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
5846 # directly to the right place in the developer console to flip the bit.
5847 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
5848 { # Describes a URL link.
5849 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
5850 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
5851 },
5852 ],
5853 },
5854 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
5855 # which can be attached to an RPC error.
5856 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
5857 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
5858 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
5859 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
5860 },
5861 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
5862 &quot;dimensions&quot;: { # The map holding related quota dimensions.
5863 &quot;a_key&quot;: &quot;A String&quot;,
5864 },
5865 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
5866 # type or metric.
5867 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
5868 # or metric.
5869 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
5870 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
5871 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
5872 },
5873 },
5874 ],
5875 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
5876 # This property is optional.
5877 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
5878 },
5879 ],
5880 },
5881 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
5882 # operation. Timestamp is in RFC3339 text format.
5883 },
5884 },
5885 &quot;currentInstanceStatuses&quot;: { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
5886 # in this managed instance group that have the status. Currently only shown
5887 # for TPU MIGs
5888 # instance group that have the status. For more information about how to
5889 # interpret each status check the instance lifecycle documentation.
5890 # Currently only shown for TPU MIGs.
5891 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
5892 # that have DEPROVISIONING status.
5893 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
5894 # have been deleted. Includes only instances that would be shown in the
5895 # listManagedInstances method and not all instances that have been
5896 # deleted in the lifetime of the MIG.
5897 # Does not include FlexStart instances that are waiting for the resources
5898 # availability, they are considered as &#x27;pending&#x27;.
5899 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
5900 # that have PENDING status, that is FlexStart instances that are waiting
5901 # for resources. Instances that do not exist because of the other reasons
5902 # are counted as &#x27;non_existent&#x27;.
5903 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
5904 # that have PENDING_STOP status.
5905 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
5906 # that have PROVISIONING status.
5907 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
5908 # that have REPAIRING status.
5909 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
5910 # that have RUNNING status.
5911 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
5912 # that have STAGING status.
5913 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
5914 # that have STOPPED status.
5915 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
5916 # that have STOPPING status.
5917 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
5918 # that have SUSPENDED status.
5919 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
5920 # that have SUSPENDING status.
5921 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
5922 # that have TERMINATED status.
5923 },
5924 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
5925 # stable state. A stable state means that: none of the instances in the
5926 # managed instance group is currently undergoing any type of change (for
5927 # example, creation, restart, or deletion); no future changes are scheduled
5928 # for instances in the managed instance group; and the managed instance
5929 # group itself is not being modified.
5930 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
5931 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
5932 # has stateful configuration, that is, if you have configured any items
5933 # in a stateful policy or in per-instance configs.
5934 # The group might report that it has no stateful configuration even when
5935 # there is still some preserved state on a managed instance, for example,
5936 # if you have deleted all PICs but not yet applied those deletions.
5937 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
5938 # has stateful configuration, that is, if you have configured any items
5939 # in a stateful policy or in per-instance configs.
5940 # The group might report that it has no stateful configuration even when
5941 # there is still some preserved state on a managed instance, for example,
5942 # if you have deleted all PICs but not yet applied those deletions. This
5943 # field is deprecated in favor of has_stateful_config.
5944 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
5945 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
5946 # (listed in the output of a listPerInstanceConfigs API call) have
5947 # status EFFECTIVE or there are no per-instance-configs.
5948 },
5949 },
5950 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
5951 # target version specified by version field on Instance Group
5952 # Manager.
5953 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
5954 # in this managed instance group, i.e. all instances are in their target
5955 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
5956 },
5957 },
5958 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
5959 # apply to all of the instances in the managed instance group.
5960 &quot;A String&quot;,
5961 ],
5962 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
5963 # You can reduce this number by using the instanceGroupManager
5964 # deleteInstances or abandonInstances methods. Resizing the group also
5965 # changes this number.
5966 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
5967 # size.
5968 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
5969 # individually or all at once.
5970 },
5971 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
5972 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
5973 # This number changes when you:
5974 #
5975 # - Stop instance using the stopInstances
5976 # method or start instances using the startInstances
5977 # method.
5978 # - Manually change the targetStoppedSize using the update
5979 # method.
5980 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
5981 # This number changes when you:
5982 #
5983 # - Suspend instance using the suspendInstances
5984 # method or resume instances using the resumeInstances
5985 # method.
5986 # - Manually change the targetSuspendedSize using the update
5987 # method.
5988 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
5989 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
5990 &quot;A String&quot;,
5991 ],
5992 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
5993 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
5994 # instance redistribution policy for regional managed instance groups.
5995 # Valid values are:
5996 #
5997 # - PROACTIVE (default): The group attempts to maintain an
5998 # even distribution of VM instances across zones in the region.
5999 # - NONE: For non-autoscaled groups, proactive
6000 # redistribution is disabled.
6001 &quot;maxSurge&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
6002 # either a fixed number or, if the group has 10 or more instances, a
6003 # percentage. If you set a percentage, the number of instances is rounded
6004 # if necessary. The default value for maxSurge is a fixed
6005 # value equal to the number of zones in which the managed instance group
6006 # operates.
6007 #
6008 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
6009 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6010 #
6011 #
6012 #
6013 # - If the value is fixed, then the calculated
6014 # value is equal to the fixed value.
6015 # - If the value is a percent, then the
6016 # calculated
6017 # value is percent/100 * targetSize. For example,
6018 # the calculated value of a 80% of a managed instance group
6019 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6020 # is a remainder, the number is rounded.
6021 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6022 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6023 # example, specify 80 for 80%.
6024 },
6025 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
6026 # process. An instance is considered available if all of the following
6027 # conditions are satisfied:
6028 #
6029 #
6030 #
6031 # - The instance&#x27;s status is
6032 # RUNNING.
6033 # - If there is a health
6034 # check on the instance group, the instance&#x27;s health check status
6035 # must be HEALTHY at least once. If there is no health check
6036 # on the group, then the instance only needs to have a status of
6037 # RUNNING to be considered available.
6038 #
6039 #
6040 # This value can be either a fixed number or, if the group has 10 or more
6041 # instances, a percentage. If you set a percentage, the number of instances
6042 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
6043 # in which the managed instance group operates.
6044 #
6045 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
6046 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6047 #
6048 #
6049 #
6050 # - If the value is fixed, then the calculated
6051 # value is equal to the fixed value.
6052 # - If the value is a percent, then the
6053 # calculated
6054 # value is percent/100 * targetSize. For example,
6055 # the calculated value of a 80% of a managed instance group
6056 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6057 # is a remainder, the number is rounded.
6058 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6059 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6060 # example, specify 80 for 80%.
6061 },
6062 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
6063 # becomes available. This value must be from range [0, 3600].
6064 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
6065 # disruption as much as possible or to apply a more disruptive action than
6066 # is necessary.
6067 #
6068 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
6069 # Compute Engine performs the necessary action to execute the update.
6070 # - To apply a more disruptive action than is strictly necessary, set the
6071 # minimal action to RESTART or REPLACE. For
6072 # example, Compute Engine does not need to restart a VM to change its
6073 # metadata. But if your application reads instance metadata only when a VM
6074 # is restarted, you can set the minimal action to RESTART in
6075 # order to pick up metadata changes.
6076 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
6077 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
6078 # as much as possible. RESTART to allow actions that can be
6079 # applied without instance replacing or REPLACE to allow all
6080 # possible actions. If the Updater determines that the minimal update
6081 # action needed is more disruptive than most disruptive allowed action you
6082 # specify it will not perform the update at all.
6083 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
6084 # See minimal_action.REPLACE
6085 &quot;type&quot;: &quot;A String&quot;, # The type
6086 # of update process. You can specify either PROACTIVE so
6087 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
6088 # to update.
6089 },
6090 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
6091 # create instances.
6092 #
6093 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
6094 # group. This field overrides the top-level instanceTemplate
6095 # field. Read more about therelationships
6096 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
6097 # remaining instances. For more information, read aboutcanary
6098 # updates.
6099 {
6100 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
6101 # instance group. The group uses this template to create new instances in
6102 # the managed instance group until the `targetSize` for this version is
6103 # reached. The templates for existing instances in the group do not change
6104 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
6105 # existing instances are updated until the `targetSize` for this version is
6106 # reached.
6107 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
6108 # managed instance group.
6109 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
6110 # even if instance_template remains unchanged.
6111 # Deprecated in favor of &#x27;name&#x27;.
6112 &quot;targetSize&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
6113 # from the template will be equal to:
6114 #
6115 #
6116 # - If expressed as a fixed number, the minimum of either
6117 # targetSize.fixed or
6118 # instanceGroupManager.targetSize is used.
6119 # - if expressed as a percent, the targetSize
6120 # would be (targetSize.percent/100 *
6121 # InstanceGroupManager.targetSize) If there is a remainder, the
6122 # number is rounded.
6123 #
6124 # If unset, this version will update any remaining instances not
6125 # updated by another version. ReadStarting
6126 # a canary update for more information.
6127 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6128 #
6129 #
6130 #
6131 # - If the value is fixed, then the calculated
6132 # value is equal to the fixed value.
6133 # - If the value is a percent, then the
6134 # calculated
6135 # value is percent/100 * targetSize. For example,
6136 # the calculated value of a 80% of a managed instance group
6137 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6138 # is a remainder, the number is rounded.
6139 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6140 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6141 # example, specify 80 for 80%.
6142 },
6143 },
6144 ],
6145 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
6146 # where the managed instance group is located (for zonal resources).
6147 }
6148
6149 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6150 that if you must retry your request, the server will know to ignore the
6151 request if it has already been completed.
6152
6153 For example, consider a situation where you make an initial request and
6154 the request times out. If you make the request again with the same
6155 request ID, the server can check if original operation with the same
6156 request ID was received, and if so, will ignore the second request. This
6157 prevents clients from accidentally creating duplicate commitments.
6158
6159 The request ID must be
6160 a valid UUID with the exception that zero UUID is not supported
6161 (00000000-0000-0000-0000-000000000000).
6162 x__xgafv: string, V1 error format.
6163 Allowed values
6164 1 - v1 error format
6165 2 - v2 error format
6166
6167 Returns:
6168 An object of the form:
6169
6170 { # Represents an Operation resource.
6171 #
6172 # Google Compute Engine has three Operation resources:
6173 #
6174 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
6175 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
6176 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
6177 #
6178 # You can use an operation resource to manage asynchronous API requests.
6179 # For more information, readHandling
6180 # API responses.
6181 #
6182 # Operations can be global, regional or zonal.
6183 #
6184 # - For global operations, use the `globalOperations`
6185 # resource.
6186 # - For regional operations, use the
6187 # `regionOperations` resource.
6188 # - For zonal operations, use
6189 # the `zoneOperations` resource.
6190 #
6191 #
6192 #
6193 # For more information, read
6194 # Global, Regional, and Zonal Resources.
6195 #
6196 # Note that completed Operation resources have a limited
6197 # retention period.
6198 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6199 # Not present otherwise.
6200 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6201 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6202 # set when the operation is created.
6203 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6204 # text format.
6205 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6206 # this field will be populated.
6207 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6208 # operation.
6209 {
6210 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6211 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6212 # details. There is a set of defined message types to use for providing
6213 # details.The syntax depends on the error code. For example,
6214 # QuotaExceededInfo will have details when the error code is
6215 # QUOTA_EXCEEDED.
6216 {
6217 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6218 #
6219 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6220 # is not enabled:
6221 #
6222 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6223 # &quot;domain&quot;: &quot;googleapis.com&quot;
6224 # &quot;metadata&quot;: {
6225 # &quot;resource&quot;: &quot;projects/123&quot;,
6226 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6227 # }
6228 # }
6229 #
6230 # This response indicates that the pubsub.googleapis.com API is not enabled.
6231 #
6232 # Example of an error that is returned when attempting to create a Spanner
6233 # instance in a region that is out of stock:
6234 #
6235 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6236 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6237 # &quot;metadata&quot;: {
6238 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6239 # }
6240 # }
6241 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6242 # is typically the registered service name of the tool or product that
6243 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6244 # generated by some common infrastructure, the error domain must be a
6245 # globally unique value that identifies the infrastructure. For Google API
6246 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6247 &quot;metadatas&quot;: { # Additional structured details about this error.
6248 #
6249 # Keys must match a regular expression of `a-z+` but should
6250 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6251 # length. When identifying the current value of an exceeded limit, the units
6252 # should be contained in the key, not the value. For example, rather than
6253 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6254 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6255 # instances that can be created in a single (batch) request.
6256 &quot;a_key&quot;: &quot;A String&quot;,
6257 },
6258 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6259 # proximate cause of the error. Error reasons are unique within a particular
6260 # domain of errors. This should be at most 63 characters and match a
6261 # regular expression of `A-Z+[A-Z0-9]`, which represents
6262 # UPPER_SNAKE_CASE.
6263 },
6264 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6265 #
6266 # For example, if a quota check failed with an error indicating the calling
6267 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6268 # directly to the right place in the developer console to flip the bit.
6269 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6270 { # Describes a URL link.
6271 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6272 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6273 },
6274 ],
6275 },
6276 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6277 # which can be attached to an RPC error.
6278 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6279 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6280 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6281 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6282 },
6283 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6284 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6285 &quot;a_key&quot;: &quot;A String&quot;,
6286 },
6287 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6288 # type or metric.
6289 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6290 # or metric.
6291 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6292 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6293 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6294 },
6295 },
6296 ],
6297 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6298 # This property is optional.
6299 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6300 },
6301 ],
6302 },
6303 &quot;getVersionOperationMetadata&quot;: {
6304 &quot;inlineSbomInfo&quot;: {
6305 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6306 # appropriate identifiers.
6307 &quot;a_key&quot;: &quot;A String&quot;,
6308 },
6309 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6310 # identifiers.
6311 &quot;a_key&quot;: &quot;A String&quot;,
6312 },
6313 },
6314 },
6315 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6316 # message that was returned, such as `NOT FOUND`.
6317 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6318 # status code that was returned. For example, a `404` means the
6319 # resource was not found.
6320 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6321 # defined by the server.
6322 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6323 # This value is inRFC3339
6324 # text format.
6325 &quot;instancesBulkInsertOperationMetadata&quot;: {
6326 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6327 # Example key: zones/us-central1-a
6328 &quot;a_key&quot;: {
6329 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6330 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6331 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6332 # error.
6333 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6334 # if the flow is rolling forward or rolling back.
6335 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6336 },
6337 },
6338 },
6339 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6340 # Operation resources.
6341 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6342 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6343 # group of operations results from a `bulkInsert` API request.
6344 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6345 # `update`, or `delete`, and so on.
6346 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6347 # There is no requirement that this be linear or support any granularity of
6348 # operations. This should not be used to guess when the operation will be
6349 # complete. This number should monotonically increase as the operation
6350 # progresses.
6351 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6352 # applicable when performing regional operations.
6353 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6354 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
6355 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6356 # this field will contain information on all underlying zonal actions and
6357 # their state.
6358 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6359 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6360 # Example key: zones/us-central1-a
6361 &quot;a_key&quot;: {
6362 &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
6363 # populated.
6364 # different programming environments, including REST APIs and RPC APIs. It is
6365 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6366 # three pieces of data: error code, error message, and error details.
6367 #
6368 # You can find out more about this error model and how to work with it in the
6369 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6370 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6371 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6372 # message types for APIs to use.
6373 {
6374 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6375 },
6376 ],
6377 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6378 # user-facing error message should be localized and sent in the
6379 # google.rpc.Status.details field, or localized by the client.
6380 },
6381 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6382 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6383 },
6384 },
6385 },
6386 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6387 # This value is inRFC3339
6388 # text format.
6389 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6390 # following:
6391 # `PENDING`, `RUNNING`, or `DONE`.
6392 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6393 # operation.
6394 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6395 # of the target resource.
6396 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6397 # operations related to creating a snapshot, this points to the disk
6398 # that the snapshot was created from.
6399 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6400 # `[email protected]` or
6401 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6402 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6403 # operation, this field will be populated.
6404 {
6405 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6406 # Engine returns NO_RESULTS_ON_PAGE if there
6407 # are no results in the response.
6408 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6409 # value format. For example:
6410 #
6411 # &quot;data&quot;: [
6412 # {
6413 # &quot;key&quot;: &quot;scope&quot;,
6414 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6415 # }
6416 {
6417 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6418 # returned. For example, for warnings where there are no results in a list
6419 # request for a particular zone, this key might be scope and
6420 # the key value might be the zone name. Other examples might be a key
6421 # indicating a deprecated resource and a suggested replacement, or a
6422 # warning about invalid network settings (for example, if an instance
6423 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6424 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6425 },
6426 ],
6427 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6428 },
6429 ],
6430 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6431 # applicable when performing per-zone operations.
6432 }</pre>
6433 </div>
6434
6435 <div class="method">
6436 <code class="details" id="list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
6437 <pre>Retrieves the list of managed instance groups that are contained
6438 within the specified region.
6439
6440 Args:
6441 project: string, Project ID for this request. (required)
6442 region: string, Name of the region scoping this request. (required)
6443 filter: string, A filter expression that filters resources listed in the response. Most
6444 Compute resources support two types of filter expressions:
6445 expressions that support regular expressions and expressions that follow
6446 API improvement proposal AIP-160.
6447 These two types of filter expressions cannot be mixed in one request.
6448
6449 If you want to use AIP-160, your expression must specify the field name, an
6450 operator, and the value that you want to use for filtering. The value
6451 must be a string, a number, or a boolean. The operator
6452 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
6453
6454 For example, if you are filtering Compute Engine instances, you can
6455 exclude instances named `example-instance` by specifying
6456 `name != example-instance`.
6457
6458 The `:*` comparison can be used to test whether a key has been defined.
6459 For example, to find all objects with `owner` label use:
6460 ```
6461 labels.owner:*
6462 ```
6463
6464 You can also filter nested fields. For example, you could specify
6465 `scheduling.automaticRestart = false` to include instances only
6466 if they are not scheduled for automatic restarts. You can use filtering
6467 on nested fields to filter based onresource labels.
6468
6469 To filter on multiple expressions, provide each separate expression within
6470 parentheses. For example:
6471 ```
6472 (scheduling.automaticRestart = true)
6473 (cpuPlatform = &quot;Intel Skylake&quot;)
6474 ```
6475 By default, each expression is an `AND` expression. However, you
6476 can include `AND` and `OR` expressions explicitly.
6477 For example:
6478 ```
6479 (cpuPlatform = &quot;Intel Skylake&quot;) OR
6480 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
6481 (scheduling.automaticRestart = true)
6482 ```
6483
6484 If you want to use a regular expression, use the `eq` (equal) or `ne`
6485 (not equal) operator against a single un-parenthesized expression with or
6486 without quotes or against multiple parenthesized expressions. Examples:
6487
6488 `fieldname eq unquoted literal`
6489 `fieldname eq &#x27;single quoted literal&#x27;`
6490 `fieldname eq &quot;double quoted literal&quot;`
6491 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
6492
6493 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
6494 The literal value must match the entire field.
6495
6496 For example, to filter for instances that do not end with name &quot;instance&quot;,
6497 you would use `name ne .*instance`.
6498
6499 You cannot combine constraints on multiple fields using regular
6500 expressions.
6501 maxResults: integer, The maximum number of results per page that should be returned.
6502 If the number of available results is larger than `maxResults`,
6503 Compute Engine returns a `nextPageToken` that can be used to get
6504 the next page of results in subsequent list requests. Acceptable values are
6505 `0` to `500`, inclusive. (Default: `500`)
6506 orderBy: string, Sorts list results by a certain order. By default, results
6507 are returned in alphanumerical order based on the resource name.
6508
6509 You can also sort results in descending order based on the creation
6510 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
6511 results based on the `creationTimestamp` field in
6512 reverse chronological order (newest result first). Use this to sort
6513 resources like operations so that the newest operation is returned first.
6514
6515 Currently, only sorting by `name` or
6516 `creationTimestamp desc` is supported.
6517 pageToken: string, Specifies a page token to use. Set `pageToken` to the
6518 `nextPageToken` returned by a previous list request to get
6519 the next page of results.
6520 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
6521 of failure. The default value is false.
6522
6523 For example, when partial success behavior is enabled, aggregatedList for a
6524 single zone scope either returns all resources in the zone or no resources,
6525 with an error code.
6526 x__xgafv: string, V1 error format.
6527 Allowed values
6528 1 - v1 error format
6529 2 - v2 error format
6530
6531 Returns:
6532 An object of the form:
6533
6534 { # Contains a list of managed instance groups.
6535 &quot;id&quot;: &quot;A String&quot;, # Output only. Unique identifier for the resource; defined by the server.
6536 &quot;items&quot;: [ # A list of InstanceGroupManager resources.
6537 { # Represents a Managed Instance Group resource.
6538 #
6539 # An instance group is a collection of VM instances that you can manage as a
6540 # single entity. For more information, readInstance groups.
6541 #
6542 # For zonal Managed Instance Group, use the instanceGroupManagers
6543 # resource.
6544 #
6545 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
6546 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
6547 # for the group.
6548 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
6549 #
6550 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
6551 # instances to apply the configuration. To apply the configuration, set the
6552 # group&#x27;s updatePolicy.type field to use proactive updates or
6553 # use the applyUpdatesToInstances method.
6554 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
6555 &quot;a_key&quot;: &quot;A String&quot;,
6556 },
6557 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
6558 # more information, see Project and
6559 # instance metadata.
6560 &quot;a_key&quot;: &quot;A String&quot;,
6561 },
6562 },
6563 },
6564 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
6565 # only one value.
6566 {
6567 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
6568 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
6569 # this field controls whether to trigger VM autohealing based on a failed
6570 # health check. Valid values are:
6571 #
6572 # - ON (default): The group recreates running VMs that
6573 # fail the application-based health check.
6574 # - OFF: When set to OFF, you can still observe instance
6575 # health state, but the group does not recreate VMs that fail the
6576 # application-based health check. This is useful for troubleshooting and
6577 # setting up your health check configuration.
6578 },
6579 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
6580 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
6581 # initialize and run its startup script. During a VM&#x27;s initial delay
6582 # period, the MIG ignores unsuccessful health checks because the VM might
6583 # be in the startup process. This prevents the MIG from prematurely
6584 # recreating a VM. If the health check receives a healthy response during
6585 # the initial delay, it indicates that the startup process is complete and
6586 # the VM is ready. The value of initial delay must be between 0 and 3600
6587 # seconds. The default value is 0.
6588 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
6589 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
6590 # The instance is considered available if all of the following conditions
6591 # are satisfied:
6592 # 1. Instance&#x27;s status is RUNNING.
6593 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
6594 # check result was observed to be HEALTHY at least once as it passed
6595 # VERIFYING).
6596 # 3. There is no outgoing action on an instance triggered by IGM.
6597 #
6598 # By default, number of concurrently autohealed instances is smaller than
6599 # the managed instance group target size. However, if a zonal managed
6600 # instance group has only one instance, or a regional managed instance
6601 # group has only one instance per zone, autohealing will recreate these
6602 # instances when they become unhealthy.
6603 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6604 #
6605 #
6606 #
6607 # - If the value is fixed, then the calculated
6608 # value is equal to the fixed value.
6609 # - If the value is a percent, then the
6610 # calculated
6611 # value is percent/100 * targetSize. For example,
6612 # the calculated value of a 80% of a managed instance group
6613 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6614 # is a remainder, the number is rounded.
6615 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6616 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6617 # example, specify 80 for 80%.
6618 },
6619 },
6620 ],
6621 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
6622 # all VMs in a MIG. The maximum character length is 58 and the name must
6623 # comply with RFC1035 format.
6624 #
6625 # When a VM is created in the group, the MIG appends a hyphen and a random
6626 # four-character string to the base instance name. If you want the MIG to
6627 # assign sequential numbers instead of a random string, then end the base
6628 # instance name with a hyphen followed by one or more hash symbols. The hash
6629 # symbols indicate the number of digits. For example, a base instance name of
6630 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
6631 # @pattern
6632 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
6633 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
6634 # text format.
6635 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
6636 # in this managed instance group that are scheduled for each of those
6637 # actions.
6638 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
6639 # that are scheduled to be abandoned. Abandoning an instance removes it
6640 # from the managed instance group without deleting it.
6641 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
6642 # are scheduled to be adopted or are currently being adopted.
6643 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
6644 # are scheduled to be created or are currently being created. If the group
6645 # fails to create any of these instances, it tries again until it creates
6646 # the instance successfully.
6647 #
6648 # If you have disabled creation retries, this field will not be populated;
6649 # instead, the creatingWithoutRetries field will be populated.
6650 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
6651 # will attempt to create atomically, in a batch mode. If the desired count
6652 # of instances can not be created, entire batch will be deleted and the
6653 # group will decrease its targetSize value accordingly.
6654 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
6655 # will attempt to create. The group attempts to create each instance
6656 # only once. If the group fails to create any of these instances, it
6657 # decreases the group&#x27;s targetSize value accordingly.
6658 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
6659 # are scheduled to be deleted or are currently being deleted.
6660 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
6661 # are running and have no scheduled actions.
6662 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
6663 # is currently queuing.
6664 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
6665 # are scheduled to be recreated or are currently being being recreated.
6666 # Recreating an instance deletes the existing root persistent disk
6667 # and creates a new disk from the image that is defined in the
6668 # instance template.
6669 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
6670 # are being reconfigured with properties that do not require a restart
6671 # or a recreate action. For example, setting or removing target
6672 # pools for the instance.
6673 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
6674 # are scheduled to be restarted or are currently being restarted.
6675 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
6676 # are scheduled to be restarted or are currently being restarted.
6677 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
6678 # are scheduled to be resumed or are currently being resumed.
6679 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
6680 # are scheduled to be started or are currently being started.
6681 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
6682 # are scheduled to be stopped or are currently being stopped.
6683 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
6684 # are scheduled to be suspended or are currently being suspended.
6685 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
6686 # are being verified. See the managedInstances[].currentAction
6687 # property in the listManagedInstances method documentation.
6688 },
6689 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
6690 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
6691 # zones in a regional managed instance group.
6692 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
6693 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
6694 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
6695 # its instances.
6696 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
6697 # instances, even if an AI zone is available in the specified region. To
6698 # create instances in an AI zone in the selected region, you must explicitly
6699 # specify it in the distribution policy together with the other preferred
6700 # zones.
6701 {
6702 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
6703 # The zone must exist in the region where the managed instance group is
6704 # located.
6705 },
6706 ],
6707 },
6708 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
6709 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
6710 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
6711 # fingerprint must be provided in order to update the InstanceGroupManager,
6712 # otherwise the request will fail with error412 conditionNotMet.
6713 #
6714 # To see the latest fingerprint, make a get() request to
6715 # retrieve an InstanceGroupManager.
6716 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
6717 # generates this identifier.
6718 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
6719 # types of machines.
6720 # Instance flexibility configuration on MIG overrides instance
6721 # template configuration.
6722 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
6723 # when creating new VMs.
6724 &quot;a_key&quot;: {
6725 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
6726 # selection.
6727 { # An instance-attached disk resource.
6728 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
6729 # or X86_64.
6730 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
6731 # deleted (but not when the disk is detached from the instance).
6732 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
6733 # partition of the disk for its root filesystem.
6734 &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
6735 # running within the instance. This name can be used to reference the device
6736 # for mounting, resizing, and so on, from within the instance.
6737 #
6738 # If not specified, the server chooses a default device name to apply to this
6739 # disk, in the form persistent-disk-x, where x is a number
6740 # assigned by Google Compute Engine. This field is only applicable for
6741 # persistent disks.
6742 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
6743 # encryption key.
6744 #
6745 # If you are creating a new disk, this field encrypts the new disk using
6746 # an encryption key that you provide. If you are attaching an existing
6747 # disk that is already encrypted, this field decrypts the disk using
6748 # the customer-supplied encryption key.
6749 #
6750 # If you encrypt a disk using a customer-supplied key, you must provide the
6751 # same key again when you attempt to use this resource at a later time. For
6752 # example, you must provide the key when you create a snapshot or an image
6753 # from the disk or when you attach the disk to a virtual machine instance.
6754 #
6755 # If you do not provide an encryption key, then the disk will be encrypted
6756 # using an automatically generated key and you do not need to provide a key
6757 # to use the disk later.
6758 #
6759 # Note:
6760 #
6761 # Instance templates do not storecustomer-supplied
6762 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
6763 #
6764 # You cannot create VMs that have disks with customer-supplied keys using
6765 # the bulk
6766 # insert method.
6767 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
6768 # For example:
6769 #
6770 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6771 # key_region/cryptoKeys/key
6772 #
6773 # The fully-qualifed key name may be returned for resource GET requests. For
6774 # example:
6775 #
6776 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6777 # key_region/cryptoKeys/key
6778 # /cryptoKeyVersions/1
6779 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
6780 # key. If absent, the Compute Engine default service account is used.
6781 # For example:
6782 #
6783 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
6784 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
6785 # encryption key, encoded in RFC
6786 # 4648 base64 to either encrypt or decrypt this resource. You can
6787 # provide either the rawKey or thersaEncryptedKey.
6788 # For example:
6789 #
6790 # &quot;rawKey&quot;:
6791 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
6792 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
6793 # customer-supplied encryption key to either encrypt or decrypt this
6794 # resource. You can provide either the rawKey or thersaEncryptedKey.
6795 # For example:
6796 #
6797 # &quot;rsaEncryptedKey&quot;:
6798 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
6799 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
6800 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
6801 #
6802 # The key must meet the following requirements before you can provide it to
6803 # Compute Engine:
6804 #
6805 # 1. The key is wrapped using a RSA public key certificate provided by
6806 # Google.
6807 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
6808 # encoding.
6809 #
6810 # Gets the RSA public key certificate provided by Google at:
6811 #
6812 #
6813 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
6814 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
6815 # 4648 base64 encoded SHA-256 hash of the customer-supplied
6816 # encryption key that protects this resource.
6817 },
6818 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
6819 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
6820 # currently attached to another instance. If you try to force attach a zonal
6821 # disk to an instance, you will receive an error.
6822 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
6823 # only for bootable images. Read
6824 # Enabling guest operating system features to see a list of available
6825 # options.
6826 { # Guest OS features.
6827 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
6828 # separate values. Set to one or more of the following values:
6829 #
6830 # - VIRTIO_SCSI_MULTIQUEUE
6831 # - WINDOWS
6832 # - MULTI_IP_SUBNET
6833 # - UEFI_COMPATIBLE
6834 # - GVNIC
6835 # - SEV_CAPABLE
6836 # - SUSPEND_RESUME_COMPATIBLE
6837 # - SEV_LIVE_MIGRATABLE_V2
6838 # - SEV_SNP_CAPABLE
6839 # - TDX_CAPABLE
6840 # - IDPF
6841 # - SNP_SVSM_CAPABLE
6842 # - CCA_CAPABLE
6843 #
6844 #
6845 # For more information, see
6846 # Enabling guest operating system features.
6847 },
6848 ],
6849 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
6850 # boot disk. If you have many disks attached to an instance, each
6851 # disk would have a unique index number.
6852 &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
6853 # alongside the new instance. Use initialization parameters to create boot
6854 # disks or local SSDs attached to the new instance.
6855 #
6856 # This property is mutually exclusive with the source property;
6857 # you can only define one or the other, but not both.
6858 # alongside the new instance. Use initialization parameters to create boot
6859 # disks or local SSDs attached to the new instance.
6860 #
6861 # This field is persisted and returned for instanceTemplate and not returned
6862 # in the context of instance.
6863 #
6864 # This property is mutually exclusive with the source property;
6865 # you can only define one or the other, but not both.
6866 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
6867 # arm64 or x86_64.
6868 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
6869 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
6870 # of the instance. If a disk with the same name already exists in the given
6871 # region, the existing disk is attached to the new instance and the
6872 # new disk is not created.
6873 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
6874 # 10 GB. If you specify a sourceImage, which is required for
6875 # boot disks, the default size is the size of the sourceImage.
6876 # If you do not specify a sourceImage, the default disk size
6877 # is 500 GB.
6878 &quot;diskType&quot;: &quot;A String&quot;,
6879 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
6880 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
6881 # only for bootable images. Read
6882 # Enabling guest operating system features to see a list of available
6883 # options.
6884 #
6885 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
6886 { # Guest OS features.
6887 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
6888 # separate values. Set to one or more of the following values:
6889 #
6890 # - VIRTIO_SCSI_MULTIQUEUE
6891 # - WINDOWS
6892 # - MULTI_IP_SUBNET
6893 # - UEFI_COMPATIBLE
6894 # - GVNIC
6895 # - SEV_CAPABLE
6896 # - SUSPEND_RESUME_COMPATIBLE
6897 # - SEV_LIVE_MIGRATABLE_V2
6898 # - SEV_SNP_CAPABLE
6899 # - TDX_CAPABLE
6900 # - IDPF
6901 # - SNP_SVSM_CAPABLE
6902 # - CCA_CAPABLE
6903 #
6904 #
6905 # For more information, see
6906 # Enabling guest operating system features.
6907 },
6908 ],
6909 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
6910 # which is either SCSI or NVME. The default isSCSI.
6911 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
6912 # persistent disks.
6913 &quot;a_key&quot;: &quot;A String&quot;,
6914 },
6915 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
6916 # disk.
6917 &quot;A String&quot;,
6918 ],
6919 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
6920 &quot;A String&quot;,
6921 ],
6922 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
6923 # more than one instance.
6924 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
6925 # is to use the existing disk.
6926 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
6927 # of I/O operations per second that the disk can handle. Values must be
6928 # between 10,000 and 120,000. For more details, see theExtreme persistent
6929 # disk documentation.
6930 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
6931 # number of throughput mb per second that the disk can handle. Values must
6932 # greater than or equal to 1.
6933 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
6934 # the URLs of the zones where the disk should be replicated to.
6935 # You must provide exactly two replica zones, and one zone must be the same
6936 # as the instance zone.
6937 &quot;A String&quot;,
6938 ],
6939 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
6940 # have the same definition as resource
6941 # manager tags. Keys and values can be either in numeric format,
6942 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
6943 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
6944 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
6945 # empty.
6946 &quot;a_key&quot;: &quot;A String&quot;,
6947 },
6948 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
6949 # Specified using the full or partial URL. For instance template, specify
6950 # only the resource policy name.
6951 &quot;A String&quot;,
6952 ],
6953 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
6954 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
6955 # is required.
6956 #
6957 # To create a disk with one of the public operating system
6958 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
6959 #
6960 # projects/debian-cloud/global/images/family/debian-9
6961 #
6962 #
6963 # Alternatively, use a specific version of a public operating system image:
6964 #
6965 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
6966 #
6967 #
6968 # To create a disk with a custom image that you created, specify the
6969 # image name in the following format:
6970 #
6971 # global/images/my-custom-image
6972 #
6973 #
6974 # You can also specify a custom image by its image family, which returns
6975 # the latest version of the image in that family. Replace the image name
6976 # with family/family-name:
6977 #
6978 # global/images/family/my-image-family
6979 #
6980 #
6981 # If the source image is deleted later, this field will not be set.
6982 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
6983 # encryption key of the source image. Required if the source image is
6984 # protected by a customer-supplied encryption key.
6985 #
6986 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
6987 # encryption keys, so you cannot create disks for instances in a managed instance group if the
6988 # source images are encrypted with your own keys.
6989 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
6990 # For example:
6991 #
6992 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6993 # key_region/cryptoKeys/key
6994 #
6995 # The fully-qualifed key name may be returned for resource GET requests. For
6996 # example:
6997 #
6998 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
6999 # key_region/cryptoKeys/key
7000 # /cryptoKeyVersions/1
7001 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7002 # key. If absent, the Compute Engine default service account is used.
7003 # For example:
7004 #
7005 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7006 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7007 # encryption key, encoded in RFC
7008 # 4648 base64 to either encrypt or decrypt this resource. You can
7009 # provide either the rawKey or thersaEncryptedKey.
7010 # For example:
7011 #
7012 # &quot;rawKey&quot;:
7013 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7014 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7015 # customer-supplied encryption key to either encrypt or decrypt this
7016 # resource. You can provide either the rawKey or thersaEncryptedKey.
7017 # For example:
7018 #
7019 # &quot;rsaEncryptedKey&quot;:
7020 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7021 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7022 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7023 #
7024 # The key must meet the following requirements before you can provide it to
7025 # Compute Engine:
7026 #
7027 # 1. The key is wrapped using a RSA public key certificate provided by
7028 # Google.
7029 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7030 # encoding.
7031 #
7032 # Gets the RSA public key certificate provided by Google at:
7033 #
7034 #
7035 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7036 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7037 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7038 # encryption key that protects this resource.
7039 },
7040 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
7041 # instance boot disk, one of initializeParams.sourceSnapshot
7042 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
7043 # is required.
7044 #
7045 # To create a disk with a snapshot that you created, specify the
7046 # snapshot name in the following format:
7047 #
7048 # us-central1-a/instantSnapshots/my-backup
7049 #
7050 #
7051 # If the source instant-snapshot is deleted later, this field will not be
7052 # set.
7053 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
7054 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
7055 # is required.
7056 #
7057 # To create a disk with a snapshot that you created, specify the
7058 # snapshot name in the following format:
7059 #
7060 # global/snapshots/my-backup
7061 #
7062 #
7063 # If the source snapshot is deleted later, this field will not be set.
7064 #
7065 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
7066 # an image instead when you create VMs using
7067 # the bulk
7068 # insert method.
7069 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
7070 # encryption key of the source snapshot.
7071 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7072 # For example:
7073 #
7074 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7075 # key_region/cryptoKeys/key
7076 #
7077 # The fully-qualifed key name may be returned for resource GET requests. For
7078 # example:
7079 #
7080 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7081 # key_region/cryptoKeys/key
7082 # /cryptoKeyVersions/1
7083 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7084 # key. If absent, the Compute Engine default service account is used.
7085 # For example:
7086 #
7087 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7088 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7089 # encryption key, encoded in RFC
7090 # 4648 base64 to either encrypt or decrypt this resource. You can
7091 # provide either the rawKey or thersaEncryptedKey.
7092 # For example:
7093 #
7094 # &quot;rawKey&quot;:
7095 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7096 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7097 # customer-supplied encryption key to either encrypt or decrypt this
7098 # resource. You can provide either the rawKey or thersaEncryptedKey.
7099 # For example:
7100 #
7101 # &quot;rsaEncryptedKey&quot;:
7102 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7103 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7104 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7105 #
7106 # The key must meet the following requirements before you can provide it to
7107 # Compute Engine:
7108 #
7109 # 1. The key is wrapped using a RSA public key certificate provided by
7110 # Google.
7111 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7112 # encoding.
7113 #
7114 # Gets the RSA public key certificate provided by Google at:
7115 #
7116 #
7117 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7118 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7119 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7120 # encryption key that protects this resource.
7121 },
7122 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7123 # this as a partial or full URL to the resource. For example, the following
7124 # are valid values:
7125 #
7126 #
7127 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7128 # - projects/project/zones/zone/storagePools/storagePool
7129 # - zones/zone/storagePools/storagePool
7130 },
7131 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
7132 # either SCSI or NVME. For most machine types, the
7133 # default is SCSI. Local SSDs can use either NVME or SCSI.
7134 # In certain configurations, persistent disks can use NVMe. For more
7135 # information, seeAbout
7136 # persistent disks.
7137 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
7138 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
7139 &quot;A String&quot;,
7140 ],
7141 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
7142 # disk is not allowed to be detached from the instance, or to be used as the
7143 # source of the snapshot creation, and the image creation. The instance with
7144 # at least one locked attached disk is not allow to be used as source of
7145 # machine image creation, instant snapshot creation, and not allowed to be
7146 # deleted with --keep-disk parameter set to true for locked disks.
7147 &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
7148 # in READ_WRITE mode.
7149 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
7150 # field is set to PRESERVED if the LocalSSD data has been saved
7151 # to a persistent location by customer request. (see the
7152 # discard_local_ssd option on Stop/Suspend).
7153 # Read-only in the api.
7154 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
7155 # these are public keys which are safe to store in public
7156 &quot;dbs&quot;: [ # The Key Database (db).
7157 {
7158 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7159 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7160 },
7161 ],
7162 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
7163 {
7164 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7165 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7166 },
7167 ],
7168 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
7169 {
7170 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7171 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7172 },
7173 ],
7174 &quot;pk&quot;: { # The Platform Key (PK).
7175 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7176 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7177 },
7178 },
7179 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
7180 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7181 # is required.
7182 #
7183 # If desired, you can also attach existing non-root persistent disks using
7184 # this property. This field is only applicable for persistent disks.
7185 #
7186 # Note that for InstanceTemplate, specify the disk name for zonal disk,
7187 # and the URL for regional disk.
7188 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
7189 },
7190 ],
7191 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
7192 &quot;A String&quot;,
7193 ],
7194 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
7195 # e.g. &#x27;Intel Ice Lake&#x27;.
7196 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
7197 # preference. MIG will first try to create a VM based on the machine-type
7198 # with lowest rank and fallback to next rank based on availability.
7199 # Machine types and instance selections with the same rank have the same
7200 # preference.
7201 },
7202 },
7203 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
7204 # when creating new VMs.
7205 &quot;a_key&quot;: {
7206 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
7207 # selection.
7208 { # An instance-attached disk resource.
7209 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
7210 # or X86_64.
7211 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
7212 # deleted (but not when the disk is detached from the instance).
7213 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
7214 # partition of the disk for its root filesystem.
7215 &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
7216 # running within the instance. This name can be used to reference the device
7217 # for mounting, resizing, and so on, from within the instance.
7218 #
7219 # If not specified, the server chooses a default device name to apply to this
7220 # disk, in the form persistent-disk-x, where x is a number
7221 # assigned by Google Compute Engine. This field is only applicable for
7222 # persistent disks.
7223 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
7224 # encryption key.
7225 #
7226 # If you are creating a new disk, this field encrypts the new disk using
7227 # an encryption key that you provide. If you are attaching an existing
7228 # disk that is already encrypted, this field decrypts the disk using
7229 # the customer-supplied encryption key.
7230 #
7231 # If you encrypt a disk using a customer-supplied key, you must provide the
7232 # same key again when you attempt to use this resource at a later time. For
7233 # example, you must provide the key when you create a snapshot or an image
7234 # from the disk or when you attach the disk to a virtual machine instance.
7235 #
7236 # If you do not provide an encryption key, then the disk will be encrypted
7237 # using an automatically generated key and you do not need to provide a key
7238 # to use the disk later.
7239 #
7240 # Note:
7241 #
7242 # Instance templates do not storecustomer-supplied
7243 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
7244 #
7245 # You cannot create VMs that have disks with customer-supplied keys using
7246 # the bulk
7247 # insert method.
7248 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7249 # For example:
7250 #
7251 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7252 # key_region/cryptoKeys/key
7253 #
7254 # The fully-qualifed key name may be returned for resource GET requests. For
7255 # example:
7256 #
7257 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7258 # key_region/cryptoKeys/key
7259 # /cryptoKeyVersions/1
7260 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7261 # key. If absent, the Compute Engine default service account is used.
7262 # For example:
7263 #
7264 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7265 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7266 # encryption key, encoded in RFC
7267 # 4648 base64 to either encrypt or decrypt this resource. You can
7268 # provide either the rawKey or thersaEncryptedKey.
7269 # For example:
7270 #
7271 # &quot;rawKey&quot;:
7272 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7273 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7274 # customer-supplied encryption key to either encrypt or decrypt this
7275 # resource. You can provide either the rawKey or thersaEncryptedKey.
7276 # For example:
7277 #
7278 # &quot;rsaEncryptedKey&quot;:
7279 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7280 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7281 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7282 #
7283 # The key must meet the following requirements before you can provide it to
7284 # Compute Engine:
7285 #
7286 # 1. The key is wrapped using a RSA public key certificate provided by
7287 # Google.
7288 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7289 # encoding.
7290 #
7291 # Gets the RSA public key certificate provided by Google at:
7292 #
7293 #
7294 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7295 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7296 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7297 # encryption key that protects this resource.
7298 },
7299 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
7300 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
7301 # currently attached to another instance. If you try to force attach a zonal
7302 # disk to an instance, you will receive an error.
7303 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7304 # only for bootable images. Read
7305 # Enabling guest operating system features to see a list of available
7306 # options.
7307 { # Guest OS features.
7308 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7309 # separate values. Set to one or more of the following values:
7310 #
7311 # - VIRTIO_SCSI_MULTIQUEUE
7312 # - WINDOWS
7313 # - MULTI_IP_SUBNET
7314 # - UEFI_COMPATIBLE
7315 # - GVNIC
7316 # - SEV_CAPABLE
7317 # - SUSPEND_RESUME_COMPATIBLE
7318 # - SEV_LIVE_MIGRATABLE_V2
7319 # - SEV_SNP_CAPABLE
7320 # - TDX_CAPABLE
7321 # - IDPF
7322 # - SNP_SVSM_CAPABLE
7323 # - CCA_CAPABLE
7324 #
7325 #
7326 # For more information, see
7327 # Enabling guest operating system features.
7328 },
7329 ],
7330 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
7331 # boot disk. If you have many disks attached to an instance, each
7332 # disk would have a unique index number.
7333 &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
7334 # alongside the new instance. Use initialization parameters to create boot
7335 # disks or local SSDs attached to the new instance.
7336 #
7337 # This property is mutually exclusive with the source property;
7338 # you can only define one or the other, but not both.
7339 # alongside the new instance. Use initialization parameters to create boot
7340 # disks or local SSDs attached to the new instance.
7341 #
7342 # This field is persisted and returned for instanceTemplate and not returned
7343 # in the context of instance.
7344 #
7345 # This property is mutually exclusive with the source property;
7346 # you can only define one or the other, but not both.
7347 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
7348 # arm64 or x86_64.
7349 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
7350 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
7351 # of the instance. If a disk with the same name already exists in the given
7352 # region, the existing disk is attached to the new instance and the
7353 # new disk is not created.
7354 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
7355 # 10 GB. If you specify a sourceImage, which is required for
7356 # boot disks, the default size is the size of the sourceImage.
7357 # If you do not specify a sourceImage, the default disk size
7358 # is 500 GB.
7359 &quot;diskType&quot;: &quot;A String&quot;,
7360 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
7361 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7362 # only for bootable images. Read
7363 # Enabling guest operating system features to see a list of available
7364 # options.
7365 #
7366 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
7367 { # Guest OS features.
7368 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7369 # separate values. Set to one or more of the following values:
7370 #
7371 # - VIRTIO_SCSI_MULTIQUEUE
7372 # - WINDOWS
7373 # - MULTI_IP_SUBNET
7374 # - UEFI_COMPATIBLE
7375 # - GVNIC
7376 # - SEV_CAPABLE
7377 # - SUSPEND_RESUME_COMPATIBLE
7378 # - SEV_LIVE_MIGRATABLE_V2
7379 # - SEV_SNP_CAPABLE
7380 # - TDX_CAPABLE
7381 # - IDPF
7382 # - SNP_SVSM_CAPABLE
7383 # - CCA_CAPABLE
7384 #
7385 #
7386 # For more information, see
7387 # Enabling guest operating system features.
7388 },
7389 ],
7390 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
7391 # which is either SCSI or NVME. The default isSCSI.
7392 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
7393 # persistent disks.
7394 &quot;a_key&quot;: &quot;A String&quot;,
7395 },
7396 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
7397 # disk.
7398 &quot;A String&quot;,
7399 ],
7400 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
7401 &quot;A String&quot;,
7402 ],
7403 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
7404 # more than one instance.
7405 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
7406 # is to use the existing disk.
7407 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
7408 # of I/O operations per second that the disk can handle. Values must be
7409 # between 10,000 and 120,000. For more details, see theExtreme persistent
7410 # disk documentation.
7411 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
7412 # number of throughput mb per second that the disk can handle. Values must
7413 # greater than or equal to 1.
7414 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
7415 # the URLs of the zones where the disk should be replicated to.
7416 # You must provide exactly two replica zones, and one zone must be the same
7417 # as the instance zone.
7418 &quot;A String&quot;,
7419 ],
7420 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
7421 # have the same definition as resource
7422 # manager tags. Keys and values can be either in numeric format,
7423 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
7424 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
7425 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
7426 # empty.
7427 &quot;a_key&quot;: &quot;A String&quot;,
7428 },
7429 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
7430 # Specified using the full or partial URL. For instance template, specify
7431 # only the resource policy name.
7432 &quot;A String&quot;,
7433 ],
7434 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
7435 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7436 # is required.
7437 #
7438 # To create a disk with one of the public operating system
7439 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
7440 #
7441 # projects/debian-cloud/global/images/family/debian-9
7442 #
7443 #
7444 # Alternatively, use a specific version of a public operating system image:
7445 #
7446 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
7447 #
7448 #
7449 # To create a disk with a custom image that you created, specify the
7450 # image name in the following format:
7451 #
7452 # global/images/my-custom-image
7453 #
7454 #
7455 # You can also specify a custom image by its image family, which returns
7456 # the latest version of the image in that family. Replace the image name
7457 # with family/family-name:
7458 #
7459 # global/images/family/my-image-family
7460 #
7461 #
7462 # If the source image is deleted later, this field will not be set.
7463 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
7464 # encryption key of the source image. Required if the source image is
7465 # protected by a customer-supplied encryption key.
7466 #
7467 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
7468 # encryption keys, so you cannot create disks for instances in a managed instance group if the
7469 # source images are encrypted with your own keys.
7470 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7471 # For example:
7472 #
7473 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7474 # key_region/cryptoKeys/key
7475 #
7476 # The fully-qualifed key name may be returned for resource GET requests. For
7477 # example:
7478 #
7479 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7480 # key_region/cryptoKeys/key
7481 # /cryptoKeyVersions/1
7482 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7483 # key. If absent, the Compute Engine default service account is used.
7484 # For example:
7485 #
7486 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7487 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7488 # encryption key, encoded in RFC
7489 # 4648 base64 to either encrypt or decrypt this resource. You can
7490 # provide either the rawKey or thersaEncryptedKey.
7491 # For example:
7492 #
7493 # &quot;rawKey&quot;:
7494 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7495 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7496 # customer-supplied encryption key to either encrypt or decrypt this
7497 # resource. You can provide either the rawKey or thersaEncryptedKey.
7498 # For example:
7499 #
7500 # &quot;rsaEncryptedKey&quot;:
7501 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7502 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7503 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7504 #
7505 # The key must meet the following requirements before you can provide it to
7506 # Compute Engine:
7507 #
7508 # 1. The key is wrapped using a RSA public key certificate provided by
7509 # Google.
7510 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7511 # encoding.
7512 #
7513 # Gets the RSA public key certificate provided by Google at:
7514 #
7515 #
7516 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7517 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7518 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7519 # encryption key that protects this resource.
7520 },
7521 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
7522 # instance boot disk, one of initializeParams.sourceSnapshot
7523 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
7524 # is required.
7525 #
7526 # To create a disk with a snapshot that you created, specify the
7527 # snapshot name in the following format:
7528 #
7529 # us-central1-a/instantSnapshots/my-backup
7530 #
7531 #
7532 # If the source instant-snapshot is deleted later, this field will not be
7533 # set.
7534 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
7535 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
7536 # is required.
7537 #
7538 # To create a disk with a snapshot that you created, specify the
7539 # snapshot name in the following format:
7540 #
7541 # global/snapshots/my-backup
7542 #
7543 #
7544 # If the source snapshot is deleted later, this field will not be set.
7545 #
7546 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
7547 # an image instead when you create VMs using
7548 # the bulk
7549 # insert method.
7550 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
7551 # encryption key of the source snapshot.
7552 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7553 # For example:
7554 #
7555 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7556 # key_region/cryptoKeys/key
7557 #
7558 # The fully-qualifed key name may be returned for resource GET requests. For
7559 # example:
7560 #
7561 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7562 # key_region/cryptoKeys/key
7563 # /cryptoKeyVersions/1
7564 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7565 # key. If absent, the Compute Engine default service account is used.
7566 # For example:
7567 #
7568 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7569 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7570 # encryption key, encoded in RFC
7571 # 4648 base64 to either encrypt or decrypt this resource. You can
7572 # provide either the rawKey or thersaEncryptedKey.
7573 # For example:
7574 #
7575 # &quot;rawKey&quot;:
7576 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7577 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7578 # customer-supplied encryption key to either encrypt or decrypt this
7579 # resource. You can provide either the rawKey or thersaEncryptedKey.
7580 # For example:
7581 #
7582 # &quot;rsaEncryptedKey&quot;:
7583 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7584 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7585 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7586 #
7587 # The key must meet the following requirements before you can provide it to
7588 # Compute Engine:
7589 #
7590 # 1. The key is wrapped using a RSA public key certificate provided by
7591 # Google.
7592 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7593 # encoding.
7594 #
7595 # Gets the RSA public key certificate provided by Google at:
7596 #
7597 #
7598 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7599 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7600 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7601 # encryption key that protects this resource.
7602 },
7603 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7604 # this as a partial or full URL to the resource. For example, the following
7605 # are valid values:
7606 #
7607 #
7608 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7609 # - projects/project/zones/zone/storagePools/storagePool
7610 # - zones/zone/storagePools/storagePool
7611 },
7612 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
7613 # either SCSI or NVME. For most machine types, the
7614 # default is SCSI. Local SSDs can use either NVME or SCSI.
7615 # In certain configurations, persistent disks can use NVMe. For more
7616 # information, seeAbout
7617 # persistent disks.
7618 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
7619 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
7620 &quot;A String&quot;,
7621 ],
7622 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
7623 # disk is not allowed to be detached from the instance, or to be used as the
7624 # source of the snapshot creation, and the image creation. The instance with
7625 # at least one locked attached disk is not allow to be used as source of
7626 # machine image creation, instant snapshot creation, and not allowed to be
7627 # deleted with --keep-disk parameter set to true for locked disks.
7628 &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
7629 # in READ_WRITE mode.
7630 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
7631 # field is set to PRESERVED if the LocalSSD data has been saved
7632 # to a persistent location by customer request. (see the
7633 # discard_local_ssd option on Stop/Suspend).
7634 # Read-only in the api.
7635 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
7636 # these are public keys which are safe to store in public
7637 &quot;dbs&quot;: [ # The Key Database (db).
7638 {
7639 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7640 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7641 },
7642 ],
7643 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
7644 {
7645 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7646 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7647 },
7648 ],
7649 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
7650 {
7651 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7652 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7653 },
7654 ],
7655 &quot;pk&quot;: { # The Platform Key (PK).
7656 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7657 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7658 },
7659 },
7660 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
7661 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7662 # is required.
7663 #
7664 # If desired, you can also attach existing non-root persistent disks using
7665 # this property. This field is only applicable for persistent disks.
7666 #
7667 # Note that for InstanceTemplate, specify the disk name for zonal disk,
7668 # and the URL for regional disk.
7669 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
7670 },
7671 ],
7672 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
7673 &quot;A String&quot;,
7674 ],
7675 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
7676 # e.g. &#x27;Intel Ice Lake&#x27;.
7677 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
7678 # preference. MIG will first try to create a VM based on the machine-type
7679 # with lowest rank and fallback to next rank based on availability.
7680 # Machine types and instance selections with the same rank have the same
7681 # preference.
7682 },
7683 },
7684 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
7685 # create instances.
7686 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
7687 # more preemption than the minimum capacity user needs. MIG will create
7688 # only Standard VMs until it reaches standard_capacity_base and only
7689 # then will start using standard_capacity_percent_above_base to mix Spot
7690 # with Standard VMs.
7691 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
7692 # remaining percentage will use Spot VMs. The percentage applies only to
7693 # the capacity above standard_capacity_base.
7694 },
7695 },
7696 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
7697 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
7698 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
7699 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
7700 # applies to the VMs on which your application fails a health check.
7701 # Valid values are
7702 #
7703 # - REPAIR (default): MIG automatically repairs a failed VM
7704 # by recreating it. For more information, see About
7705 # repairing VMs in a MIG.
7706 # - DO_NOTHING: MIG does not repair a failed VM.
7707 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
7708 # configuration when repairing a VM. Valid options are:
7709 #
7710 #
7711 #
7712 # - NO (default): If configuration updates are available, they are not
7713 # forcefully applied during repair. Instead, configuration updates are
7714 # applied according to the group&#x27;s update policy.
7715 #
7716 # - YES: If configuration updates are available, they are applied
7717 # during repair.
7718 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
7719 # instance during initialization when stopping / suspending an instance.
7720 # The Instance Group Manager will wait for a signal that indicates
7721 # successful initialization before stopping / suspending an instance.
7722 #
7723 # If a successful readiness signal is not sent before timeout, the
7724 # corresponding instance will not be stopped / suspended. Instead,
7725 # an error will be visible in the lastAttempt.errors field of
7726 # the managed instance in the listmanagedinstances
7727 # method.
7728 #
7729 # If metadataBasedReadinessSignal.timeoutSec is unset,
7730 # the Instance Group Manager will directly proceed to suspend / stop
7731 # instances, skipping initialization on them.
7732 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
7733 # initialization before timing out.
7734 },
7735 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
7736 # unhealthy when the application running on that VM fails a health check.
7737 # Valid values are:
7738 #
7739 # - DEFAULT_ACTION (default): MIG uses the same action
7740 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
7741 # - REPAIR: MIG automatically repairs an unhealthy VM by
7742 # recreating it.
7743 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
7744 # For more information, see
7745 # About repairing VMs in a MIG.
7746 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
7747 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
7748 # Valid values are:
7749 #
7750 # - NO (default): MIG cannot change a VM&#x27;s zone during a
7751 # repair.
7752 # - YES: MIG can select a different zone for the VM during
7753 # a repair.
7754 },
7755 },
7756 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
7757 # instance group. The group uses this template to create all new instances
7758 # in the managed instance group. The templates for existing instances in the
7759 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
7760 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
7761 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
7762 # this managed instance group.
7763 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
7764 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
7765 # long, and comply withRFC1035.
7766 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
7767 # to this Instance Group Manager.
7768 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
7769 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
7770 # The name must be 1-63 characters long, and comply withRFC1035.
7771 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
7772 },
7773 ],
7774 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
7775 # as part of resource payload.
7776 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
7777 # key-value pairs. Keys and values can be either in numeric format,
7778 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
7779 # format such as `{org_id|project_id}/{tag_key_short_name}` and
7780 # `{tag_value_short_name}`. For more information, seeManage tags
7781 # for resources.
7782 &quot;a_key&quot;: &quot;A String&quot;,
7783 },
7784 },
7785 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
7786 # where the managed instance group resides (for regional resources).
7787 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
7788 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
7789 # instance group.
7790 # It can be a full or partial URL. For example, the following are
7791 # all valid URLs to a workload policy:
7792 #
7793 #
7794 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
7795 # - projects/project/regions/region/resourcePolicies/resourcePolicy
7796 # - regions/region/resourcePolicies/resourcePolicy
7797 },
7798 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
7799 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
7800 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
7801 # this URL.
7802 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
7803 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
7804 # by the managed instance group on instances. The service accounts needs all
7805 # permissions required to create and delete instances.
7806 # By default, the service account
7807 # {projectNumber}@cloudservices.gserviceaccount.com is used.
7808 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
7809 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
7810 # stop a VM after that VM was created. The initial delay gives the
7811 # initialization script the time to prepare your VM for a quick scale out.
7812 # The value of initial delay must be between 0 and 3600 seconds. The
7813 # default value is 0.
7814 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
7815 # group scales out. The default mode is `MANUAL`.
7816 },
7817 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
7818 &quot;preservedState&quot;: { # Configuration of preserved resources.
7819 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
7820 # delete, update, etc. This map is keyed with the device names of
7821 # the disks.
7822 &quot;a_key&quot;: {
7823 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
7824 # update or VM instance recreate operations.
7825 # This flag is used to configure if the disk should be deleted after it
7826 # is no longer used by the group, e.g. when the given instance or
7827 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
7828 },
7829 },
7830 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
7831 # instance delete, update, etc. This map is keyed with the network
7832 # interface name.
7833 &quot;a_key&quot;: {
7834 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7835 # update or VM instance recreate operations.
7836 # This flag is used to configure if the IP reservation should be deleted
7837 # after it is no longer used by the group, e.g. when the given instance
7838 # or the whole group is deleted.
7839 },
7840 },
7841 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
7842 # instance delete, update, etc. This map is keyed with the network
7843 # interface name.
7844 &quot;a_key&quot;: {
7845 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7846 # update or VM instance recreate operations.
7847 # This flag is used to configure if the IP reservation should be deleted
7848 # after it is no longer used by the group, e.g. when the given instance
7849 # or the whole group is deleted.
7850 },
7851 },
7852 },
7853 },
7854 &quot;status&quot;: { # Output only. The status of this managed instance group.
7855 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
7856 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
7857 # This value is in RFC3339 text format.
7858 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
7859 # been applied to all managed instances in the group.
7860 },
7861 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
7862 # Currently only one accelerator topology is supported.
7863 {
7864 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
7865 # The value is the same as configured in the WorkloadPolicy.
7866 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
7867 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
7868 # check.
7869 &quot;error&quot;: { # Output only. Encountered errors.
7870 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7871 # operation.
7872 {
7873 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7874 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7875 # details. There is a set of defined message types to use for providing
7876 # details.The syntax depends on the error code. For example,
7877 # QuotaExceededInfo will have details when the error code is
7878 # QUOTA_EXCEEDED.
7879 {
7880 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7881 #
7882 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7883 # is not enabled:
7884 #
7885 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7886 # &quot;domain&quot;: &quot;googleapis.com&quot;
7887 # &quot;metadata&quot;: {
7888 # &quot;resource&quot;: &quot;projects/123&quot;,
7889 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7890 # }
7891 # }
7892 #
7893 # This response indicates that the pubsub.googleapis.com API is not enabled.
7894 #
7895 # Example of an error that is returned when attempting to create a Spanner
7896 # instance in a region that is out of stock:
7897 #
7898 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7899 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7900 # &quot;metadata&quot;: {
7901 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7902 # }
7903 # }
7904 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7905 # is typically the registered service name of the tool or product that
7906 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7907 # generated by some common infrastructure, the error domain must be a
7908 # globally unique value that identifies the infrastructure. For Google API
7909 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7910 &quot;metadatas&quot;: { # Additional structured details about this error.
7911 #
7912 # Keys must match a regular expression of `a-z+` but should
7913 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7914 # length. When identifying the current value of an exceeded limit, the units
7915 # should be contained in the key, not the value. For example, rather than
7916 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7917 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7918 # instances that can be created in a single (batch) request.
7919 &quot;a_key&quot;: &quot;A String&quot;,
7920 },
7921 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7922 # proximate cause of the error. Error reasons are unique within a particular
7923 # domain of errors. This should be at most 63 characters and match a
7924 # regular expression of `A-Z+[A-Z0-9]`, which represents
7925 # UPPER_SNAKE_CASE.
7926 },
7927 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7928 #
7929 # For example, if a quota check failed with an error indicating the calling
7930 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7931 # directly to the right place in the developer console to flip the bit.
7932 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7933 { # Describes a URL link.
7934 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7935 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7936 },
7937 ],
7938 },
7939 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7940 # which can be attached to an RPC error.
7941 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7942 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7943 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7944 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7945 },
7946 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7947 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7948 &quot;a_key&quot;: &quot;A String&quot;,
7949 },
7950 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7951 # type or metric.
7952 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7953 # or metric.
7954 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7955 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7956 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7957 },
7958 },
7959 ],
7960 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7961 # This property is optional.
7962 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7963 },
7964 ],
7965 },
7966 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
7967 # has // RFC3339 //
7968 # text format.
7969 },
7970 },
7971 ],
7972 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
7973 # that targets this instance group manager.
7974 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
7975 # targetSizePolicy.mode is set to BULK.
7976 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
7977 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
7978 # operation.
7979 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
7980 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7981 # operation.
7982 {
7983 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7984 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7985 # details. There is a set of defined message types to use for providing
7986 # details.The syntax depends on the error code. For example,
7987 # QuotaExceededInfo will have details when the error code is
7988 # QUOTA_EXCEEDED.
7989 {
7990 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7991 #
7992 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7993 # is not enabled:
7994 #
7995 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7996 # &quot;domain&quot;: &quot;googleapis.com&quot;
7997 # &quot;metadata&quot;: {
7998 # &quot;resource&quot;: &quot;projects/123&quot;,
7999 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8000 # }
8001 # }
8002 #
8003 # This response indicates that the pubsub.googleapis.com API is not enabled.
8004 #
8005 # Example of an error that is returned when attempting to create a Spanner
8006 # instance in a region that is out of stock:
8007 #
8008 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8009 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8010 # &quot;metadata&quot;: {
8011 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8012 # }
8013 # }
8014 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8015 # is typically the registered service name of the tool or product that
8016 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8017 # generated by some common infrastructure, the error domain must be a
8018 # globally unique value that identifies the infrastructure. For Google API
8019 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8020 &quot;metadatas&quot;: { # Additional structured details about this error.
8021 #
8022 # Keys must match a regular expression of `a-z+` but should
8023 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8024 # length. When identifying the current value of an exceeded limit, the units
8025 # should be contained in the key, not the value. For example, rather than
8026 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8027 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8028 # instances that can be created in a single (batch) request.
8029 &quot;a_key&quot;: &quot;A String&quot;,
8030 },
8031 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8032 # proximate cause of the error. Error reasons are unique within a particular
8033 # domain of errors. This should be at most 63 characters and match a
8034 # regular expression of `A-Z+[A-Z0-9]`, which represents
8035 # UPPER_SNAKE_CASE.
8036 },
8037 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8038 #
8039 # For example, if a quota check failed with an error indicating the calling
8040 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8041 # directly to the right place in the developer console to flip the bit.
8042 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8043 { # Describes a URL link.
8044 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8045 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8046 },
8047 ],
8048 },
8049 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8050 # which can be attached to an RPC error.
8051 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8052 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8053 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8054 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8055 },
8056 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8057 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8058 &quot;a_key&quot;: &quot;A String&quot;,
8059 },
8060 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8061 # type or metric.
8062 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8063 # or metric.
8064 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8065 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8066 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8067 },
8068 },
8069 ],
8070 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8071 # This property is optional.
8072 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8073 },
8074 ],
8075 },
8076 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
8077 # operation. Timestamp is in RFC3339 text format.
8078 },
8079 },
8080 &quot;currentInstanceStatuses&quot;: { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
8081 # in this managed instance group that have the status. Currently only shown
8082 # for TPU MIGs
8083 # instance group that have the status. For more information about how to
8084 # interpret each status check the instance lifecycle documentation.
8085 # Currently only shown for TPU MIGs.
8086 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
8087 # that have DEPROVISIONING status.
8088 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
8089 # have been deleted. Includes only instances that would be shown in the
8090 # listManagedInstances method and not all instances that have been
8091 # deleted in the lifetime of the MIG.
8092 # Does not include FlexStart instances that are waiting for the resources
8093 # availability, they are considered as &#x27;pending&#x27;.
8094 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
8095 # that have PENDING status, that is FlexStart instances that are waiting
8096 # for resources. Instances that do not exist because of the other reasons
8097 # are counted as &#x27;non_existent&#x27;.
8098 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
8099 # that have PENDING_STOP status.
8100 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
8101 # that have PROVISIONING status.
8102 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
8103 # that have REPAIRING status.
8104 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
8105 # that have RUNNING status.
8106 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
8107 # that have STAGING status.
8108 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
8109 # that have STOPPED status.
8110 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
8111 # that have STOPPING status.
8112 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
8113 # that have SUSPENDED status.
8114 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
8115 # that have SUSPENDING status.
8116 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
8117 # that have TERMINATED status.
8118 },
8119 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
8120 # stable state. A stable state means that: none of the instances in the
8121 # managed instance group is currently undergoing any type of change (for
8122 # example, creation, restart, or deletion); no future changes are scheduled
8123 # for instances in the managed instance group; and the managed instance
8124 # group itself is not being modified.
8125 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
8126 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
8127 # has stateful configuration, that is, if you have configured any items
8128 # in a stateful policy or in per-instance configs.
8129 # The group might report that it has no stateful configuration even when
8130 # there is still some preserved state on a managed instance, for example,
8131 # if you have deleted all PICs but not yet applied those deletions.
8132 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
8133 # has stateful configuration, that is, if you have configured any items
8134 # in a stateful policy or in per-instance configs.
8135 # The group might report that it has no stateful configuration even when
8136 # there is still some preserved state on a managed instance, for example,
8137 # if you have deleted all PICs but not yet applied those deletions. This
8138 # field is deprecated in favor of has_stateful_config.
8139 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
8140 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
8141 # (listed in the output of a listPerInstanceConfigs API call) have
8142 # status EFFECTIVE or there are no per-instance-configs.
8143 },
8144 },
8145 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
8146 # target version specified by version field on Instance Group
8147 # Manager.
8148 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
8149 # in this managed instance group, i.e. all instances are in their target
8150 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
8151 },
8152 },
8153 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
8154 # apply to all of the instances in the managed instance group.
8155 &quot;A String&quot;,
8156 ],
8157 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
8158 # You can reduce this number by using the instanceGroupManager
8159 # deleteInstances or abandonInstances methods. Resizing the group also
8160 # changes this number.
8161 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
8162 # size.
8163 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
8164 # individually or all at once.
8165 },
8166 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
8167 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
8168 # This number changes when you:
8169 #
8170 # - Stop instance using the stopInstances
8171 # method or start instances using the startInstances
8172 # method.
8173 # - Manually change the targetStoppedSize using the update
8174 # method.
8175 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
8176 # This number changes when you:
8177 #
8178 # - Suspend instance using the suspendInstances
8179 # method or resume instances using the resumeInstances
8180 # method.
8181 # - Manually change the targetSuspendedSize using the update
8182 # method.
8183 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
8184 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
8185 &quot;A String&quot;,
8186 ],
8187 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
8188 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
8189 # instance redistribution policy for regional managed instance groups.
8190 # Valid values are:
8191 #
8192 # - PROACTIVE (default): The group attempts to maintain an
8193 # even distribution of VM instances across zones in the region.
8194 # - NONE: For non-autoscaled groups, proactive
8195 # redistribution is disabled.
8196 &quot;maxSurge&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
8197 # either a fixed number or, if the group has 10 or more instances, a
8198 # percentage. If you set a percentage, the number of instances is rounded
8199 # if necessary. The default value for maxSurge is a fixed
8200 # value equal to the number of zones in which the managed instance group
8201 # operates.
8202 #
8203 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
8204 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8205 #
8206 #
8207 #
8208 # - If the value is fixed, then the calculated
8209 # value is equal to the fixed value.
8210 # - If the value is a percent, then the
8211 # calculated
8212 # value is percent/100 * targetSize. For example,
8213 # the calculated value of a 80% of a managed instance group
8214 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8215 # is a remainder, the number is rounded.
8216 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8217 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8218 # example, specify 80 for 80%.
8219 },
8220 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
8221 # process. An instance is considered available if all of the following
8222 # conditions are satisfied:
8223 #
8224 #
8225 #
8226 # - The instance&#x27;s status is
8227 # RUNNING.
8228 # - If there is a health
8229 # check on the instance group, the instance&#x27;s health check status
8230 # must be HEALTHY at least once. If there is no health check
8231 # on the group, then the instance only needs to have a status of
8232 # RUNNING to be considered available.
8233 #
8234 #
8235 # This value can be either a fixed number or, if the group has 10 or more
8236 # instances, a percentage. If you set a percentage, the number of instances
8237 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
8238 # in which the managed instance group operates.
8239 #
8240 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
8241 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8242 #
8243 #
8244 #
8245 # - If the value is fixed, then the calculated
8246 # value is equal to the fixed value.
8247 # - If the value is a percent, then the
8248 # calculated
8249 # value is percent/100 * targetSize. For example,
8250 # the calculated value of a 80% of a managed instance group
8251 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8252 # is a remainder, the number is rounded.
8253 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8254 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8255 # example, specify 80 for 80%.
8256 },
8257 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
8258 # becomes available. This value must be from range [0, 3600].
8259 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
8260 # disruption as much as possible or to apply a more disruptive action than
8261 # is necessary.
8262 #
8263 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
8264 # Compute Engine performs the necessary action to execute the update.
8265 # - To apply a more disruptive action than is strictly necessary, set the
8266 # minimal action to RESTART or REPLACE. For
8267 # example, Compute Engine does not need to restart a VM to change its
8268 # metadata. But if your application reads instance metadata only when a VM
8269 # is restarted, you can set the minimal action to RESTART in
8270 # order to pick up metadata changes.
8271 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
8272 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
8273 # as much as possible. RESTART to allow actions that can be
8274 # applied without instance replacing or REPLACE to allow all
8275 # possible actions. If the Updater determines that the minimal update
8276 # action needed is more disruptive than most disruptive allowed action you
8277 # specify it will not perform the update at all.
8278 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
8279 # See minimal_action.REPLACE
8280 &quot;type&quot;: &quot;A String&quot;, # The type
8281 # of update process. You can specify either PROACTIVE so
8282 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
8283 # to update.
8284 },
8285 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
8286 # create instances.
8287 #
8288 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
8289 # group. This field overrides the top-level instanceTemplate
8290 # field. Read more about therelationships
8291 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
8292 # remaining instances. For more information, read aboutcanary
8293 # updates.
8294 {
8295 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
8296 # instance group. The group uses this template to create new instances in
8297 # the managed instance group until the `targetSize` for this version is
8298 # reached. The templates for existing instances in the group do not change
8299 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
8300 # existing instances are updated until the `targetSize` for this version is
8301 # reached.
8302 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
8303 # managed instance group.
8304 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
8305 # even if instance_template remains unchanged.
8306 # Deprecated in favor of &#x27;name&#x27;.
8307 &quot;targetSize&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
8308 # from the template will be equal to:
8309 #
8310 #
8311 # - If expressed as a fixed number, the minimum of either
8312 # targetSize.fixed or
8313 # instanceGroupManager.targetSize is used.
8314 # - if expressed as a percent, the targetSize
8315 # would be (targetSize.percent/100 *
8316 # InstanceGroupManager.targetSize) If there is a remainder, the
8317 # number is rounded.
8318 #
8319 # If unset, this version will update any remaining instances not
8320 # updated by another version. ReadStarting
8321 # a canary update for more information.
8322 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8323 #
8324 #
8325 #
8326 # - If the value is fixed, then the calculated
8327 # value is equal to the fixed value.
8328 # - If the value is a percent, then the
8329 # calculated
8330 # value is percent/100 * targetSize. For example,
8331 # the calculated value of a 80% of a managed instance group
8332 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8333 # is a remainder, the number is rounded.
8334 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8335 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8336 # example, specify 80 for 80%.
8337 },
8338 },
8339 ],
8340 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
8341 # where the managed instance group is located (for zonal resources).
8342 },
8343 ],
8344 &quot;kind&quot;: &quot;compute#regionInstanceGroupManagerList&quot;, # Output only. The resource type, which is always compute#instanceGroupManagerList for a
8345 # list of managed instance groups that exist in th regional scope.
8346 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. This token allows you to get the next page of results for
8347 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
8348 # the query parameter pageToken in the next list request.
8349 # Subsequent list requests will have their own nextPageToken to
8350 # continue paging through the results.
8351 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource.
8352 &quot;warning&quot;: { # Output only. Informational warning message.
8353 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8354 # Engine returns NO_RESULTS_ON_PAGE if there
8355 # are no results in the response.
8356 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8357 # value format. For example:
8358 #
8359 # &quot;data&quot;: [
8360 # {
8361 # &quot;key&quot;: &quot;scope&quot;,
8362 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8363 # }
8364 {
8365 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8366 # returned. For example, for warnings where there are no results in a list
8367 # request for a particular zone, this key might be scope and
8368 # the key value might be the zone name. Other examples might be a key
8369 # indicating a deprecated resource and a suggested replacement, or a
8370 # warning about invalid network settings (for example, if an instance
8371 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8372 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8373 },
8374 ],
8375 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8376 },
8377 }</pre>
8378 </div>
8379
8380 <div class="method">
8381 <code class="details" id="listErrors">listErrors(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
8382 <pre>Lists all errors thrown by actions on instances for a given regional
8383 managed instance group. The filter andorderBy query parameters are not supported.
8384
8385 Args:
8386 project: string, Project ID for this request. (required)
8387 region: string, Name of the region scoping this request.
8388 This should conform to RFC1035. (required)
8389 instanceGroupManager: string, The name of the managed instance group.
8390 It must be a string that meets the requirements in RFC1035, or an
8391 unsigned long integer: must match regexp pattern:
8392 (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. (required)
8393 filter: string, A filter expression that filters resources listed in the response. Most
8394 Compute resources support two types of filter expressions:
8395 expressions that support regular expressions and expressions that follow
8396 API improvement proposal AIP-160.
8397 These two types of filter expressions cannot be mixed in one request.
8398
8399 If you want to use AIP-160, your expression must specify the field name, an
8400 operator, and the value that you want to use for filtering. The value
8401 must be a string, a number, or a boolean. The operator
8402 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
8403
8404 For example, if you are filtering Compute Engine instances, you can
8405 exclude instances named `example-instance` by specifying
8406 `name != example-instance`.
8407
8408 The `:*` comparison can be used to test whether a key has been defined.
8409 For example, to find all objects with `owner` label use:
8410 ```
8411 labels.owner:*
8412 ```
8413
8414 You can also filter nested fields. For example, you could specify
8415 `scheduling.automaticRestart = false` to include instances only
8416 if they are not scheduled for automatic restarts. You can use filtering
8417 on nested fields to filter based onresource labels.
8418
8419 To filter on multiple expressions, provide each separate expression within
8420 parentheses. For example:
8421 ```
8422 (scheduling.automaticRestart = true)
8423 (cpuPlatform = &quot;Intel Skylake&quot;)
8424 ```
8425 By default, each expression is an `AND` expression. However, you
8426 can include `AND` and `OR` expressions explicitly.
8427 For example:
8428 ```
8429 (cpuPlatform = &quot;Intel Skylake&quot;) OR
8430 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
8431 (scheduling.automaticRestart = true)
8432 ```
8433
8434 If you want to use a regular expression, use the `eq` (equal) or `ne`
8435 (not equal) operator against a single un-parenthesized expression with or
8436 without quotes or against multiple parenthesized expressions. Examples:
8437
8438 `fieldname eq unquoted literal`
8439 `fieldname eq &#x27;single quoted literal&#x27;`
8440 `fieldname eq &quot;double quoted literal&quot;`
8441 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
8442
8443 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
8444 The literal value must match the entire field.
8445
8446 For example, to filter for instances that do not end with name &quot;instance&quot;,
8447 you would use `name ne .*instance`.
8448
8449 You cannot combine constraints on multiple fields using regular
8450 expressions.
8451 maxResults: integer, The maximum number of results per page that should be returned.
8452 If the number of available results is larger than `maxResults`,
8453 Compute Engine returns a `nextPageToken` that can be used to get
8454 the next page of results in subsequent list requests. Acceptable values are
8455 `0` to `500`, inclusive. (Default: `500`)
8456 orderBy: string, Sorts list results by a certain order. By default, results
8457 are returned in alphanumerical order based on the resource name.
8458
8459 You can also sort results in descending order based on the creation
8460 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
8461 results based on the `creationTimestamp` field in
8462 reverse chronological order (newest result first). Use this to sort
8463 resources like operations so that the newest operation is returned first.
8464
8465 Currently, only sorting by `name` or
8466 `creationTimestamp desc` is supported.
8467 pageToken: string, Specifies a page token to use. Set `pageToken` to the
8468 `nextPageToken` returned by a previous list request to get
8469 the next page of results.
8470 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
8471 of failure. The default value is false.
8472
8473 For example, when partial success behavior is enabled, aggregatedList for a
8474 single zone scope either returns all resources in the zone or no resources,
8475 with an error code.
8476 x__xgafv: string, V1 error format.
8477 Allowed values
8478 1 - v1 error format
8479 2 - v2 error format
8480
8481 Returns:
8482 An object of the form:
8483
8484 {
8485 &quot;items&quot;: [ # [Output Only] The list of errors of the managed instance group.
8486 {
8487 &quot;error&quot;: { # Output only. Contents of the error.
8488 &quot;code&quot;: &quot;A String&quot;, # Output only. Error code.
8489 &quot;message&quot;: &quot;A String&quot;, # Output only. Error message.
8490 },
8491 &quot;instanceActionDetails&quot;: { # Output only. Details of the instance action that triggered this error.
8492 # May be null, if the error was not caused by an action on an instance.
8493 # This field is optional.
8494 &quot;action&quot;: &quot;A String&quot;, # Output only. Action that managed instance group was executing on the instance when the
8495 # error occurred. Possible values:
8496 &quot;instance&quot;: &quot;A String&quot;, # Output only. The URL of the instance. The URL can be set even if the instance has not
8497 # yet been created.
8498 &quot;version&quot;: { # Output only. Version this instance was created from, or was being
8499 # created from, but the creation failed. Corresponds to one of the versions
8500 # that were set on the Instance Group Manager resource at the time this
8501 # instance was being created.
8502 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
8503 # when current_action is one of { DELETING, ABANDONING }.
8504 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] Name of the version.
8505 },
8506 },
8507 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. The time that this error occurred. This value is in RFC3339 text format.
8508 },
8509 ],
8510 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
8511 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
8512 # the query parameter pageToken in the next list request.
8513 # Subsequent list requests will have their own nextPageToken to
8514 # continue paging through the results.
8515 }</pre>
8516 </div>
8517
8518 <div class="method">
8519 <code class="details" id="listErrors_next">listErrors_next()</code>
8520 <pre>Retrieves the next page of results.
8521
8522 Args:
8523 previous_request: The request for the previous page. (required)
8524 previous_response: The response from the request for the previous page. (required)
8525
8526 Returns:
8527 A request object that you can call &#x27;execute()&#x27; on to request the next
8528 page. Returns None if there are no more items in the collection.
8529 </pre>
8530 </div>
8531
8532 <div class="method">
8533 <code class="details" id="listManagedInstances">listManagedInstances(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
8534 <pre>Lists the instances in the managed instance group and instances that are
8535 scheduled to be created. The list includes any current actions
8536 that the group has scheduled for its instances. The orderBy
8537 query parameter is not supported. The `pageToken` query parameter is
8538 supported only if the group&#x27;s `listManagedInstancesResults` field is set
8539 to `PAGINATED`.
8540
8541 Args:
8542 project: string, Project ID for this request. (required)
8543 region: string, Name of the region scoping this request. (required)
8544 instanceGroupManager: string, The name of the managed instance group. (required)
8545 filter: string, A filter expression that filters resources listed in the response. Most
8546 Compute resources support two types of filter expressions:
8547 expressions that support regular expressions and expressions that follow
8548 API improvement proposal AIP-160.
8549 These two types of filter expressions cannot be mixed in one request.
8550
8551 If you want to use AIP-160, your expression must specify the field name, an
8552 operator, and the value that you want to use for filtering. The value
8553 must be a string, a number, or a boolean. The operator
8554 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
8555
8556 For example, if you are filtering Compute Engine instances, you can
8557 exclude instances named `example-instance` by specifying
8558 `name != example-instance`.
8559
8560 The `:*` comparison can be used to test whether a key has been defined.
8561 For example, to find all objects with `owner` label use:
8562 ```
8563 labels.owner:*
8564 ```
8565
8566 You can also filter nested fields. For example, you could specify
8567 `scheduling.automaticRestart = false` to include instances only
8568 if they are not scheduled for automatic restarts. You can use filtering
8569 on nested fields to filter based onresource labels.
8570
8571 To filter on multiple expressions, provide each separate expression within
8572 parentheses. For example:
8573 ```
8574 (scheduling.automaticRestart = true)
8575 (cpuPlatform = &quot;Intel Skylake&quot;)
8576 ```
8577 By default, each expression is an `AND` expression. However, you
8578 can include `AND` and `OR` expressions explicitly.
8579 For example:
8580 ```
8581 (cpuPlatform = &quot;Intel Skylake&quot;) OR
8582 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
8583 (scheduling.automaticRestart = true)
8584 ```
8585
8586 If you want to use a regular expression, use the `eq` (equal) or `ne`
8587 (not equal) operator against a single un-parenthesized expression with or
8588 without quotes or against multiple parenthesized expressions. Examples:
8589
8590 `fieldname eq unquoted literal`
8591 `fieldname eq &#x27;single quoted literal&#x27;`
8592 `fieldname eq &quot;double quoted literal&quot;`
8593 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
8594
8595 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
8596 The literal value must match the entire field.
8597
8598 For example, to filter for instances that do not end with name &quot;instance&quot;,
8599 you would use `name ne .*instance`.
8600
8601 You cannot combine constraints on multiple fields using regular
8602 expressions.
8603 maxResults: integer, The maximum number of results per page that should be returned.
8604 If the number of available results is larger than `maxResults`,
8605 Compute Engine returns a `nextPageToken` that can be used to get
8606 the next page of results in subsequent list requests. Acceptable values are
8607 `0` to `500`, inclusive. (Default: `500`)
8608 orderBy: string, Sorts list results by a certain order. By default, results
8609 are returned in alphanumerical order based on the resource name.
8610
8611 You can also sort results in descending order based on the creation
8612 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
8613 results based on the `creationTimestamp` field in
8614 reverse chronological order (newest result first). Use this to sort
8615 resources like operations so that the newest operation is returned first.
8616
8617 Currently, only sorting by `name` or
8618 `creationTimestamp desc` is supported.
8619 pageToken: string, Specifies a page token to use. Set `pageToken` to the
8620 `nextPageToken` returned by a previous list request to get
8621 the next page of results.
8622 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
8623 of failure. The default value is false.
8624
8625 For example, when partial success behavior is enabled, aggregatedList for a
8626 single zone scope either returns all resources in the zone or no resources,
8627 with an error code.
8628 x__xgafv: string, V1 error format.
8629 Allowed values
8630 1 - v1 error format
8631 2 - v2 error format
8632
8633 Returns:
8634 An object of the form:
8635
8636 {
8637 &quot;managedInstances&quot;: [ # A list of managed instances.
8638 { # A Managed Instance resource.
8639 &quot;allInstancesConfig&quot;: { # Output only. [Output Only] Current all-instances configuration revision applied to this
8640 # instance.
8641 &quot;revision&quot;: &quot;A String&quot;, # Output only. [Output Only] Current all-instances configuration revision.
8642 # This value is in RFC3339 text format.
8643 },
8644 &quot;currentAction&quot;: &quot;A String&quot;, # Output only. [Output Only] The current action that the managed instance group has
8645 # scheduled for the instance. Possible values:
8646 #
8647 # - NONE The instance is running, and the managed
8648 # instance group does not have any scheduled actions for this instance.
8649 # - CREATING The managed instance group is creating this
8650 # instance. If the group fails to create this instance, it will try again
8651 # until it is successful.
8652 # - CREATING_WITHOUT_RETRIES The managed instance group
8653 # is attempting to create this instance only once. If the group fails
8654 # to create this instance, it does not try again and the group&#x27;stargetSize value is decreased instead.
8655 # - RECREATING The managed instance group is recreating
8656 # this instance.
8657 # - DELETING The managed instance group is permanently
8658 # deleting this instance.
8659 # - ABANDONING The managed instance group is abandoning
8660 # this instance. The instance will be removed from the instance group
8661 # and from any target pools that are associated with this group.
8662 # - RESTARTING The managed instance group is restarting
8663 # the instance.
8664 # - REFRESHING The managed instance group is applying
8665 # configuration changes to the instance without stopping it. For example,
8666 # the group can update the target pool list for an instance without
8667 # stopping that instance.
8668 # - VERIFYING The managed instance group has created the
8669 # instance and it is in the process of being verified.
8670 &quot;currentActionDetails&quot;: {
8671 &quot;methodName&quot;: &quot;A String&quot;,
8672 &quot;trigger&quot;: &quot;A String&quot;, # Output only. [Output Only] Details of the current action that the managed instance
8673 # group has scheduled for the instance. Contains trigger for the current
8674 # action, and methodName in case it was triggered by API call. Possible
8675 # values for trigger:
8676 #
8677 # - API Any API call.
8678 # - PROACTIVE_UPDATE Proactive updater scheduled an update
8679 # on this managed instance.
8680 # - AUTOSCALING Instance being deleted/created after a
8681 # decision from the Autoscaler.
8682 # - REDISTRIBUTION The regional managed instance group is
8683 # moving instances between zones to restore balance.
8684 # - STANDBY_REFILL The managed instance group is refilling
8685 # the Standby Pool (stopped/suspended virtual machines) after scale
8686 # up.
8687 # - MAINTENANCE Manual maintenance.
8688 # - FAILED_CREATION The managed instance group is handling
8689 # failed instance creation.
8690 # - INSTANCE_FAILURE The managed instance group is handling
8691 # instance failure, according to
8692 # the Instance Lifecycle Policy.
8693 # - FAILED_HEALTH_CHECK The managed instance group is
8694 # handling failed health check, according to the Instance Lifecycle
8695 # Policy.
8696 # - TERMINATION_TIMESTAMP Instance reached termination time,
8697 # thus managed instance group stops/deletes it.
8698 },
8699 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output only] The unique identifier for this resource. This field is empty
8700 # when instance does not exist.
8701 &quot;instance&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of the instance. The URL can exist even if the
8702 # instance has not yet been created.
8703 &quot;instanceFlexibilityOverride&quot;: { # Output only. [Output Only] The overrides to instance properties resulting from
8704 # InstanceFlexibilityPolicy.
8705 &quot;disks&quot;: [ # List of disks to be attached to the instance.
8706 { # An instance-attached disk resource.
8707 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
8708 # or X86_64.
8709 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
8710 # deleted (but not when the disk is detached from the instance).
8711 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
8712 # partition of the disk for its root filesystem.
8713 &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
8714 # running within the instance. This name can be used to reference the device
8715 # for mounting, resizing, and so on, from within the instance.
8716 #
8717 # If not specified, the server chooses a default device name to apply to this
8718 # disk, in the form persistent-disk-x, where x is a number
8719 # assigned by Google Compute Engine. This field is only applicable for
8720 # persistent disks.
8721 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
8722 # encryption key.
8723 #
8724 # If you are creating a new disk, this field encrypts the new disk using
8725 # an encryption key that you provide. If you are attaching an existing
8726 # disk that is already encrypted, this field decrypts the disk using
8727 # the customer-supplied encryption key.
8728 #
8729 # If you encrypt a disk using a customer-supplied key, you must provide the
8730 # same key again when you attempt to use this resource at a later time. For
8731 # example, you must provide the key when you create a snapshot or an image
8732 # from the disk or when you attach the disk to a virtual machine instance.
8733 #
8734 # If you do not provide an encryption key, then the disk will be encrypted
8735 # using an automatically generated key and you do not need to provide a key
8736 # to use the disk later.
8737 #
8738 # Note:
8739 #
8740 # Instance templates do not storecustomer-supplied
8741 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
8742 #
8743 # You cannot create VMs that have disks with customer-supplied keys using
8744 # the bulk
8745 # insert method.
8746 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
8747 # For example:
8748 #
8749 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8750 # key_region/cryptoKeys/key
8751 #
8752 # The fully-qualifed key name may be returned for resource GET requests. For
8753 # example:
8754 #
8755 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8756 # key_region/cryptoKeys/key
8757 # /cryptoKeyVersions/1
8758 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
8759 # key. If absent, the Compute Engine default service account is used.
8760 # For example:
8761 #
8762 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
8763 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
8764 # encryption key, encoded in RFC
8765 # 4648 base64 to either encrypt or decrypt this resource. You can
8766 # provide either the rawKey or thersaEncryptedKey.
8767 # For example:
8768 #
8769 # &quot;rawKey&quot;:
8770 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
8771 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
8772 # customer-supplied encryption key to either encrypt or decrypt this
8773 # resource. You can provide either the rawKey or thersaEncryptedKey.
8774 # For example:
8775 #
8776 # &quot;rsaEncryptedKey&quot;:
8777 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
8778 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
8779 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
8780 #
8781 # The key must meet the following requirements before you can provide it to
8782 # Compute Engine:
8783 #
8784 # 1. The key is wrapped using a RSA public key certificate provided by
8785 # Google.
8786 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
8787 # encoding.
8788 #
8789 # Gets the RSA public key certificate provided by Google at:
8790 #
8791 #
8792 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
8793 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
8794 # 4648 base64 encoded SHA-256 hash of the customer-supplied
8795 # encryption key that protects this resource.
8796 },
8797 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
8798 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
8799 # currently attached to another instance. If you try to force attach a zonal
8800 # disk to an instance, you will receive an error.
8801 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
8802 # only for bootable images. Read
8803 # Enabling guest operating system features to see a list of available
8804 # options.
8805 { # Guest OS features.
8806 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
8807 # separate values. Set to one or more of the following values:
8808 #
8809 # - VIRTIO_SCSI_MULTIQUEUE
8810 # - WINDOWS
8811 # - MULTI_IP_SUBNET
8812 # - UEFI_COMPATIBLE
8813 # - GVNIC
8814 # - SEV_CAPABLE
8815 # - SUSPEND_RESUME_COMPATIBLE
8816 # - SEV_LIVE_MIGRATABLE_V2
8817 # - SEV_SNP_CAPABLE
8818 # - TDX_CAPABLE
8819 # - IDPF
8820 # - SNP_SVSM_CAPABLE
8821 # - CCA_CAPABLE
8822 #
8823 #
8824 # For more information, see
8825 # Enabling guest operating system features.
8826 },
8827 ],
8828 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
8829 # boot disk. If you have many disks attached to an instance, each
8830 # disk would have a unique index number.
8831 &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
8832 # alongside the new instance. Use initialization parameters to create boot
8833 # disks or local SSDs attached to the new instance.
8834 #
8835 # This property is mutually exclusive with the source property;
8836 # you can only define one or the other, but not both.
8837 # alongside the new instance. Use initialization parameters to create boot
8838 # disks or local SSDs attached to the new instance.
8839 #
8840 # This field is persisted and returned for instanceTemplate and not returned
8841 # in the context of instance.
8842 #
8843 # This property is mutually exclusive with the source property;
8844 # you can only define one or the other, but not both.
8845 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
8846 # arm64 or x86_64.
8847 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
8848 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
8849 # of the instance. If a disk with the same name already exists in the given
8850 # region, the existing disk is attached to the new instance and the
8851 # new disk is not created.
8852 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
8853 # 10 GB. If you specify a sourceImage, which is required for
8854 # boot disks, the default size is the size of the sourceImage.
8855 # If you do not specify a sourceImage, the default disk size
8856 # is 500 GB.
8857 &quot;diskType&quot;: &quot;A String&quot;,
8858 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
8859 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
8860 # only for bootable images. Read
8861 # Enabling guest operating system features to see a list of available
8862 # options.
8863 #
8864 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
8865 { # Guest OS features.
8866 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
8867 # separate values. Set to one or more of the following values:
8868 #
8869 # - VIRTIO_SCSI_MULTIQUEUE
8870 # - WINDOWS
8871 # - MULTI_IP_SUBNET
8872 # - UEFI_COMPATIBLE
8873 # - GVNIC
8874 # - SEV_CAPABLE
8875 # - SUSPEND_RESUME_COMPATIBLE
8876 # - SEV_LIVE_MIGRATABLE_V2
8877 # - SEV_SNP_CAPABLE
8878 # - TDX_CAPABLE
8879 # - IDPF
8880 # - SNP_SVSM_CAPABLE
8881 # - CCA_CAPABLE
8882 #
8883 #
8884 # For more information, see
8885 # Enabling guest operating system features.
8886 },
8887 ],
8888 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
8889 # which is either SCSI or NVME. The default isSCSI.
8890 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
8891 # persistent disks.
8892 &quot;a_key&quot;: &quot;A String&quot;,
8893 },
8894 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
8895 # disk.
8896 &quot;A String&quot;,
8897 ],
8898 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
8899 &quot;A String&quot;,
8900 ],
8901 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
8902 # more than one instance.
8903 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
8904 # is to use the existing disk.
8905 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
8906 # of I/O operations per second that the disk can handle. Values must be
8907 # between 10,000 and 120,000. For more details, see theExtreme persistent
8908 # disk documentation.
8909 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
8910 # number of throughput mb per second that the disk can handle. Values must
8911 # greater than or equal to 1.
8912 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
8913 # the URLs of the zones where the disk should be replicated to.
8914 # You must provide exactly two replica zones, and one zone must be the same
8915 # as the instance zone.
8916 &quot;A String&quot;,
8917 ],
8918 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
8919 # have the same definition as resource
8920 # manager tags. Keys and values can be either in numeric format,
8921 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
8922 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
8923 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
8924 # empty.
8925 &quot;a_key&quot;: &quot;A String&quot;,
8926 },
8927 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
8928 # Specified using the full or partial URL. For instance template, specify
8929 # only the resource policy name.
8930 &quot;A String&quot;,
8931 ],
8932 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
8933 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
8934 # is required.
8935 #
8936 # To create a disk with one of the public operating system
8937 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
8938 #
8939 # projects/debian-cloud/global/images/family/debian-9
8940 #
8941 #
8942 # Alternatively, use a specific version of a public operating system image:
8943 #
8944 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
8945 #
8946 #
8947 # To create a disk with a custom image that you created, specify the
8948 # image name in the following format:
8949 #
8950 # global/images/my-custom-image
8951 #
8952 #
8953 # You can also specify a custom image by its image family, which returns
8954 # the latest version of the image in that family. Replace the image name
8955 # with family/family-name:
8956 #
8957 # global/images/family/my-image-family
8958 #
8959 #
8960 # If the source image is deleted later, this field will not be set.
8961 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
8962 # encryption key of the source image. Required if the source image is
8963 # protected by a customer-supplied encryption key.
8964 #
8965 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
8966 # encryption keys, so you cannot create disks for instances in a managed instance group if the
8967 # source images are encrypted with your own keys.
8968 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
8969 # For example:
8970 #
8971 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8972 # key_region/cryptoKeys/key
8973 #
8974 # The fully-qualifed key name may be returned for resource GET requests. For
8975 # example:
8976 #
8977 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8978 # key_region/cryptoKeys/key
8979 # /cryptoKeyVersions/1
8980 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
8981 # key. If absent, the Compute Engine default service account is used.
8982 # For example:
8983 #
8984 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
8985 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
8986 # encryption key, encoded in RFC
8987 # 4648 base64 to either encrypt or decrypt this resource. You can
8988 # provide either the rawKey or thersaEncryptedKey.
8989 # For example:
8990 #
8991 # &quot;rawKey&quot;:
8992 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
8993 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
8994 # customer-supplied encryption key to either encrypt or decrypt this
8995 # resource. You can provide either the rawKey or thersaEncryptedKey.
8996 # For example:
8997 #
8998 # &quot;rsaEncryptedKey&quot;:
8999 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9000 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9001 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9002 #
9003 # The key must meet the following requirements before you can provide it to
9004 # Compute Engine:
9005 #
9006 # 1. The key is wrapped using a RSA public key certificate provided by
9007 # Google.
9008 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9009 # encoding.
9010 #
9011 # Gets the RSA public key certificate provided by Google at:
9012 #
9013 #
9014 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9015 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9016 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9017 # encryption key that protects this resource.
9018 },
9019 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
9020 # instance boot disk, one of initializeParams.sourceSnapshot
9021 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
9022 # is required.
9023 #
9024 # To create a disk with a snapshot that you created, specify the
9025 # snapshot name in the following format:
9026 #
9027 # us-central1-a/instantSnapshots/my-backup
9028 #
9029 #
9030 # If the source instant-snapshot is deleted later, this field will not be
9031 # set.
9032 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
9033 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
9034 # is required.
9035 #
9036 # To create a disk with a snapshot that you created, specify the
9037 # snapshot name in the following format:
9038 #
9039 # global/snapshots/my-backup
9040 #
9041 #
9042 # If the source snapshot is deleted later, this field will not be set.
9043 #
9044 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
9045 # an image instead when you create VMs using
9046 # the bulk
9047 # insert method.
9048 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
9049 # encryption key of the source snapshot.
9050 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9051 # For example:
9052 #
9053 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9054 # key_region/cryptoKeys/key
9055 #
9056 # The fully-qualifed key name may be returned for resource GET requests. For
9057 # example:
9058 #
9059 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9060 # key_region/cryptoKeys/key
9061 # /cryptoKeyVersions/1
9062 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9063 # key. If absent, the Compute Engine default service account is used.
9064 # For example:
9065 #
9066 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9067 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9068 # encryption key, encoded in RFC
9069 # 4648 base64 to either encrypt or decrypt this resource. You can
9070 # provide either the rawKey or thersaEncryptedKey.
9071 # For example:
9072 #
9073 # &quot;rawKey&quot;:
9074 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9075 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9076 # customer-supplied encryption key to either encrypt or decrypt this
9077 # resource. You can provide either the rawKey or thersaEncryptedKey.
9078 # For example:
9079 #
9080 # &quot;rsaEncryptedKey&quot;:
9081 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9082 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9083 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9084 #
9085 # The key must meet the following requirements before you can provide it to
9086 # Compute Engine:
9087 #
9088 # 1. The key is wrapped using a RSA public key certificate provided by
9089 # Google.
9090 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9091 # encoding.
9092 #
9093 # Gets the RSA public key certificate provided by Google at:
9094 #
9095 #
9096 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9097 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9098 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9099 # encryption key that protects this resource.
9100 },
9101 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
9102 # this as a partial or full URL to the resource. For example, the following
9103 # are valid values:
9104 #
9105 #
9106 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
9107 # - projects/project/zones/zone/storagePools/storagePool
9108 # - zones/zone/storagePools/storagePool
9109 },
9110 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
9111 # either SCSI or NVME. For most machine types, the
9112 # default is SCSI. Local SSDs can use either NVME or SCSI.
9113 # In certain configurations, persistent disks can use NVMe. For more
9114 # information, seeAbout
9115 # persistent disks.
9116 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
9117 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
9118 &quot;A String&quot;,
9119 ],
9120 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
9121 # disk is not allowed to be detached from the instance, or to be used as the
9122 # source of the snapshot creation, and the image creation. The instance with
9123 # at least one locked attached disk is not allow to be used as source of
9124 # machine image creation, instant snapshot creation, and not allowed to be
9125 # deleted with --keep-disk parameter set to true for locked disks.
9126 &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
9127 # in READ_WRITE mode.
9128 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
9129 # field is set to PRESERVED if the LocalSSD data has been saved
9130 # to a persistent location by customer request. (see the
9131 # discard_local_ssd option on Stop/Suspend).
9132 # Read-only in the api.
9133 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
9134 # these are public keys which are safe to store in public
9135 &quot;dbs&quot;: [ # The Key Database (db).
9136 {
9137 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9138 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9139 },
9140 ],
9141 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
9142 {
9143 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9144 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9145 },
9146 ],
9147 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
9148 {
9149 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9150 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9151 },
9152 ],
9153 &quot;pk&quot;: { # The Platform Key (PK).
9154 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9155 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9156 },
9157 },
9158 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
9159 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
9160 # is required.
9161 #
9162 # If desired, you can also attach existing non-root persistent disks using
9163 # this property. This field is only applicable for persistent disks.
9164 #
9165 # Note that for InstanceTemplate, specify the disk name for zonal disk,
9166 # and the URL for regional disk.
9167 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
9168 },
9169 ],
9170 &quot;machineType&quot;: &quot;A String&quot;, # The machine type to be used for this instance.
9171 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance.
9172 # e.g. &#x27;Intel Ice Lake&#x27;.
9173 &quot;provisioningModel&quot;: &quot;A String&quot;, # The provisioning model to be used for this instance.
9174 },
9175 &quot;instanceHealth&quot;: [ # Output only. [Output Only] Health state of the instance per health-check.
9176 {
9177 &quot;detailedHealthState&quot;: &quot;A String&quot;, # Output only. [Output Only] The current detailed instance health state.
9178 &quot;healthCheck&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for the health check that verifies whether the
9179 # instance is healthy.
9180 &quot;healthState&quot;: &quot;A String&quot;, # Output only. [Output Only] The current instance health state.
9181 # This field will not get promoted to beta/GA and might be removed from
9182 # alpha APIs after 01/12/2019. Please use detailed_health_state field
9183 # instead.
9184 },
9185 ],
9186 &quot;instanceStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the instance. This field is empty when
9187 # the instance does not exist.
9188 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
9189 # when current_action is one of { DELETING, ABANDONING }.
9190 &quot;lastAttempt&quot;: { # Output only. [Output Only] Information about the last attempt to create or delete
9191 # the instance.
9192 &quot;errors&quot;: { # Output only. [Output Only] Encountered errors during the last attempt to create or
9193 # delete the instance.
9194 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
9195 # operation.
9196 {
9197 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
9198 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
9199 # details. There is a set of defined message types to use for providing
9200 # details.The syntax depends on the error code. For example,
9201 # QuotaExceededInfo will have details when the error code is
9202 # QUOTA_EXCEEDED.
9203 {
9204 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
9205 #
9206 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
9207 # is not enabled:
9208 #
9209 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
9210 # &quot;domain&quot;: &quot;googleapis.com&quot;
9211 # &quot;metadata&quot;: {
9212 # &quot;resource&quot;: &quot;projects/123&quot;,
9213 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
9214 # }
9215 # }
9216 #
9217 # This response indicates that the pubsub.googleapis.com API is not enabled.
9218 #
9219 # Example of an error that is returned when attempting to create a Spanner
9220 # instance in a region that is out of stock:
9221 #
9222 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
9223 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
9224 # &quot;metadata&quot;: {
9225 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
9226 # }
9227 # }
9228 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
9229 # is typically the registered service name of the tool or product that
9230 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
9231 # generated by some common infrastructure, the error domain must be a
9232 # globally unique value that identifies the infrastructure. For Google API
9233 # infrastructure, the error domain is &quot;googleapis.com&quot;.
9234 &quot;metadatas&quot;: { # Additional structured details about this error.
9235 #
9236 # Keys must match a regular expression of `a-z+` but should
9237 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
9238 # length. When identifying the current value of an exceeded limit, the units
9239 # should be contained in the key, not the value. For example, rather than
9240 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
9241 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
9242 # instances that can be created in a single (batch) request.
9243 &quot;a_key&quot;: &quot;A String&quot;,
9244 },
9245 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
9246 # proximate cause of the error. Error reasons are unique within a particular
9247 # domain of errors. This should be at most 63 characters and match a
9248 # regular expression of `A-Z+[A-Z0-9]`, which represents
9249 # UPPER_SNAKE_CASE.
9250 },
9251 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
9252 #
9253 # For example, if a quota check failed with an error indicating the calling
9254 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
9255 # directly to the right place in the developer console to flip the bit.
9256 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
9257 { # Describes a URL link.
9258 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
9259 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
9260 },
9261 ],
9262 },
9263 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
9264 # which can be attached to an RPC error.
9265 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
9266 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
9267 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
9268 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
9269 },
9270 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
9271 &quot;dimensions&quot;: { # The map holding related quota dimensions.
9272 &quot;a_key&quot;: &quot;A String&quot;,
9273 },
9274 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
9275 # type or metric.
9276 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
9277 # or metric.
9278 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
9279 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
9280 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
9281 },
9282 },
9283 ],
9284 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
9285 # This property is optional.
9286 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
9287 },
9288 ],
9289 },
9290 },
9291 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] The name of the instance. The name always exists even if the
9292 # instance has not yet been created.
9293 &quot;preservedStateFromConfig&quot;: { # Preserved state for a given instance. # Output only. [Output Only] Preserved state applied from per-instance config
9294 # for this instance.
9295 &quot;disks&quot;: { # Preserved disks defined for this instance.
9296 # This map is keyed with the device names of the disks.
9297 &quot;a_key&quot;: {
9298 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
9299 # update, instance recreate operations. This flag is used to configure
9300 # if the disk should be deleted after it is no longer used by the group,
9301 # e.g. when the given instance or the whole MIG is deleted.
9302 # Note: disks attached in READ_ONLY mode cannot be
9303 # auto-deleted.
9304 &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
9305 # disk in READ_WRITE mode.
9306 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
9307 # to the VM instance.
9308 },
9309 },
9310 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
9311 # This map is keyed with the name of the network interface.
9312 &quot;a_key&quot;: {
9313 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9314 # update or VM instance recreate operations.
9315 # This flag is used to configure if the IP reservation should be deleted
9316 # after it is no longer used by the group, e.g. when the given instance
9317 # or the whole group is deleted.
9318 &quot;ipAddress&quot;: { # Ip address representation
9319 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
9320 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
9321 # network interface.
9322 },
9323 },
9324 },
9325 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
9326 # This map is keyed with the name of the network interface.
9327 &quot;a_key&quot;: {
9328 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9329 # update or VM instance recreate operations.
9330 # This flag is used to configure if the IP reservation should be deleted
9331 # after it is no longer used by the group, e.g. when the given instance
9332 # or the whole group is deleted.
9333 &quot;ipAddress&quot;: { # Ip address representation
9334 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
9335 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
9336 # network interface.
9337 },
9338 },
9339 },
9340 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
9341 &quot;a_key&quot;: &quot;A String&quot;,
9342 },
9343 },
9344 &quot;preservedStateFromPolicy&quot;: { # Preserved state for a given instance. # Output only. [Output Only] Preserved state generated based on stateful policy
9345 # for this instance.
9346 &quot;disks&quot;: { # Preserved disks defined for this instance.
9347 # This map is keyed with the device names of the disks.
9348 &quot;a_key&quot;: {
9349 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
9350 # update, instance recreate operations. This flag is used to configure
9351 # if the disk should be deleted after it is no longer used by the group,
9352 # e.g. when the given instance or the whole MIG is deleted.
9353 # Note: disks attached in READ_ONLY mode cannot be
9354 # auto-deleted.
9355 &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
9356 # disk in READ_WRITE mode.
9357 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
9358 # to the VM instance.
9359 },
9360 },
9361 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
9362 # This map is keyed with the name of the network interface.
9363 &quot;a_key&quot;: {
9364 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9365 # update or VM instance recreate operations.
9366 # This flag is used to configure if the IP reservation should be deleted
9367 # after it is no longer used by the group, e.g. when the given instance
9368 # or the whole group is deleted.
9369 &quot;ipAddress&quot;: { # Ip address representation
9370 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
9371 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
9372 # network interface.
9373 },
9374 },
9375 },
9376 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
9377 # This map is keyed with the name of the network interface.
9378 &quot;a_key&quot;: {
9379 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9380 # update or VM instance recreate operations.
9381 # This flag is used to configure if the IP reservation should be deleted
9382 # after it is no longer used by the group, e.g. when the given instance
9383 # or the whole group is deleted.
9384 &quot;ipAddress&quot;: { # Ip address representation
9385 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
9386 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
9387 # network interface.
9388 },
9389 },
9390 },
9391 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
9392 &quot;a_key&quot;: &quot;A String&quot;,
9393 },
9394 },
9395 &quot;propertiesFromFlexibilityPolicy&quot;: { # Output only. [Output Only] Instance properties selected for this instance resulting from
9396 # InstanceFlexibilityPolicy.
9397 &quot;disks&quot;: [ # List of disks to be attached to the instance.
9398 { # An instance-attached disk resource.
9399 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
9400 # or X86_64.
9401 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
9402 # deleted (but not when the disk is detached from the instance).
9403 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
9404 # partition of the disk for its root filesystem.
9405 &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
9406 # running within the instance. This name can be used to reference the device
9407 # for mounting, resizing, and so on, from within the instance.
9408 #
9409 # If not specified, the server chooses a default device name to apply to this
9410 # disk, in the form persistent-disk-x, where x is a number
9411 # assigned by Google Compute Engine. This field is only applicable for
9412 # persistent disks.
9413 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
9414 # encryption key.
9415 #
9416 # If you are creating a new disk, this field encrypts the new disk using
9417 # an encryption key that you provide. If you are attaching an existing
9418 # disk that is already encrypted, this field decrypts the disk using
9419 # the customer-supplied encryption key.
9420 #
9421 # If you encrypt a disk using a customer-supplied key, you must provide the
9422 # same key again when you attempt to use this resource at a later time. For
9423 # example, you must provide the key when you create a snapshot or an image
9424 # from the disk or when you attach the disk to a virtual machine instance.
9425 #
9426 # If you do not provide an encryption key, then the disk will be encrypted
9427 # using an automatically generated key and you do not need to provide a key
9428 # to use the disk later.
9429 #
9430 # Note:
9431 #
9432 # Instance templates do not storecustomer-supplied
9433 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
9434 #
9435 # You cannot create VMs that have disks with customer-supplied keys using
9436 # the bulk
9437 # insert method.
9438 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9439 # For example:
9440 #
9441 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9442 # key_region/cryptoKeys/key
9443 #
9444 # The fully-qualifed key name may be returned for resource GET requests. For
9445 # example:
9446 #
9447 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9448 # key_region/cryptoKeys/key
9449 # /cryptoKeyVersions/1
9450 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9451 # key. If absent, the Compute Engine default service account is used.
9452 # For example:
9453 #
9454 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9455 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9456 # encryption key, encoded in RFC
9457 # 4648 base64 to either encrypt or decrypt this resource. You can
9458 # provide either the rawKey or thersaEncryptedKey.
9459 # For example:
9460 #
9461 # &quot;rawKey&quot;:
9462 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9463 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9464 # customer-supplied encryption key to either encrypt or decrypt this
9465 # resource. You can provide either the rawKey or thersaEncryptedKey.
9466 # For example:
9467 #
9468 # &quot;rsaEncryptedKey&quot;:
9469 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9470 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9471 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9472 #
9473 # The key must meet the following requirements before you can provide it to
9474 # Compute Engine:
9475 #
9476 # 1. The key is wrapped using a RSA public key certificate provided by
9477 # Google.
9478 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9479 # encoding.
9480 #
9481 # Gets the RSA public key certificate provided by Google at:
9482 #
9483 #
9484 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9485 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9486 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9487 # encryption key that protects this resource.
9488 },
9489 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
9490 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
9491 # currently attached to another instance. If you try to force attach a zonal
9492 # disk to an instance, you will receive an error.
9493 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
9494 # only for bootable images. Read
9495 # Enabling guest operating system features to see a list of available
9496 # options.
9497 { # Guest OS features.
9498 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
9499 # separate values. Set to one or more of the following values:
9500 #
9501 # - VIRTIO_SCSI_MULTIQUEUE
9502 # - WINDOWS
9503 # - MULTI_IP_SUBNET
9504 # - UEFI_COMPATIBLE
9505 # - GVNIC
9506 # - SEV_CAPABLE
9507 # - SUSPEND_RESUME_COMPATIBLE
9508 # - SEV_LIVE_MIGRATABLE_V2
9509 # - SEV_SNP_CAPABLE
9510 # - TDX_CAPABLE
9511 # - IDPF
9512 # - SNP_SVSM_CAPABLE
9513 # - CCA_CAPABLE
9514 #
9515 #
9516 # For more information, see
9517 # Enabling guest operating system features.
9518 },
9519 ],
9520 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
9521 # boot disk. If you have many disks attached to an instance, each
9522 # disk would have a unique index number.
9523 &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
9524 # alongside the new instance. Use initialization parameters to create boot
9525 # disks or local SSDs attached to the new instance.
9526 #
9527 # This property is mutually exclusive with the source property;
9528 # you can only define one or the other, but not both.
9529 # alongside the new instance. Use initialization parameters to create boot
9530 # disks or local SSDs attached to the new instance.
9531 #
9532 # This field is persisted and returned for instanceTemplate and not returned
9533 # in the context of instance.
9534 #
9535 # This property is mutually exclusive with the source property;
9536 # you can only define one or the other, but not both.
9537 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
9538 # arm64 or x86_64.
9539 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
9540 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
9541 # of the instance. If a disk with the same name already exists in the given
9542 # region, the existing disk is attached to the new instance and the
9543 # new disk is not created.
9544 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
9545 # 10 GB. If you specify a sourceImage, which is required for
9546 # boot disks, the default size is the size of the sourceImage.
9547 # If you do not specify a sourceImage, the default disk size
9548 # is 500 GB.
9549 &quot;diskType&quot;: &quot;A String&quot;,
9550 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
9551 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
9552 # only for bootable images. Read
9553 # Enabling guest operating system features to see a list of available
9554 # options.
9555 #
9556 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
9557 { # Guest OS features.
9558 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
9559 # separate values. Set to one or more of the following values:
9560 #
9561 # - VIRTIO_SCSI_MULTIQUEUE
9562 # - WINDOWS
9563 # - MULTI_IP_SUBNET
9564 # - UEFI_COMPATIBLE
9565 # - GVNIC
9566 # - SEV_CAPABLE
9567 # - SUSPEND_RESUME_COMPATIBLE
9568 # - SEV_LIVE_MIGRATABLE_V2
9569 # - SEV_SNP_CAPABLE
9570 # - TDX_CAPABLE
9571 # - IDPF
9572 # - SNP_SVSM_CAPABLE
9573 # - CCA_CAPABLE
9574 #
9575 #
9576 # For more information, see
9577 # Enabling guest operating system features.
9578 },
9579 ],
9580 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
9581 # which is either SCSI or NVME. The default isSCSI.
9582 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
9583 # persistent disks.
9584 &quot;a_key&quot;: &quot;A String&quot;,
9585 },
9586 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
9587 # disk.
9588 &quot;A String&quot;,
9589 ],
9590 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
9591 &quot;A String&quot;,
9592 ],
9593 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
9594 # more than one instance.
9595 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
9596 # is to use the existing disk.
9597 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
9598 # of I/O operations per second that the disk can handle. Values must be
9599 # between 10,000 and 120,000. For more details, see theExtreme persistent
9600 # disk documentation.
9601 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
9602 # number of throughput mb per second that the disk can handle. Values must
9603 # greater than or equal to 1.
9604 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
9605 # the URLs of the zones where the disk should be replicated to.
9606 # You must provide exactly two replica zones, and one zone must be the same
9607 # as the instance zone.
9608 &quot;A String&quot;,
9609 ],
9610 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
9611 # have the same definition as resource
9612 # manager tags. Keys and values can be either in numeric format,
9613 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
9614 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
9615 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
9616 # empty.
9617 &quot;a_key&quot;: &quot;A String&quot;,
9618 },
9619 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
9620 # Specified using the full or partial URL. For instance template, specify
9621 # only the resource policy name.
9622 &quot;A String&quot;,
9623 ],
9624 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
9625 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
9626 # is required.
9627 #
9628 # To create a disk with one of the public operating system
9629 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
9630 #
9631 # projects/debian-cloud/global/images/family/debian-9
9632 #
9633 #
9634 # Alternatively, use a specific version of a public operating system image:
9635 #
9636 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
9637 #
9638 #
9639 # To create a disk with a custom image that you created, specify the
9640 # image name in the following format:
9641 #
9642 # global/images/my-custom-image
9643 #
9644 #
9645 # You can also specify a custom image by its image family, which returns
9646 # the latest version of the image in that family. Replace the image name
9647 # with family/family-name:
9648 #
9649 # global/images/family/my-image-family
9650 #
9651 #
9652 # If the source image is deleted later, this field will not be set.
9653 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
9654 # encryption key of the source image. Required if the source image is
9655 # protected by a customer-supplied encryption key.
9656 #
9657 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
9658 # encryption keys, so you cannot create disks for instances in a managed instance group if the
9659 # source images are encrypted with your own keys.
9660 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9661 # For example:
9662 #
9663 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9664 # key_region/cryptoKeys/key
9665 #
9666 # The fully-qualifed key name may be returned for resource GET requests. For
9667 # example:
9668 #
9669 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9670 # key_region/cryptoKeys/key
9671 # /cryptoKeyVersions/1
9672 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9673 # key. If absent, the Compute Engine default service account is used.
9674 # For example:
9675 #
9676 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9677 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9678 # encryption key, encoded in RFC
9679 # 4648 base64 to either encrypt or decrypt this resource. You can
9680 # provide either the rawKey or thersaEncryptedKey.
9681 # For example:
9682 #
9683 # &quot;rawKey&quot;:
9684 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9685 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9686 # customer-supplied encryption key to either encrypt or decrypt this
9687 # resource. You can provide either the rawKey or thersaEncryptedKey.
9688 # For example:
9689 #
9690 # &quot;rsaEncryptedKey&quot;:
9691 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9692 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9693 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9694 #
9695 # The key must meet the following requirements before you can provide it to
9696 # Compute Engine:
9697 #
9698 # 1. The key is wrapped using a RSA public key certificate provided by
9699 # Google.
9700 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9701 # encoding.
9702 #
9703 # Gets the RSA public key certificate provided by Google at:
9704 #
9705 #
9706 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9707 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9708 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9709 # encryption key that protects this resource.
9710 },
9711 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
9712 # instance boot disk, one of initializeParams.sourceSnapshot
9713 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
9714 # is required.
9715 #
9716 # To create a disk with a snapshot that you created, specify the
9717 # snapshot name in the following format:
9718 #
9719 # us-central1-a/instantSnapshots/my-backup
9720 #
9721 #
9722 # If the source instant-snapshot is deleted later, this field will not be
9723 # set.
9724 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
9725 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
9726 # is required.
9727 #
9728 # To create a disk with a snapshot that you created, specify the
9729 # snapshot name in the following format:
9730 #
9731 # global/snapshots/my-backup
9732 #
9733 #
9734 # If the source snapshot is deleted later, this field will not be set.
9735 #
9736 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
9737 # an image instead when you create VMs using
9738 # the bulk
9739 # insert method.
9740 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
9741 # encryption key of the source snapshot.
9742 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9743 # For example:
9744 #
9745 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9746 # key_region/cryptoKeys/key
9747 #
9748 # The fully-qualifed key name may be returned for resource GET requests. For
9749 # example:
9750 #
9751 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9752 # key_region/cryptoKeys/key
9753 # /cryptoKeyVersions/1
9754 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9755 # key. If absent, the Compute Engine default service account is used.
9756 # For example:
9757 #
9758 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9759 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9760 # encryption key, encoded in RFC
9761 # 4648 base64 to either encrypt or decrypt this resource. You can
9762 # provide either the rawKey or thersaEncryptedKey.
9763 # For example:
9764 #
9765 # &quot;rawKey&quot;:
9766 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9767 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9768 # customer-supplied encryption key to either encrypt or decrypt this
9769 # resource. You can provide either the rawKey or thersaEncryptedKey.
9770 # For example:
9771 #
9772 # &quot;rsaEncryptedKey&quot;:
9773 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9774 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9775 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9776 #
9777 # The key must meet the following requirements before you can provide it to
9778 # Compute Engine:
9779 #
9780 # 1. The key is wrapped using a RSA public key certificate provided by
9781 # Google.
9782 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9783 # encoding.
9784 #
9785 # Gets the RSA public key certificate provided by Google at:
9786 #
9787 #
9788 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9789 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9790 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9791 # encryption key that protects this resource.
9792 },
9793 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
9794 # this as a partial or full URL to the resource. For example, the following
9795 # are valid values:
9796 #
9797 #
9798 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
9799 # - projects/project/zones/zone/storagePools/storagePool
9800 # - zones/zone/storagePools/storagePool
9801 },
9802 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
9803 # either SCSI or NVME. For most machine types, the
9804 # default is SCSI. Local SSDs can use either NVME or SCSI.
9805 # In certain configurations, persistent disks can use NVMe. For more
9806 # information, seeAbout
9807 # persistent disks.
9808 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
9809 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
9810 &quot;A String&quot;,
9811 ],
9812 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
9813 # disk is not allowed to be detached from the instance, or to be used as the
9814 # source of the snapshot creation, and the image creation. The instance with
9815 # at least one locked attached disk is not allow to be used as source of
9816 # machine image creation, instant snapshot creation, and not allowed to be
9817 # deleted with --keep-disk parameter set to true for locked disks.
9818 &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
9819 # in READ_WRITE mode.
9820 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
9821 # field is set to PRESERVED if the LocalSSD data has been saved
9822 # to a persistent location by customer request. (see the
9823 # discard_local_ssd option on Stop/Suspend).
9824 # Read-only in the api.
9825 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
9826 # these are public keys which are safe to store in public
9827 &quot;dbs&quot;: [ # The Key Database (db).
9828 {
9829 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9830 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9831 },
9832 ],
9833 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
9834 {
9835 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9836 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9837 },
9838 ],
9839 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
9840 {
9841 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9842 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9843 },
9844 ],
9845 &quot;pk&quot;: { # The Platform Key (PK).
9846 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9847 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9848 },
9849 },
9850 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
9851 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
9852 # is required.
9853 #
9854 # If desired, you can also attach existing non-root persistent disks using
9855 # this property. This field is only applicable for persistent disks.
9856 #
9857 # Note that for InstanceTemplate, specify the disk name for zonal disk,
9858 # and the URL for regional disk.
9859 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
9860 },
9861 ],
9862 &quot;machineType&quot;: &quot;A String&quot;, # Output only. The machine type to be used for this instance.
9863 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance.
9864 # e.g. &#x27;Intel Ice Lake&#x27;.
9865 &quot;provisioningModel&quot;: &quot;A String&quot;, # Output only. The provisioning model to be used for this instance.
9866 },
9867 &quot;scheduling&quot;: { # Output only. [Output Only] Information about the termination timestamp of the instance,
9868 # if applicable.
9869 &quot;gracefulShutdownTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The timestamp at which the underlying instance will be
9870 # triggered for graceful shutdown if it is configured. This is in RFC3339 text format.
9871 &quot;terminationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The timestamp at which the managed instance will be
9872 # terminated. This is in RFC3339 text format.
9873 },
9874 &quot;shutdownDetails&quot;: { # Output only. [Output Only] Specifies the graceful shutdown details if the instance is in
9875 # `PENDING_STOP` state or there is a programmed stop scheduled.
9876 &quot;maxDuration&quot;: { # A Duration represents a fixed-length span of time represented # Output only. [Output Only] The duration for graceful shutdown. Only applicable when
9877 # the instance is in `PENDING_STOP` state.
9878 # as a count of seconds and fractions of seconds at nanosecond
9879 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9880 # or &quot;month&quot;. Range is approximately 10,000 years.
9881 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9882 # Durations less than one second are represented with a 0
9883 # `seconds` field and a positive `nanos` field. Must be from 0
9884 # to 999,999,999 inclusive.
9885 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9886 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9887 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9888 },
9889 &quot;requestTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Past timestamp indicating the beginning of `PENDING_STOP`
9890 # state of instance in RFC3339 text format.
9891 },
9892 &quot;sizeInUnit&quot;: 3.14, # Output only. [Output only] The size of the VM represented by this Managed Instance.
9893 # This is how much this Managed Instance contributes to the
9894 # size of the group.
9895 &quot;tag&quot;: &quot;A String&quot;, # Output only. [Output Only] Tag describing the version.
9896 &quot;targetStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] The eventual status of the instance. The instance group
9897 # manager will not be identified as stable till each managed instance reaches
9898 # its targetStatus.
9899 &quot;version&quot;: { # Output only. [Output Only] Intended version of this instance.
9900 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
9901 # when current_action is one of { DELETING, ABANDONING }.
9902 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] Name of the version.
9903 },
9904 },
9905 ],
9906 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
9907 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
9908 # the query parameter pageToken in the next list request.
9909 # Subsequent list requests will have their own nextPageToken to
9910 # continue paging through the results.
9911 }</pre>
9912 </div>
9913
9914 <div class="method">
9915 <code class="details" id="listManagedInstances_next">listManagedInstances_next()</code>
9916 <pre>Retrieves the next page of results.
9917
9918 Args:
9919 previous_request: The request for the previous page. (required)
9920 previous_response: The response from the request for the previous page. (required)
9921
9922 Returns:
9923 A request object that you can call &#x27;execute()&#x27; on to request the next
9924 page. Returns None if there are no more items in the collection.
9925 </pre>
9926 </div>
9927
9928 <div class="method">
9929 <code class="details" id="listPerInstanceConfigs">listPerInstanceConfigs(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
9930 <pre>Lists all of the per-instance configurations defined for the managed
9931 instance group. The orderBy query parameter is not supported.
9932
9933 Args:
9934 project: string, Project ID for this request. (required)
9935 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
9936 instanceGroupManager: string, The name of the managed instance group. It should conform to RFC1035. (required)
9937 filter: string, A filter expression that filters resources listed in the response. Most
9938 Compute resources support two types of filter expressions:
9939 expressions that support regular expressions and expressions that follow
9940 API improvement proposal AIP-160.
9941 These two types of filter expressions cannot be mixed in one request.
9942
9943 If you want to use AIP-160, your expression must specify the field name, an
9944 operator, and the value that you want to use for filtering. The value
9945 must be a string, a number, or a boolean. The operator
9946 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
9947
9948 For example, if you are filtering Compute Engine instances, you can
9949 exclude instances named `example-instance` by specifying
9950 `name != example-instance`.
9951
9952 The `:*` comparison can be used to test whether a key has been defined.
9953 For example, to find all objects with `owner` label use:
9954 ```
9955 labels.owner:*
9956 ```
9957
9958 You can also filter nested fields. For example, you could specify
9959 `scheduling.automaticRestart = false` to include instances only
9960 if they are not scheduled for automatic restarts. You can use filtering
9961 on nested fields to filter based onresource labels.
9962
9963 To filter on multiple expressions, provide each separate expression within
9964 parentheses. For example:
9965 ```
9966 (scheduling.automaticRestart = true)
9967 (cpuPlatform = &quot;Intel Skylake&quot;)
9968 ```
9969 By default, each expression is an `AND` expression. However, you
9970 can include `AND` and `OR` expressions explicitly.
9971 For example:
9972 ```
9973 (cpuPlatform = &quot;Intel Skylake&quot;) OR
9974 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
9975 (scheduling.automaticRestart = true)
9976 ```
9977
9978 If you want to use a regular expression, use the `eq` (equal) or `ne`
9979 (not equal) operator against a single un-parenthesized expression with or
9980 without quotes or against multiple parenthesized expressions. Examples:
9981
9982 `fieldname eq unquoted literal`
9983 `fieldname eq &#x27;single quoted literal&#x27;`
9984 `fieldname eq &quot;double quoted literal&quot;`
9985 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
9986
9987 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
9988 The literal value must match the entire field.
9989
9990 For example, to filter for instances that do not end with name &quot;instance&quot;,
9991 you would use `name ne .*instance`.
9992
9993 You cannot combine constraints on multiple fields using regular
9994 expressions.
9995 maxResults: integer, The maximum number of results per page that should be returned.
9996 If the number of available results is larger than `maxResults`,
9997 Compute Engine returns a `nextPageToken` that can be used to get
9998 the next page of results in subsequent list requests. Acceptable values are
9999 `0` to `500`, inclusive. (Default: `500`)
10000 orderBy: string, Sorts list results by a certain order. By default, results
10001 are returned in alphanumerical order based on the resource name.
10002
10003 You can also sort results in descending order based on the creation
10004 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
10005 results based on the `creationTimestamp` field in
10006 reverse chronological order (newest result first). Use this to sort
10007 resources like operations so that the newest operation is returned first.
10008
10009 Currently, only sorting by `name` or
10010 `creationTimestamp desc` is supported.
10011 pageToken: string, Specifies a page token to use. Set `pageToken` to the
10012 `nextPageToken` returned by a previous list request to get
10013 the next page of results.
10014 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
10015 of failure. The default value is false.
10016
10017 For example, when partial success behavior is enabled, aggregatedList for a
10018 single zone scope either returns all resources in the zone or no resources,
10019 with an error code.
10020 x__xgafv: string, V1 error format.
10021 Allowed values
10022 1 - v1 error format
10023 2 - v2 error format
10024
10025 Returns:
10026 An object of the form:
10027
10028 {
10029 &quot;items&quot;: [ # Output only. [Output Only] The list of PerInstanceConfig.
10030 {
10031 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
10032 # optimistic locking. It is ignored when inserting a per-instance
10033 # config. An up-to-date fingerprint must be provided in order to update an
10034 # existing per-instance configuration or the field needs to be unset.
10035 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
10036 # Serves as a merge key during UpdatePerInstanceConfigs
10037 # operations, that is, if a per-instance configuration with the same name
10038 # exists then it will be updated, otherwise a new one will be created for the
10039 # VM instance with the same name. An attempt to create a per-instance
10040 # configuration for a VM instance that either doesn&#x27;t exist or is not part
10041 # of the group will result in an error.
10042 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
10043 # preserved state generated from a stateful policy.
10044 &quot;disks&quot;: { # Preserved disks defined for this instance.
10045 # This map is keyed with the device names of the disks.
10046 &quot;a_key&quot;: {
10047 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
10048 # update, instance recreate operations. This flag is used to configure
10049 # if the disk should be deleted after it is no longer used by the group,
10050 # e.g. when the given instance or the whole MIG is deleted.
10051 # Note: disks attached in READ_ONLY mode cannot be
10052 # auto-deleted.
10053 &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
10054 # disk in READ_WRITE mode.
10055 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
10056 # to the VM instance.
10057 },
10058 },
10059 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
10060 # This map is keyed with the name of the network interface.
10061 &quot;a_key&quot;: {
10062 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
10063 # update or VM instance recreate operations.
10064 # This flag is used to configure if the IP reservation should be deleted
10065 # after it is no longer used by the group, e.g. when the given instance
10066 # or the whole group is deleted.
10067 &quot;ipAddress&quot;: { # Ip address representation
10068 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
10069 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
10070 # network interface.
10071 },
10072 },
10073 },
10074 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
10075 # This map is keyed with the name of the network interface.
10076 &quot;a_key&quot;: {
10077 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
10078 # update or VM instance recreate operations.
10079 # This flag is used to configure if the IP reservation should be deleted
10080 # after it is no longer used by the group, e.g. when the given instance
10081 # or the whole group is deleted.
10082 &quot;ipAddress&quot;: { # Ip address representation
10083 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
10084 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
10085 # network interface.
10086 },
10087 },
10088 },
10089 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
10090 &quot;a_key&quot;: &quot;A String&quot;,
10091 },
10092 },
10093 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
10094 # managed instance.
10095 },
10096 ],
10097 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
10098 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
10099 # the query parameter pageToken in the next list request.
10100 # Subsequent list requests will have their own nextPageToken to
10101 # continue paging through the results.
10102 &quot;warning&quot;: { # Output only. [Output Only] Informational warning message.
10103 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
10104 # Engine returns NO_RESULTS_ON_PAGE if there
10105 # are no results in the response.
10106 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
10107 # value format. For example:
10108 #
10109 # &quot;data&quot;: [
10110 # {
10111 # &quot;key&quot;: &quot;scope&quot;,
10112 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
10113 # }
10114 {
10115 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
10116 # returned. For example, for warnings where there are no results in a list
10117 # request for a particular zone, this key might be scope and
10118 # the key value might be the zone name. Other examples might be a key
10119 # indicating a deprecated resource and a suggested replacement, or a
10120 # warning about invalid network settings (for example, if an instance
10121 # attempts to perform IP forwarding but is not enabled for IP forwarding).
10122 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
10123 },
10124 ],
10125 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
10126 },
10127 }</pre>
10128 </div>
10129
10130 <div class="method">
10131 <code class="details" id="listPerInstanceConfigs_next">listPerInstanceConfigs_next()</code>
10132 <pre>Retrieves the next page of results.
10133
10134 Args:
10135 previous_request: The request for the previous page. (required)
10136 previous_response: The response from the request for the previous page. (required)
10137
10138 Returns:
10139 A request object that you can call &#x27;execute()&#x27; on to request the next
10140 page. Returns None if there are no more items in the collection.
10141 </pre>
10142 </div>
10143
10144 <div class="method">
10145 <code class="details" id="list_next">list_next()</code>
10146 <pre>Retrieves the next page of results.
10147
10148 Args:
10149 previous_request: The request for the previous page. (required)
10150 previous_response: The response from the request for the previous page. (required)
10151
10152 Returns:
10153 A request object that you can call &#x27;execute()&#x27; on to request the next
10154 page. Returns None if there are no more items in the collection.
10155 </pre>
10156 </div>
10157
10158 <div class="method">
10159 <code class="details" id="patch">patch(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
10160 <pre>Updates a managed instance group using the information that you specify
10161 in the request.
10162 This operation is marked as DONE when the group is patched
10163 even if the instances in the group are still in the process of being
10164 patched. You must separately verify the status of the individual instances
10165 with the listmanagedinstances
10166 method. This method supportsPATCH
10167 semantics and uses theJSON merge
10168 patch format and processing rules.
10169
10170 If you update your group to specify a new template or instance
10171 configuration, it&#x27;s possible that your intended specification for each VM
10172 in the group is different from the current state of that VM. To learn how
10173 to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
10174 a MIG.
10175
10176 Args:
10177 project: string, Project ID for this request. (required)
10178 region: string, Name of the region scoping this request. (required)
10179 instanceGroupManager: string, The name of the instance group manager. (required)
10180 body: object, The request body.
10181 The object takes the form of:
10182
10183 { # Represents a Managed Instance Group resource.
10184 #
10185 # An instance group is a collection of VM instances that you can manage as a
10186 # single entity. For more information, readInstance groups.
10187 #
10188 # For zonal Managed Instance Group, use the instanceGroupManagers
10189 # resource.
10190 #
10191 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
10192 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
10193 # for the group.
10194 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
10195 #
10196 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
10197 # instances to apply the configuration. To apply the configuration, set the
10198 # group&#x27;s updatePolicy.type field to use proactive updates or
10199 # use the applyUpdatesToInstances method.
10200 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
10201 &quot;a_key&quot;: &quot;A String&quot;,
10202 },
10203 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
10204 # more information, see Project and
10205 # instance metadata.
10206 &quot;a_key&quot;: &quot;A String&quot;,
10207 },
10208 },
10209 },
10210 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
10211 # only one value.
10212 {
10213 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
10214 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
10215 # this field controls whether to trigger VM autohealing based on a failed
10216 # health check. Valid values are:
10217 #
10218 # - ON (default): The group recreates running VMs that
10219 # fail the application-based health check.
10220 # - OFF: When set to OFF, you can still observe instance
10221 # health state, but the group does not recreate VMs that fail the
10222 # application-based health check. This is useful for troubleshooting and
10223 # setting up your health check configuration.
10224 },
10225 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
10226 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
10227 # initialize and run its startup script. During a VM&#x27;s initial delay
10228 # period, the MIG ignores unsuccessful health checks because the VM might
10229 # be in the startup process. This prevents the MIG from prematurely
10230 # recreating a VM. If the health check receives a healthy response during
10231 # the initial delay, it indicates that the startup process is complete and
10232 # the VM is ready. The value of initial delay must be between 0 and 3600
10233 # seconds. The default value is 0.
10234 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
10235 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
10236 # The instance is considered available if all of the following conditions
10237 # are satisfied:
10238 # 1. Instance&#x27;s status is RUNNING.
10239 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
10240 # check result was observed to be HEALTHY at least once as it passed
10241 # VERIFYING).
10242 # 3. There is no outgoing action on an instance triggered by IGM.
10243 #
10244 # By default, number of concurrently autohealed instances is smaller than
10245 # the managed instance group target size. However, if a zonal managed
10246 # instance group has only one instance, or a regional managed instance
10247 # group has only one instance per zone, autohealing will recreate these
10248 # instances when they become unhealthy.
10249 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
10250 #
10251 #
10252 #
10253 # - If the value is fixed, then the calculated
10254 # value is equal to the fixed value.
10255 # - If the value is a percent, then the
10256 # calculated
10257 # value is percent/100 * targetSize. For example,
10258 # the calculated value of a 80% of a managed instance group
10259 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
10260 # is a remainder, the number is rounded.
10261 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
10262 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
10263 # example, specify 80 for 80%.
10264 },
10265 },
10266 ],
10267 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
10268 # all VMs in a MIG. The maximum character length is 58 and the name must
10269 # comply with RFC1035 format.
10270 #
10271 # When a VM is created in the group, the MIG appends a hyphen and a random
10272 # four-character string to the base instance name. If you want the MIG to
10273 # assign sequential numbers instead of a random string, then end the base
10274 # instance name with a hyphen followed by one or more hash symbols. The hash
10275 # symbols indicate the number of digits. For example, a base instance name of
10276 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
10277 # @pattern
10278 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
10279 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
10280 # text format.
10281 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
10282 # in this managed instance group that are scheduled for each of those
10283 # actions.
10284 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
10285 # that are scheduled to be abandoned. Abandoning an instance removes it
10286 # from the managed instance group without deleting it.
10287 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
10288 # are scheduled to be adopted or are currently being adopted.
10289 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
10290 # are scheduled to be created or are currently being created. If the group
10291 # fails to create any of these instances, it tries again until it creates
10292 # the instance successfully.
10293 #
10294 # If you have disabled creation retries, this field will not be populated;
10295 # instead, the creatingWithoutRetries field will be populated.
10296 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
10297 # will attempt to create atomically, in a batch mode. If the desired count
10298 # of instances can not be created, entire batch will be deleted and the
10299 # group will decrease its targetSize value accordingly.
10300 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
10301 # will attempt to create. The group attempts to create each instance
10302 # only once. If the group fails to create any of these instances, it
10303 # decreases the group&#x27;s targetSize value accordingly.
10304 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
10305 # are scheduled to be deleted or are currently being deleted.
10306 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
10307 # are running and have no scheduled actions.
10308 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
10309 # is currently queuing.
10310 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
10311 # are scheduled to be recreated or are currently being being recreated.
10312 # Recreating an instance deletes the existing root persistent disk
10313 # and creates a new disk from the image that is defined in the
10314 # instance template.
10315 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
10316 # are being reconfigured with properties that do not require a restart
10317 # or a recreate action. For example, setting or removing target
10318 # pools for the instance.
10319 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
10320 # are scheduled to be restarted or are currently being restarted.
10321 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
10322 # are scheduled to be restarted or are currently being restarted.
10323 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
10324 # are scheduled to be resumed or are currently being resumed.
10325 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
10326 # are scheduled to be started or are currently being started.
10327 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
10328 # are scheduled to be stopped or are currently being stopped.
10329 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
10330 # are scheduled to be suspended or are currently being suspended.
10331 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
10332 # are being verified. See the managedInstances[].currentAction
10333 # property in the listManagedInstances method documentation.
10334 },
10335 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
10336 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
10337 # zones in a regional managed instance group.
10338 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
10339 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
10340 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
10341 # its instances.
10342 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
10343 # instances, even if an AI zone is available in the specified region. To
10344 # create instances in an AI zone in the selected region, you must explicitly
10345 # specify it in the distribution policy together with the other preferred
10346 # zones.
10347 {
10348 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
10349 # The zone must exist in the region where the managed instance group is
10350 # located.
10351 },
10352 ],
10353 },
10354 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
10355 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
10356 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
10357 # fingerprint must be provided in order to update the InstanceGroupManager,
10358 # otherwise the request will fail with error412 conditionNotMet.
10359 #
10360 # To see the latest fingerprint, make a get() request to
10361 # retrieve an InstanceGroupManager.
10362 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
10363 # generates this identifier.
10364 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
10365 # types of machines.
10366 # Instance flexibility configuration on MIG overrides instance
10367 # template configuration.
10368 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
10369 # when creating new VMs.
10370 &quot;a_key&quot;: {
10371 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
10372 # selection.
10373 { # An instance-attached disk resource.
10374 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
10375 # or X86_64.
10376 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
10377 # deleted (but not when the disk is detached from the instance).
10378 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
10379 # partition of the disk for its root filesystem.
10380 &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
10381 # running within the instance. This name can be used to reference the device
10382 # for mounting, resizing, and so on, from within the instance.
10383 #
10384 # If not specified, the server chooses a default device name to apply to this
10385 # disk, in the form persistent-disk-x, where x is a number
10386 # assigned by Google Compute Engine. This field is only applicable for
10387 # persistent disks.
10388 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
10389 # encryption key.
10390 #
10391 # If you are creating a new disk, this field encrypts the new disk using
10392 # an encryption key that you provide. If you are attaching an existing
10393 # disk that is already encrypted, this field decrypts the disk using
10394 # the customer-supplied encryption key.
10395 #
10396 # If you encrypt a disk using a customer-supplied key, you must provide the
10397 # same key again when you attempt to use this resource at a later time. For
10398 # example, you must provide the key when you create a snapshot or an image
10399 # from the disk or when you attach the disk to a virtual machine instance.
10400 #
10401 # If you do not provide an encryption key, then the disk will be encrypted
10402 # using an automatically generated key and you do not need to provide a key
10403 # to use the disk later.
10404 #
10405 # Note:
10406 #
10407 # Instance templates do not storecustomer-supplied
10408 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
10409 #
10410 # You cannot create VMs that have disks with customer-supplied keys using
10411 # the bulk
10412 # insert method.
10413 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
10414 # For example:
10415 #
10416 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10417 # key_region/cryptoKeys/key
10418 #
10419 # The fully-qualifed key name may be returned for resource GET requests. For
10420 # example:
10421 #
10422 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10423 # key_region/cryptoKeys/key
10424 # /cryptoKeyVersions/1
10425 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
10426 # key. If absent, the Compute Engine default service account is used.
10427 # For example:
10428 #
10429 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
10430 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
10431 # encryption key, encoded in RFC
10432 # 4648 base64 to either encrypt or decrypt this resource. You can
10433 # provide either the rawKey or thersaEncryptedKey.
10434 # For example:
10435 #
10436 # &quot;rawKey&quot;:
10437 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
10438 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
10439 # customer-supplied encryption key to either encrypt or decrypt this
10440 # resource. You can provide either the rawKey or thersaEncryptedKey.
10441 # For example:
10442 #
10443 # &quot;rsaEncryptedKey&quot;:
10444 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
10445 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
10446 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
10447 #
10448 # The key must meet the following requirements before you can provide it to
10449 # Compute Engine:
10450 #
10451 # 1. The key is wrapped using a RSA public key certificate provided by
10452 # Google.
10453 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
10454 # encoding.
10455 #
10456 # Gets the RSA public key certificate provided by Google at:
10457 #
10458 #
10459 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
10460 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
10461 # 4648 base64 encoded SHA-256 hash of the customer-supplied
10462 # encryption key that protects this resource.
10463 },
10464 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
10465 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
10466 # currently attached to another instance. If you try to force attach a zonal
10467 # disk to an instance, you will receive an error.
10468 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
10469 # only for bootable images. Read
10470 # Enabling guest operating system features to see a list of available
10471 # options.
10472 { # Guest OS features.
10473 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
10474 # separate values. Set to one or more of the following values:
10475 #
10476 # - VIRTIO_SCSI_MULTIQUEUE
10477 # - WINDOWS
10478 # - MULTI_IP_SUBNET
10479 # - UEFI_COMPATIBLE
10480 # - GVNIC
10481 # - SEV_CAPABLE
10482 # - SUSPEND_RESUME_COMPATIBLE
10483 # - SEV_LIVE_MIGRATABLE_V2
10484 # - SEV_SNP_CAPABLE
10485 # - TDX_CAPABLE
10486 # - IDPF
10487 # - SNP_SVSM_CAPABLE
10488 # - CCA_CAPABLE
10489 #
10490 #
10491 # For more information, see
10492 # Enabling guest operating system features.
10493 },
10494 ],
10495 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
10496 # boot disk. If you have many disks attached to an instance, each
10497 # disk would have a unique index number.
10498 &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
10499 # alongside the new instance. Use initialization parameters to create boot
10500 # disks or local SSDs attached to the new instance.
10501 #
10502 # This property is mutually exclusive with the source property;
10503 # you can only define one or the other, but not both.
10504 # alongside the new instance. Use initialization parameters to create boot
10505 # disks or local SSDs attached to the new instance.
10506 #
10507 # This field is persisted and returned for instanceTemplate and not returned
10508 # in the context of instance.
10509 #
10510 # This property is mutually exclusive with the source property;
10511 # you can only define one or the other, but not both.
10512 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
10513 # arm64 or x86_64.
10514 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
10515 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
10516 # of the instance. If a disk with the same name already exists in the given
10517 # region, the existing disk is attached to the new instance and the
10518 # new disk is not created.
10519 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
10520 # 10 GB. If you specify a sourceImage, which is required for
10521 # boot disks, the default size is the size of the sourceImage.
10522 # If you do not specify a sourceImage, the default disk size
10523 # is 500 GB.
10524 &quot;diskType&quot;: &quot;A String&quot;,
10525 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
10526 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
10527 # only for bootable images. Read
10528 # Enabling guest operating system features to see a list of available
10529 # options.
10530 #
10531 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
10532 { # Guest OS features.
10533 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
10534 # separate values. Set to one or more of the following values:
10535 #
10536 # - VIRTIO_SCSI_MULTIQUEUE
10537 # - WINDOWS
10538 # - MULTI_IP_SUBNET
10539 # - UEFI_COMPATIBLE
10540 # - GVNIC
10541 # - SEV_CAPABLE
10542 # - SUSPEND_RESUME_COMPATIBLE
10543 # - SEV_LIVE_MIGRATABLE_V2
10544 # - SEV_SNP_CAPABLE
10545 # - TDX_CAPABLE
10546 # - IDPF
10547 # - SNP_SVSM_CAPABLE
10548 # - CCA_CAPABLE
10549 #
10550 #
10551 # For more information, see
10552 # Enabling guest operating system features.
10553 },
10554 ],
10555 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
10556 # which is either SCSI or NVME. The default isSCSI.
10557 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
10558 # persistent disks.
10559 &quot;a_key&quot;: &quot;A String&quot;,
10560 },
10561 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
10562 # disk.
10563 &quot;A String&quot;,
10564 ],
10565 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
10566 &quot;A String&quot;,
10567 ],
10568 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
10569 # more than one instance.
10570 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
10571 # is to use the existing disk.
10572 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
10573 # of I/O operations per second that the disk can handle. Values must be
10574 # between 10,000 and 120,000. For more details, see theExtreme persistent
10575 # disk documentation.
10576 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
10577 # number of throughput mb per second that the disk can handle. Values must
10578 # greater than or equal to 1.
10579 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
10580 # the URLs of the zones where the disk should be replicated to.
10581 # You must provide exactly two replica zones, and one zone must be the same
10582 # as the instance zone.
10583 &quot;A String&quot;,
10584 ],
10585 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
10586 # have the same definition as resource
10587 # manager tags. Keys and values can be either in numeric format,
10588 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
10589 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
10590 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
10591 # empty.
10592 &quot;a_key&quot;: &quot;A String&quot;,
10593 },
10594 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
10595 # Specified using the full or partial URL. For instance template, specify
10596 # only the resource policy name.
10597 &quot;A String&quot;,
10598 ],
10599 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
10600 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
10601 # is required.
10602 #
10603 # To create a disk with one of the public operating system
10604 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
10605 #
10606 # projects/debian-cloud/global/images/family/debian-9
10607 #
10608 #
10609 # Alternatively, use a specific version of a public operating system image:
10610 #
10611 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
10612 #
10613 #
10614 # To create a disk with a custom image that you created, specify the
10615 # image name in the following format:
10616 #
10617 # global/images/my-custom-image
10618 #
10619 #
10620 # You can also specify a custom image by its image family, which returns
10621 # the latest version of the image in that family. Replace the image name
10622 # with family/family-name:
10623 #
10624 # global/images/family/my-image-family
10625 #
10626 #
10627 # If the source image is deleted later, this field will not be set.
10628 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
10629 # encryption key of the source image. Required if the source image is
10630 # protected by a customer-supplied encryption key.
10631 #
10632 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
10633 # encryption keys, so you cannot create disks for instances in a managed instance group if the
10634 # source images are encrypted with your own keys.
10635 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
10636 # For example:
10637 #
10638 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10639 # key_region/cryptoKeys/key
10640 #
10641 # The fully-qualifed key name may be returned for resource GET requests. For
10642 # example:
10643 #
10644 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10645 # key_region/cryptoKeys/key
10646 # /cryptoKeyVersions/1
10647 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
10648 # key. If absent, the Compute Engine default service account is used.
10649 # For example:
10650 #
10651 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
10652 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
10653 # encryption key, encoded in RFC
10654 # 4648 base64 to either encrypt or decrypt this resource. You can
10655 # provide either the rawKey or thersaEncryptedKey.
10656 # For example:
10657 #
10658 # &quot;rawKey&quot;:
10659 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
10660 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
10661 # customer-supplied encryption key to either encrypt or decrypt this
10662 # resource. You can provide either the rawKey or thersaEncryptedKey.
10663 # For example:
10664 #
10665 # &quot;rsaEncryptedKey&quot;:
10666 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
10667 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
10668 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
10669 #
10670 # The key must meet the following requirements before you can provide it to
10671 # Compute Engine:
10672 #
10673 # 1. The key is wrapped using a RSA public key certificate provided by
10674 # Google.
10675 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
10676 # encoding.
10677 #
10678 # Gets the RSA public key certificate provided by Google at:
10679 #
10680 #
10681 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
10682 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
10683 # 4648 base64 encoded SHA-256 hash of the customer-supplied
10684 # encryption key that protects this resource.
10685 },
10686 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
10687 # instance boot disk, one of initializeParams.sourceSnapshot
10688 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
10689 # is required.
10690 #
10691 # To create a disk with a snapshot that you created, specify the
10692 # snapshot name in the following format:
10693 #
10694 # us-central1-a/instantSnapshots/my-backup
10695 #
10696 #
10697 # If the source instant-snapshot is deleted later, this field will not be
10698 # set.
10699 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
10700 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
10701 # is required.
10702 #
10703 # To create a disk with a snapshot that you created, specify the
10704 # snapshot name in the following format:
10705 #
10706 # global/snapshots/my-backup
10707 #
10708 #
10709 # If the source snapshot is deleted later, this field will not be set.
10710 #
10711 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
10712 # an image instead when you create VMs using
10713 # the bulk
10714 # insert method.
10715 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
10716 # encryption key of the source snapshot.
10717 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
10718 # For example:
10719 #
10720 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10721 # key_region/cryptoKeys/key
10722 #
10723 # The fully-qualifed key name may be returned for resource GET requests. For
10724 # example:
10725 #
10726 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10727 # key_region/cryptoKeys/key
10728 # /cryptoKeyVersions/1
10729 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
10730 # key. If absent, the Compute Engine default service account is used.
10731 # For example:
10732 #
10733 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
10734 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
10735 # encryption key, encoded in RFC
10736 # 4648 base64 to either encrypt or decrypt this resource. You can
10737 # provide either the rawKey or thersaEncryptedKey.
10738 # For example:
10739 #
10740 # &quot;rawKey&quot;:
10741 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
10742 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
10743 # customer-supplied encryption key to either encrypt or decrypt this
10744 # resource. You can provide either the rawKey or thersaEncryptedKey.
10745 # For example:
10746 #
10747 # &quot;rsaEncryptedKey&quot;:
10748 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
10749 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
10750 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
10751 #
10752 # The key must meet the following requirements before you can provide it to
10753 # Compute Engine:
10754 #
10755 # 1. The key is wrapped using a RSA public key certificate provided by
10756 # Google.
10757 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
10758 # encoding.
10759 #
10760 # Gets the RSA public key certificate provided by Google at:
10761 #
10762 #
10763 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
10764 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
10765 # 4648 base64 encoded SHA-256 hash of the customer-supplied
10766 # encryption key that protects this resource.
10767 },
10768 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
10769 # this as a partial or full URL to the resource. For example, the following
10770 # are valid values:
10771 #
10772 #
10773 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
10774 # - projects/project/zones/zone/storagePools/storagePool
10775 # - zones/zone/storagePools/storagePool
10776 },
10777 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
10778 # either SCSI or NVME. For most machine types, the
10779 # default is SCSI. Local SSDs can use either NVME or SCSI.
10780 # In certain configurations, persistent disks can use NVMe. For more
10781 # information, seeAbout
10782 # persistent disks.
10783 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
10784 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
10785 &quot;A String&quot;,
10786 ],
10787 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
10788 # disk is not allowed to be detached from the instance, or to be used as the
10789 # source of the snapshot creation, and the image creation. The instance with
10790 # at least one locked attached disk is not allow to be used as source of
10791 # machine image creation, instant snapshot creation, and not allowed to be
10792 # deleted with --keep-disk parameter set to true for locked disks.
10793 &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
10794 # in READ_WRITE mode.
10795 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
10796 # field is set to PRESERVED if the LocalSSD data has been saved
10797 # to a persistent location by customer request. (see the
10798 # discard_local_ssd option on Stop/Suspend).
10799 # Read-only in the api.
10800 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
10801 # these are public keys which are safe to store in public
10802 &quot;dbs&quot;: [ # The Key Database (db).
10803 {
10804 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
10805 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
10806 },
10807 ],
10808 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
10809 {
10810 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
10811 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
10812 },
10813 ],
10814 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
10815 {
10816 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
10817 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
10818 },
10819 ],
10820 &quot;pk&quot;: { # The Platform Key (PK).
10821 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
10822 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
10823 },
10824 },
10825 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
10826 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
10827 # is required.
10828 #
10829 # If desired, you can also attach existing non-root persistent disks using
10830 # this property. This field is only applicable for persistent disks.
10831 #
10832 # Note that for InstanceTemplate, specify the disk name for zonal disk,
10833 # and the URL for regional disk.
10834 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
10835 },
10836 ],
10837 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
10838 &quot;A String&quot;,
10839 ],
10840 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
10841 # e.g. &#x27;Intel Ice Lake&#x27;.
10842 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
10843 # preference. MIG will first try to create a VM based on the machine-type
10844 # with lowest rank and fallback to next rank based on availability.
10845 # Machine types and instance selections with the same rank have the same
10846 # preference.
10847 },
10848 },
10849 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
10850 # when creating new VMs.
10851 &quot;a_key&quot;: {
10852 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
10853 # selection.
10854 { # An instance-attached disk resource.
10855 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
10856 # or X86_64.
10857 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
10858 # deleted (but not when the disk is detached from the instance).
10859 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
10860 # partition of the disk for its root filesystem.
10861 &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
10862 # running within the instance. This name can be used to reference the device
10863 # for mounting, resizing, and so on, from within the instance.
10864 #
10865 # If not specified, the server chooses a default device name to apply to this
10866 # disk, in the form persistent-disk-x, where x is a number
10867 # assigned by Google Compute Engine. This field is only applicable for
10868 # persistent disks.
10869 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
10870 # encryption key.
10871 #
10872 # If you are creating a new disk, this field encrypts the new disk using
10873 # an encryption key that you provide. If you are attaching an existing
10874 # disk that is already encrypted, this field decrypts the disk using
10875 # the customer-supplied encryption key.
10876 #
10877 # If you encrypt a disk using a customer-supplied key, you must provide the
10878 # same key again when you attempt to use this resource at a later time. For
10879 # example, you must provide the key when you create a snapshot or an image
10880 # from the disk or when you attach the disk to a virtual machine instance.
10881 #
10882 # If you do not provide an encryption key, then the disk will be encrypted
10883 # using an automatically generated key and you do not need to provide a key
10884 # to use the disk later.
10885 #
10886 # Note:
10887 #
10888 # Instance templates do not storecustomer-supplied
10889 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
10890 #
10891 # You cannot create VMs that have disks with customer-supplied keys using
10892 # the bulk
10893 # insert method.
10894 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
10895 # For example:
10896 #
10897 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10898 # key_region/cryptoKeys/key
10899 #
10900 # The fully-qualifed key name may be returned for resource GET requests. For
10901 # example:
10902 #
10903 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10904 # key_region/cryptoKeys/key
10905 # /cryptoKeyVersions/1
10906 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
10907 # key. If absent, the Compute Engine default service account is used.
10908 # For example:
10909 #
10910 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
10911 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
10912 # encryption key, encoded in RFC
10913 # 4648 base64 to either encrypt or decrypt this resource. You can
10914 # provide either the rawKey or thersaEncryptedKey.
10915 # For example:
10916 #
10917 # &quot;rawKey&quot;:
10918 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
10919 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
10920 # customer-supplied encryption key to either encrypt or decrypt this
10921 # resource. You can provide either the rawKey or thersaEncryptedKey.
10922 # For example:
10923 #
10924 # &quot;rsaEncryptedKey&quot;:
10925 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
10926 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
10927 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
10928 #
10929 # The key must meet the following requirements before you can provide it to
10930 # Compute Engine:
10931 #
10932 # 1. The key is wrapped using a RSA public key certificate provided by
10933 # Google.
10934 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
10935 # encoding.
10936 #
10937 # Gets the RSA public key certificate provided by Google at:
10938 #
10939 #
10940 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
10941 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
10942 # 4648 base64 encoded SHA-256 hash of the customer-supplied
10943 # encryption key that protects this resource.
10944 },
10945 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
10946 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
10947 # currently attached to another instance. If you try to force attach a zonal
10948 # disk to an instance, you will receive an error.
10949 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
10950 # only for bootable images. Read
10951 # Enabling guest operating system features to see a list of available
10952 # options.
10953 { # Guest OS features.
10954 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
10955 # separate values. Set to one or more of the following values:
10956 #
10957 # - VIRTIO_SCSI_MULTIQUEUE
10958 # - WINDOWS
10959 # - MULTI_IP_SUBNET
10960 # - UEFI_COMPATIBLE
10961 # - GVNIC
10962 # - SEV_CAPABLE
10963 # - SUSPEND_RESUME_COMPATIBLE
10964 # - SEV_LIVE_MIGRATABLE_V2
10965 # - SEV_SNP_CAPABLE
10966 # - TDX_CAPABLE
10967 # - IDPF
10968 # - SNP_SVSM_CAPABLE
10969 # - CCA_CAPABLE
10970 #
10971 #
10972 # For more information, see
10973 # Enabling guest operating system features.
10974 },
10975 ],
10976 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
10977 # boot disk. If you have many disks attached to an instance, each
10978 # disk would have a unique index number.
10979 &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
10980 # alongside the new instance. Use initialization parameters to create boot
10981 # disks or local SSDs attached to the new instance.
10982 #
10983 # This property is mutually exclusive with the source property;
10984 # you can only define one or the other, but not both.
10985 # alongside the new instance. Use initialization parameters to create boot
10986 # disks or local SSDs attached to the new instance.
10987 #
10988 # This field is persisted and returned for instanceTemplate and not returned
10989 # in the context of instance.
10990 #
10991 # This property is mutually exclusive with the source property;
10992 # you can only define one or the other, but not both.
10993 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
10994 # arm64 or x86_64.
10995 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
10996 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
10997 # of the instance. If a disk with the same name already exists in the given
10998 # region, the existing disk is attached to the new instance and the
10999 # new disk is not created.
11000 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
11001 # 10 GB. If you specify a sourceImage, which is required for
11002 # boot disks, the default size is the size of the sourceImage.
11003 # If you do not specify a sourceImage, the default disk size
11004 # is 500 GB.
11005 &quot;diskType&quot;: &quot;A String&quot;,
11006 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
11007 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
11008 # only for bootable images. Read
11009 # Enabling guest operating system features to see a list of available
11010 # options.
11011 #
11012 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
11013 { # Guest OS features.
11014 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
11015 # separate values. Set to one or more of the following values:
11016 #
11017 # - VIRTIO_SCSI_MULTIQUEUE
11018 # - WINDOWS
11019 # - MULTI_IP_SUBNET
11020 # - UEFI_COMPATIBLE
11021 # - GVNIC
11022 # - SEV_CAPABLE
11023 # - SUSPEND_RESUME_COMPATIBLE
11024 # - SEV_LIVE_MIGRATABLE_V2
11025 # - SEV_SNP_CAPABLE
11026 # - TDX_CAPABLE
11027 # - IDPF
11028 # - SNP_SVSM_CAPABLE
11029 # - CCA_CAPABLE
11030 #
11031 #
11032 # For more information, see
11033 # Enabling guest operating system features.
11034 },
11035 ],
11036 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
11037 # which is either SCSI or NVME. The default isSCSI.
11038 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
11039 # persistent disks.
11040 &quot;a_key&quot;: &quot;A String&quot;,
11041 },
11042 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
11043 # disk.
11044 &quot;A String&quot;,
11045 ],
11046 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
11047 &quot;A String&quot;,
11048 ],
11049 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
11050 # more than one instance.
11051 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
11052 # is to use the existing disk.
11053 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
11054 # of I/O operations per second that the disk can handle. Values must be
11055 # between 10,000 and 120,000. For more details, see theExtreme persistent
11056 # disk documentation.
11057 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
11058 # number of throughput mb per second that the disk can handle. Values must
11059 # greater than or equal to 1.
11060 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
11061 # the URLs of the zones where the disk should be replicated to.
11062 # You must provide exactly two replica zones, and one zone must be the same
11063 # as the instance zone.
11064 &quot;A String&quot;,
11065 ],
11066 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
11067 # have the same definition as resource
11068 # manager tags. Keys and values can be either in numeric format,
11069 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
11070 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
11071 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
11072 # empty.
11073 &quot;a_key&quot;: &quot;A String&quot;,
11074 },
11075 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
11076 # Specified using the full or partial URL. For instance template, specify
11077 # only the resource policy name.
11078 &quot;A String&quot;,
11079 ],
11080 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
11081 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
11082 # is required.
11083 #
11084 # To create a disk with one of the public operating system
11085 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
11086 #
11087 # projects/debian-cloud/global/images/family/debian-9
11088 #
11089 #
11090 # Alternatively, use a specific version of a public operating system image:
11091 #
11092 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
11093 #
11094 #
11095 # To create a disk with a custom image that you created, specify the
11096 # image name in the following format:
11097 #
11098 # global/images/my-custom-image
11099 #
11100 #
11101 # You can also specify a custom image by its image family, which returns
11102 # the latest version of the image in that family. Replace the image name
11103 # with family/family-name:
11104 #
11105 # global/images/family/my-image-family
11106 #
11107 #
11108 # If the source image is deleted later, this field will not be set.
11109 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
11110 # encryption key of the source image. Required if the source image is
11111 # protected by a customer-supplied encryption key.
11112 #
11113 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
11114 # encryption keys, so you cannot create disks for instances in a managed instance group if the
11115 # source images are encrypted with your own keys.
11116 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
11117 # For example:
11118 #
11119 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11120 # key_region/cryptoKeys/key
11121 #
11122 # The fully-qualifed key name may be returned for resource GET requests. For
11123 # example:
11124 #
11125 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11126 # key_region/cryptoKeys/key
11127 # /cryptoKeyVersions/1
11128 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
11129 # key. If absent, the Compute Engine default service account is used.
11130 # For example:
11131 #
11132 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
11133 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
11134 # encryption key, encoded in RFC
11135 # 4648 base64 to either encrypt or decrypt this resource. You can
11136 # provide either the rawKey or thersaEncryptedKey.
11137 # For example:
11138 #
11139 # &quot;rawKey&quot;:
11140 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
11141 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
11142 # customer-supplied encryption key to either encrypt or decrypt this
11143 # resource. You can provide either the rawKey or thersaEncryptedKey.
11144 # For example:
11145 #
11146 # &quot;rsaEncryptedKey&quot;:
11147 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
11148 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
11149 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
11150 #
11151 # The key must meet the following requirements before you can provide it to
11152 # Compute Engine:
11153 #
11154 # 1. The key is wrapped using a RSA public key certificate provided by
11155 # Google.
11156 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
11157 # encoding.
11158 #
11159 # Gets the RSA public key certificate provided by Google at:
11160 #
11161 #
11162 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
11163 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
11164 # 4648 base64 encoded SHA-256 hash of the customer-supplied
11165 # encryption key that protects this resource.
11166 },
11167 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
11168 # instance boot disk, one of initializeParams.sourceSnapshot
11169 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
11170 # is required.
11171 #
11172 # To create a disk with a snapshot that you created, specify the
11173 # snapshot name in the following format:
11174 #
11175 # us-central1-a/instantSnapshots/my-backup
11176 #
11177 #
11178 # If the source instant-snapshot is deleted later, this field will not be
11179 # set.
11180 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
11181 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
11182 # is required.
11183 #
11184 # To create a disk with a snapshot that you created, specify the
11185 # snapshot name in the following format:
11186 #
11187 # global/snapshots/my-backup
11188 #
11189 #
11190 # If the source snapshot is deleted later, this field will not be set.
11191 #
11192 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
11193 # an image instead when you create VMs using
11194 # the bulk
11195 # insert method.
11196 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
11197 # encryption key of the source snapshot.
11198 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
11199 # For example:
11200 #
11201 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11202 # key_region/cryptoKeys/key
11203 #
11204 # The fully-qualifed key name may be returned for resource GET requests. For
11205 # example:
11206 #
11207 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
11208 # key_region/cryptoKeys/key
11209 # /cryptoKeyVersions/1
11210 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
11211 # key. If absent, the Compute Engine default service account is used.
11212 # For example:
11213 #
11214 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
11215 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
11216 # encryption key, encoded in RFC
11217 # 4648 base64 to either encrypt or decrypt this resource. You can
11218 # provide either the rawKey or thersaEncryptedKey.
11219 # For example:
11220 #
11221 # &quot;rawKey&quot;:
11222 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
11223 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
11224 # customer-supplied encryption key to either encrypt or decrypt this
11225 # resource. You can provide either the rawKey or thersaEncryptedKey.
11226 # For example:
11227 #
11228 # &quot;rsaEncryptedKey&quot;:
11229 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
11230 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
11231 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
11232 #
11233 # The key must meet the following requirements before you can provide it to
11234 # Compute Engine:
11235 #
11236 # 1. The key is wrapped using a RSA public key certificate provided by
11237 # Google.
11238 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
11239 # encoding.
11240 #
11241 # Gets the RSA public key certificate provided by Google at:
11242 #
11243 #
11244 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
11245 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
11246 # 4648 base64 encoded SHA-256 hash of the customer-supplied
11247 # encryption key that protects this resource.
11248 },
11249 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
11250 # this as a partial or full URL to the resource. For example, the following
11251 # are valid values:
11252 #
11253 #
11254 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
11255 # - projects/project/zones/zone/storagePools/storagePool
11256 # - zones/zone/storagePools/storagePool
11257 },
11258 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
11259 # either SCSI or NVME. For most machine types, the
11260 # default is SCSI. Local SSDs can use either NVME or SCSI.
11261 # In certain configurations, persistent disks can use NVMe. For more
11262 # information, seeAbout
11263 # persistent disks.
11264 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
11265 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
11266 &quot;A String&quot;,
11267 ],
11268 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
11269 # disk is not allowed to be detached from the instance, or to be used as the
11270 # source of the snapshot creation, and the image creation. The instance with
11271 # at least one locked attached disk is not allow to be used as source of
11272 # machine image creation, instant snapshot creation, and not allowed to be
11273 # deleted with --keep-disk parameter set to true for locked disks.
11274 &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
11275 # in READ_WRITE mode.
11276 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
11277 # field is set to PRESERVED if the LocalSSD data has been saved
11278 # to a persistent location by customer request. (see the
11279 # discard_local_ssd option on Stop/Suspend).
11280 # Read-only in the api.
11281 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
11282 # these are public keys which are safe to store in public
11283 &quot;dbs&quot;: [ # The Key Database (db).
11284 {
11285 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11286 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11287 },
11288 ],
11289 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
11290 {
11291 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11292 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11293 },
11294 ],
11295 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
11296 {
11297 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11298 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11299 },
11300 ],
11301 &quot;pk&quot;: { # The Platform Key (PK).
11302 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
11303 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
11304 },
11305 },
11306 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
11307 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
11308 # is required.
11309 #
11310 # If desired, you can also attach existing non-root persistent disks using
11311 # this property. This field is only applicable for persistent disks.
11312 #
11313 # Note that for InstanceTemplate, specify the disk name for zonal disk,
11314 # and the URL for regional disk.
11315 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
11316 },
11317 ],
11318 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
11319 &quot;A String&quot;,
11320 ],
11321 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
11322 # e.g. &#x27;Intel Ice Lake&#x27;.
11323 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
11324 # preference. MIG will first try to create a VM based on the machine-type
11325 # with lowest rank and fallback to next rank based on availability.
11326 # Machine types and instance selections with the same rank have the same
11327 # preference.
11328 },
11329 },
11330 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
11331 # create instances.
11332 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
11333 # more preemption than the minimum capacity user needs. MIG will create
11334 # only Standard VMs until it reaches standard_capacity_base and only
11335 # then will start using standard_capacity_percent_above_base to mix Spot
11336 # with Standard VMs.
11337 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
11338 # remaining percentage will use Spot VMs. The percentage applies only to
11339 # the capacity above standard_capacity_base.
11340 },
11341 },
11342 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
11343 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
11344 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
11345 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
11346 # applies to the VMs on which your application fails a health check.
11347 # Valid values are
11348 #
11349 # - REPAIR (default): MIG automatically repairs a failed VM
11350 # by recreating it. For more information, see About
11351 # repairing VMs in a MIG.
11352 # - DO_NOTHING: MIG does not repair a failed VM.
11353 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
11354 # configuration when repairing a VM. Valid options are:
11355 #
11356 #
11357 #
11358 # - NO (default): If configuration updates are available, they are not
11359 # forcefully applied during repair. Instead, configuration updates are
11360 # applied according to the group&#x27;s update policy.
11361 #
11362 # - YES: If configuration updates are available, they are applied
11363 # during repair.
11364 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
11365 # instance during initialization when stopping / suspending an instance.
11366 # The Instance Group Manager will wait for a signal that indicates
11367 # successful initialization before stopping / suspending an instance.
11368 #
11369 # If a successful readiness signal is not sent before timeout, the
11370 # corresponding instance will not be stopped / suspended. Instead,
11371 # an error will be visible in the lastAttempt.errors field of
11372 # the managed instance in the listmanagedinstances
11373 # method.
11374 #
11375 # If metadataBasedReadinessSignal.timeoutSec is unset,
11376 # the Instance Group Manager will directly proceed to suspend / stop
11377 # instances, skipping initialization on them.
11378 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
11379 # initialization before timing out.
11380 },
11381 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
11382 # unhealthy when the application running on that VM fails a health check.
11383 # Valid values are:
11384 #
11385 # - DEFAULT_ACTION (default): MIG uses the same action
11386 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
11387 # - REPAIR: MIG automatically repairs an unhealthy VM by
11388 # recreating it.
11389 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
11390 # For more information, see
11391 # About repairing VMs in a MIG.
11392 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
11393 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
11394 # Valid values are:
11395 #
11396 # - NO (default): MIG cannot change a VM&#x27;s zone during a
11397 # repair.
11398 # - YES: MIG can select a different zone for the VM during
11399 # a repair.
11400 },
11401 },
11402 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
11403 # instance group. The group uses this template to create all new instances
11404 # in the managed instance group. The templates for existing instances in the
11405 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
11406 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
11407 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
11408 # this managed instance group.
11409 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
11410 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
11411 # long, and comply withRFC1035.
11412 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
11413 # to this Instance Group Manager.
11414 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
11415 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
11416 # The name must be 1-63 characters long, and comply withRFC1035.
11417 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
11418 },
11419 ],
11420 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
11421 # as part of resource payload.
11422 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
11423 # key-value pairs. Keys and values can be either in numeric format,
11424 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
11425 # format such as `{org_id|project_id}/{tag_key_short_name}` and
11426 # `{tag_value_short_name}`. For more information, seeManage tags
11427 # for resources.
11428 &quot;a_key&quot;: &quot;A String&quot;,
11429 },
11430 },
11431 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
11432 # where the managed instance group resides (for regional resources).
11433 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
11434 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
11435 # instance group.
11436 # It can be a full or partial URL. For example, the following are
11437 # all valid URLs to a workload policy:
11438 #
11439 #
11440 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
11441 # - projects/project/regions/region/resourcePolicies/resourcePolicy
11442 # - regions/region/resourcePolicies/resourcePolicy
11443 },
11444 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
11445 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
11446 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
11447 # this URL.
11448 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
11449 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
11450 # by the managed instance group on instances. The service accounts needs all
11451 # permissions required to create and delete instances.
11452 # By default, the service account
11453 # {projectNumber}@cloudservices.gserviceaccount.com is used.
11454 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
11455 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
11456 # stop a VM after that VM was created. The initial delay gives the
11457 # initialization script the time to prepare your VM for a quick scale out.
11458 # The value of initial delay must be between 0 and 3600 seconds. The
11459 # default value is 0.
11460 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
11461 # group scales out. The default mode is `MANUAL`.
11462 },
11463 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
11464 &quot;preservedState&quot;: { # Configuration of preserved resources.
11465 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
11466 # delete, update, etc. This map is keyed with the device names of
11467 # the disks.
11468 &quot;a_key&quot;: {
11469 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
11470 # update or VM instance recreate operations.
11471 # This flag is used to configure if the disk should be deleted after it
11472 # is no longer used by the group, e.g. when the given instance or
11473 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
11474 },
11475 },
11476 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
11477 # instance delete, update, etc. This map is keyed with the network
11478 # interface name.
11479 &quot;a_key&quot;: {
11480 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
11481 # update or VM instance recreate operations.
11482 # This flag is used to configure if the IP reservation should be deleted
11483 # after it is no longer used by the group, e.g. when the given instance
11484 # or the whole group is deleted.
11485 },
11486 },
11487 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
11488 # instance delete, update, etc. This map is keyed with the network
11489 # interface name.
11490 &quot;a_key&quot;: {
11491 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
11492 # update or VM instance recreate operations.
11493 # This flag is used to configure if the IP reservation should be deleted
11494 # after it is no longer used by the group, e.g. when the given instance
11495 # or the whole group is deleted.
11496 },
11497 },
11498 },
11499 },
11500 &quot;status&quot;: { # Output only. The status of this managed instance group.
11501 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
11502 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
11503 # This value is in RFC3339 text format.
11504 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
11505 # been applied to all managed instances in the group.
11506 },
11507 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
11508 # Currently only one accelerator topology is supported.
11509 {
11510 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
11511 # The value is the same as configured in the WorkloadPolicy.
11512 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
11513 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
11514 # check.
11515 &quot;error&quot;: { # Output only. Encountered errors.
11516 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11517 # operation.
11518 {
11519 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11520 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11521 # details. There is a set of defined message types to use for providing
11522 # details.The syntax depends on the error code. For example,
11523 # QuotaExceededInfo will have details when the error code is
11524 # QUOTA_EXCEEDED.
11525 {
11526 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11527 #
11528 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11529 # is not enabled:
11530 #
11531 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11532 # &quot;domain&quot;: &quot;googleapis.com&quot;
11533 # &quot;metadata&quot;: {
11534 # &quot;resource&quot;: &quot;projects/123&quot;,
11535 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11536 # }
11537 # }
11538 #
11539 # This response indicates that the pubsub.googleapis.com API is not enabled.
11540 #
11541 # Example of an error that is returned when attempting to create a Spanner
11542 # instance in a region that is out of stock:
11543 #
11544 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11545 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11546 # &quot;metadata&quot;: {
11547 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11548 # }
11549 # }
11550 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11551 # is typically the registered service name of the tool or product that
11552 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11553 # generated by some common infrastructure, the error domain must be a
11554 # globally unique value that identifies the infrastructure. For Google API
11555 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11556 &quot;metadatas&quot;: { # Additional structured details about this error.
11557 #
11558 # Keys must match a regular expression of `a-z+` but should
11559 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11560 # length. When identifying the current value of an exceeded limit, the units
11561 # should be contained in the key, not the value. For example, rather than
11562 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11563 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11564 # instances that can be created in a single (batch) request.
11565 &quot;a_key&quot;: &quot;A String&quot;,
11566 },
11567 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11568 # proximate cause of the error. Error reasons are unique within a particular
11569 # domain of errors. This should be at most 63 characters and match a
11570 # regular expression of `A-Z+[A-Z0-9]`, which represents
11571 # UPPER_SNAKE_CASE.
11572 },
11573 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11574 #
11575 # For example, if a quota check failed with an error indicating the calling
11576 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11577 # directly to the right place in the developer console to flip the bit.
11578 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11579 { # Describes a URL link.
11580 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11581 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11582 },
11583 ],
11584 },
11585 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11586 # which can be attached to an RPC error.
11587 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11588 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11589 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11590 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11591 },
11592 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11593 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11594 &quot;a_key&quot;: &quot;A String&quot;,
11595 },
11596 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11597 # type or metric.
11598 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11599 # or metric.
11600 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11601 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11602 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11603 },
11604 },
11605 ],
11606 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11607 # This property is optional.
11608 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11609 },
11610 ],
11611 },
11612 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
11613 # has // RFC3339 //
11614 # text format.
11615 },
11616 },
11617 ],
11618 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
11619 # that targets this instance group manager.
11620 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
11621 # targetSizePolicy.mode is set to BULK.
11622 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
11623 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
11624 # operation.
11625 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
11626 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11627 # operation.
11628 {
11629 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11630 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11631 # details. There is a set of defined message types to use for providing
11632 # details.The syntax depends on the error code. For example,
11633 # QuotaExceededInfo will have details when the error code is
11634 # QUOTA_EXCEEDED.
11635 {
11636 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11637 #
11638 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11639 # is not enabled:
11640 #
11641 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11642 # &quot;domain&quot;: &quot;googleapis.com&quot;
11643 # &quot;metadata&quot;: {
11644 # &quot;resource&quot;: &quot;projects/123&quot;,
11645 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11646 # }
11647 # }
11648 #
11649 # This response indicates that the pubsub.googleapis.com API is not enabled.
11650 #
11651 # Example of an error that is returned when attempting to create a Spanner
11652 # instance in a region that is out of stock:
11653 #
11654 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11655 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11656 # &quot;metadata&quot;: {
11657 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11658 # }
11659 # }
11660 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11661 # is typically the registered service name of the tool or product that
11662 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11663 # generated by some common infrastructure, the error domain must be a
11664 # globally unique value that identifies the infrastructure. For Google API
11665 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11666 &quot;metadatas&quot;: { # Additional structured details about this error.
11667 #
11668 # Keys must match a regular expression of `a-z+` but should
11669 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11670 # length. When identifying the current value of an exceeded limit, the units
11671 # should be contained in the key, not the value. For example, rather than
11672 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11673 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11674 # instances that can be created in a single (batch) request.
11675 &quot;a_key&quot;: &quot;A String&quot;,
11676 },
11677 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11678 # proximate cause of the error. Error reasons are unique within a particular
11679 # domain of errors. This should be at most 63 characters and match a
11680 # regular expression of `A-Z+[A-Z0-9]`, which represents
11681 # UPPER_SNAKE_CASE.
11682 },
11683 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11684 #
11685 # For example, if a quota check failed with an error indicating the calling
11686 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11687 # directly to the right place in the developer console to flip the bit.
11688 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11689 { # Describes a URL link.
11690 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11691 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11692 },
11693 ],
11694 },
11695 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11696 # which can be attached to an RPC error.
11697 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11698 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11699 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11700 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11701 },
11702 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11703 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11704 &quot;a_key&quot;: &quot;A String&quot;,
11705 },
11706 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11707 # type or metric.
11708 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11709 # or metric.
11710 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11711 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11712 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11713 },
11714 },
11715 ],
11716 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11717 # This property is optional.
11718 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11719 },
11720 ],
11721 },
11722 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
11723 # operation. Timestamp is in RFC3339 text format.
11724 },
11725 },
11726 &quot;currentInstanceStatuses&quot;: { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
11727 # in this managed instance group that have the status. Currently only shown
11728 # for TPU MIGs
11729 # instance group that have the status. For more information about how to
11730 # interpret each status check the instance lifecycle documentation.
11731 # Currently only shown for TPU MIGs.
11732 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
11733 # that have DEPROVISIONING status.
11734 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
11735 # have been deleted. Includes only instances that would be shown in the
11736 # listManagedInstances method and not all instances that have been
11737 # deleted in the lifetime of the MIG.
11738 # Does not include FlexStart instances that are waiting for the resources
11739 # availability, they are considered as &#x27;pending&#x27;.
11740 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
11741 # that have PENDING status, that is FlexStart instances that are waiting
11742 # for resources. Instances that do not exist because of the other reasons
11743 # are counted as &#x27;non_existent&#x27;.
11744 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
11745 # that have PENDING_STOP status.
11746 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
11747 # that have PROVISIONING status.
11748 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
11749 # that have REPAIRING status.
11750 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
11751 # that have RUNNING status.
11752 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
11753 # that have STAGING status.
11754 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
11755 # that have STOPPED status.
11756 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
11757 # that have STOPPING status.
11758 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
11759 # that have SUSPENDED status.
11760 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
11761 # that have SUSPENDING status.
11762 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
11763 # that have TERMINATED status.
11764 },
11765 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
11766 # stable state. A stable state means that: none of the instances in the
11767 # managed instance group is currently undergoing any type of change (for
11768 # example, creation, restart, or deletion); no future changes are scheduled
11769 # for instances in the managed instance group; and the managed instance
11770 # group itself is not being modified.
11771 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
11772 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
11773 # has stateful configuration, that is, if you have configured any items
11774 # in a stateful policy or in per-instance configs.
11775 # The group might report that it has no stateful configuration even when
11776 # there is still some preserved state on a managed instance, for example,
11777 # if you have deleted all PICs but not yet applied those deletions.
11778 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
11779 # has stateful configuration, that is, if you have configured any items
11780 # in a stateful policy or in per-instance configs.
11781 # The group might report that it has no stateful configuration even when
11782 # there is still some preserved state on a managed instance, for example,
11783 # if you have deleted all PICs but not yet applied those deletions. This
11784 # field is deprecated in favor of has_stateful_config.
11785 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
11786 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
11787 # (listed in the output of a listPerInstanceConfigs API call) have
11788 # status EFFECTIVE or there are no per-instance-configs.
11789 },
11790 },
11791 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
11792 # target version specified by version field on Instance Group
11793 # Manager.
11794 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
11795 # in this managed instance group, i.e. all instances are in their target
11796 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
11797 },
11798 },
11799 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
11800 # apply to all of the instances in the managed instance group.
11801 &quot;A String&quot;,
11802 ],
11803 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
11804 # You can reduce this number by using the instanceGroupManager
11805 # deleteInstances or abandonInstances methods. Resizing the group also
11806 # changes this number.
11807 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
11808 # size.
11809 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
11810 # individually or all at once.
11811 },
11812 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
11813 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
11814 # This number changes when you:
11815 #
11816 # - Stop instance using the stopInstances
11817 # method or start instances using the startInstances
11818 # method.
11819 # - Manually change the targetStoppedSize using the update
11820 # method.
11821 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
11822 # This number changes when you:
11823 #
11824 # - Suspend instance using the suspendInstances
11825 # method or resume instances using the resumeInstances
11826 # method.
11827 # - Manually change the targetSuspendedSize using the update
11828 # method.
11829 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
11830 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
11831 &quot;A String&quot;,
11832 ],
11833 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
11834 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
11835 # instance redistribution policy for regional managed instance groups.
11836 # Valid values are:
11837 #
11838 # - PROACTIVE (default): The group attempts to maintain an
11839 # even distribution of VM instances across zones in the region.
11840 # - NONE: For non-autoscaled groups, proactive
11841 # redistribution is disabled.
11842 &quot;maxSurge&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
11843 # either a fixed number or, if the group has 10 or more instances, a
11844 # percentage. If you set a percentage, the number of instances is rounded
11845 # if necessary. The default value for maxSurge is a fixed
11846 # value equal to the number of zones in which the managed instance group
11847 # operates.
11848 #
11849 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
11850 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
11851 #
11852 #
11853 #
11854 # - If the value is fixed, then the calculated
11855 # value is equal to the fixed value.
11856 # - If the value is a percent, then the
11857 # calculated
11858 # value is percent/100 * targetSize. For example,
11859 # the calculated value of a 80% of a managed instance group
11860 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
11861 # is a remainder, the number is rounded.
11862 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
11863 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
11864 # example, specify 80 for 80%.
11865 },
11866 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
11867 # process. An instance is considered available if all of the following
11868 # conditions are satisfied:
11869 #
11870 #
11871 #
11872 # - The instance&#x27;s status is
11873 # RUNNING.
11874 # - If there is a health
11875 # check on the instance group, the instance&#x27;s health check status
11876 # must be HEALTHY at least once. If there is no health check
11877 # on the group, then the instance only needs to have a status of
11878 # RUNNING to be considered available.
11879 #
11880 #
11881 # This value can be either a fixed number or, if the group has 10 or more
11882 # instances, a percentage. If you set a percentage, the number of instances
11883 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
11884 # in which the managed instance group operates.
11885 #
11886 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
11887 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
11888 #
11889 #
11890 #
11891 # - If the value is fixed, then the calculated
11892 # value is equal to the fixed value.
11893 # - If the value is a percent, then the
11894 # calculated
11895 # value is percent/100 * targetSize. For example,
11896 # the calculated value of a 80% of a managed instance group
11897 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
11898 # is a remainder, the number is rounded.
11899 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
11900 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
11901 # example, specify 80 for 80%.
11902 },
11903 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
11904 # becomes available. This value must be from range [0, 3600].
11905 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
11906 # disruption as much as possible or to apply a more disruptive action than
11907 # is necessary.
11908 #
11909 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
11910 # Compute Engine performs the necessary action to execute the update.
11911 # - To apply a more disruptive action than is strictly necessary, set the
11912 # minimal action to RESTART or REPLACE. For
11913 # example, Compute Engine does not need to restart a VM to change its
11914 # metadata. But if your application reads instance metadata only when a VM
11915 # is restarted, you can set the minimal action to RESTART in
11916 # order to pick up metadata changes.
11917 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
11918 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
11919 # as much as possible. RESTART to allow actions that can be
11920 # applied without instance replacing or REPLACE to allow all
11921 # possible actions. If the Updater determines that the minimal update
11922 # action needed is more disruptive than most disruptive allowed action you
11923 # specify it will not perform the update at all.
11924 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
11925 # See minimal_action.REPLACE
11926 &quot;type&quot;: &quot;A String&quot;, # The type
11927 # of update process. You can specify either PROACTIVE so
11928 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
11929 # to update.
11930 },
11931 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
11932 # create instances.
11933 #
11934 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
11935 # group. This field overrides the top-level instanceTemplate
11936 # field. Read more about therelationships
11937 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
11938 # remaining instances. For more information, read aboutcanary
11939 # updates.
11940 {
11941 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
11942 # instance group. The group uses this template to create new instances in
11943 # the managed instance group until the `targetSize` for this version is
11944 # reached. The templates for existing instances in the group do not change
11945 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
11946 # existing instances are updated until the `targetSize` for this version is
11947 # reached.
11948 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
11949 # managed instance group.
11950 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
11951 # even if instance_template remains unchanged.
11952 # Deprecated in favor of &#x27;name&#x27;.
11953 &quot;targetSize&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
11954 # from the template will be equal to:
11955 #
11956 #
11957 # - If expressed as a fixed number, the minimum of either
11958 # targetSize.fixed or
11959 # instanceGroupManager.targetSize is used.
11960 # - if expressed as a percent, the targetSize
11961 # would be (targetSize.percent/100 *
11962 # InstanceGroupManager.targetSize) If there is a remainder, the
11963 # number is rounded.
11964 #
11965 # If unset, this version will update any remaining instances not
11966 # updated by another version. ReadStarting
11967 # a canary update for more information.
11968 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
11969 #
11970 #
11971 #
11972 # - If the value is fixed, then the calculated
11973 # value is equal to the fixed value.
11974 # - If the value is a percent, then the
11975 # calculated
11976 # value is percent/100 * targetSize. For example,
11977 # the calculated value of a 80% of a managed instance group
11978 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
11979 # is a remainder, the number is rounded.
11980 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
11981 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
11982 # example, specify 80 for 80%.
11983 },
11984 },
11985 ],
11986 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
11987 # where the managed instance group is located (for zonal resources).
11988 }
11989
11990 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11991 that if you must retry your request, the server will know to ignore the
11992 request if it has already been completed.
11993
11994 For example, consider a situation where you make an initial request and
11995 the request times out. If you make the request again with the same
11996 request ID, the server can check if original operation with the same
11997 request ID was received, and if so, will ignore the second request. This
11998 prevents clients from accidentally creating duplicate commitments.
11999
12000 The request ID must be
12001 a valid UUID with the exception that zero UUID is not supported
12002 (00000000-0000-0000-0000-000000000000).
12003 x__xgafv: string, V1 error format.
12004 Allowed values
12005 1 - v1 error format
12006 2 - v2 error format
12007
12008 Returns:
12009 An object of the form:
12010
12011 { # Represents an Operation resource.
12012 #
12013 # Google Compute Engine has three Operation resources:
12014 #
12015 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
12016 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
12017 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
12018 #
12019 # You can use an operation resource to manage asynchronous API requests.
12020 # For more information, readHandling
12021 # API responses.
12022 #
12023 # Operations can be global, regional or zonal.
12024 #
12025 # - For global operations, use the `globalOperations`
12026 # resource.
12027 # - For regional operations, use the
12028 # `regionOperations` resource.
12029 # - For zonal operations, use
12030 # the `zoneOperations` resource.
12031 #
12032 #
12033 #
12034 # For more information, read
12035 # Global, Regional, and Zonal Resources.
12036 #
12037 # Note that completed Operation resources have a limited
12038 # retention period.
12039 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12040 # Not present otherwise.
12041 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12042 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12043 # set when the operation is created.
12044 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12045 # text format.
12046 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12047 # this field will be populated.
12048 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12049 # operation.
12050 {
12051 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12052 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12053 # details. There is a set of defined message types to use for providing
12054 # details.The syntax depends on the error code. For example,
12055 # QuotaExceededInfo will have details when the error code is
12056 # QUOTA_EXCEEDED.
12057 {
12058 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12059 #
12060 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12061 # is not enabled:
12062 #
12063 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12064 # &quot;domain&quot;: &quot;googleapis.com&quot;
12065 # &quot;metadata&quot;: {
12066 # &quot;resource&quot;: &quot;projects/123&quot;,
12067 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12068 # }
12069 # }
12070 #
12071 # This response indicates that the pubsub.googleapis.com API is not enabled.
12072 #
12073 # Example of an error that is returned when attempting to create a Spanner
12074 # instance in a region that is out of stock:
12075 #
12076 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12077 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12078 # &quot;metadata&quot;: {
12079 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12080 # }
12081 # }
12082 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12083 # is typically the registered service name of the tool or product that
12084 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12085 # generated by some common infrastructure, the error domain must be a
12086 # globally unique value that identifies the infrastructure. For Google API
12087 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12088 &quot;metadatas&quot;: { # Additional structured details about this error.
12089 #
12090 # Keys must match a regular expression of `a-z+` but should
12091 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12092 # length. When identifying the current value of an exceeded limit, the units
12093 # should be contained in the key, not the value. For example, rather than
12094 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12095 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12096 # instances that can be created in a single (batch) request.
12097 &quot;a_key&quot;: &quot;A String&quot;,
12098 },
12099 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12100 # proximate cause of the error. Error reasons are unique within a particular
12101 # domain of errors. This should be at most 63 characters and match a
12102 # regular expression of `A-Z+[A-Z0-9]`, which represents
12103 # UPPER_SNAKE_CASE.
12104 },
12105 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12106 #
12107 # For example, if a quota check failed with an error indicating the calling
12108 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12109 # directly to the right place in the developer console to flip the bit.
12110 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12111 { # Describes a URL link.
12112 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12113 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12114 },
12115 ],
12116 },
12117 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12118 # which can be attached to an RPC error.
12119 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12120 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12121 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12122 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12123 },
12124 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12125 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12126 &quot;a_key&quot;: &quot;A String&quot;,
12127 },
12128 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12129 # type or metric.
12130 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12131 # or metric.
12132 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12133 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12134 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12135 },
12136 },
12137 ],
12138 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12139 # This property is optional.
12140 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12141 },
12142 ],
12143 },
12144 &quot;getVersionOperationMetadata&quot;: {
12145 &quot;inlineSbomInfo&quot;: {
12146 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12147 # appropriate identifiers.
12148 &quot;a_key&quot;: &quot;A String&quot;,
12149 },
12150 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12151 # identifiers.
12152 &quot;a_key&quot;: &quot;A String&quot;,
12153 },
12154 },
12155 },
12156 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12157 # message that was returned, such as `NOT FOUND`.
12158 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12159 # status code that was returned. For example, a `404` means the
12160 # resource was not found.
12161 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12162 # defined by the server.
12163 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12164 # This value is inRFC3339
12165 # text format.
12166 &quot;instancesBulkInsertOperationMetadata&quot;: {
12167 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12168 # Example key: zones/us-central1-a
12169 &quot;a_key&quot;: {
12170 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12171 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12172 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12173 # error.
12174 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12175 # if the flow is rolling forward or rolling back.
12176 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12177 },
12178 },
12179 },
12180 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12181 # Operation resources.
12182 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12183 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12184 # group of operations results from a `bulkInsert` API request.
12185 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12186 # `update`, or `delete`, and so on.
12187 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12188 # There is no requirement that this be linear or support any granularity of
12189 # operations. This should not be used to guess when the operation will be
12190 # complete. This number should monotonically increase as the operation
12191 # progresses.
12192 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12193 # applicable when performing regional operations.
12194 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12195 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
12196 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12197 # this field will contain information on all underlying zonal actions and
12198 # their state.
12199 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12200 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12201 # Example key: zones/us-central1-a
12202 &quot;a_key&quot;: {
12203 &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
12204 # populated.
12205 # different programming environments, including REST APIs and RPC APIs. It is
12206 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12207 # three pieces of data: error code, error message, and error details.
12208 #
12209 # You can find out more about this error model and how to work with it in the
12210 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12211 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12212 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12213 # message types for APIs to use.
12214 {
12215 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12216 },
12217 ],
12218 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12219 # user-facing error message should be localized and sent in the
12220 # google.rpc.Status.details field, or localized by the client.
12221 },
12222 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12223 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12224 },
12225 },
12226 },
12227 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12228 # This value is inRFC3339
12229 # text format.
12230 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12231 # following:
12232 # `PENDING`, `RUNNING`, or `DONE`.
12233 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12234 # operation.
12235 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12236 # of the target resource.
12237 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12238 # operations related to creating a snapshot, this points to the disk
12239 # that the snapshot was created from.
12240 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12241 # `[email protected]` or
12242 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12243 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12244 # operation, this field will be populated.
12245 {
12246 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12247 # Engine returns NO_RESULTS_ON_PAGE if there
12248 # are no results in the response.
12249 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12250 # value format. For example:
12251 #
12252 # &quot;data&quot;: [
12253 # {
12254 # &quot;key&quot;: &quot;scope&quot;,
12255 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12256 # }
12257 {
12258 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12259 # returned. For example, for warnings where there are no results in a list
12260 # request for a particular zone, this key might be scope and
12261 # the key value might be the zone name. Other examples might be a key
12262 # indicating a deprecated resource and a suggested replacement, or a
12263 # warning about invalid network settings (for example, if an instance
12264 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12265 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12266 },
12267 ],
12268 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12269 },
12270 ],
12271 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12272 # applicable when performing per-zone operations.
12273 }</pre>
12274 </div>
12275
12276 <div class="method">
12277 <code class="details" id="patchPerInstanceConfigs">patchPerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
12278 <pre>Inserts or patches per-instance configurations for the managed instance
12279 group. perInstanceConfig.name serves as a key used to
12280 distinguish whether to perform insert or patch.
12281
12282 Args:
12283 project: string, Project ID for this request. (required)
12284 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
12285 instanceGroupManager: string, The name of the managed instance group.
12286 It should conform to RFC1035. (required)
12287 body: object, The request body.
12288 The object takes the form of:
12289
12290 { # RegionInstanceGroupManagers.patchPerInstanceConfigs
12291 &quot;perInstanceConfigs&quot;: [ # The list of per-instance configurations to insert or patch on this managed
12292 # instance group.
12293 {
12294 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
12295 # optimistic locking. It is ignored when inserting a per-instance
12296 # config. An up-to-date fingerprint must be provided in order to update an
12297 # existing per-instance configuration or the field needs to be unset.
12298 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
12299 # Serves as a merge key during UpdatePerInstanceConfigs
12300 # operations, that is, if a per-instance configuration with the same name
12301 # exists then it will be updated, otherwise a new one will be created for the
12302 # VM instance with the same name. An attempt to create a per-instance
12303 # configuration for a VM instance that either doesn&#x27;t exist or is not part
12304 # of the group will result in an error.
12305 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
12306 # preserved state generated from a stateful policy.
12307 &quot;disks&quot;: { # Preserved disks defined for this instance.
12308 # This map is keyed with the device names of the disks.
12309 &quot;a_key&quot;: {
12310 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
12311 # update, instance recreate operations. This flag is used to configure
12312 # if the disk should be deleted after it is no longer used by the group,
12313 # e.g. when the given instance or the whole MIG is deleted.
12314 # Note: disks attached in READ_ONLY mode cannot be
12315 # auto-deleted.
12316 &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
12317 # disk in READ_WRITE mode.
12318 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
12319 # to the VM instance.
12320 },
12321 },
12322 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
12323 # This map is keyed with the name of the network interface.
12324 &quot;a_key&quot;: {
12325 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
12326 # update or VM instance recreate operations.
12327 # This flag is used to configure if the IP reservation should be deleted
12328 # after it is no longer used by the group, e.g. when the given instance
12329 # or the whole group is deleted.
12330 &quot;ipAddress&quot;: { # Ip address representation
12331 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
12332 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
12333 # network interface.
12334 },
12335 },
12336 },
12337 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
12338 # This map is keyed with the name of the network interface.
12339 &quot;a_key&quot;: {
12340 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
12341 # update or VM instance recreate operations.
12342 # This flag is used to configure if the IP reservation should be deleted
12343 # after it is no longer used by the group, e.g. when the given instance
12344 # or the whole group is deleted.
12345 &quot;ipAddress&quot;: { # Ip address representation
12346 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
12347 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
12348 # network interface.
12349 },
12350 },
12351 },
12352 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
12353 &quot;a_key&quot;: &quot;A String&quot;,
12354 },
12355 },
12356 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
12357 # managed instance.
12358 },
12359 ],
12360 }
12361
12362 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12363 that if you must retry your request, the server will know to ignore the
12364 request if it has already been completed.
12365
12366 For example, consider a situation where you make an initial request and
12367 the request times out. If you make the request again with the same
12368 request ID, the server can check if original operation with the same
12369 request ID was received, and if so, will ignore the second request. This
12370 prevents clients from accidentally creating duplicate commitments.
12371
12372 The request ID must be
12373 a valid UUID with the exception that zero UUID is not supported
12374 (00000000-0000-0000-0000-000000000000).
12375 x__xgafv: string, V1 error format.
12376 Allowed values
12377 1 - v1 error format
12378 2 - v2 error format
12379
12380 Returns:
12381 An object of the form:
12382
12383 { # Represents an Operation resource.
12384 #
12385 # Google Compute Engine has three Operation resources:
12386 #
12387 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
12388 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
12389 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
12390 #
12391 # You can use an operation resource to manage asynchronous API requests.
12392 # For more information, readHandling
12393 # API responses.
12394 #
12395 # Operations can be global, regional or zonal.
12396 #
12397 # - For global operations, use the `globalOperations`
12398 # resource.
12399 # - For regional operations, use the
12400 # `regionOperations` resource.
12401 # - For zonal operations, use
12402 # the `zoneOperations` resource.
12403 #
12404 #
12405 #
12406 # For more information, read
12407 # Global, Regional, and Zonal Resources.
12408 #
12409 # Note that completed Operation resources have a limited
12410 # retention period.
12411 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12412 # Not present otherwise.
12413 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12414 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12415 # set when the operation is created.
12416 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12417 # text format.
12418 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12419 # this field will be populated.
12420 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12421 # operation.
12422 {
12423 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12424 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12425 # details. There is a set of defined message types to use for providing
12426 # details.The syntax depends on the error code. For example,
12427 # QuotaExceededInfo will have details when the error code is
12428 # QUOTA_EXCEEDED.
12429 {
12430 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12431 #
12432 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12433 # is not enabled:
12434 #
12435 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12436 # &quot;domain&quot;: &quot;googleapis.com&quot;
12437 # &quot;metadata&quot;: {
12438 # &quot;resource&quot;: &quot;projects/123&quot;,
12439 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12440 # }
12441 # }
12442 #
12443 # This response indicates that the pubsub.googleapis.com API is not enabled.
12444 #
12445 # Example of an error that is returned when attempting to create a Spanner
12446 # instance in a region that is out of stock:
12447 #
12448 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12449 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12450 # &quot;metadata&quot;: {
12451 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12452 # }
12453 # }
12454 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12455 # is typically the registered service name of the tool or product that
12456 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12457 # generated by some common infrastructure, the error domain must be a
12458 # globally unique value that identifies the infrastructure. For Google API
12459 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12460 &quot;metadatas&quot;: { # Additional structured details about this error.
12461 #
12462 # Keys must match a regular expression of `a-z+` but should
12463 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12464 # length. When identifying the current value of an exceeded limit, the units
12465 # should be contained in the key, not the value. For example, rather than
12466 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12467 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12468 # instances that can be created in a single (batch) request.
12469 &quot;a_key&quot;: &quot;A String&quot;,
12470 },
12471 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12472 # proximate cause of the error. Error reasons are unique within a particular
12473 # domain of errors. This should be at most 63 characters and match a
12474 # regular expression of `A-Z+[A-Z0-9]`, which represents
12475 # UPPER_SNAKE_CASE.
12476 },
12477 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12478 #
12479 # For example, if a quota check failed with an error indicating the calling
12480 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12481 # directly to the right place in the developer console to flip the bit.
12482 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12483 { # Describes a URL link.
12484 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12485 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12486 },
12487 ],
12488 },
12489 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12490 # which can be attached to an RPC error.
12491 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12492 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12493 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12494 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12495 },
12496 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12497 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12498 &quot;a_key&quot;: &quot;A String&quot;,
12499 },
12500 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12501 # type or metric.
12502 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12503 # or metric.
12504 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12505 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12506 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12507 },
12508 },
12509 ],
12510 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12511 # This property is optional.
12512 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12513 },
12514 ],
12515 },
12516 &quot;getVersionOperationMetadata&quot;: {
12517 &quot;inlineSbomInfo&quot;: {
12518 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12519 # appropriate identifiers.
12520 &quot;a_key&quot;: &quot;A String&quot;,
12521 },
12522 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12523 # identifiers.
12524 &quot;a_key&quot;: &quot;A String&quot;,
12525 },
12526 },
12527 },
12528 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12529 # message that was returned, such as `NOT FOUND`.
12530 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12531 # status code that was returned. For example, a `404` means the
12532 # resource was not found.
12533 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12534 # defined by the server.
12535 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12536 # This value is inRFC3339
12537 # text format.
12538 &quot;instancesBulkInsertOperationMetadata&quot;: {
12539 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12540 # Example key: zones/us-central1-a
12541 &quot;a_key&quot;: {
12542 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12543 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12544 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12545 # error.
12546 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12547 # if the flow is rolling forward or rolling back.
12548 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12549 },
12550 },
12551 },
12552 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12553 # Operation resources.
12554 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12555 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12556 # group of operations results from a `bulkInsert` API request.
12557 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12558 # `update`, or `delete`, and so on.
12559 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12560 # There is no requirement that this be linear or support any granularity of
12561 # operations. This should not be used to guess when the operation will be
12562 # complete. This number should monotonically increase as the operation
12563 # progresses.
12564 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12565 # applicable when performing regional operations.
12566 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12567 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
12568 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12569 # this field will contain information on all underlying zonal actions and
12570 # their state.
12571 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12572 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12573 # Example key: zones/us-central1-a
12574 &quot;a_key&quot;: {
12575 &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
12576 # populated.
12577 # different programming environments, including REST APIs and RPC APIs. It is
12578 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12579 # three pieces of data: error code, error message, and error details.
12580 #
12581 # You can find out more about this error model and how to work with it in the
12582 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12583 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12584 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12585 # message types for APIs to use.
12586 {
12587 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12588 },
12589 ],
12590 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12591 # user-facing error message should be localized and sent in the
12592 # google.rpc.Status.details field, or localized by the client.
12593 },
12594 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12595 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12596 },
12597 },
12598 },
12599 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12600 # This value is inRFC3339
12601 # text format.
12602 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12603 # following:
12604 # `PENDING`, `RUNNING`, or `DONE`.
12605 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12606 # operation.
12607 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12608 # of the target resource.
12609 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12610 # operations related to creating a snapshot, this points to the disk
12611 # that the snapshot was created from.
12612 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12613 # `[email protected]` or
12614 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12615 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12616 # operation, this field will be populated.
12617 {
12618 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12619 # Engine returns NO_RESULTS_ON_PAGE if there
12620 # are no results in the response.
12621 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12622 # value format. For example:
12623 #
12624 # &quot;data&quot;: [
12625 # {
12626 # &quot;key&quot;: &quot;scope&quot;,
12627 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12628 # }
12629 {
12630 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12631 # returned. For example, for warnings where there are no results in a list
12632 # request for a particular zone, this key might be scope and
12633 # the key value might be the zone name. Other examples might be a key
12634 # indicating a deprecated resource and a suggested replacement, or a
12635 # warning about invalid network settings (for example, if an instance
12636 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12637 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12638 },
12639 ],
12640 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12641 },
12642 ],
12643 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12644 # applicable when performing per-zone operations.
12645 }</pre>
12646 </div>
12647
12648 <div class="method">
12649 <code class="details" id="recreateInstances">recreateInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
12650 <pre>Flags the specified VM instances in the managed instance group to be
12651 immediately recreated. Each instance is recreated using the group&#x27;s current
12652 configuration. This operation is marked as DONE when the flag
12653 is set even if the instances have not yet been recreated. You must
12654 separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking
12655 the status of managed instances.
12656
12657 If the group is part of a backend
12658 service that has enabled
12659 connection draining, it can take up to 60 seconds after the connection
12660 draining duration has elapsed before the VM instance is removed or deleted.
12661
12662 You can specify a maximum of 1000 instances with this method per request.
12663
12664 Args:
12665 project: string, Project ID for this request. (required)
12666 region: string, Name of the region scoping this request. (required)
12667 instanceGroupManager: string, Name of the managed instance group. (required)
12668 body: object, The request body.
12669 The object takes the form of:
12670
12671 {
12672 &quot;instances&quot;: [ # The URLs of one or more instances to recreate. This can be a full URL or
12673 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
12674 &quot;A String&quot;,
12675 ],
12676 }
12677
12678 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance recreation even if it&#x27;s
12679 configured for the instances.
12680 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12681 that if you must retry your request, the server will know to ignore the
12682 request if it has already been completed.
12683
12684 For example, consider a situation where you make an initial request and
12685 the request times out. If you make the request again with the same
12686 request ID, the server can check if original operation with the same
12687 request ID was received, and if so, will ignore the second request. This
12688 prevents clients from accidentally creating duplicate commitments.
12689
12690 The request ID must be
12691 a valid UUID with the exception that zero UUID is not supported
12692 (00000000-0000-0000-0000-000000000000).
12693 x__xgafv: string, V1 error format.
12694 Allowed values
12695 1 - v1 error format
12696 2 - v2 error format
12697
12698 Returns:
12699 An object of the form:
12700
12701 { # Represents an Operation resource.
12702 #
12703 # Google Compute Engine has three Operation resources:
12704 #
12705 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
12706 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
12707 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
12708 #
12709 # You can use an operation resource to manage asynchronous API requests.
12710 # For more information, readHandling
12711 # API responses.
12712 #
12713 # Operations can be global, regional or zonal.
12714 #
12715 # - For global operations, use the `globalOperations`
12716 # resource.
12717 # - For regional operations, use the
12718 # `regionOperations` resource.
12719 # - For zonal operations, use
12720 # the `zoneOperations` resource.
12721 #
12722 #
12723 #
12724 # For more information, read
12725 # Global, Regional, and Zonal Resources.
12726 #
12727 # Note that completed Operation resources have a limited
12728 # retention period.
12729 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12730 # Not present otherwise.
12731 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12732 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12733 # set when the operation is created.
12734 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12735 # text format.
12736 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12737 # this field will be populated.
12738 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12739 # operation.
12740 {
12741 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12742 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12743 # details. There is a set of defined message types to use for providing
12744 # details.The syntax depends on the error code. For example,
12745 # QuotaExceededInfo will have details when the error code is
12746 # QUOTA_EXCEEDED.
12747 {
12748 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12749 #
12750 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12751 # is not enabled:
12752 #
12753 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12754 # &quot;domain&quot;: &quot;googleapis.com&quot;
12755 # &quot;metadata&quot;: {
12756 # &quot;resource&quot;: &quot;projects/123&quot;,
12757 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12758 # }
12759 # }
12760 #
12761 # This response indicates that the pubsub.googleapis.com API is not enabled.
12762 #
12763 # Example of an error that is returned when attempting to create a Spanner
12764 # instance in a region that is out of stock:
12765 #
12766 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12767 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12768 # &quot;metadata&quot;: {
12769 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12770 # }
12771 # }
12772 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12773 # is typically the registered service name of the tool or product that
12774 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12775 # generated by some common infrastructure, the error domain must be a
12776 # globally unique value that identifies the infrastructure. For Google API
12777 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12778 &quot;metadatas&quot;: { # Additional structured details about this error.
12779 #
12780 # Keys must match a regular expression of `a-z+` but should
12781 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12782 # length. When identifying the current value of an exceeded limit, the units
12783 # should be contained in the key, not the value. For example, rather than
12784 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12785 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12786 # instances that can be created in a single (batch) request.
12787 &quot;a_key&quot;: &quot;A String&quot;,
12788 },
12789 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12790 # proximate cause of the error. Error reasons are unique within a particular
12791 # domain of errors. This should be at most 63 characters and match a
12792 # regular expression of `A-Z+[A-Z0-9]`, which represents
12793 # UPPER_SNAKE_CASE.
12794 },
12795 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12796 #
12797 # For example, if a quota check failed with an error indicating the calling
12798 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12799 # directly to the right place in the developer console to flip the bit.
12800 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12801 { # Describes a URL link.
12802 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12803 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12804 },
12805 ],
12806 },
12807 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12808 # which can be attached to an RPC error.
12809 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12810 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12811 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12812 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12813 },
12814 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12815 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12816 &quot;a_key&quot;: &quot;A String&quot;,
12817 },
12818 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12819 # type or metric.
12820 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12821 # or metric.
12822 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12823 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12824 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12825 },
12826 },
12827 ],
12828 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12829 # This property is optional.
12830 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12831 },
12832 ],
12833 },
12834 &quot;getVersionOperationMetadata&quot;: {
12835 &quot;inlineSbomInfo&quot;: {
12836 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12837 # appropriate identifiers.
12838 &quot;a_key&quot;: &quot;A String&quot;,
12839 },
12840 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12841 # identifiers.
12842 &quot;a_key&quot;: &quot;A String&quot;,
12843 },
12844 },
12845 },
12846 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12847 # message that was returned, such as `NOT FOUND`.
12848 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12849 # status code that was returned. For example, a `404` means the
12850 # resource was not found.
12851 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12852 # defined by the server.
12853 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12854 # This value is inRFC3339
12855 # text format.
12856 &quot;instancesBulkInsertOperationMetadata&quot;: {
12857 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12858 # Example key: zones/us-central1-a
12859 &quot;a_key&quot;: {
12860 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12861 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12862 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12863 # error.
12864 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12865 # if the flow is rolling forward or rolling back.
12866 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12867 },
12868 },
12869 },
12870 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12871 # Operation resources.
12872 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12873 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12874 # group of operations results from a `bulkInsert` API request.
12875 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12876 # `update`, or `delete`, and so on.
12877 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12878 # There is no requirement that this be linear or support any granularity of
12879 # operations. This should not be used to guess when the operation will be
12880 # complete. This number should monotonically increase as the operation
12881 # progresses.
12882 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12883 # applicable when performing regional operations.
12884 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12885 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
12886 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12887 # this field will contain information on all underlying zonal actions and
12888 # their state.
12889 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12890 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12891 # Example key: zones/us-central1-a
12892 &quot;a_key&quot;: {
12893 &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
12894 # populated.
12895 # different programming environments, including REST APIs and RPC APIs. It is
12896 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12897 # three pieces of data: error code, error message, and error details.
12898 #
12899 # You can find out more about this error model and how to work with it in the
12900 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12901 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12902 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12903 # message types for APIs to use.
12904 {
12905 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12906 },
12907 ],
12908 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12909 # user-facing error message should be localized and sent in the
12910 # google.rpc.Status.details field, or localized by the client.
12911 },
12912 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12913 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12914 },
12915 },
12916 },
12917 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12918 # This value is inRFC3339
12919 # text format.
12920 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12921 # following:
12922 # `PENDING`, `RUNNING`, or `DONE`.
12923 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12924 # operation.
12925 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12926 # of the target resource.
12927 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12928 # operations related to creating a snapshot, this points to the disk
12929 # that the snapshot was created from.
12930 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12931 # `[email protected]` or
12932 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12933 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12934 # operation, this field will be populated.
12935 {
12936 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12937 # Engine returns NO_RESULTS_ON_PAGE if there
12938 # are no results in the response.
12939 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12940 # value format. For example:
12941 #
12942 # &quot;data&quot;: [
12943 # {
12944 # &quot;key&quot;: &quot;scope&quot;,
12945 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12946 # }
12947 {
12948 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12949 # returned. For example, for warnings where there are no results in a list
12950 # request for a particular zone, this key might be scope and
12951 # the key value might be the zone name. Other examples might be a key
12952 # indicating a deprecated resource and a suggested replacement, or a
12953 # warning about invalid network settings (for example, if an instance
12954 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12955 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12956 },
12957 ],
12958 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12959 },
12960 ],
12961 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12962 # applicable when performing per-zone operations.
12963 }</pre>
12964 </div>
12965
12966 <div class="method">
12967 <code class="details" id="resize">resize(project, region, instanceGroupManager, size, requestId=None, x__xgafv=None)</code>
12968 <pre>Changes the intended size of the managed instance group. If you increase
12969 the size, the group creates new instances using the current instance
12970 template. If you decrease the size, the group deletes one or more
12971 instances.
12972
12973 The resize operation is marked DONE if theresize request is successful. The underlying actions take
12974 additional time. You must separately verify the status of thecreating or deleting actions with thelistmanagedinstances
12975 method.
12976
12977 If the group is part of a backend
12978 service that has enabled
12979 connection draining, it can take up to 60 seconds after the connection
12980 draining duration has elapsed before the VM instance is removed or deleted.
12981
12982 Args:
12983 project: string, Project ID for this request. (required)
12984 region: string, Name of the region scoping this request. (required)
12985 instanceGroupManager: string, Name of the managed instance group. (required)
12986 size: integer, Number of instances that should exist in this instance group
12987 manager. (required)
12988 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12989 that if you must retry your request, the server will know to ignore the
12990 request if it has already been completed.
12991
12992 For example, consider a situation where you make an initial request and
12993 the request times out. If you make the request again with the same
12994 request ID, the server can check if original operation with the same
12995 request ID was received, and if so, will ignore the second request. This
12996 prevents clients from accidentally creating duplicate commitments.
12997
12998 The request ID must be
12999 a valid UUID with the exception that zero UUID is not supported
13000 (00000000-0000-0000-0000-000000000000).
13001 x__xgafv: string, V1 error format.
13002 Allowed values
13003 1 - v1 error format
13004 2 - v2 error format
13005
13006 Returns:
13007 An object of the form:
13008
13009 { # Represents an Operation resource.
13010 #
13011 # Google Compute Engine has three Operation resources:
13012 #
13013 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
13014 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
13015 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
13016 #
13017 # You can use an operation resource to manage asynchronous API requests.
13018 # For more information, readHandling
13019 # API responses.
13020 #
13021 # Operations can be global, regional or zonal.
13022 #
13023 # - For global operations, use the `globalOperations`
13024 # resource.
13025 # - For regional operations, use the
13026 # `regionOperations` resource.
13027 # - For zonal operations, use
13028 # the `zoneOperations` resource.
13029 #
13030 #
13031 #
13032 # For more information, read
13033 # Global, Regional, and Zonal Resources.
13034 #
13035 # Note that completed Operation resources have a limited
13036 # retention period.
13037 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
13038 # Not present otherwise.
13039 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
13040 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
13041 # set when the operation is created.
13042 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
13043 # text format.
13044 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
13045 # this field will be populated.
13046 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
13047 # operation.
13048 {
13049 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
13050 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
13051 # details. There is a set of defined message types to use for providing
13052 # details.The syntax depends on the error code. For example,
13053 # QuotaExceededInfo will have details when the error code is
13054 # QUOTA_EXCEEDED.
13055 {
13056 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
13057 #
13058 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
13059 # is not enabled:
13060 #
13061 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
13062 # &quot;domain&quot;: &quot;googleapis.com&quot;
13063 # &quot;metadata&quot;: {
13064 # &quot;resource&quot;: &quot;projects/123&quot;,
13065 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
13066 # }
13067 # }
13068 #
13069 # This response indicates that the pubsub.googleapis.com API is not enabled.
13070 #
13071 # Example of an error that is returned when attempting to create a Spanner
13072 # instance in a region that is out of stock:
13073 #
13074 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
13075 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
13076 # &quot;metadata&quot;: {
13077 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
13078 # }
13079 # }
13080 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
13081 # is typically the registered service name of the tool or product that
13082 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
13083 # generated by some common infrastructure, the error domain must be a
13084 # globally unique value that identifies the infrastructure. For Google API
13085 # infrastructure, the error domain is &quot;googleapis.com&quot;.
13086 &quot;metadatas&quot;: { # Additional structured details about this error.
13087 #
13088 # Keys must match a regular expression of `a-z+` but should
13089 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
13090 # length. When identifying the current value of an exceeded limit, the units
13091 # should be contained in the key, not the value. For example, rather than
13092 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
13093 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
13094 # instances that can be created in a single (batch) request.
13095 &quot;a_key&quot;: &quot;A String&quot;,
13096 },
13097 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
13098 # proximate cause of the error. Error reasons are unique within a particular
13099 # domain of errors. This should be at most 63 characters and match a
13100 # regular expression of `A-Z+[A-Z0-9]`, which represents
13101 # UPPER_SNAKE_CASE.
13102 },
13103 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
13104 #
13105 # For example, if a quota check failed with an error indicating the calling
13106 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
13107 # directly to the right place in the developer console to flip the bit.
13108 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
13109 { # Describes a URL link.
13110 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
13111 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
13112 },
13113 ],
13114 },
13115 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
13116 # which can be attached to an RPC error.
13117 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
13118 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
13119 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
13120 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
13121 },
13122 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
13123 &quot;dimensions&quot;: { # The map holding related quota dimensions.
13124 &quot;a_key&quot;: &quot;A String&quot;,
13125 },
13126 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
13127 # type or metric.
13128 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
13129 # or metric.
13130 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
13131 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
13132 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
13133 },
13134 },
13135 ],
13136 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
13137 # This property is optional.
13138 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
13139 },
13140 ],
13141 },
13142 &quot;getVersionOperationMetadata&quot;: {
13143 &quot;inlineSbomInfo&quot;: {
13144 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
13145 # appropriate identifiers.
13146 &quot;a_key&quot;: &quot;A String&quot;,
13147 },
13148 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
13149 # identifiers.
13150 &quot;a_key&quot;: &quot;A String&quot;,
13151 },
13152 },
13153 },
13154 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
13155 # message that was returned, such as `NOT FOUND`.
13156 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
13157 # status code that was returned. For example, a `404` means the
13158 # resource was not found.
13159 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
13160 # defined by the server.
13161 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
13162 # This value is inRFC3339
13163 # text format.
13164 &quot;instancesBulkInsertOperationMetadata&quot;: {
13165 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
13166 # Example key: zones/us-central1-a
13167 &quot;a_key&quot;: {
13168 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
13169 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
13170 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
13171 # error.
13172 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
13173 # if the flow is rolling forward or rolling back.
13174 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
13175 },
13176 },
13177 },
13178 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
13179 # Operation resources.
13180 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
13181 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
13182 # group of operations results from a `bulkInsert` API request.
13183 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
13184 # `update`, or `delete`, and so on.
13185 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
13186 # There is no requirement that this be linear or support any granularity of
13187 # operations. This should not be used to guess when the operation will be
13188 # complete. This number should monotonically increase as the operation
13189 # progresses.
13190 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
13191 # applicable when performing regional operations.
13192 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
13193 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
13194 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
13195 # this field will contain information on all underlying zonal actions and
13196 # their state.
13197 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
13198 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
13199 # Example key: zones/us-central1-a
13200 &quot;a_key&quot;: {
13201 &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
13202 # populated.
13203 # different programming environments, including REST APIs and RPC APIs. It is
13204 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
13205 # three pieces of data: error code, error message, and error details.
13206 #
13207 # You can find out more about this error model and how to work with it in the
13208 # [API Design Guide](https://cloud.google.com/apis/design/errors).
13209 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
13210 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
13211 # message types for APIs to use.
13212 {
13213 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
13214 },
13215 ],
13216 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
13217 # user-facing error message should be localized and sent in the
13218 # google.rpc.Status.details field, or localized by the client.
13219 },
13220 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
13221 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
13222 },
13223 },
13224 },
13225 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
13226 # This value is inRFC3339
13227 # text format.
13228 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
13229 # following:
13230 # `PENDING`, `RUNNING`, or `DONE`.
13231 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
13232 # operation.
13233 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
13234 # of the target resource.
13235 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
13236 # operations related to creating a snapshot, this points to the disk
13237 # that the snapshot was created from.
13238 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
13239 # `[email protected]` or
13240 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
13241 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
13242 # operation, this field will be populated.
13243 {
13244 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
13245 # Engine returns NO_RESULTS_ON_PAGE if there
13246 # are no results in the response.
13247 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
13248 # value format. For example:
13249 #
13250 # &quot;data&quot;: [
13251 # {
13252 # &quot;key&quot;: &quot;scope&quot;,
13253 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
13254 # }
13255 {
13256 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
13257 # returned. For example, for warnings where there are no results in a list
13258 # request for a particular zone, this key might be scope and
13259 # the key value might be the zone name. Other examples might be a key
13260 # indicating a deprecated resource and a suggested replacement, or a
13261 # warning about invalid network settings (for example, if an instance
13262 # attempts to perform IP forwarding but is not enabled for IP forwarding).
13263 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
13264 },
13265 ],
13266 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
13267 },
13268 ],
13269 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
13270 # applicable when performing per-zone operations.
13271 }</pre>
13272 </div>
13273
13274 <div class="method">
13275 <code class="details" id="resizeAdvanced">resizeAdvanced(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
13276 <pre>Resizes the regional managed instance group with advanced configuration
13277 options like disabling creation retries. This is an extended version of theresize method.
13278
13279 If you increase the size, the group creates new instances using the current
13280 instance template. If you decrease the size, the group deletes one or more
13281 instances.
13282
13283 The resize operation is marked DONE if theresize request is successful. The underlying actions take
13284 additional time. You must separately verify the status of thecreating or deleting actions with the get
13285 orlistmanagedinstances
13286 method.
13287
13288 If the group is part of a backend
13289 service that has enabled
13290 connection draining, it can take up to 60 seconds after the connection
13291 draining duration has elapsed before the VM instance is removed or deleted.
13292
13293 Args:
13294 project: string, Project ID for this request. (required)
13295 region: string, Name of the region scoping this request.
13296 It must be a string that meets the requirements in RFC1035. (required)
13297 instanceGroupManager: string, The name of the managed instance group.
13298 It must be a string that meets the requirements in RFC1035. (required)
13299 body: object, The request body.
13300 The object takes the form of:
13301
13302 {
13303 &quot;noCreationRetries&quot;: True or False, # If this flag is true, the managed instance group attempts to create all
13304 # instances initiated by this resize request only once. If there is an error
13305 # during creation, the managed instance group does not retry create this
13306 # instance, and we will decrease the targetSize of the request
13307 # instead. If the flag is false, the group attempts to recreate each instance
13308 # continuously until it succeeds.
13309 #
13310 # This flag matters only in the first attempt of creation of an instance.
13311 # After an instance is successfully created while this flag is enabled, the
13312 # instance behaves the same way as all the other instances created with a
13313 # regular resize request. In particular, if a running instance dies
13314 # unexpectedly at a later time and needs to be recreated, this mode does not
13315 # affect the recreation behavior in that scenario.
13316 #
13317 # This flag is applicable only to the current resize request. It does not
13318 # influence other resize requests in any way.
13319 #
13320 # You can see which instances ar being created in which mode by calling
13321 # the get or listManagedInstances API.
13322 &quot;scaleInProtection&quot;: True or False, # If this flag is enabled within a request to decrease a MIG&#x27;s target size,
13323 # then the MIG declines that request.
13324 &quot;targetSize&quot;: 42, # The number of running instances that the managed instance group should
13325 # maintain at any given time. The group automatically adds or removes
13326 # instances to maintain the number of instances specified by this parameter.
13327 }
13328
13329 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
13330 that if you must retry your request, the server will know to ignore the
13331 request if it has already been completed.
13332
13333 For example, consider a situation where you make an initial request and
13334 the request times out. If you make the request again with the same
13335 request ID, the server can check if original operation with the same
13336 request ID was received, and if so, will ignore the second request. This
13337 prevents clients from accidentally creating duplicate commitments.
13338
13339 The request ID must be
13340 a valid UUID with the exception that zero UUID is not supported
13341 (00000000-0000-0000-0000-000000000000).
13342 x__xgafv: string, V1 error format.
13343 Allowed values
13344 1 - v1 error format
13345 2 - v2 error format
13346
13347 Returns:
13348 An object of the form:
13349
13350 { # Represents an Operation resource.
13351 #
13352 # Google Compute Engine has three Operation resources:
13353 #
13354 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
13355 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
13356 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
13357 #
13358 # You can use an operation resource to manage asynchronous API requests.
13359 # For more information, readHandling
13360 # API responses.
13361 #
13362 # Operations can be global, regional or zonal.
13363 #
13364 # - For global operations, use the `globalOperations`
13365 # resource.
13366 # - For regional operations, use the
13367 # `regionOperations` resource.
13368 # - For zonal operations, use
13369 # the `zoneOperations` resource.
13370 #
13371 #
13372 #
13373 # For more information, read
13374 # Global, Regional, and Zonal Resources.
13375 #
13376 # Note that completed Operation resources have a limited
13377 # retention period.
13378 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
13379 # Not present otherwise.
13380 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
13381 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
13382 # set when the operation is created.
13383 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
13384 # text format.
13385 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
13386 # this field will be populated.
13387 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
13388 # operation.
13389 {
13390 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
13391 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
13392 # details. There is a set of defined message types to use for providing
13393 # details.The syntax depends on the error code. For example,
13394 # QuotaExceededInfo will have details when the error code is
13395 # QUOTA_EXCEEDED.
13396 {
13397 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
13398 #
13399 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
13400 # is not enabled:
13401 #
13402 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
13403 # &quot;domain&quot;: &quot;googleapis.com&quot;
13404 # &quot;metadata&quot;: {
13405 # &quot;resource&quot;: &quot;projects/123&quot;,
13406 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
13407 # }
13408 # }
13409 #
13410 # This response indicates that the pubsub.googleapis.com API is not enabled.
13411 #
13412 # Example of an error that is returned when attempting to create a Spanner
13413 # instance in a region that is out of stock:
13414 #
13415 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
13416 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
13417 # &quot;metadata&quot;: {
13418 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
13419 # }
13420 # }
13421 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
13422 # is typically the registered service name of the tool or product that
13423 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
13424 # generated by some common infrastructure, the error domain must be a
13425 # globally unique value that identifies the infrastructure. For Google API
13426 # infrastructure, the error domain is &quot;googleapis.com&quot;.
13427 &quot;metadatas&quot;: { # Additional structured details about this error.
13428 #
13429 # Keys must match a regular expression of `a-z+` but should
13430 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
13431 # length. When identifying the current value of an exceeded limit, the units
13432 # should be contained in the key, not the value. For example, rather than
13433 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
13434 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
13435 # instances that can be created in a single (batch) request.
13436 &quot;a_key&quot;: &quot;A String&quot;,
13437 },
13438 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
13439 # proximate cause of the error. Error reasons are unique within a particular
13440 # domain of errors. This should be at most 63 characters and match a
13441 # regular expression of `A-Z+[A-Z0-9]`, which represents
13442 # UPPER_SNAKE_CASE.
13443 },
13444 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
13445 #
13446 # For example, if a quota check failed with an error indicating the calling
13447 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
13448 # directly to the right place in the developer console to flip the bit.
13449 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
13450 { # Describes a URL link.
13451 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
13452 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
13453 },
13454 ],
13455 },
13456 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
13457 # which can be attached to an RPC error.
13458 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
13459 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
13460 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
13461 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
13462 },
13463 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
13464 &quot;dimensions&quot;: { # The map holding related quota dimensions.
13465 &quot;a_key&quot;: &quot;A String&quot;,
13466 },
13467 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
13468 # type or metric.
13469 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
13470 # or metric.
13471 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
13472 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
13473 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
13474 },
13475 },
13476 ],
13477 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
13478 # This property is optional.
13479 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
13480 },
13481 ],
13482 },
13483 &quot;getVersionOperationMetadata&quot;: {
13484 &quot;inlineSbomInfo&quot;: {
13485 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
13486 # appropriate identifiers.
13487 &quot;a_key&quot;: &quot;A String&quot;,
13488 },
13489 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
13490 # identifiers.
13491 &quot;a_key&quot;: &quot;A String&quot;,
13492 },
13493 },
13494 },
13495 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
13496 # message that was returned, such as `NOT FOUND`.
13497 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
13498 # status code that was returned. For example, a `404` means the
13499 # resource was not found.
13500 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
13501 # defined by the server.
13502 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
13503 # This value is inRFC3339
13504 # text format.
13505 &quot;instancesBulkInsertOperationMetadata&quot;: {
13506 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
13507 # Example key: zones/us-central1-a
13508 &quot;a_key&quot;: {
13509 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
13510 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
13511 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
13512 # error.
13513 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
13514 # if the flow is rolling forward or rolling back.
13515 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
13516 },
13517 },
13518 },
13519 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
13520 # Operation resources.
13521 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
13522 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
13523 # group of operations results from a `bulkInsert` API request.
13524 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
13525 # `update`, or `delete`, and so on.
13526 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
13527 # There is no requirement that this be linear or support any granularity of
13528 # operations. This should not be used to guess when the operation will be
13529 # complete. This number should monotonically increase as the operation
13530 # progresses.
13531 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
13532 # applicable when performing regional operations.
13533 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
13534 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
13535 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
13536 # this field will contain information on all underlying zonal actions and
13537 # their state.
13538 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
13539 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
13540 # Example key: zones/us-central1-a
13541 &quot;a_key&quot;: {
13542 &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
13543 # populated.
13544 # different programming environments, including REST APIs and RPC APIs. It is
13545 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
13546 # three pieces of data: error code, error message, and error details.
13547 #
13548 # You can find out more about this error model and how to work with it in the
13549 # [API Design Guide](https://cloud.google.com/apis/design/errors).
13550 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
13551 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
13552 # message types for APIs to use.
13553 {
13554 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
13555 },
13556 ],
13557 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
13558 # user-facing error message should be localized and sent in the
13559 # google.rpc.Status.details field, or localized by the client.
13560 },
13561 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
13562 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
13563 },
13564 },
13565 },
13566 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
13567 # This value is inRFC3339
13568 # text format.
13569 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
13570 # following:
13571 # `PENDING`, `RUNNING`, or `DONE`.
13572 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
13573 # operation.
13574 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
13575 # of the target resource.
13576 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
13577 # operations related to creating a snapshot, this points to the disk
13578 # that the snapshot was created from.
13579 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
13580 # `[email protected]` or
13581 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
13582 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
13583 # operation, this field will be populated.
13584 {
13585 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
13586 # Engine returns NO_RESULTS_ON_PAGE if there
13587 # are no results in the response.
13588 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
13589 # value format. For example:
13590 #
13591 # &quot;data&quot;: [
13592 # {
13593 # &quot;key&quot;: &quot;scope&quot;,
13594 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
13595 # }
13596 {
13597 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
13598 # returned. For example, for warnings where there are no results in a list
13599 # request for a particular zone, this key might be scope and
13600 # the key value might be the zone name. Other examples might be a key
13601 # indicating a deprecated resource and a suggested replacement, or a
13602 # warning about invalid network settings (for example, if an instance
13603 # attempts to perform IP forwarding but is not enabled for IP forwarding).
13604 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
13605 },
13606 ],
13607 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
13608 },
13609 ],
13610 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
13611 # applicable when performing per-zone operations.
13612 }</pre>
13613 </div>
13614
13615 <div class="method">
13616 <code class="details" id="resumeInstances">resumeInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
13617 <pre>Flags the specified instances in the managed instance group to be
13618 resumed. This method increases thetargetSize and decreases the targetSuspendedSize
13619 of the managed instance group by the number of instances that you resume.
13620 The resumeInstances operation is marked DONE if
13621 the resumeInstances request is successful. The underlying
13622 actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances
13623 method.
13624
13625 In this request, you can only specify instances that are suspended. For
13626 example, if an instance was previously suspended using the suspendInstances
13627 method, it can be resumed using the resumeInstances method.
13628
13629 If a health check is attached to the managed instance group, the specified
13630 instances will be verified as healthy after they are resumed.
13631
13632 You can specify a maximum of 1000 instances with this method per request.
13633
13634 Args:
13635 project: string, Project ID for this request. (required)
13636 region: string, Name of the region scoping this request. (required)
13637 instanceGroupManager: string, Name of the managed instance group. (required)
13638 body: object, The request body.
13639 The object takes the form of:
13640
13641 {
13642 &quot;instances&quot;: [ # The URLs of one or more instances to resume. This can be a full URL or
13643 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
13644 &quot;A String&quot;,
13645 ],
13646 }
13647
13648 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
13649 that if you must retry your request, the server will know to ignore the
13650 request if it has already been completed.
13651
13652 For example, consider a situation where you make an initial request and
13653 the request times out. If you make the request again with the same
13654 request ID, the server can check if original operation with the same
13655 request ID was received, and if so, will ignore the second request. This
13656 prevents clients from accidentally creating duplicate commitments.
13657
13658 The request ID must be
13659 a valid UUID with the exception that zero UUID is not supported
13660 (00000000-0000-0000-0000-000000000000).
13661 x__xgafv: string, V1 error format.
13662 Allowed values
13663 1 - v1 error format
13664 2 - v2 error format
13665
13666 Returns:
13667 An object of the form:
13668
13669 { # Represents an Operation resource.
13670 #
13671 # Google Compute Engine has three Operation resources:
13672 #
13673 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
13674 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
13675 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
13676 #
13677 # You can use an operation resource to manage asynchronous API requests.
13678 # For more information, readHandling
13679 # API responses.
13680 #
13681 # Operations can be global, regional or zonal.
13682 #
13683 # - For global operations, use the `globalOperations`
13684 # resource.
13685 # - For regional operations, use the
13686 # `regionOperations` resource.
13687 # - For zonal operations, use
13688 # the `zoneOperations` resource.
13689 #
13690 #
13691 #
13692 # For more information, read
13693 # Global, Regional, and Zonal Resources.
13694 #
13695 # Note that completed Operation resources have a limited
13696 # retention period.
13697 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
13698 # Not present otherwise.
13699 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
13700 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
13701 # set when the operation is created.
13702 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
13703 # text format.
13704 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
13705 # this field will be populated.
13706 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
13707 # operation.
13708 {
13709 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
13710 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
13711 # details. There is a set of defined message types to use for providing
13712 # details.The syntax depends on the error code. For example,
13713 # QuotaExceededInfo will have details when the error code is
13714 # QUOTA_EXCEEDED.
13715 {
13716 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
13717 #
13718 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
13719 # is not enabled:
13720 #
13721 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
13722 # &quot;domain&quot;: &quot;googleapis.com&quot;
13723 # &quot;metadata&quot;: {
13724 # &quot;resource&quot;: &quot;projects/123&quot;,
13725 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
13726 # }
13727 # }
13728 #
13729 # This response indicates that the pubsub.googleapis.com API is not enabled.
13730 #
13731 # Example of an error that is returned when attempting to create a Spanner
13732 # instance in a region that is out of stock:
13733 #
13734 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
13735 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
13736 # &quot;metadata&quot;: {
13737 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
13738 # }
13739 # }
13740 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
13741 # is typically the registered service name of the tool or product that
13742 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
13743 # generated by some common infrastructure, the error domain must be a
13744 # globally unique value that identifies the infrastructure. For Google API
13745 # infrastructure, the error domain is &quot;googleapis.com&quot;.
13746 &quot;metadatas&quot;: { # Additional structured details about this error.
13747 #
13748 # Keys must match a regular expression of `a-z+` but should
13749 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
13750 # length. When identifying the current value of an exceeded limit, the units
13751 # should be contained in the key, not the value. For example, rather than
13752 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
13753 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
13754 # instances that can be created in a single (batch) request.
13755 &quot;a_key&quot;: &quot;A String&quot;,
13756 },
13757 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
13758 # proximate cause of the error. Error reasons are unique within a particular
13759 # domain of errors. This should be at most 63 characters and match a
13760 # regular expression of `A-Z+[A-Z0-9]`, which represents
13761 # UPPER_SNAKE_CASE.
13762 },
13763 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
13764 #
13765 # For example, if a quota check failed with an error indicating the calling
13766 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
13767 # directly to the right place in the developer console to flip the bit.
13768 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
13769 { # Describes a URL link.
13770 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
13771 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
13772 },
13773 ],
13774 },
13775 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
13776 # which can be attached to an RPC error.
13777 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
13778 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
13779 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
13780 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
13781 },
13782 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
13783 &quot;dimensions&quot;: { # The map holding related quota dimensions.
13784 &quot;a_key&quot;: &quot;A String&quot;,
13785 },
13786 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
13787 # type or metric.
13788 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
13789 # or metric.
13790 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
13791 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
13792 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
13793 },
13794 },
13795 ],
13796 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
13797 # This property is optional.
13798 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
13799 },
13800 ],
13801 },
13802 &quot;getVersionOperationMetadata&quot;: {
13803 &quot;inlineSbomInfo&quot;: {
13804 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
13805 # appropriate identifiers.
13806 &quot;a_key&quot;: &quot;A String&quot;,
13807 },
13808 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
13809 # identifiers.
13810 &quot;a_key&quot;: &quot;A String&quot;,
13811 },
13812 },
13813 },
13814 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
13815 # message that was returned, such as `NOT FOUND`.
13816 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
13817 # status code that was returned. For example, a `404` means the
13818 # resource was not found.
13819 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
13820 # defined by the server.
13821 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
13822 # This value is inRFC3339
13823 # text format.
13824 &quot;instancesBulkInsertOperationMetadata&quot;: {
13825 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
13826 # Example key: zones/us-central1-a
13827 &quot;a_key&quot;: {
13828 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
13829 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
13830 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
13831 # error.
13832 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
13833 # if the flow is rolling forward or rolling back.
13834 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
13835 },
13836 },
13837 },
13838 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
13839 # Operation resources.
13840 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
13841 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
13842 # group of operations results from a `bulkInsert` API request.
13843 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
13844 # `update`, or `delete`, and so on.
13845 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
13846 # There is no requirement that this be linear or support any granularity of
13847 # operations. This should not be used to guess when the operation will be
13848 # complete. This number should monotonically increase as the operation
13849 # progresses.
13850 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
13851 # applicable when performing regional operations.
13852 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
13853 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
13854 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
13855 # this field will contain information on all underlying zonal actions and
13856 # their state.
13857 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
13858 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
13859 # Example key: zones/us-central1-a
13860 &quot;a_key&quot;: {
13861 &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
13862 # populated.
13863 # different programming environments, including REST APIs and RPC APIs. It is
13864 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
13865 # three pieces of data: error code, error message, and error details.
13866 #
13867 # You can find out more about this error model and how to work with it in the
13868 # [API Design Guide](https://cloud.google.com/apis/design/errors).
13869 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
13870 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
13871 # message types for APIs to use.
13872 {
13873 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
13874 },
13875 ],
13876 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
13877 # user-facing error message should be localized and sent in the
13878 # google.rpc.Status.details field, or localized by the client.
13879 },
13880 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
13881 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
13882 },
13883 },
13884 },
13885 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
13886 # This value is inRFC3339
13887 # text format.
13888 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
13889 # following:
13890 # `PENDING`, `RUNNING`, or `DONE`.
13891 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
13892 # operation.
13893 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
13894 # of the target resource.
13895 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
13896 # operations related to creating a snapshot, this points to the disk
13897 # that the snapshot was created from.
13898 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
13899 # `[email protected]` or
13900 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
13901 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
13902 # operation, this field will be populated.
13903 {
13904 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
13905 # Engine returns NO_RESULTS_ON_PAGE if there
13906 # are no results in the response.
13907 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
13908 # value format. For example:
13909 #
13910 # &quot;data&quot;: [
13911 # {
13912 # &quot;key&quot;: &quot;scope&quot;,
13913 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
13914 # }
13915 {
13916 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
13917 # returned. For example, for warnings where there are no results in a list
13918 # request for a particular zone, this key might be scope and
13919 # the key value might be the zone name. Other examples might be a key
13920 # indicating a deprecated resource and a suggested replacement, or a
13921 # warning about invalid network settings (for example, if an instance
13922 # attempts to perform IP forwarding but is not enabled for IP forwarding).
13923 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
13924 },
13925 ],
13926 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
13927 },
13928 ],
13929 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
13930 # applicable when performing per-zone operations.
13931 }</pre>
13932 </div>
13933
13934 <div class="method">
13935 <code class="details" id="setAutoHealingPolicies">setAutoHealingPolicies(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
13936 <pre>Modifies the autohealing policy for the instances in this managed
13937 instance group.
13938 [Deprecated] This method is deprecated. UseregionInstanceGroupManagers.patch instead.
13939
13940 Args:
13941 project: string, Project ID for this request. (required)
13942 region: string, Name of the region scoping this request. (required)
13943 instanceGroupManager: string, Name of the managed instance group. (required)
13944 body: object, The request body.
13945 The object takes the form of:
13946
13947 {
13948 &quot;autoHealingPolicies&quot;: [
13949 {
13950 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
13951 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
13952 # this field controls whether to trigger VM autohealing based on a failed
13953 # health check. Valid values are:
13954 #
13955 # - ON (default): The group recreates running VMs that
13956 # fail the application-based health check.
13957 # - OFF: When set to OFF, you can still observe instance
13958 # health state, but the group does not recreate VMs that fail the
13959 # application-based health check. This is useful for troubleshooting and
13960 # setting up your health check configuration.
13961 },
13962 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
13963 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
13964 # initialize and run its startup script. During a VM&#x27;s initial delay
13965 # period, the MIG ignores unsuccessful health checks because the VM might
13966 # be in the startup process. This prevents the MIG from prematurely
13967 # recreating a VM. If the health check receives a healthy response during
13968 # the initial delay, it indicates that the startup process is complete and
13969 # the VM is ready. The value of initial delay must be between 0 and 3600
13970 # seconds. The default value is 0.
13971 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
13972 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
13973 # The instance is considered available if all of the following conditions
13974 # are satisfied:
13975 # 1. Instance&#x27;s status is RUNNING.
13976 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
13977 # check result was observed to be HEALTHY at least once as it passed
13978 # VERIFYING).
13979 # 3. There is no outgoing action on an instance triggered by IGM.
13980 #
13981 # By default, number of concurrently autohealed instances is smaller than
13982 # the managed instance group target size. However, if a zonal managed
13983 # instance group has only one instance, or a regional managed instance
13984 # group has only one instance per zone, autohealing will recreate these
13985 # instances when they become unhealthy.
13986 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
13987 #
13988 #
13989 #
13990 # - If the value is fixed, then the calculated
13991 # value is equal to the fixed value.
13992 # - If the value is a percent, then the
13993 # calculated
13994 # value is percent/100 * targetSize. For example,
13995 # the calculated value of a 80% of a managed instance group
13996 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
13997 # is a remainder, the number is rounded.
13998 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
13999 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
14000 # example, specify 80 for 80%.
14001 },
14002 },
14003 ],
14004 }
14005
14006 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14007 that if you must retry your request, the server will know to ignore the
14008 request if it has already been completed.
14009
14010 For example, consider a situation where you make an initial request and
14011 the request times out. If you make the request again with the same
14012 request ID, the server can check if original operation with the same
14013 request ID was received, and if so, will ignore the second request. This
14014 prevents clients from accidentally creating duplicate commitments.
14015
14016 The request ID must be
14017 a valid UUID with the exception that zero UUID is not supported
14018 (00000000-0000-0000-0000-000000000000).
14019 x__xgafv: string, V1 error format.
14020 Allowed values
14021 1 - v1 error format
14022 2 - v2 error format
14023
14024 Returns:
14025 An object of the form:
14026
14027 { # Represents an Operation resource.
14028 #
14029 # Google Compute Engine has three Operation resources:
14030 #
14031 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
14032 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
14033 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
14034 #
14035 # You can use an operation resource to manage asynchronous API requests.
14036 # For more information, readHandling
14037 # API responses.
14038 #
14039 # Operations can be global, regional or zonal.
14040 #
14041 # - For global operations, use the `globalOperations`
14042 # resource.
14043 # - For regional operations, use the
14044 # `regionOperations` resource.
14045 # - For zonal operations, use
14046 # the `zoneOperations` resource.
14047 #
14048 #
14049 #
14050 # For more information, read
14051 # Global, Regional, and Zonal Resources.
14052 #
14053 # Note that completed Operation resources have a limited
14054 # retention period.
14055 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14056 # Not present otherwise.
14057 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14058 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14059 # set when the operation is created.
14060 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14061 # text format.
14062 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14063 # this field will be populated.
14064 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14065 # operation.
14066 {
14067 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14068 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14069 # details. There is a set of defined message types to use for providing
14070 # details.The syntax depends on the error code. For example,
14071 # QuotaExceededInfo will have details when the error code is
14072 # QUOTA_EXCEEDED.
14073 {
14074 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14075 #
14076 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14077 # is not enabled:
14078 #
14079 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14080 # &quot;domain&quot;: &quot;googleapis.com&quot;
14081 # &quot;metadata&quot;: {
14082 # &quot;resource&quot;: &quot;projects/123&quot;,
14083 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14084 # }
14085 # }
14086 #
14087 # This response indicates that the pubsub.googleapis.com API is not enabled.
14088 #
14089 # Example of an error that is returned when attempting to create a Spanner
14090 # instance in a region that is out of stock:
14091 #
14092 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14093 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14094 # &quot;metadata&quot;: {
14095 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14096 # }
14097 # }
14098 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14099 # is typically the registered service name of the tool or product that
14100 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14101 # generated by some common infrastructure, the error domain must be a
14102 # globally unique value that identifies the infrastructure. For Google API
14103 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14104 &quot;metadatas&quot;: { # Additional structured details about this error.
14105 #
14106 # Keys must match a regular expression of `a-z+` but should
14107 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14108 # length. When identifying the current value of an exceeded limit, the units
14109 # should be contained in the key, not the value. For example, rather than
14110 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14111 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14112 # instances that can be created in a single (batch) request.
14113 &quot;a_key&quot;: &quot;A String&quot;,
14114 },
14115 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14116 # proximate cause of the error. Error reasons are unique within a particular
14117 # domain of errors. This should be at most 63 characters and match a
14118 # regular expression of `A-Z+[A-Z0-9]`, which represents
14119 # UPPER_SNAKE_CASE.
14120 },
14121 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14122 #
14123 # For example, if a quota check failed with an error indicating the calling
14124 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14125 # directly to the right place in the developer console to flip the bit.
14126 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14127 { # Describes a URL link.
14128 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14129 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14130 },
14131 ],
14132 },
14133 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14134 # which can be attached to an RPC error.
14135 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14136 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14137 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14138 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14139 },
14140 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14141 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14142 &quot;a_key&quot;: &quot;A String&quot;,
14143 },
14144 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14145 # type or metric.
14146 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14147 # or metric.
14148 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14149 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14150 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14151 },
14152 },
14153 ],
14154 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14155 # This property is optional.
14156 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14157 },
14158 ],
14159 },
14160 &quot;getVersionOperationMetadata&quot;: {
14161 &quot;inlineSbomInfo&quot;: {
14162 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14163 # appropriate identifiers.
14164 &quot;a_key&quot;: &quot;A String&quot;,
14165 },
14166 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14167 # identifiers.
14168 &quot;a_key&quot;: &quot;A String&quot;,
14169 },
14170 },
14171 },
14172 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14173 # message that was returned, such as `NOT FOUND`.
14174 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14175 # status code that was returned. For example, a `404` means the
14176 # resource was not found.
14177 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14178 # defined by the server.
14179 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14180 # This value is inRFC3339
14181 # text format.
14182 &quot;instancesBulkInsertOperationMetadata&quot;: {
14183 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14184 # Example key: zones/us-central1-a
14185 &quot;a_key&quot;: {
14186 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14187 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14188 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14189 # error.
14190 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14191 # if the flow is rolling forward or rolling back.
14192 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14193 },
14194 },
14195 },
14196 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
14197 # Operation resources.
14198 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
14199 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
14200 # group of operations results from a `bulkInsert` API request.
14201 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
14202 # `update`, or `delete`, and so on.
14203 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
14204 # There is no requirement that this be linear or support any granularity of
14205 # operations. This should not be used to guess when the operation will be
14206 # complete. This number should monotonically increase as the operation
14207 # progresses.
14208 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
14209 # applicable when performing regional operations.
14210 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
14211 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
14212 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
14213 # this field will contain information on all underlying zonal actions and
14214 # their state.
14215 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
14216 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
14217 # Example key: zones/us-central1-a
14218 &quot;a_key&quot;: {
14219 &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
14220 # populated.
14221 # different programming environments, including REST APIs and RPC APIs. It is
14222 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
14223 # three pieces of data: error code, error message, and error details.
14224 #
14225 # You can find out more about this error model and how to work with it in the
14226 # [API Design Guide](https://cloud.google.com/apis/design/errors).
14227 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
14228 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
14229 # message types for APIs to use.
14230 {
14231 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
14232 },
14233 ],
14234 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
14235 # user-facing error message should be localized and sent in the
14236 # google.rpc.Status.details field, or localized by the client.
14237 },
14238 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
14239 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
14240 },
14241 },
14242 },
14243 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
14244 # This value is inRFC3339
14245 # text format.
14246 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
14247 # following:
14248 # `PENDING`, `RUNNING`, or `DONE`.
14249 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
14250 # operation.
14251 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
14252 # of the target resource.
14253 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
14254 # operations related to creating a snapshot, this points to the disk
14255 # that the snapshot was created from.
14256 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
14257 # `[email protected]` or
14258 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
14259 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
14260 # operation, this field will be populated.
14261 {
14262 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
14263 # Engine returns NO_RESULTS_ON_PAGE if there
14264 # are no results in the response.
14265 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
14266 # value format. For example:
14267 #
14268 # &quot;data&quot;: [
14269 # {
14270 # &quot;key&quot;: &quot;scope&quot;,
14271 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
14272 # }
14273 {
14274 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
14275 # returned. For example, for warnings where there are no results in a list
14276 # request for a particular zone, this key might be scope and
14277 # the key value might be the zone name. Other examples might be a key
14278 # indicating a deprecated resource and a suggested replacement, or a
14279 # warning about invalid network settings (for example, if an instance
14280 # attempts to perform IP forwarding but is not enabled for IP forwarding).
14281 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
14282 },
14283 ],
14284 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
14285 },
14286 ],
14287 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
14288 # applicable when performing per-zone operations.
14289 }</pre>
14290 </div>
14291
14292 <div class="method">
14293 <code class="details" id="setInstanceTemplate">setInstanceTemplate(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
14294 <pre>Sets the instance template to use when creating new instances or recreating
14295 instances in this group. Existing instances are not affected.
14296
14297 Args:
14298 project: string, Project ID for this request. (required)
14299 region: string, Name of the region scoping this request. (required)
14300 instanceGroupManager: string, The name of the managed instance group. (required)
14301 body: object, The request body.
14302 The object takes the form of:
14303
14304 {
14305 &quot;instanceTemplate&quot;: &quot;A String&quot;, # URL of the InstanceTemplate resource from which all new instances will be
14306 # created.
14307 }
14308
14309 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14310 that if you must retry your request, the server will know to ignore the
14311 request if it has already been completed.
14312
14313 For example, consider a situation where you make an initial request and
14314 the request times out. If you make the request again with the same
14315 request ID, the server can check if original operation with the same
14316 request ID was received, and if so, will ignore the second request. This
14317 prevents clients from accidentally creating duplicate commitments.
14318
14319 The request ID must be
14320 a valid UUID with the exception that zero UUID is not supported
14321 (00000000-0000-0000-0000-000000000000).
14322 x__xgafv: string, V1 error format.
14323 Allowed values
14324 1 - v1 error format
14325 2 - v2 error format
14326
14327 Returns:
14328 An object of the form:
14329
14330 { # Represents an Operation resource.
14331 #
14332 # Google Compute Engine has three Operation resources:
14333 #
14334 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
14335 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
14336 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
14337 #
14338 # You can use an operation resource to manage asynchronous API requests.
14339 # For more information, readHandling
14340 # API responses.
14341 #
14342 # Operations can be global, regional or zonal.
14343 #
14344 # - For global operations, use the `globalOperations`
14345 # resource.
14346 # - For regional operations, use the
14347 # `regionOperations` resource.
14348 # - For zonal operations, use
14349 # the `zoneOperations` resource.
14350 #
14351 #
14352 #
14353 # For more information, read
14354 # Global, Regional, and Zonal Resources.
14355 #
14356 # Note that completed Operation resources have a limited
14357 # retention period.
14358 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14359 # Not present otherwise.
14360 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14361 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14362 # set when the operation is created.
14363 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14364 # text format.
14365 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14366 # this field will be populated.
14367 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14368 # operation.
14369 {
14370 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14371 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14372 # details. There is a set of defined message types to use for providing
14373 # details.The syntax depends on the error code. For example,
14374 # QuotaExceededInfo will have details when the error code is
14375 # QUOTA_EXCEEDED.
14376 {
14377 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14378 #
14379 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14380 # is not enabled:
14381 #
14382 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14383 # &quot;domain&quot;: &quot;googleapis.com&quot;
14384 # &quot;metadata&quot;: {
14385 # &quot;resource&quot;: &quot;projects/123&quot;,
14386 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14387 # }
14388 # }
14389 #
14390 # This response indicates that the pubsub.googleapis.com API is not enabled.
14391 #
14392 # Example of an error that is returned when attempting to create a Spanner
14393 # instance in a region that is out of stock:
14394 #
14395 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14396 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14397 # &quot;metadata&quot;: {
14398 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14399 # }
14400 # }
14401 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14402 # is typically the registered service name of the tool or product that
14403 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14404 # generated by some common infrastructure, the error domain must be a
14405 # globally unique value that identifies the infrastructure. For Google API
14406 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14407 &quot;metadatas&quot;: { # Additional structured details about this error.
14408 #
14409 # Keys must match a regular expression of `a-z+` but should
14410 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14411 # length. When identifying the current value of an exceeded limit, the units
14412 # should be contained in the key, not the value. For example, rather than
14413 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14414 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14415 # instances that can be created in a single (batch) request.
14416 &quot;a_key&quot;: &quot;A String&quot;,
14417 },
14418 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14419 # proximate cause of the error. Error reasons are unique within a particular
14420 # domain of errors. This should be at most 63 characters and match a
14421 # regular expression of `A-Z+[A-Z0-9]`, which represents
14422 # UPPER_SNAKE_CASE.
14423 },
14424 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14425 #
14426 # For example, if a quota check failed with an error indicating the calling
14427 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14428 # directly to the right place in the developer console to flip the bit.
14429 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14430 { # Describes a URL link.
14431 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14432 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14433 },
14434 ],
14435 },
14436 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14437 # which can be attached to an RPC error.
14438 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14439 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14440 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14441 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14442 },
14443 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14444 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14445 &quot;a_key&quot;: &quot;A String&quot;,
14446 },
14447 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14448 # type or metric.
14449 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14450 # or metric.
14451 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14452 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14453 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14454 },
14455 },
14456 ],
14457 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14458 # This property is optional.
14459 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14460 },
14461 ],
14462 },
14463 &quot;getVersionOperationMetadata&quot;: {
14464 &quot;inlineSbomInfo&quot;: {
14465 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14466 # appropriate identifiers.
14467 &quot;a_key&quot;: &quot;A String&quot;,
14468 },
14469 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14470 # identifiers.
14471 &quot;a_key&quot;: &quot;A String&quot;,
14472 },
14473 },
14474 },
14475 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14476 # message that was returned, such as `NOT FOUND`.
14477 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14478 # status code that was returned. For example, a `404` means the
14479 # resource was not found.
14480 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14481 # defined by the server.
14482 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14483 # This value is inRFC3339
14484 # text format.
14485 &quot;instancesBulkInsertOperationMetadata&quot;: {
14486 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14487 # Example key: zones/us-central1-a
14488 &quot;a_key&quot;: {
14489 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14490 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14491 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14492 # error.
14493 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14494 # if the flow is rolling forward or rolling back.
14495 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14496 },
14497 },
14498 },
14499 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
14500 # Operation resources.
14501 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
14502 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
14503 # group of operations results from a `bulkInsert` API request.
14504 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
14505 # `update`, or `delete`, and so on.
14506 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
14507 # There is no requirement that this be linear or support any granularity of
14508 # operations. This should not be used to guess when the operation will be
14509 # complete. This number should monotonically increase as the operation
14510 # progresses.
14511 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
14512 # applicable when performing regional operations.
14513 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
14514 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
14515 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
14516 # this field will contain information on all underlying zonal actions and
14517 # their state.
14518 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
14519 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
14520 # Example key: zones/us-central1-a
14521 &quot;a_key&quot;: {
14522 &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
14523 # populated.
14524 # different programming environments, including REST APIs and RPC APIs. It is
14525 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
14526 # three pieces of data: error code, error message, and error details.
14527 #
14528 # You can find out more about this error model and how to work with it in the
14529 # [API Design Guide](https://cloud.google.com/apis/design/errors).
14530 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
14531 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
14532 # message types for APIs to use.
14533 {
14534 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
14535 },
14536 ],
14537 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
14538 # user-facing error message should be localized and sent in the
14539 # google.rpc.Status.details field, or localized by the client.
14540 },
14541 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
14542 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
14543 },
14544 },
14545 },
14546 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
14547 # This value is inRFC3339
14548 # text format.
14549 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
14550 # following:
14551 # `PENDING`, `RUNNING`, or `DONE`.
14552 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
14553 # operation.
14554 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
14555 # of the target resource.
14556 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
14557 # operations related to creating a snapshot, this points to the disk
14558 # that the snapshot was created from.
14559 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
14560 # `[email protected]` or
14561 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
14562 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
14563 # operation, this field will be populated.
14564 {
14565 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
14566 # Engine returns NO_RESULTS_ON_PAGE if there
14567 # are no results in the response.
14568 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
14569 # value format. For example:
14570 #
14571 # &quot;data&quot;: [
14572 # {
14573 # &quot;key&quot;: &quot;scope&quot;,
14574 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
14575 # }
14576 {
14577 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
14578 # returned. For example, for warnings where there are no results in a list
14579 # request for a particular zone, this key might be scope and
14580 # the key value might be the zone name. Other examples might be a key
14581 # indicating a deprecated resource and a suggested replacement, or a
14582 # warning about invalid network settings (for example, if an instance
14583 # attempts to perform IP forwarding but is not enabled for IP forwarding).
14584 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
14585 },
14586 ],
14587 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
14588 },
14589 ],
14590 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
14591 # applicable when performing per-zone operations.
14592 }</pre>
14593 </div>
14594
14595 <div class="method">
14596 <code class="details" id="setTargetPools">setTargetPools(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
14597 <pre>Modifies the target pools to which all new instances in this group are
14598 assigned. Existing instances in the group are not affected.
14599
14600 Args:
14601 project: string, Project ID for this request. (required)
14602 region: string, Name of the region scoping this request. (required)
14603 instanceGroupManager: string, Name of the managed instance group. (required)
14604 body: object, The request body.
14605 The object takes the form of:
14606
14607 {
14608 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of the target pools information, which is a hash of the
14609 # contents. This field is used for optimistic locking when you update the
14610 # target pool entries. This field is optional.
14611 &quot;targetPools&quot;: [ # The URL of all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
14612 # apply to all of the instances in the managed instance group.
14613 &quot;A String&quot;,
14614 ],
14615 }
14616
14617 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14618 that if you must retry your request, the server will know to ignore the
14619 request if it has already been completed.
14620
14621 For example, consider a situation where you make an initial request and
14622 the request times out. If you make the request again with the same
14623 request ID, the server can check if original operation with the same
14624 request ID was received, and if so, will ignore the second request. This
14625 prevents clients from accidentally creating duplicate commitments.
14626
14627 The request ID must be
14628 a valid UUID with the exception that zero UUID is not supported
14629 (00000000-0000-0000-0000-000000000000).
14630 x__xgafv: string, V1 error format.
14631 Allowed values
14632 1 - v1 error format
14633 2 - v2 error format
14634
14635 Returns:
14636 An object of the form:
14637
14638 { # Represents an Operation resource.
14639 #
14640 # Google Compute Engine has three Operation resources:
14641 #
14642 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
14643 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
14644 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
14645 #
14646 # You can use an operation resource to manage asynchronous API requests.
14647 # For more information, readHandling
14648 # API responses.
14649 #
14650 # Operations can be global, regional or zonal.
14651 #
14652 # - For global operations, use the `globalOperations`
14653 # resource.
14654 # - For regional operations, use the
14655 # `regionOperations` resource.
14656 # - For zonal operations, use
14657 # the `zoneOperations` resource.
14658 #
14659 #
14660 #
14661 # For more information, read
14662 # Global, Regional, and Zonal Resources.
14663 #
14664 # Note that completed Operation resources have a limited
14665 # retention period.
14666 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14667 # Not present otherwise.
14668 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14669 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14670 # set when the operation is created.
14671 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14672 # text format.
14673 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14674 # this field will be populated.
14675 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14676 # operation.
14677 {
14678 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14679 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14680 # details. There is a set of defined message types to use for providing
14681 # details.The syntax depends on the error code. For example,
14682 # QuotaExceededInfo will have details when the error code is
14683 # QUOTA_EXCEEDED.
14684 {
14685 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14686 #
14687 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14688 # is not enabled:
14689 #
14690 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14691 # &quot;domain&quot;: &quot;googleapis.com&quot;
14692 # &quot;metadata&quot;: {
14693 # &quot;resource&quot;: &quot;projects/123&quot;,
14694 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14695 # }
14696 # }
14697 #
14698 # This response indicates that the pubsub.googleapis.com API is not enabled.
14699 #
14700 # Example of an error that is returned when attempting to create a Spanner
14701 # instance in a region that is out of stock:
14702 #
14703 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14704 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14705 # &quot;metadata&quot;: {
14706 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14707 # }
14708 # }
14709 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14710 # is typically the registered service name of the tool or product that
14711 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14712 # generated by some common infrastructure, the error domain must be a
14713 # globally unique value that identifies the infrastructure. For Google API
14714 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14715 &quot;metadatas&quot;: { # Additional structured details about this error.
14716 #
14717 # Keys must match a regular expression of `a-z+` but should
14718 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14719 # length. When identifying the current value of an exceeded limit, the units
14720 # should be contained in the key, not the value. For example, rather than
14721 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14722 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14723 # instances that can be created in a single (batch) request.
14724 &quot;a_key&quot;: &quot;A String&quot;,
14725 },
14726 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14727 # proximate cause of the error. Error reasons are unique within a particular
14728 # domain of errors. This should be at most 63 characters and match a
14729 # regular expression of `A-Z+[A-Z0-9]`, which represents
14730 # UPPER_SNAKE_CASE.
14731 },
14732 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14733 #
14734 # For example, if a quota check failed with an error indicating the calling
14735 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14736 # directly to the right place in the developer console to flip the bit.
14737 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14738 { # Describes a URL link.
14739 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14740 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14741 },
14742 ],
14743 },
14744 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14745 # which can be attached to an RPC error.
14746 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14747 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14748 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14749 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14750 },
14751 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14752 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14753 &quot;a_key&quot;: &quot;A String&quot;,
14754 },
14755 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14756 # type or metric.
14757 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14758 # or metric.
14759 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14760 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14761 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14762 },
14763 },
14764 ],
14765 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14766 # This property is optional.
14767 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14768 },
14769 ],
14770 },
14771 &quot;getVersionOperationMetadata&quot;: {
14772 &quot;inlineSbomInfo&quot;: {
14773 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14774 # appropriate identifiers.
14775 &quot;a_key&quot;: &quot;A String&quot;,
14776 },
14777 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14778 # identifiers.
14779 &quot;a_key&quot;: &quot;A String&quot;,
14780 },
14781 },
14782 },
14783 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14784 # message that was returned, such as `NOT FOUND`.
14785 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14786 # status code that was returned. For example, a `404` means the
14787 # resource was not found.
14788 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14789 # defined by the server.
14790 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14791 # This value is inRFC3339
14792 # text format.
14793 &quot;instancesBulkInsertOperationMetadata&quot;: {
14794 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14795 # Example key: zones/us-central1-a
14796 &quot;a_key&quot;: {
14797 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14798 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14799 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14800 # error.
14801 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14802 # if the flow is rolling forward or rolling back.
14803 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14804 },
14805 },
14806 },
14807 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
14808 # Operation resources.
14809 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
14810 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
14811 # group of operations results from a `bulkInsert` API request.
14812 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
14813 # `update`, or `delete`, and so on.
14814 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
14815 # There is no requirement that this be linear or support any granularity of
14816 # operations. This should not be used to guess when the operation will be
14817 # complete. This number should monotonically increase as the operation
14818 # progresses.
14819 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
14820 # applicable when performing regional operations.
14821 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
14822 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
14823 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
14824 # this field will contain information on all underlying zonal actions and
14825 # their state.
14826 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
14827 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
14828 # Example key: zones/us-central1-a
14829 &quot;a_key&quot;: {
14830 &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
14831 # populated.
14832 # different programming environments, including REST APIs and RPC APIs. It is
14833 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
14834 # three pieces of data: error code, error message, and error details.
14835 #
14836 # You can find out more about this error model and how to work with it in the
14837 # [API Design Guide](https://cloud.google.com/apis/design/errors).
14838 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
14839 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
14840 # message types for APIs to use.
14841 {
14842 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
14843 },
14844 ],
14845 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
14846 # user-facing error message should be localized and sent in the
14847 # google.rpc.Status.details field, or localized by the client.
14848 },
14849 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
14850 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
14851 },
14852 },
14853 },
14854 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
14855 # This value is inRFC3339
14856 # text format.
14857 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
14858 # following:
14859 # `PENDING`, `RUNNING`, or `DONE`.
14860 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
14861 # operation.
14862 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
14863 # of the target resource.
14864 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
14865 # operations related to creating a snapshot, this points to the disk
14866 # that the snapshot was created from.
14867 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
14868 # `[email protected]` or
14869 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
14870 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
14871 # operation, this field will be populated.
14872 {
14873 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
14874 # Engine returns NO_RESULTS_ON_PAGE if there
14875 # are no results in the response.
14876 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
14877 # value format. For example:
14878 #
14879 # &quot;data&quot;: [
14880 # {
14881 # &quot;key&quot;: &quot;scope&quot;,
14882 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
14883 # }
14884 {
14885 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
14886 # returned. For example, for warnings where there are no results in a list
14887 # request for a particular zone, this key might be scope and
14888 # the key value might be the zone name. Other examples might be a key
14889 # indicating a deprecated resource and a suggested replacement, or a
14890 # warning about invalid network settings (for example, if an instance
14891 # attempts to perform IP forwarding but is not enabled for IP forwarding).
14892 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
14893 },
14894 ],
14895 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
14896 },
14897 ],
14898 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
14899 # applicable when performing per-zone operations.
14900 }</pre>
14901 </div>
14902
14903 <div class="method">
14904 <code class="details" id="startInstances">startInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
14905 <pre>Flags the specified instances in the managed instance group to be
14906 started. This method increases thetargetSize and decreases the targetStoppedSize
14907 of the managed instance group by the number of instances that you start.
14908 The startInstances operation is marked DONE if
14909 the startInstances request is successful. The underlying
14910 actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances
14911 method.
14912
14913 In this request, you can only specify instances that are stopped. For
14914 example, if an instance was previously stopped using the stopInstances
14915 method, it can be started using the startInstances method.
14916
14917 If a health check is attached to the managed instance group, the specified
14918 instances will be verified as healthy after they are started.
14919
14920 You can specify a maximum of 1000 instances with this method per request.
14921
14922 Args:
14923 project: string, Project ID for this request. (required)
14924 region: string, Name of the region scoping this request. (required)
14925 instanceGroupManager: string, Name of the managed instance group. (required)
14926 body: object, The request body.
14927 The object takes the form of:
14928
14929 {
14930 &quot;instances&quot;: [ # The URLs of one or more instances to start. This can be a full URL or
14931 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
14932 &quot;A String&quot;,
14933 ],
14934 }
14935
14936 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14937 that if you must retry your request, the server will know to ignore the
14938 request if it has already been completed.
14939
14940 For example, consider a situation where you make an initial request and
14941 the request times out. If you make the request again with the same
14942 request ID, the server can check if original operation with the same
14943 request ID was received, and if so, will ignore the second request. This
14944 prevents clients from accidentally creating duplicate commitments.
14945
14946 The request ID must be
14947 a valid UUID with the exception that zero UUID is not supported
14948 (00000000-0000-0000-0000-000000000000).
14949 x__xgafv: string, V1 error format.
14950 Allowed values
14951 1 - v1 error format
14952 2 - v2 error format
14953
14954 Returns:
14955 An object of the form:
14956
14957 { # Represents an Operation resource.
14958 #
14959 # Google Compute Engine has three Operation resources:
14960 #
14961 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
14962 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
14963 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
14964 #
14965 # You can use an operation resource to manage asynchronous API requests.
14966 # For more information, readHandling
14967 # API responses.
14968 #
14969 # Operations can be global, regional or zonal.
14970 #
14971 # - For global operations, use the `globalOperations`
14972 # resource.
14973 # - For regional operations, use the
14974 # `regionOperations` resource.
14975 # - For zonal operations, use
14976 # the `zoneOperations` resource.
14977 #
14978 #
14979 #
14980 # For more information, read
14981 # Global, Regional, and Zonal Resources.
14982 #
14983 # Note that completed Operation resources have a limited
14984 # retention period.
14985 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14986 # Not present otherwise.
14987 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14988 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14989 # set when the operation is created.
14990 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14991 # text format.
14992 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14993 # this field will be populated.
14994 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14995 # operation.
14996 {
14997 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14998 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14999 # details. There is a set of defined message types to use for providing
15000 # details.The syntax depends on the error code. For example,
15001 # QuotaExceededInfo will have details when the error code is
15002 # QUOTA_EXCEEDED.
15003 {
15004 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
15005 #
15006 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
15007 # is not enabled:
15008 #
15009 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
15010 # &quot;domain&quot;: &quot;googleapis.com&quot;
15011 # &quot;metadata&quot;: {
15012 # &quot;resource&quot;: &quot;projects/123&quot;,
15013 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
15014 # }
15015 # }
15016 #
15017 # This response indicates that the pubsub.googleapis.com API is not enabled.
15018 #
15019 # Example of an error that is returned when attempting to create a Spanner
15020 # instance in a region that is out of stock:
15021 #
15022 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
15023 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
15024 # &quot;metadata&quot;: {
15025 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
15026 # }
15027 # }
15028 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
15029 # is typically the registered service name of the tool or product that
15030 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
15031 # generated by some common infrastructure, the error domain must be a
15032 # globally unique value that identifies the infrastructure. For Google API
15033 # infrastructure, the error domain is &quot;googleapis.com&quot;.
15034 &quot;metadatas&quot;: { # Additional structured details about this error.
15035 #
15036 # Keys must match a regular expression of `a-z+` but should
15037 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
15038 # length. When identifying the current value of an exceeded limit, the units
15039 # should be contained in the key, not the value. For example, rather than
15040 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
15041 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
15042 # instances that can be created in a single (batch) request.
15043 &quot;a_key&quot;: &quot;A String&quot;,
15044 },
15045 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
15046 # proximate cause of the error. Error reasons are unique within a particular
15047 # domain of errors. This should be at most 63 characters and match a
15048 # regular expression of `A-Z+[A-Z0-9]`, which represents
15049 # UPPER_SNAKE_CASE.
15050 },
15051 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
15052 #
15053 # For example, if a quota check failed with an error indicating the calling
15054 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
15055 # directly to the right place in the developer console to flip the bit.
15056 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
15057 { # Describes a URL link.
15058 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
15059 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
15060 },
15061 ],
15062 },
15063 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
15064 # which can be attached to an RPC error.
15065 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
15066 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
15067 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
15068 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
15069 },
15070 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
15071 &quot;dimensions&quot;: { # The map holding related quota dimensions.
15072 &quot;a_key&quot;: &quot;A String&quot;,
15073 },
15074 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
15075 # type or metric.
15076 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
15077 # or metric.
15078 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
15079 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
15080 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
15081 },
15082 },
15083 ],
15084 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
15085 # This property is optional.
15086 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
15087 },
15088 ],
15089 },
15090 &quot;getVersionOperationMetadata&quot;: {
15091 &quot;inlineSbomInfo&quot;: {
15092 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
15093 # appropriate identifiers.
15094 &quot;a_key&quot;: &quot;A String&quot;,
15095 },
15096 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
15097 # identifiers.
15098 &quot;a_key&quot;: &quot;A String&quot;,
15099 },
15100 },
15101 },
15102 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
15103 # message that was returned, such as `NOT FOUND`.
15104 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
15105 # status code that was returned. For example, a `404` means the
15106 # resource was not found.
15107 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
15108 # defined by the server.
15109 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
15110 # This value is inRFC3339
15111 # text format.
15112 &quot;instancesBulkInsertOperationMetadata&quot;: {
15113 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
15114 # Example key: zones/us-central1-a
15115 &quot;a_key&quot;: {
15116 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
15117 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
15118 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
15119 # error.
15120 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
15121 # if the flow is rolling forward or rolling back.
15122 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
15123 },
15124 },
15125 },
15126 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
15127 # Operation resources.
15128 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
15129 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
15130 # group of operations results from a `bulkInsert` API request.
15131 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
15132 # `update`, or `delete`, and so on.
15133 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
15134 # There is no requirement that this be linear or support any granularity of
15135 # operations. This should not be used to guess when the operation will be
15136 # complete. This number should monotonically increase as the operation
15137 # progresses.
15138 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
15139 # applicable when performing regional operations.
15140 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15141 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
15142 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
15143 # this field will contain information on all underlying zonal actions and
15144 # their state.
15145 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
15146 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
15147 # Example key: zones/us-central1-a
15148 &quot;a_key&quot;: {
15149 &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
15150 # populated.
15151 # different programming environments, including REST APIs and RPC APIs. It is
15152 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
15153 # three pieces of data: error code, error message, and error details.
15154 #
15155 # You can find out more about this error model and how to work with it in the
15156 # [API Design Guide](https://cloud.google.com/apis/design/errors).
15157 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
15158 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
15159 # message types for APIs to use.
15160 {
15161 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
15162 },
15163 ],
15164 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
15165 # user-facing error message should be localized and sent in the
15166 # google.rpc.Status.details field, or localized by the client.
15167 },
15168 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
15169 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
15170 },
15171 },
15172 },
15173 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
15174 # This value is inRFC3339
15175 # text format.
15176 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
15177 # following:
15178 # `PENDING`, `RUNNING`, or `DONE`.
15179 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
15180 # operation.
15181 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
15182 # of the target resource.
15183 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
15184 # operations related to creating a snapshot, this points to the disk
15185 # that the snapshot was created from.
15186 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
15187 # `[email protected]` or
15188 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
15189 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
15190 # operation, this field will be populated.
15191 {
15192 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
15193 # Engine returns NO_RESULTS_ON_PAGE if there
15194 # are no results in the response.
15195 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
15196 # value format. For example:
15197 #
15198 # &quot;data&quot;: [
15199 # {
15200 # &quot;key&quot;: &quot;scope&quot;,
15201 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15202 # }
15203 {
15204 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15205 # returned. For example, for warnings where there are no results in a list
15206 # request for a particular zone, this key might be scope and
15207 # the key value might be the zone name. Other examples might be a key
15208 # indicating a deprecated resource and a suggested replacement, or a
15209 # warning about invalid network settings (for example, if an instance
15210 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15211 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15212 },
15213 ],
15214 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
15215 },
15216 ],
15217 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
15218 # applicable when performing per-zone operations.
15219 }</pre>
15220 </div>
15221
15222 <div class="method">
15223 <code class="details" id="stopInstances">stopInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
15224 <pre>Flags the specified instances in the managed instance group to be
15225 immediately stopped. You can only specify instances that are running in
15226 this request. This method reduces thetargetSize and increases the targetStoppedSize
15227 of the managed instance group by the number of instances that you stop.
15228 The stopInstances operation is marked DONE if
15229 the stopInstances request is successful. The underlying
15230 actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances
15231 method.
15232
15233 If the standbyPolicy.initialDelaySec field is set, the group
15234 delays stopping the instances until initialDelaySec have
15235 passed from instance.creationTimestamp (that is, when the
15236 instance was created). This delay gives your application time to
15237 set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
15238 will be zero delay.
15239
15240 If the group is part of a backend
15241 service that has enabled
15242 connection draining, it can take up to 60 seconds after the connection
15243 draining duration has elapsed before the VM instance is stopped.
15244
15245 Stopped instances can be started using the startInstances
15246 method.
15247
15248 You can specify a maximum of 1000 instances with this method per request.
15249
15250 Args:
15251 project: string, Project ID for this request. (required)
15252 region: string, Name of the region scoping this request. (required)
15253 instanceGroupManager: string, The name of the managed instance group. (required)
15254 body: object, The request body.
15255 The object takes the form of:
15256
15257 {
15258 &quot;forceStop&quot;: True or False, # If this flag is set to true, the Instance Group Manager will proceed to
15259 # stop the instances, skipping initialization on them.
15260 &quot;instances&quot;: [ # The URLs of one or more instances to stop. This can be a full URL or
15261 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
15262 &quot;A String&quot;,
15263 ],
15264 }
15265
15266 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance stopping even if it&#x27;s
15267 configured for the instances.
15268 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
15269 that if you must retry your request, the server will know to ignore the
15270 request if it has already been completed.
15271
15272 For example, consider a situation where you make an initial request and
15273 the request times out. If you make the request again with the same
15274 request ID, the server can check if original operation with the same
15275 request ID was received, and if so, will ignore the second request. This
15276 prevents clients from accidentally creating duplicate commitments.
15277
15278 The request ID must be
15279 a valid UUID with the exception that zero UUID is not supported
15280 (00000000-0000-0000-0000-000000000000).
15281 x__xgafv: string, V1 error format.
15282 Allowed values
15283 1 - v1 error format
15284 2 - v2 error format
15285
15286 Returns:
15287 An object of the form:
15288
15289 { # Represents an Operation resource.
15290 #
15291 # Google Compute Engine has three Operation resources:
15292 #
15293 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
15294 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
15295 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
15296 #
15297 # You can use an operation resource to manage asynchronous API requests.
15298 # For more information, readHandling
15299 # API responses.
15300 #
15301 # Operations can be global, regional or zonal.
15302 #
15303 # - For global operations, use the `globalOperations`
15304 # resource.
15305 # - For regional operations, use the
15306 # `regionOperations` resource.
15307 # - For zonal operations, use
15308 # the `zoneOperations` resource.
15309 #
15310 #
15311 #
15312 # For more information, read
15313 # Global, Regional, and Zonal Resources.
15314 #
15315 # Note that completed Operation resources have a limited
15316 # retention period.
15317 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
15318 # Not present otherwise.
15319 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
15320 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
15321 # set when the operation is created.
15322 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
15323 # text format.
15324 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
15325 # this field will be populated.
15326 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
15327 # operation.
15328 {
15329 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
15330 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
15331 # details. There is a set of defined message types to use for providing
15332 # details.The syntax depends on the error code. For example,
15333 # QuotaExceededInfo will have details when the error code is
15334 # QUOTA_EXCEEDED.
15335 {
15336 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
15337 #
15338 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
15339 # is not enabled:
15340 #
15341 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
15342 # &quot;domain&quot;: &quot;googleapis.com&quot;
15343 # &quot;metadata&quot;: {
15344 # &quot;resource&quot;: &quot;projects/123&quot;,
15345 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
15346 # }
15347 # }
15348 #
15349 # This response indicates that the pubsub.googleapis.com API is not enabled.
15350 #
15351 # Example of an error that is returned when attempting to create a Spanner
15352 # instance in a region that is out of stock:
15353 #
15354 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
15355 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
15356 # &quot;metadata&quot;: {
15357 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
15358 # }
15359 # }
15360 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
15361 # is typically the registered service name of the tool or product that
15362 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
15363 # generated by some common infrastructure, the error domain must be a
15364 # globally unique value that identifies the infrastructure. For Google API
15365 # infrastructure, the error domain is &quot;googleapis.com&quot;.
15366 &quot;metadatas&quot;: { # Additional structured details about this error.
15367 #
15368 # Keys must match a regular expression of `a-z+` but should
15369 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
15370 # length. When identifying the current value of an exceeded limit, the units
15371 # should be contained in the key, not the value. For example, rather than
15372 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
15373 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
15374 # instances that can be created in a single (batch) request.
15375 &quot;a_key&quot;: &quot;A String&quot;,
15376 },
15377 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
15378 # proximate cause of the error. Error reasons are unique within a particular
15379 # domain of errors. This should be at most 63 characters and match a
15380 # regular expression of `A-Z+[A-Z0-9]`, which represents
15381 # UPPER_SNAKE_CASE.
15382 },
15383 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
15384 #
15385 # For example, if a quota check failed with an error indicating the calling
15386 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
15387 # directly to the right place in the developer console to flip the bit.
15388 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
15389 { # Describes a URL link.
15390 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
15391 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
15392 },
15393 ],
15394 },
15395 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
15396 # which can be attached to an RPC error.
15397 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
15398 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
15399 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
15400 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
15401 },
15402 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
15403 &quot;dimensions&quot;: { # The map holding related quota dimensions.
15404 &quot;a_key&quot;: &quot;A String&quot;,
15405 },
15406 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
15407 # type or metric.
15408 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
15409 # or metric.
15410 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
15411 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
15412 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
15413 },
15414 },
15415 ],
15416 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
15417 # This property is optional.
15418 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
15419 },
15420 ],
15421 },
15422 &quot;getVersionOperationMetadata&quot;: {
15423 &quot;inlineSbomInfo&quot;: {
15424 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
15425 # appropriate identifiers.
15426 &quot;a_key&quot;: &quot;A String&quot;,
15427 },
15428 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
15429 # identifiers.
15430 &quot;a_key&quot;: &quot;A String&quot;,
15431 },
15432 },
15433 },
15434 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
15435 # message that was returned, such as `NOT FOUND`.
15436 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
15437 # status code that was returned. For example, a `404` means the
15438 # resource was not found.
15439 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
15440 # defined by the server.
15441 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
15442 # This value is inRFC3339
15443 # text format.
15444 &quot;instancesBulkInsertOperationMetadata&quot;: {
15445 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
15446 # Example key: zones/us-central1-a
15447 &quot;a_key&quot;: {
15448 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
15449 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
15450 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
15451 # error.
15452 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
15453 # if the flow is rolling forward or rolling back.
15454 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
15455 },
15456 },
15457 },
15458 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
15459 # Operation resources.
15460 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
15461 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
15462 # group of operations results from a `bulkInsert` API request.
15463 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
15464 # `update`, or `delete`, and so on.
15465 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
15466 # There is no requirement that this be linear or support any granularity of
15467 # operations. This should not be used to guess when the operation will be
15468 # complete. This number should monotonically increase as the operation
15469 # progresses.
15470 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
15471 # applicable when performing regional operations.
15472 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15473 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
15474 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
15475 # this field will contain information on all underlying zonal actions and
15476 # their state.
15477 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
15478 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
15479 # Example key: zones/us-central1-a
15480 &quot;a_key&quot;: {
15481 &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
15482 # populated.
15483 # different programming environments, including REST APIs and RPC APIs. It is
15484 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
15485 # three pieces of data: error code, error message, and error details.
15486 #
15487 # You can find out more about this error model and how to work with it in the
15488 # [API Design Guide](https://cloud.google.com/apis/design/errors).
15489 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
15490 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
15491 # message types for APIs to use.
15492 {
15493 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
15494 },
15495 ],
15496 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
15497 # user-facing error message should be localized and sent in the
15498 # google.rpc.Status.details field, or localized by the client.
15499 },
15500 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
15501 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
15502 },
15503 },
15504 },
15505 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
15506 # This value is inRFC3339
15507 # text format.
15508 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
15509 # following:
15510 # `PENDING`, `RUNNING`, or `DONE`.
15511 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
15512 # operation.
15513 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
15514 # of the target resource.
15515 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
15516 # operations related to creating a snapshot, this points to the disk
15517 # that the snapshot was created from.
15518 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
15519 # `[email protected]` or
15520 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
15521 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
15522 # operation, this field will be populated.
15523 {
15524 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
15525 # Engine returns NO_RESULTS_ON_PAGE if there
15526 # are no results in the response.
15527 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
15528 # value format. For example:
15529 #
15530 # &quot;data&quot;: [
15531 # {
15532 # &quot;key&quot;: &quot;scope&quot;,
15533 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15534 # }
15535 {
15536 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15537 # returned. For example, for warnings where there are no results in a list
15538 # request for a particular zone, this key might be scope and
15539 # the key value might be the zone name. Other examples might be a key
15540 # indicating a deprecated resource and a suggested replacement, or a
15541 # warning about invalid network settings (for example, if an instance
15542 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15543 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15544 },
15545 ],
15546 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
15547 },
15548 ],
15549 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
15550 # applicable when performing per-zone operations.
15551 }</pre>
15552 </div>
15553
15554 <div class="method">
15555 <code class="details" id="suspendInstances">suspendInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
15556 <pre>Flags the specified instances in the managed instance group to be
15557 immediately suspended. You can only specify instances that are running in
15558 this request. This method reduces thetargetSize and increases the targetSuspendedSize
15559 of the managed instance group by the number of instances that you suspend.
15560 The suspendInstances operation is marked DONE if
15561 the suspendInstances request is successful. The underlying
15562 actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances
15563 method.
15564
15565 If the standbyPolicy.initialDelaySec field is set, the group
15566 delays suspension of the instances until initialDelaySec have
15567 passed from instance.creationTimestamp (that is, when the
15568 instance was created). This delay gives your application time to
15569 set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
15570 will be zero delay.
15571
15572 If the group is part of a backend
15573 service that has enabled
15574 connection draining, it can take up to 60 seconds after the connection
15575 draining duration has elapsed before the VM instance is suspended.
15576
15577 Suspended instances can be resumed using the resumeInstances
15578 method.
15579
15580 You can specify a maximum of 1000 instances with this method per request.
15581
15582 Args:
15583 project: string, Project ID for this request. (required)
15584 region: string, Name of the region scoping this request. (required)
15585 instanceGroupManager: string, Name of the managed instance group. (required)
15586 body: object, The request body.
15587 The object takes the form of:
15588
15589 {
15590 &quot;forceSuspend&quot;: True or False, # If this flag is set to true, the Instance Group Manager will proceed to
15591 # suspend the instances, skipping initialization on them.
15592 &quot;instances&quot;: [ # The URLs of one or more instances to suspend. This can be a full URL or
15593 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
15594 &quot;A String&quot;,
15595 ],
15596 }
15597
15598 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
15599 that if you must retry your request, the server will know to ignore the
15600 request if it has already been completed.
15601
15602 For example, consider a situation where you make an initial request and
15603 the request times out. If you make the request again with the same
15604 request ID, the server can check if original operation with the same
15605 request ID was received, and if so, will ignore the second request. This
15606 prevents clients from accidentally creating duplicate commitments.
15607
15608 The request ID must be
15609 a valid UUID with the exception that zero UUID is not supported
15610 (00000000-0000-0000-0000-000000000000).
15611 x__xgafv: string, V1 error format.
15612 Allowed values
15613 1 - v1 error format
15614 2 - v2 error format
15615
15616 Returns:
15617 An object of the form:
15618
15619 { # Represents an Operation resource.
15620 #
15621 # Google Compute Engine has three Operation resources:
15622 #
15623 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
15624 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
15625 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
15626 #
15627 # You can use an operation resource to manage asynchronous API requests.
15628 # For more information, readHandling
15629 # API responses.
15630 #
15631 # Operations can be global, regional or zonal.
15632 #
15633 # - For global operations, use the `globalOperations`
15634 # resource.
15635 # - For regional operations, use the
15636 # `regionOperations` resource.
15637 # - For zonal operations, use
15638 # the `zoneOperations` resource.
15639 #
15640 #
15641 #
15642 # For more information, read
15643 # Global, Regional, and Zonal Resources.
15644 #
15645 # Note that completed Operation resources have a limited
15646 # retention period.
15647 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
15648 # Not present otherwise.
15649 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
15650 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
15651 # set when the operation is created.
15652 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
15653 # text format.
15654 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
15655 # this field will be populated.
15656 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
15657 # operation.
15658 {
15659 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
15660 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
15661 # details. There is a set of defined message types to use for providing
15662 # details.The syntax depends on the error code. For example,
15663 # QuotaExceededInfo will have details when the error code is
15664 # QUOTA_EXCEEDED.
15665 {
15666 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
15667 #
15668 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
15669 # is not enabled:
15670 #
15671 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
15672 # &quot;domain&quot;: &quot;googleapis.com&quot;
15673 # &quot;metadata&quot;: {
15674 # &quot;resource&quot;: &quot;projects/123&quot;,
15675 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
15676 # }
15677 # }
15678 #
15679 # This response indicates that the pubsub.googleapis.com API is not enabled.
15680 #
15681 # Example of an error that is returned when attempting to create a Spanner
15682 # instance in a region that is out of stock:
15683 #
15684 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
15685 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
15686 # &quot;metadata&quot;: {
15687 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
15688 # }
15689 # }
15690 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
15691 # is typically the registered service name of the tool or product that
15692 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
15693 # generated by some common infrastructure, the error domain must be a
15694 # globally unique value that identifies the infrastructure. For Google API
15695 # infrastructure, the error domain is &quot;googleapis.com&quot;.
15696 &quot;metadatas&quot;: { # Additional structured details about this error.
15697 #
15698 # Keys must match a regular expression of `a-z+` but should
15699 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
15700 # length. When identifying the current value of an exceeded limit, the units
15701 # should be contained in the key, not the value. For example, rather than
15702 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
15703 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
15704 # instances that can be created in a single (batch) request.
15705 &quot;a_key&quot;: &quot;A String&quot;,
15706 },
15707 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
15708 # proximate cause of the error. Error reasons are unique within a particular
15709 # domain of errors. This should be at most 63 characters and match a
15710 # regular expression of `A-Z+[A-Z0-9]`, which represents
15711 # UPPER_SNAKE_CASE.
15712 },
15713 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
15714 #
15715 # For example, if a quota check failed with an error indicating the calling
15716 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
15717 # directly to the right place in the developer console to flip the bit.
15718 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
15719 { # Describes a URL link.
15720 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
15721 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
15722 },
15723 ],
15724 },
15725 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
15726 # which can be attached to an RPC error.
15727 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
15728 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
15729 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
15730 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
15731 },
15732 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
15733 &quot;dimensions&quot;: { # The map holding related quota dimensions.
15734 &quot;a_key&quot;: &quot;A String&quot;,
15735 },
15736 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
15737 # type or metric.
15738 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
15739 # or metric.
15740 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
15741 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
15742 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
15743 },
15744 },
15745 ],
15746 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
15747 # This property is optional.
15748 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
15749 },
15750 ],
15751 },
15752 &quot;getVersionOperationMetadata&quot;: {
15753 &quot;inlineSbomInfo&quot;: {
15754 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
15755 # appropriate identifiers.
15756 &quot;a_key&quot;: &quot;A String&quot;,
15757 },
15758 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
15759 # identifiers.
15760 &quot;a_key&quot;: &quot;A String&quot;,
15761 },
15762 },
15763 },
15764 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
15765 # message that was returned, such as `NOT FOUND`.
15766 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
15767 # status code that was returned. For example, a `404` means the
15768 # resource was not found.
15769 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
15770 # defined by the server.
15771 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
15772 # This value is inRFC3339
15773 # text format.
15774 &quot;instancesBulkInsertOperationMetadata&quot;: {
15775 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
15776 # Example key: zones/us-central1-a
15777 &quot;a_key&quot;: {
15778 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
15779 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
15780 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
15781 # error.
15782 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
15783 # if the flow is rolling forward or rolling back.
15784 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
15785 },
15786 },
15787 },
15788 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
15789 # Operation resources.
15790 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
15791 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
15792 # group of operations results from a `bulkInsert` API request.
15793 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
15794 # `update`, or `delete`, and so on.
15795 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
15796 # There is no requirement that this be linear or support any granularity of
15797 # operations. This should not be used to guess when the operation will be
15798 # complete. This number should monotonically increase as the operation
15799 # progresses.
15800 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
15801 # applicable when performing regional operations.
15802 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
15803 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
15804 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
15805 # this field will contain information on all underlying zonal actions and
15806 # their state.
15807 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
15808 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
15809 # Example key: zones/us-central1-a
15810 &quot;a_key&quot;: {
15811 &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
15812 # populated.
15813 # different programming environments, including REST APIs and RPC APIs. It is
15814 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
15815 # three pieces of data: error code, error message, and error details.
15816 #
15817 # You can find out more about this error model and how to work with it in the
15818 # [API Design Guide](https://cloud.google.com/apis/design/errors).
15819 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
15820 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
15821 # message types for APIs to use.
15822 {
15823 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
15824 },
15825 ],
15826 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
15827 # user-facing error message should be localized and sent in the
15828 # google.rpc.Status.details field, or localized by the client.
15829 },
15830 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
15831 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
15832 },
15833 },
15834 },
15835 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
15836 # This value is inRFC3339
15837 # text format.
15838 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
15839 # following:
15840 # `PENDING`, `RUNNING`, or `DONE`.
15841 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
15842 # operation.
15843 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
15844 # of the target resource.
15845 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
15846 # operations related to creating a snapshot, this points to the disk
15847 # that the snapshot was created from.
15848 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
15849 # `[email protected]` or
15850 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
15851 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
15852 # operation, this field will be populated.
15853 {
15854 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
15855 # Engine returns NO_RESULTS_ON_PAGE if there
15856 # are no results in the response.
15857 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
15858 # value format. For example:
15859 #
15860 # &quot;data&quot;: [
15861 # {
15862 # &quot;key&quot;: &quot;scope&quot;,
15863 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15864 # }
15865 {
15866 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15867 # returned. For example, for warnings where there are no results in a list
15868 # request for a particular zone, this key might be scope and
15869 # the key value might be the zone name. Other examples might be a key
15870 # indicating a deprecated resource and a suggested replacement, or a
15871 # warning about invalid network settings (for example, if an instance
15872 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15873 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15874 },
15875 ],
15876 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
15877 },
15878 ],
15879 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
15880 # applicable when performing per-zone operations.
15881 }</pre>
15882 </div>
15883
15884 <div class="method">
15885 <code class="details" id="testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</code>
15886 <pre>Returns permissions that a caller has on the specified resource.
15887
15888 Args:
15889 project: string, Project ID for this request. (required)
15890 region: string, The name of the region for this request. (required)
15891 resource: string, Name or id of the resource for this request. (required)
15892 body: object, The request body.
15893 The object takes the form of:
15894
15895 {
15896 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
15897 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
15898 &quot;A String&quot;,
15899 ],
15900 }
15901
15902 x__xgafv: string, V1 error format.
15903 Allowed values
15904 1 - v1 error format
15905 2 - v2 error format
15906
15907 Returns:
15908 An object of the form:
15909
15910 {
15911 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
15912 # allowed.
15913 &quot;A String&quot;,
15914 ],
15915 }</pre>
15916 </div>
15917
15918 <div class="method">
15919 <code class="details" id="update">update(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
15920 <pre>Updates a managed instance group using the information that you specify
15921 in the request.
15922 This operation is marked as DONE when the group is updated
15923 even if the instances in the group have not yet been updated. You must
15924 separately verify the status of the individual instances with thelistmanagedinstances
15925 method.
15926
15927 If you update your group to specify a new template or instance
15928 configuration, it&#x27;s possible that your intended specification for each VM
15929 in the group is different from the current state of that VM. To learn how
15930 to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
15931 a MIG.
15932
15933 Args:
15934 project: string, Project ID for this request. (required)
15935 region: string, Name of the region scoping this request. (required)
15936 instanceGroupManager: string, The name of the instance group manager. (required)
15937 body: object, The request body.
15938 The object takes the form of:
15939
15940 { # Represents a Managed Instance Group resource.
15941 #
15942 # An instance group is a collection of VM instances that you can manage as a
15943 # single entity. For more information, readInstance groups.
15944 #
15945 # For zonal Managed Instance Group, use the instanceGroupManagers
15946 # resource.
15947 #
15948 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
15949 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
15950 # for the group.
15951 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
15952 #
15953 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
15954 # instances to apply the configuration. To apply the configuration, set the
15955 # group&#x27;s updatePolicy.type field to use proactive updates or
15956 # use the applyUpdatesToInstances method.
15957 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
15958 &quot;a_key&quot;: &quot;A String&quot;,
15959 },
15960 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
15961 # more information, see Project and
15962 # instance metadata.
15963 &quot;a_key&quot;: &quot;A String&quot;,
15964 },
15965 },
15966 },
15967 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
15968 # only one value.
15969 {
15970 &quot;autoHealingTriggers&quot;: { # Restricts what triggers autohealing.
15971 &quot;onHealthCheck&quot;: &quot;A String&quot;, # If you have configured an application-based health check for the group,
15972 # this field controls whether to trigger VM autohealing based on a failed
15973 # health check. Valid values are:
15974 #
15975 # - ON (default): The group recreates running VMs that
15976 # fail the application-based health check.
15977 # - OFF: When set to OFF, you can still observe instance
15978 # health state, but the group does not recreate VMs that fail the
15979 # application-based health check. This is useful for troubleshooting and
15980 # setting up your health check configuration.
15981 },
15982 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
15983 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
15984 # initialize and run its startup script. During a VM&#x27;s initial delay
15985 # period, the MIG ignores unsuccessful health checks because the VM might
15986 # be in the startup process. This prevents the MIG from prematurely
15987 # recreating a VM. If the health check receives a healthy response during
15988 # the initial delay, it indicates that the startup process is complete and
15989 # the VM is ready. The value of initial delay must be between 0 and 3600
15990 # seconds. The default value is 0.
15991 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Maximum number of instances that can be unavailable when autohealing.
15992 # When &#x27;percent&#x27; is used, the value is rounded if necessary.
15993 # The instance is considered available if all of the following conditions
15994 # are satisfied:
15995 # 1. Instance&#x27;s status is RUNNING.
15996 # 2. Instance&#x27;s currentAction is NONE (in particular its liveness health
15997 # check result was observed to be HEALTHY at least once as it passed
15998 # VERIFYING).
15999 # 3. There is no outgoing action on an instance triggered by IGM.
16000 #
16001 # By default, number of concurrently autohealed instances is smaller than
16002 # the managed instance group target size. However, if a zonal managed
16003 # instance group has only one instance, or a regional managed instance
16004 # group has only one instance per zone, autohealing will recreate these
16005 # instances when they become unhealthy.
16006 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
16007 #
16008 #
16009 #
16010 # - If the value is fixed, then the calculated
16011 # value is equal to the fixed value.
16012 # - If the value is a percent, then the
16013 # calculated
16014 # value is percent/100 * targetSize. For example,
16015 # the calculated value of a 80% of a managed instance group
16016 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
16017 # is a remainder, the number is rounded.
16018 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
16019 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
16020 # example, specify 80 for 80%.
16021 },
16022 },
16023 ],
16024 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
16025 # all VMs in a MIG. The maximum character length is 58 and the name must
16026 # comply with RFC1035 format.
16027 #
16028 # When a VM is created in the group, the MIG appends a hyphen and a random
16029 # four-character string to the base instance name. If you want the MIG to
16030 # assign sequential numbers instead of a random string, then end the base
16031 # instance name with a hyphen followed by one or more hash symbols. The hash
16032 # symbols indicate the number of digits. For example, a base instance name of
16033 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
16034 # @pattern
16035 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
16036 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
16037 # text format.
16038 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
16039 # in this managed instance group that are scheduled for each of those
16040 # actions.
16041 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
16042 # that are scheduled to be abandoned. Abandoning an instance removes it
16043 # from the managed instance group without deleting it.
16044 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
16045 # are scheduled to be adopted or are currently being adopted.
16046 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
16047 # are scheduled to be created or are currently being created. If the group
16048 # fails to create any of these instances, it tries again until it creates
16049 # the instance successfully.
16050 #
16051 # If you have disabled creation retries, this field will not be populated;
16052 # instead, the creatingWithoutRetries field will be populated.
16053 &quot;creatingAtomically&quot;: 42, # Output only. The number of instances that the managed instance group
16054 # will attempt to create atomically, in a batch mode. If the desired count
16055 # of instances can not be created, entire batch will be deleted and the
16056 # group will decrease its targetSize value accordingly.
16057 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
16058 # will attempt to create. The group attempts to create each instance
16059 # only once. If the group fails to create any of these instances, it
16060 # decreases the group&#x27;s targetSize value accordingly.
16061 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
16062 # are scheduled to be deleted or are currently being deleted.
16063 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
16064 # are running and have no scheduled actions.
16065 &quot;queuing&quot;: 42, # Output only. The number of instances that the managed instance group
16066 # is currently queuing.
16067 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
16068 # are scheduled to be recreated or are currently being being recreated.
16069 # Recreating an instance deletes the existing root persistent disk
16070 # and creates a new disk from the image that is defined in the
16071 # instance template.
16072 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
16073 # are being reconfigured with properties that do not require a restart
16074 # or a recreate action. For example, setting or removing target
16075 # pools for the instance.
16076 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
16077 # are scheduled to be restarted or are currently being restarted.
16078 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
16079 # are scheduled to be restarted or are currently being restarted.
16080 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
16081 # are scheduled to be resumed or are currently being resumed.
16082 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
16083 # are scheduled to be started or are currently being started.
16084 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
16085 # are scheduled to be stopped or are currently being stopped.
16086 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
16087 # are scheduled to be suspended or are currently being suspended.
16088 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
16089 # are being verified. See the managedInstances[].currentAction
16090 # property in the listManagedInstances method documentation.
16091 },
16092 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
16093 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
16094 # zones in a regional managed instance group.
16095 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
16096 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
16097 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
16098 # its instances.
16099 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
16100 # instances, even if an AI zone is available in the specified region. To
16101 # create instances in an AI zone in the selected region, you must explicitly
16102 # specify it in the distribution policy together with the other preferred
16103 # zones.
16104 {
16105 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
16106 # The zone must exist in the region where the managed instance group is
16107 # located.
16108 },
16109 ],
16110 },
16111 &quot;failoverAction&quot;: &quot;A String&quot;, # The action to perform in case of zone failure. Only one value is supported,NO_FAILOVER. The default is NO_FAILOVER.
16112 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
16113 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
16114 # fingerprint must be provided in order to update the InstanceGroupManager,
16115 # otherwise the request will fail with error412 conditionNotMet.
16116 #
16117 # To see the latest fingerprint, make a get() request to
16118 # retrieve an InstanceGroupManager.
16119 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
16120 # generates this identifier.
16121 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
16122 # types of machines.
16123 # Instance flexibility configuration on MIG overrides instance
16124 # template configuration.
16125 &quot;instanceSelectionLists&quot;: { # Named instance selections configuring properties that the group will use
16126 # when creating new VMs.
16127 &quot;a_key&quot;: {
16128 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
16129 # selection.
16130 { # An instance-attached disk resource.
16131 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
16132 # or X86_64.
16133 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
16134 # deleted (but not when the disk is detached from the instance).
16135 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
16136 # partition of the disk for its root filesystem.
16137 &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
16138 # running within the instance. This name can be used to reference the device
16139 # for mounting, resizing, and so on, from within the instance.
16140 #
16141 # If not specified, the server chooses a default device name to apply to this
16142 # disk, in the form persistent-disk-x, where x is a number
16143 # assigned by Google Compute Engine. This field is only applicable for
16144 # persistent disks.
16145 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
16146 # encryption key.
16147 #
16148 # If you are creating a new disk, this field encrypts the new disk using
16149 # an encryption key that you provide. If you are attaching an existing
16150 # disk that is already encrypted, this field decrypts the disk using
16151 # the customer-supplied encryption key.
16152 #
16153 # If you encrypt a disk using a customer-supplied key, you must provide the
16154 # same key again when you attempt to use this resource at a later time. For
16155 # example, you must provide the key when you create a snapshot or an image
16156 # from the disk or when you attach the disk to a virtual machine instance.
16157 #
16158 # If you do not provide an encryption key, then the disk will be encrypted
16159 # using an automatically generated key and you do not need to provide a key
16160 # to use the disk later.
16161 #
16162 # Note:
16163 #
16164 # Instance templates do not storecustomer-supplied
16165 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
16166 #
16167 # You cannot create VMs that have disks with customer-supplied keys using
16168 # the bulk
16169 # insert method.
16170 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
16171 # For example:
16172 #
16173 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16174 # key_region/cryptoKeys/key
16175 #
16176 # The fully-qualifed key name may be returned for resource GET requests. For
16177 # example:
16178 #
16179 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16180 # key_region/cryptoKeys/key
16181 # /cryptoKeyVersions/1
16182 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
16183 # key. If absent, the Compute Engine default service account is used.
16184 # For example:
16185 #
16186 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
16187 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
16188 # encryption key, encoded in RFC
16189 # 4648 base64 to either encrypt or decrypt this resource. You can
16190 # provide either the rawKey or thersaEncryptedKey.
16191 # For example:
16192 #
16193 # &quot;rawKey&quot;:
16194 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
16195 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
16196 # customer-supplied encryption key to either encrypt or decrypt this
16197 # resource. You can provide either the rawKey or thersaEncryptedKey.
16198 # For example:
16199 #
16200 # &quot;rsaEncryptedKey&quot;:
16201 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
16202 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
16203 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
16204 #
16205 # The key must meet the following requirements before you can provide it to
16206 # Compute Engine:
16207 #
16208 # 1. The key is wrapped using a RSA public key certificate provided by
16209 # Google.
16210 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
16211 # encoding.
16212 #
16213 # Gets the RSA public key certificate provided by Google at:
16214 #
16215 #
16216 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
16217 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
16218 # 4648 base64 encoded SHA-256 hash of the customer-supplied
16219 # encryption key that protects this resource.
16220 },
16221 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
16222 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
16223 # currently attached to another instance. If you try to force attach a zonal
16224 # disk to an instance, you will receive an error.
16225 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
16226 # only for bootable images. Read
16227 # Enabling guest operating system features to see a list of available
16228 # options.
16229 { # Guest OS features.
16230 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
16231 # separate values. Set to one or more of the following values:
16232 #
16233 # - VIRTIO_SCSI_MULTIQUEUE
16234 # - WINDOWS
16235 # - MULTI_IP_SUBNET
16236 # - UEFI_COMPATIBLE
16237 # - GVNIC
16238 # - SEV_CAPABLE
16239 # - SUSPEND_RESUME_COMPATIBLE
16240 # - SEV_LIVE_MIGRATABLE_V2
16241 # - SEV_SNP_CAPABLE
16242 # - TDX_CAPABLE
16243 # - IDPF
16244 # - SNP_SVSM_CAPABLE
16245 # - CCA_CAPABLE
16246 #
16247 #
16248 # For more information, see
16249 # Enabling guest operating system features.
16250 },
16251 ],
16252 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
16253 # boot disk. If you have many disks attached to an instance, each
16254 # disk would have a unique index number.
16255 &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
16256 # alongside the new instance. Use initialization parameters to create boot
16257 # disks or local SSDs attached to the new instance.
16258 #
16259 # This property is mutually exclusive with the source property;
16260 # you can only define one or the other, but not both.
16261 # alongside the new instance. Use initialization parameters to create boot
16262 # disks or local SSDs attached to the new instance.
16263 #
16264 # This field is persisted and returned for instanceTemplate and not returned
16265 # in the context of instance.
16266 #
16267 # This property is mutually exclusive with the source property;
16268 # you can only define one or the other, but not both.
16269 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
16270 # arm64 or x86_64.
16271 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
16272 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
16273 # of the instance. If a disk with the same name already exists in the given
16274 # region, the existing disk is attached to the new instance and the
16275 # new disk is not created.
16276 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
16277 # 10 GB. If you specify a sourceImage, which is required for
16278 # boot disks, the default size is the size of the sourceImage.
16279 # If you do not specify a sourceImage, the default disk size
16280 # is 500 GB.
16281 &quot;diskType&quot;: &quot;A String&quot;,
16282 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
16283 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
16284 # only for bootable images. Read
16285 # Enabling guest operating system features to see a list of available
16286 # options.
16287 #
16288 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
16289 { # Guest OS features.
16290 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
16291 # separate values. Set to one or more of the following values:
16292 #
16293 # - VIRTIO_SCSI_MULTIQUEUE
16294 # - WINDOWS
16295 # - MULTI_IP_SUBNET
16296 # - UEFI_COMPATIBLE
16297 # - GVNIC
16298 # - SEV_CAPABLE
16299 # - SUSPEND_RESUME_COMPATIBLE
16300 # - SEV_LIVE_MIGRATABLE_V2
16301 # - SEV_SNP_CAPABLE
16302 # - TDX_CAPABLE
16303 # - IDPF
16304 # - SNP_SVSM_CAPABLE
16305 # - CCA_CAPABLE
16306 #
16307 #
16308 # For more information, see
16309 # Enabling guest operating system features.
16310 },
16311 ],
16312 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
16313 # which is either SCSI or NVME. The default isSCSI.
16314 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
16315 # persistent disks.
16316 &quot;a_key&quot;: &quot;A String&quot;,
16317 },
16318 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
16319 # disk.
16320 &quot;A String&quot;,
16321 ],
16322 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
16323 &quot;A String&quot;,
16324 ],
16325 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
16326 # more than one instance.
16327 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
16328 # is to use the existing disk.
16329 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
16330 # of I/O operations per second that the disk can handle. Values must be
16331 # between 10,000 and 120,000. For more details, see theExtreme persistent
16332 # disk documentation.
16333 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
16334 # number of throughput mb per second that the disk can handle. Values must
16335 # greater than or equal to 1.
16336 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
16337 # the URLs of the zones where the disk should be replicated to.
16338 # You must provide exactly two replica zones, and one zone must be the same
16339 # as the instance zone.
16340 &quot;A String&quot;,
16341 ],
16342 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
16343 # have the same definition as resource
16344 # manager tags. Keys and values can be either in numeric format,
16345 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
16346 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
16347 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
16348 # empty.
16349 &quot;a_key&quot;: &quot;A String&quot;,
16350 },
16351 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
16352 # Specified using the full or partial URL. For instance template, specify
16353 # only the resource policy name.
16354 &quot;A String&quot;,
16355 ],
16356 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
16357 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
16358 # is required.
16359 #
16360 # To create a disk with one of the public operating system
16361 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
16362 #
16363 # projects/debian-cloud/global/images/family/debian-9
16364 #
16365 #
16366 # Alternatively, use a specific version of a public operating system image:
16367 #
16368 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
16369 #
16370 #
16371 # To create a disk with a custom image that you created, specify the
16372 # image name in the following format:
16373 #
16374 # global/images/my-custom-image
16375 #
16376 #
16377 # You can also specify a custom image by its image family, which returns
16378 # the latest version of the image in that family. Replace the image name
16379 # with family/family-name:
16380 #
16381 # global/images/family/my-image-family
16382 #
16383 #
16384 # If the source image is deleted later, this field will not be set.
16385 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
16386 # encryption key of the source image. Required if the source image is
16387 # protected by a customer-supplied encryption key.
16388 #
16389 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
16390 # encryption keys, so you cannot create disks for instances in a managed instance group if the
16391 # source images are encrypted with your own keys.
16392 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
16393 # For example:
16394 #
16395 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16396 # key_region/cryptoKeys/key
16397 #
16398 # The fully-qualifed key name may be returned for resource GET requests. For
16399 # example:
16400 #
16401 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16402 # key_region/cryptoKeys/key
16403 # /cryptoKeyVersions/1
16404 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
16405 # key. If absent, the Compute Engine default service account is used.
16406 # For example:
16407 #
16408 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
16409 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
16410 # encryption key, encoded in RFC
16411 # 4648 base64 to either encrypt or decrypt this resource. You can
16412 # provide either the rawKey or thersaEncryptedKey.
16413 # For example:
16414 #
16415 # &quot;rawKey&quot;:
16416 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
16417 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
16418 # customer-supplied encryption key to either encrypt or decrypt this
16419 # resource. You can provide either the rawKey or thersaEncryptedKey.
16420 # For example:
16421 #
16422 # &quot;rsaEncryptedKey&quot;:
16423 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
16424 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
16425 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
16426 #
16427 # The key must meet the following requirements before you can provide it to
16428 # Compute Engine:
16429 #
16430 # 1. The key is wrapped using a RSA public key certificate provided by
16431 # Google.
16432 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
16433 # encoding.
16434 #
16435 # Gets the RSA public key certificate provided by Google at:
16436 #
16437 #
16438 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
16439 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
16440 # 4648 base64 encoded SHA-256 hash of the customer-supplied
16441 # encryption key that protects this resource.
16442 },
16443 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
16444 # instance boot disk, one of initializeParams.sourceSnapshot
16445 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
16446 # is required.
16447 #
16448 # To create a disk with a snapshot that you created, specify the
16449 # snapshot name in the following format:
16450 #
16451 # us-central1-a/instantSnapshots/my-backup
16452 #
16453 #
16454 # If the source instant-snapshot is deleted later, this field will not be
16455 # set.
16456 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
16457 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
16458 # is required.
16459 #
16460 # To create a disk with a snapshot that you created, specify the
16461 # snapshot name in the following format:
16462 #
16463 # global/snapshots/my-backup
16464 #
16465 #
16466 # If the source snapshot is deleted later, this field will not be set.
16467 #
16468 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
16469 # an image instead when you create VMs using
16470 # the bulk
16471 # insert method.
16472 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
16473 # encryption key of the source snapshot.
16474 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
16475 # For example:
16476 #
16477 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16478 # key_region/cryptoKeys/key
16479 #
16480 # The fully-qualifed key name may be returned for resource GET requests. For
16481 # example:
16482 #
16483 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16484 # key_region/cryptoKeys/key
16485 # /cryptoKeyVersions/1
16486 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
16487 # key. If absent, the Compute Engine default service account is used.
16488 # For example:
16489 #
16490 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
16491 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
16492 # encryption key, encoded in RFC
16493 # 4648 base64 to either encrypt or decrypt this resource. You can
16494 # provide either the rawKey or thersaEncryptedKey.
16495 # For example:
16496 #
16497 # &quot;rawKey&quot;:
16498 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
16499 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
16500 # customer-supplied encryption key to either encrypt or decrypt this
16501 # resource. You can provide either the rawKey or thersaEncryptedKey.
16502 # For example:
16503 #
16504 # &quot;rsaEncryptedKey&quot;:
16505 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
16506 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
16507 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
16508 #
16509 # The key must meet the following requirements before you can provide it to
16510 # Compute Engine:
16511 #
16512 # 1. The key is wrapped using a RSA public key certificate provided by
16513 # Google.
16514 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
16515 # encoding.
16516 #
16517 # Gets the RSA public key certificate provided by Google at:
16518 #
16519 #
16520 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
16521 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
16522 # 4648 base64 encoded SHA-256 hash of the customer-supplied
16523 # encryption key that protects this resource.
16524 },
16525 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
16526 # this as a partial or full URL to the resource. For example, the following
16527 # are valid values:
16528 #
16529 #
16530 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
16531 # - projects/project/zones/zone/storagePools/storagePool
16532 # - zones/zone/storagePools/storagePool
16533 },
16534 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
16535 # either SCSI or NVME. For most machine types, the
16536 # default is SCSI. Local SSDs can use either NVME or SCSI.
16537 # In certain configurations, persistent disks can use NVMe. For more
16538 # information, seeAbout
16539 # persistent disks.
16540 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
16541 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
16542 &quot;A String&quot;,
16543 ],
16544 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
16545 # disk is not allowed to be detached from the instance, or to be used as the
16546 # source of the snapshot creation, and the image creation. The instance with
16547 # at least one locked attached disk is not allow to be used as source of
16548 # machine image creation, instant snapshot creation, and not allowed to be
16549 # deleted with --keep-disk parameter set to true for locked disks.
16550 &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
16551 # in READ_WRITE mode.
16552 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
16553 # field is set to PRESERVED if the LocalSSD data has been saved
16554 # to a persistent location by customer request. (see the
16555 # discard_local_ssd option on Stop/Suspend).
16556 # Read-only in the api.
16557 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
16558 # these are public keys which are safe to store in public
16559 &quot;dbs&quot;: [ # The Key Database (db).
16560 {
16561 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
16562 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
16563 },
16564 ],
16565 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
16566 {
16567 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
16568 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
16569 },
16570 ],
16571 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
16572 {
16573 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
16574 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
16575 },
16576 ],
16577 &quot;pk&quot;: { # The Platform Key (PK).
16578 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
16579 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
16580 },
16581 },
16582 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
16583 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
16584 # is required.
16585 #
16586 # If desired, you can also attach existing non-root persistent disks using
16587 # this property. This field is only applicable for persistent disks.
16588 #
16589 # Note that for InstanceTemplate, specify the disk name for zonal disk,
16590 # and the URL for regional disk.
16591 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
16592 },
16593 ],
16594 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
16595 &quot;A String&quot;,
16596 ],
16597 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
16598 # e.g. &#x27;Intel Ice Lake&#x27;.
16599 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
16600 # preference. MIG will first try to create a VM based on the machine-type
16601 # with lowest rank and fallback to next rank based on availability.
16602 # Machine types and instance selections with the same rank have the same
16603 # preference.
16604 },
16605 },
16606 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
16607 # when creating new VMs.
16608 &quot;a_key&quot;: {
16609 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
16610 # selection.
16611 { # An instance-attached disk resource.
16612 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
16613 # or X86_64.
16614 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
16615 # deleted (but not when the disk is detached from the instance).
16616 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
16617 # partition of the disk for its root filesystem.
16618 &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
16619 # running within the instance. This name can be used to reference the device
16620 # for mounting, resizing, and so on, from within the instance.
16621 #
16622 # If not specified, the server chooses a default device name to apply to this
16623 # disk, in the form persistent-disk-x, where x is a number
16624 # assigned by Google Compute Engine. This field is only applicable for
16625 # persistent disks.
16626 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
16627 # encryption key.
16628 #
16629 # If you are creating a new disk, this field encrypts the new disk using
16630 # an encryption key that you provide. If you are attaching an existing
16631 # disk that is already encrypted, this field decrypts the disk using
16632 # the customer-supplied encryption key.
16633 #
16634 # If you encrypt a disk using a customer-supplied key, you must provide the
16635 # same key again when you attempt to use this resource at a later time. For
16636 # example, you must provide the key when you create a snapshot or an image
16637 # from the disk or when you attach the disk to a virtual machine instance.
16638 #
16639 # If you do not provide an encryption key, then the disk will be encrypted
16640 # using an automatically generated key and you do not need to provide a key
16641 # to use the disk later.
16642 #
16643 # Note:
16644 #
16645 # Instance templates do not storecustomer-supplied
16646 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
16647 #
16648 # You cannot create VMs that have disks with customer-supplied keys using
16649 # the bulk
16650 # insert method.
16651 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
16652 # For example:
16653 #
16654 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16655 # key_region/cryptoKeys/key
16656 #
16657 # The fully-qualifed key name may be returned for resource GET requests. For
16658 # example:
16659 #
16660 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16661 # key_region/cryptoKeys/key
16662 # /cryptoKeyVersions/1
16663 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
16664 # key. If absent, the Compute Engine default service account is used.
16665 # For example:
16666 #
16667 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
16668 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
16669 # encryption key, encoded in RFC
16670 # 4648 base64 to either encrypt or decrypt this resource. You can
16671 # provide either the rawKey or thersaEncryptedKey.
16672 # For example:
16673 #
16674 # &quot;rawKey&quot;:
16675 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
16676 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
16677 # customer-supplied encryption key to either encrypt or decrypt this
16678 # resource. You can provide either the rawKey or thersaEncryptedKey.
16679 # For example:
16680 #
16681 # &quot;rsaEncryptedKey&quot;:
16682 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
16683 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
16684 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
16685 #
16686 # The key must meet the following requirements before you can provide it to
16687 # Compute Engine:
16688 #
16689 # 1. The key is wrapped using a RSA public key certificate provided by
16690 # Google.
16691 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
16692 # encoding.
16693 #
16694 # Gets the RSA public key certificate provided by Google at:
16695 #
16696 #
16697 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
16698 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
16699 # 4648 base64 encoded SHA-256 hash of the customer-supplied
16700 # encryption key that protects this resource.
16701 },
16702 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
16703 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
16704 # currently attached to another instance. If you try to force attach a zonal
16705 # disk to an instance, you will receive an error.
16706 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
16707 # only for bootable images. Read
16708 # Enabling guest operating system features to see a list of available
16709 # options.
16710 { # Guest OS features.
16711 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
16712 # separate values. Set to one or more of the following values:
16713 #
16714 # - VIRTIO_SCSI_MULTIQUEUE
16715 # - WINDOWS
16716 # - MULTI_IP_SUBNET
16717 # - UEFI_COMPATIBLE
16718 # - GVNIC
16719 # - SEV_CAPABLE
16720 # - SUSPEND_RESUME_COMPATIBLE
16721 # - SEV_LIVE_MIGRATABLE_V2
16722 # - SEV_SNP_CAPABLE
16723 # - TDX_CAPABLE
16724 # - IDPF
16725 # - SNP_SVSM_CAPABLE
16726 # - CCA_CAPABLE
16727 #
16728 #
16729 # For more information, see
16730 # Enabling guest operating system features.
16731 },
16732 ],
16733 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
16734 # boot disk. If you have many disks attached to an instance, each
16735 # disk would have a unique index number.
16736 &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
16737 # alongside the new instance. Use initialization parameters to create boot
16738 # disks or local SSDs attached to the new instance.
16739 #
16740 # This property is mutually exclusive with the source property;
16741 # you can only define one or the other, but not both.
16742 # alongside the new instance. Use initialization parameters to create boot
16743 # disks or local SSDs attached to the new instance.
16744 #
16745 # This field is persisted and returned for instanceTemplate and not returned
16746 # in the context of instance.
16747 #
16748 # This property is mutually exclusive with the source property;
16749 # you can only define one or the other, but not both.
16750 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
16751 # arm64 or x86_64.
16752 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
16753 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
16754 # of the instance. If a disk with the same name already exists in the given
16755 # region, the existing disk is attached to the new instance and the
16756 # new disk is not created.
16757 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
16758 # 10 GB. If you specify a sourceImage, which is required for
16759 # boot disks, the default size is the size of the sourceImage.
16760 # If you do not specify a sourceImage, the default disk size
16761 # is 500 GB.
16762 &quot;diskType&quot;: &quot;A String&quot;,
16763 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
16764 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
16765 # only for bootable images. Read
16766 # Enabling guest operating system features to see a list of available
16767 # options.
16768 #
16769 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
16770 { # Guest OS features.
16771 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
16772 # separate values. Set to one or more of the following values:
16773 #
16774 # - VIRTIO_SCSI_MULTIQUEUE
16775 # - WINDOWS
16776 # - MULTI_IP_SUBNET
16777 # - UEFI_COMPATIBLE
16778 # - GVNIC
16779 # - SEV_CAPABLE
16780 # - SUSPEND_RESUME_COMPATIBLE
16781 # - SEV_LIVE_MIGRATABLE_V2
16782 # - SEV_SNP_CAPABLE
16783 # - TDX_CAPABLE
16784 # - IDPF
16785 # - SNP_SVSM_CAPABLE
16786 # - CCA_CAPABLE
16787 #
16788 #
16789 # For more information, see
16790 # Enabling guest operating system features.
16791 },
16792 ],
16793 &quot;interface&quot;: &quot;A String&quot;, # [Deprecated] Specifies the disk interface to use for attaching this disk,
16794 # which is either SCSI or NVME. The default isSCSI.
16795 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
16796 # persistent disks.
16797 &quot;a_key&quot;: &quot;A String&quot;,
16798 },
16799 &quot;licenseCodes&quot;: [ # Integer license codes indicating which licenses are attached to this
16800 # disk.
16801 &quot;A String&quot;,
16802 ],
16803 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
16804 &quot;A String&quot;,
16805 ],
16806 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
16807 # more than one instance.
16808 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
16809 # is to use the existing disk.
16810 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
16811 # of I/O operations per second that the disk can handle. Values must be
16812 # between 10,000 and 120,000. For more details, see theExtreme persistent
16813 # disk documentation.
16814 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
16815 # number of throughput mb per second that the disk can handle. Values must
16816 # greater than or equal to 1.
16817 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
16818 # the URLs of the zones where the disk should be replicated to.
16819 # You must provide exactly two replica zones, and one zone must be the same
16820 # as the instance zone.
16821 &quot;A String&quot;,
16822 ],
16823 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
16824 # have the same definition as resource
16825 # manager tags. Keys and values can be either in numeric format,
16826 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
16827 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
16828 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
16829 # empty.
16830 &quot;a_key&quot;: &quot;A String&quot;,
16831 },
16832 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
16833 # Specified using the full or partial URL. For instance template, specify
16834 # only the resource policy name.
16835 &quot;A String&quot;,
16836 ],
16837 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
16838 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
16839 # is required.
16840 #
16841 # To create a disk with one of the public operating system
16842 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
16843 #
16844 # projects/debian-cloud/global/images/family/debian-9
16845 #
16846 #
16847 # Alternatively, use a specific version of a public operating system image:
16848 #
16849 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
16850 #
16851 #
16852 # To create a disk with a custom image that you created, specify the
16853 # image name in the following format:
16854 #
16855 # global/images/my-custom-image
16856 #
16857 #
16858 # You can also specify a custom image by its image family, which returns
16859 # the latest version of the image in that family. Replace the image name
16860 # with family/family-name:
16861 #
16862 # global/images/family/my-image-family
16863 #
16864 #
16865 # If the source image is deleted later, this field will not be set.
16866 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
16867 # encryption key of the source image. Required if the source image is
16868 # protected by a customer-supplied encryption key.
16869 #
16870 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
16871 # encryption keys, so you cannot create disks for instances in a managed instance group if the
16872 # source images are encrypted with your own keys.
16873 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
16874 # For example:
16875 #
16876 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16877 # key_region/cryptoKeys/key
16878 #
16879 # The fully-qualifed key name may be returned for resource GET requests. For
16880 # example:
16881 #
16882 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16883 # key_region/cryptoKeys/key
16884 # /cryptoKeyVersions/1
16885 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
16886 # key. If absent, the Compute Engine default service account is used.
16887 # For example:
16888 #
16889 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
16890 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
16891 # encryption key, encoded in RFC
16892 # 4648 base64 to either encrypt or decrypt this resource. You can
16893 # provide either the rawKey or thersaEncryptedKey.
16894 # For example:
16895 #
16896 # &quot;rawKey&quot;:
16897 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
16898 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
16899 # customer-supplied encryption key to either encrypt or decrypt this
16900 # resource. You can provide either the rawKey or thersaEncryptedKey.
16901 # For example:
16902 #
16903 # &quot;rsaEncryptedKey&quot;:
16904 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
16905 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
16906 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
16907 #
16908 # The key must meet the following requirements before you can provide it to
16909 # Compute Engine:
16910 #
16911 # 1. The key is wrapped using a RSA public key certificate provided by
16912 # Google.
16913 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
16914 # encoding.
16915 #
16916 # Gets the RSA public key certificate provided by Google at:
16917 #
16918 #
16919 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
16920 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
16921 # 4648 base64 encoded SHA-256 hash of the customer-supplied
16922 # encryption key that protects this resource.
16923 },
16924 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
16925 # instance boot disk, one of initializeParams.sourceSnapshot
16926 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
16927 # is required.
16928 #
16929 # To create a disk with a snapshot that you created, specify the
16930 # snapshot name in the following format:
16931 #
16932 # us-central1-a/instantSnapshots/my-backup
16933 #
16934 #
16935 # If the source instant-snapshot is deleted later, this field will not be
16936 # set.
16937 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
16938 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
16939 # is required.
16940 #
16941 # To create a disk with a snapshot that you created, specify the
16942 # snapshot name in the following format:
16943 #
16944 # global/snapshots/my-backup
16945 #
16946 #
16947 # If the source snapshot is deleted later, this field will not be set.
16948 #
16949 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
16950 # an image instead when you create VMs using
16951 # the bulk
16952 # insert method.
16953 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
16954 # encryption key of the source snapshot.
16955 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
16956 # For example:
16957 #
16958 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16959 # key_region/cryptoKeys/key
16960 #
16961 # The fully-qualifed key name may be returned for resource GET requests. For
16962 # example:
16963 #
16964 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
16965 # key_region/cryptoKeys/key
16966 # /cryptoKeyVersions/1
16967 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
16968 # key. If absent, the Compute Engine default service account is used.
16969 # For example:
16970 #
16971 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
16972 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
16973 # encryption key, encoded in RFC
16974 # 4648 base64 to either encrypt or decrypt this resource. You can
16975 # provide either the rawKey or thersaEncryptedKey.
16976 # For example:
16977 #
16978 # &quot;rawKey&quot;:
16979 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
16980 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
16981 # customer-supplied encryption key to either encrypt or decrypt this
16982 # resource. You can provide either the rawKey or thersaEncryptedKey.
16983 # For example:
16984 #
16985 # &quot;rsaEncryptedKey&quot;:
16986 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
16987 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
16988 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
16989 #
16990 # The key must meet the following requirements before you can provide it to
16991 # Compute Engine:
16992 #
16993 # 1. The key is wrapped using a RSA public key certificate provided by
16994 # Google.
16995 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
16996 # encoding.
16997 #
16998 # Gets the RSA public key certificate provided by Google at:
16999 #
17000 #
17001 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
17002 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
17003 # 4648 base64 encoded SHA-256 hash of the customer-supplied
17004 # encryption key that protects this resource.
17005 },
17006 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
17007 # this as a partial or full URL to the resource. For example, the following
17008 # are valid values:
17009 #
17010 #
17011 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
17012 # - projects/project/zones/zone/storagePools/storagePool
17013 # - zones/zone/storagePools/storagePool
17014 },
17015 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
17016 # either SCSI or NVME. For most machine types, the
17017 # default is SCSI. Local SSDs can use either NVME or SCSI.
17018 # In certain configurations, persistent disks can use NVMe. For more
17019 # information, seeAbout
17020 # persistent disks.
17021 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
17022 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
17023 &quot;A String&quot;,
17024 ],
17025 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
17026 # disk is not allowed to be detached from the instance, or to be used as the
17027 # source of the snapshot creation, and the image creation. The instance with
17028 # at least one locked attached disk is not allow to be used as source of
17029 # machine image creation, instant snapshot creation, and not allowed to be
17030 # deleted with --keep-disk parameter set to true for locked disks.
17031 &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
17032 # in READ_WRITE mode.
17033 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
17034 # field is set to PRESERVED if the LocalSSD data has been saved
17035 # to a persistent location by customer request. (see the
17036 # discard_local_ssd option on Stop/Suspend).
17037 # Read-only in the api.
17038 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
17039 # these are public keys which are safe to store in public
17040 &quot;dbs&quot;: [ # The Key Database (db).
17041 {
17042 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
17043 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
17044 },
17045 ],
17046 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
17047 {
17048 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
17049 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
17050 },
17051 ],
17052 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
17053 {
17054 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
17055 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
17056 },
17057 ],
17058 &quot;pk&quot;: { # The Platform Key (PK).
17059 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
17060 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
17061 },
17062 },
17063 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
17064 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
17065 # is required.
17066 #
17067 # If desired, you can also attach existing non-root persistent disks using
17068 # this property. This field is only applicable for persistent disks.
17069 #
17070 # Note that for InstanceTemplate, specify the disk name for zonal disk,
17071 # and the URL for regional disk.
17072 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
17073 },
17074 ],
17075 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
17076 &quot;A String&quot;,
17077 ],
17078 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
17079 # e.g. &#x27;Intel Ice Lake&#x27;.
17080 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
17081 # preference. MIG will first try to create a VM based on the machine-type
17082 # with lowest rank and fallback to next rank based on availability.
17083 # Machine types and instance selections with the same rank have the same
17084 # preference.
17085 },
17086 },
17087 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
17088 # create instances.
17089 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
17090 # more preemption than the minimum capacity user needs. MIG will create
17091 # only Standard VMs until it reaches standard_capacity_base and only
17092 # then will start using standard_capacity_percent_above_base to mix Spot
17093 # with Standard VMs.
17094 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
17095 # remaining percentage will use Spot VMs. The percentage applies only to
17096 # the capacity above standard_capacity_base.
17097 },
17098 },
17099 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
17100 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
17101 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
17102 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
17103 # applies to the VMs on which your application fails a health check.
17104 # Valid values are
17105 #
17106 # - REPAIR (default): MIG automatically repairs a failed VM
17107 # by recreating it. For more information, see About
17108 # repairing VMs in a MIG.
17109 # - DO_NOTHING: MIG does not repair a failed VM.
17110 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
17111 # configuration when repairing a VM. Valid options are:
17112 #
17113 #
17114 #
17115 # - NO (default): If configuration updates are available, they are not
17116 # forcefully applied during repair. Instead, configuration updates are
17117 # applied according to the group&#x27;s update policy.
17118 #
17119 # - YES: If configuration updates are available, they are applied
17120 # during repair.
17121 &quot;metadataBasedReadinessSignal&quot;: { # The configuration for metadata based readiness signal sent by the
17122 # instance during initialization when stopping / suspending an instance.
17123 # The Instance Group Manager will wait for a signal that indicates
17124 # successful initialization before stopping / suspending an instance.
17125 #
17126 # If a successful readiness signal is not sent before timeout, the
17127 # corresponding instance will not be stopped / suspended. Instead,
17128 # an error will be visible in the lastAttempt.errors field of
17129 # the managed instance in the listmanagedinstances
17130 # method.
17131 #
17132 # If metadataBasedReadinessSignal.timeoutSec is unset,
17133 # the Instance Group Manager will directly proceed to suspend / stop
17134 # instances, skipping initialization on them.
17135 &quot;timeoutSec&quot;: 42, # The number of seconds to wait for a readiness signal during
17136 # initialization before timing out.
17137 },
17138 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
17139 # unhealthy when the application running on that VM fails a health check.
17140 # Valid values are:
17141 #
17142 # - DEFAULT_ACTION (default): MIG uses the same action
17143 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
17144 # - REPAIR: MIG automatically repairs an unhealthy VM by
17145 # recreating it.
17146 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
17147 # For more information, see
17148 # About repairing VMs in a MIG.
17149 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
17150 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
17151 # Valid values are:
17152 #
17153 # - NO (default): MIG cannot change a VM&#x27;s zone during a
17154 # repair.
17155 # - YES: MIG can select a different zone for the VM during
17156 # a repair.
17157 },
17158 },
17159 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
17160 # instance group. The group uses this template to create all new instances
17161 # in the managed instance group. The templates for existing instances in the
17162 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
17163 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
17164 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
17165 # this managed instance group.
17166 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
17167 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
17168 # long, and comply withRFC1035.
17169 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
17170 # to this Instance Group Manager.
17171 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
17172 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
17173 # The name must be 1-63 characters long, and comply withRFC1035.
17174 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
17175 },
17176 ],
17177 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
17178 # as part of resource payload.
17179 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
17180 # key-value pairs. Keys and values can be either in numeric format,
17181 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
17182 # format such as `{org_id|project_id}/{tag_key_short_name}` and
17183 # `{tag_value_short_name}`. For more information, seeManage tags
17184 # for resources.
17185 &quot;a_key&quot;: &quot;A String&quot;,
17186 },
17187 },
17188 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
17189 # where the managed instance group resides (for regional resources).
17190 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
17191 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
17192 # instance group.
17193 # It can be a full or partial URL. For example, the following are
17194 # all valid URLs to a workload policy:
17195 #
17196 #
17197 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
17198 # - projects/project/regions/region/resourcePolicies/resourcePolicy
17199 # - regions/region/resourcePolicies/resourcePolicy
17200 },
17201 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
17202 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
17203 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
17204 # this URL.
17205 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
17206 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
17207 # by the managed instance group on instances. The service accounts needs all
17208 # permissions required to create and delete instances.
17209 # By default, the service account
17210 # {projectNumber}@cloudservices.gserviceaccount.com is used.
17211 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
17212 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
17213 # stop a VM after that VM was created. The initial delay gives the
17214 # initialization script the time to prepare your VM for a quick scale out.
17215 # The value of initial delay must be between 0 and 3600 seconds. The
17216 # default value is 0.
17217 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
17218 # group scales out. The default mode is `MANUAL`.
17219 },
17220 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
17221 &quot;preservedState&quot;: { # Configuration of preserved resources.
17222 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
17223 # delete, update, etc. This map is keyed with the device names of
17224 # the disks.
17225 &quot;a_key&quot;: {
17226 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
17227 # update or VM instance recreate operations.
17228 # This flag is used to configure if the disk should be deleted after it
17229 # is no longer used by the group, e.g. when the given instance or
17230 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
17231 },
17232 },
17233 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
17234 # instance delete, update, etc. This map is keyed with the network
17235 # interface name.
17236 &quot;a_key&quot;: {
17237 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
17238 # update or VM instance recreate operations.
17239 # This flag is used to configure if the IP reservation should be deleted
17240 # after it is no longer used by the group, e.g. when the given instance
17241 # or the whole group is deleted.
17242 },
17243 },
17244 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
17245 # instance delete, update, etc. This map is keyed with the network
17246 # interface name.
17247 &quot;a_key&quot;: {
17248 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
17249 # update or VM instance recreate operations.
17250 # This flag is used to configure if the IP reservation should be deleted
17251 # after it is no longer used by the group, e.g. when the given instance
17252 # or the whole group is deleted.
17253 },
17254 },
17255 },
17256 },
17257 &quot;status&quot;: { # Output only. The status of this managed instance group.
17258 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
17259 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
17260 # This value is in RFC3339 text format.
17261 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
17262 # been applied to all managed instances in the group.
17263 },
17264 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
17265 # Currently only one accelerator topology is supported.
17266 {
17267 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
17268 # The value is the same as configured in the WorkloadPolicy.
17269 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
17270 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
17271 # check.
17272 &quot;error&quot;: { # Output only. Encountered errors.
17273 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
17274 # operation.
17275 {
17276 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
17277 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
17278 # details. There is a set of defined message types to use for providing
17279 # details.The syntax depends on the error code. For example,
17280 # QuotaExceededInfo will have details when the error code is
17281 # QUOTA_EXCEEDED.
17282 {
17283 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
17284 #
17285 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
17286 # is not enabled:
17287 #
17288 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
17289 # &quot;domain&quot;: &quot;googleapis.com&quot;
17290 # &quot;metadata&quot;: {
17291 # &quot;resource&quot;: &quot;projects/123&quot;,
17292 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
17293 # }
17294 # }
17295 #
17296 # This response indicates that the pubsub.googleapis.com API is not enabled.
17297 #
17298 # Example of an error that is returned when attempting to create a Spanner
17299 # instance in a region that is out of stock:
17300 #
17301 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
17302 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
17303 # &quot;metadata&quot;: {
17304 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
17305 # }
17306 # }
17307 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
17308 # is typically the registered service name of the tool or product that
17309 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
17310 # generated by some common infrastructure, the error domain must be a
17311 # globally unique value that identifies the infrastructure. For Google API
17312 # infrastructure, the error domain is &quot;googleapis.com&quot;.
17313 &quot;metadatas&quot;: { # Additional structured details about this error.
17314 #
17315 # Keys must match a regular expression of `a-z+` but should
17316 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
17317 # length. When identifying the current value of an exceeded limit, the units
17318 # should be contained in the key, not the value. For example, rather than
17319 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
17320 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
17321 # instances that can be created in a single (batch) request.
17322 &quot;a_key&quot;: &quot;A String&quot;,
17323 },
17324 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
17325 # proximate cause of the error. Error reasons are unique within a particular
17326 # domain of errors. This should be at most 63 characters and match a
17327 # regular expression of `A-Z+[A-Z0-9]`, which represents
17328 # UPPER_SNAKE_CASE.
17329 },
17330 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
17331 #
17332 # For example, if a quota check failed with an error indicating the calling
17333 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
17334 # directly to the right place in the developer console to flip the bit.
17335 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
17336 { # Describes a URL link.
17337 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
17338 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
17339 },
17340 ],
17341 },
17342 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
17343 # which can be attached to an RPC error.
17344 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
17345 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
17346 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
17347 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
17348 },
17349 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
17350 &quot;dimensions&quot;: { # The map holding related quota dimensions.
17351 &quot;a_key&quot;: &quot;A String&quot;,
17352 },
17353 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
17354 # type or metric.
17355 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
17356 # or metric.
17357 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
17358 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
17359 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
17360 },
17361 },
17362 ],
17363 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
17364 # This property is optional.
17365 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
17366 },
17367 ],
17368 },
17369 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
17370 # has // RFC3339 //
17371 # text format.
17372 },
17373 },
17374 ],
17375 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
17376 # that targets this instance group manager.
17377 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
17378 # targetSizePolicy.mode is set to BULK.
17379 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
17380 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
17381 # operation.
17382 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
17383 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
17384 # operation.
17385 {
17386 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
17387 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
17388 # details. There is a set of defined message types to use for providing
17389 # details.The syntax depends on the error code. For example,
17390 # QuotaExceededInfo will have details when the error code is
17391 # QUOTA_EXCEEDED.
17392 {
17393 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
17394 #
17395 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
17396 # is not enabled:
17397 #
17398 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
17399 # &quot;domain&quot;: &quot;googleapis.com&quot;
17400 # &quot;metadata&quot;: {
17401 # &quot;resource&quot;: &quot;projects/123&quot;,
17402 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
17403 # }
17404 # }
17405 #
17406 # This response indicates that the pubsub.googleapis.com API is not enabled.
17407 #
17408 # Example of an error that is returned when attempting to create a Spanner
17409 # instance in a region that is out of stock:
17410 #
17411 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
17412 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
17413 # &quot;metadata&quot;: {
17414 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
17415 # }
17416 # }
17417 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
17418 # is typically the registered service name of the tool or product that
17419 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
17420 # generated by some common infrastructure, the error domain must be a
17421 # globally unique value that identifies the infrastructure. For Google API
17422 # infrastructure, the error domain is &quot;googleapis.com&quot;.
17423 &quot;metadatas&quot;: { # Additional structured details about this error.
17424 #
17425 # Keys must match a regular expression of `a-z+` but should
17426 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
17427 # length. When identifying the current value of an exceeded limit, the units
17428 # should be contained in the key, not the value. For example, rather than
17429 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
17430 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
17431 # instances that can be created in a single (batch) request.
17432 &quot;a_key&quot;: &quot;A String&quot;,
17433 },
17434 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
17435 # proximate cause of the error. Error reasons are unique within a particular
17436 # domain of errors. This should be at most 63 characters and match a
17437 # regular expression of `A-Z+[A-Z0-9]`, which represents
17438 # UPPER_SNAKE_CASE.
17439 },
17440 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
17441 #
17442 # For example, if a quota check failed with an error indicating the calling
17443 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
17444 # directly to the right place in the developer console to flip the bit.
17445 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
17446 { # Describes a URL link.
17447 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
17448 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
17449 },
17450 ],
17451 },
17452 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
17453 # which can be attached to an RPC error.
17454 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
17455 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
17456 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
17457 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
17458 },
17459 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
17460 &quot;dimensions&quot;: { # The map holding related quota dimensions.
17461 &quot;a_key&quot;: &quot;A String&quot;,
17462 },
17463 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
17464 # type or metric.
17465 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
17466 # or metric.
17467 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
17468 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
17469 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
17470 },
17471 },
17472 ],
17473 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
17474 # This property is optional.
17475 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
17476 },
17477 ],
17478 },
17479 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
17480 # operation. Timestamp is in RFC3339 text format.
17481 },
17482 },
17483 &quot;currentInstanceStatuses&quot;: { # The list of instance statuses and the number of instances in this managed # Output only. The list of instance statuses and the number of instances
17484 # in this managed instance group that have the status. Currently only shown
17485 # for TPU MIGs
17486 # instance group that have the status. For more information about how to
17487 # interpret each status check the instance lifecycle documentation.
17488 # Currently only shown for TPU MIGs.
17489 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
17490 # that have DEPROVISIONING status.
17491 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
17492 # have been deleted. Includes only instances that would be shown in the
17493 # listManagedInstances method and not all instances that have been
17494 # deleted in the lifetime of the MIG.
17495 # Does not include FlexStart instances that are waiting for the resources
17496 # availability, they are considered as &#x27;pending&#x27;.
17497 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
17498 # that have PENDING status, that is FlexStart instances that are waiting
17499 # for resources. Instances that do not exist because of the other reasons
17500 # are counted as &#x27;non_existent&#x27;.
17501 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
17502 # that have PENDING_STOP status.
17503 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
17504 # that have PROVISIONING status.
17505 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
17506 # that have REPAIRING status.
17507 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
17508 # that have RUNNING status.
17509 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
17510 # that have STAGING status.
17511 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
17512 # that have STOPPED status.
17513 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
17514 # that have STOPPING status.
17515 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
17516 # that have SUSPENDED status.
17517 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
17518 # that have SUSPENDING status.
17519 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
17520 # that have TERMINATED status.
17521 },
17522 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
17523 # stable state. A stable state means that: none of the instances in the
17524 # managed instance group is currently undergoing any type of change (for
17525 # example, creation, restart, or deletion); no future changes are scheduled
17526 # for instances in the managed instance group; and the managed instance
17527 # group itself is not being modified.
17528 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
17529 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
17530 # has stateful configuration, that is, if you have configured any items
17531 # in a stateful policy or in per-instance configs.
17532 # The group might report that it has no stateful configuration even when
17533 # there is still some preserved state on a managed instance, for example,
17534 # if you have deleted all PICs but not yet applied those deletions.
17535 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
17536 # has stateful configuration, that is, if you have configured any items
17537 # in a stateful policy or in per-instance configs.
17538 # The group might report that it has no stateful configuration even when
17539 # there is still some preserved state on a managed instance, for example,
17540 # if you have deleted all PICs but not yet applied those deletions. This
17541 # field is deprecated in favor of has_stateful_config.
17542 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
17543 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
17544 # (listed in the output of a listPerInstanceConfigs API call) have
17545 # status EFFECTIVE or there are no per-instance-configs.
17546 },
17547 },
17548 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
17549 # target version specified by version field on Instance Group
17550 # Manager.
17551 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
17552 # in this managed instance group, i.e. all instances are in their target
17553 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
17554 },
17555 },
17556 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
17557 # apply to all of the instances in the managed instance group.
17558 &quot;A String&quot;,
17559 ],
17560 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
17561 # You can reduce this number by using the instanceGroupManager
17562 # deleteInstances or abandonInstances methods. Resizing the group also
17563 # changes this number.
17564 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
17565 # size.
17566 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
17567 # individually or all at once.
17568 },
17569 &quot;targetSizeUnit&quot;: &quot;A String&quot;, # The unit of measure for the target size.
17570 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
17571 # This number changes when you:
17572 #
17573 # - Stop instance using the stopInstances
17574 # method or start instances using the startInstances
17575 # method.
17576 # - Manually change the targetStoppedSize using the update
17577 # method.
17578 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
17579 # This number changes when you:
17580 #
17581 # - Suspend instance using the suspendInstances
17582 # method or resume instances using the resumeInstances
17583 # method.
17584 # - Manually change the targetSuspendedSize using the update
17585 # method.
17586 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
17587 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
17588 &quot;A String&quot;,
17589 ],
17590 &quot;disruptionMode&quot;: &quot;A String&quot;, # Whether the boot disk is allowed to be updated with restart.
17591 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
17592 # instance redistribution policy for regional managed instance groups.
17593 # Valid values are:
17594 #
17595 # - PROACTIVE (default): The group attempts to maintain an
17596 # even distribution of VM instances across zones in the region.
17597 # - NONE: For non-autoscaled groups, proactive
17598 # redistribution is disabled.
17599 &quot;maxSurge&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be created above the specifiedtargetSize during the update process. This value can be
17600 # either a fixed number or, if the group has 10 or more instances, a
17601 # percentage. If you set a percentage, the number of instances is rounded
17602 # if necessary. The default value for maxSurge is a fixed
17603 # value equal to the number of zones in which the managed instance group
17604 # operates.
17605 #
17606 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
17607 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
17608 #
17609 #
17610 #
17611 # - If the value is fixed, then the calculated
17612 # value is equal to the fixed value.
17613 # - If the value is a percent, then the
17614 # calculated
17615 # value is percent/100 * targetSize. For example,
17616 # the calculated value of a 80% of a managed instance group
17617 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
17618 # is a remainder, the number is rounded.
17619 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
17620 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
17621 # example, specify 80 for 80%.
17622 },
17623 &quot;maxUnavailable&quot;: { # Encapsulates numeric value that can be either absolute or relative. # The maximum number of instances that can be unavailable during the update
17624 # process. An instance is considered available if all of the following
17625 # conditions are satisfied:
17626 #
17627 #
17628 #
17629 # - The instance&#x27;s status is
17630 # RUNNING.
17631 # - If there is a health
17632 # check on the instance group, the instance&#x27;s health check status
17633 # must be HEALTHY at least once. If there is no health check
17634 # on the group, then the instance only needs to have a status of
17635 # RUNNING to be considered available.
17636 #
17637 #
17638 # This value can be either a fixed number or, if the group has 10 or more
17639 # instances, a percentage. If you set a percentage, the number of instances
17640 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
17641 # in which the managed instance group operates.
17642 #
17643 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
17644 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
17645 #
17646 #
17647 #
17648 # - If the value is fixed, then the calculated
17649 # value is equal to the fixed value.
17650 # - If the value is a percent, then the
17651 # calculated
17652 # value is percent/100 * targetSize. For example,
17653 # the calculated value of a 80% of a managed instance group
17654 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
17655 # is a remainder, the number is rounded.
17656 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
17657 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
17658 # example, specify 80 for 80%.
17659 },
17660 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
17661 # becomes available. This value must be from range [0, 3600].
17662 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
17663 # disruption as much as possible or to apply a more disruptive action than
17664 # is necessary.
17665 #
17666 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
17667 # Compute Engine performs the necessary action to execute the update.
17668 # - To apply a more disruptive action than is strictly necessary, set the
17669 # minimal action to RESTART or REPLACE. For
17670 # example, Compute Engine does not need to restart a VM to change its
17671 # metadata. But if your application reads instance metadata only when a VM
17672 # is restarted, you can set the minimal action to RESTART in
17673 # order to pick up metadata changes.
17674 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
17675 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
17676 # as much as possible. RESTART to allow actions that can be
17677 # applied without instance replacing or REPLACE to allow all
17678 # possible actions. If the Updater determines that the minimal update
17679 # action needed is more disruptive than most disruptive allowed action you
17680 # specify it will not perform the update at all.
17681 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
17682 # See minimal_action.REPLACE
17683 &quot;type&quot;: &quot;A String&quot;, # The type
17684 # of update process. You can specify either PROACTIVE so
17685 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
17686 # to update.
17687 },
17688 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
17689 # create instances.
17690 #
17691 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
17692 # group. This field overrides the top-level instanceTemplate
17693 # field. Read more about therelationships
17694 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
17695 # remaining instances. For more information, read aboutcanary
17696 # updates.
17697 {
17698 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
17699 # instance group. The group uses this template to create new instances in
17700 # the managed instance group until the `targetSize` for this version is
17701 # reached. The templates for existing instances in the group do not change
17702 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
17703 # existing instances are updated until the `targetSize` for this version is
17704 # reached.
17705 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
17706 # managed instance group.
17707 &quot;tag&quot;: &quot;A String&quot;, # Tag describing the version. Used to trigger rollout of a target version
17708 # even if instance_template remains unchanged.
17709 # Deprecated in favor of &#x27;name&#x27;.
17710 &quot;targetSize&quot;: { # Encapsulates numeric value that can be either absolute or relative. # Specifies the intended number of instances to be created from theinstanceTemplate. The final number of instances created
17711 # from the template will be equal to:
17712 #
17713 #
17714 # - If expressed as a fixed number, the minimum of either
17715 # targetSize.fixed or
17716 # instanceGroupManager.targetSize is used.
17717 # - if expressed as a percent, the targetSize
17718 # would be (targetSize.percent/100 *
17719 # InstanceGroupManager.targetSize) If there is a remainder, the
17720 # number is rounded.
17721 #
17722 # If unset, this version will update any remaining instances not
17723 # updated by another version. ReadStarting
17724 # a canary update for more information.
17725 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
17726 #
17727 #
17728 #
17729 # - If the value is fixed, then the calculated
17730 # value is equal to the fixed value.
17731 # - If the value is a percent, then the
17732 # calculated
17733 # value is percent/100 * targetSize. For example,
17734 # the calculated value of a 80% of a managed instance group
17735 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
17736 # is a remainder, the number is rounded.
17737 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
17738 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
17739 # example, specify 80 for 80%.
17740 },
17741 },
17742 ],
17743 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
17744 # where the managed instance group is located (for zonal resources).
17745 }
17746
17747 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
17748 that if you must retry your request, the server will know to ignore the
17749 request if it has already been completed.
17750
17751 For example, consider a situation where you make an initial request and
17752 the request times out. If you make the request again with the same
17753 request ID, the server can check if original operation with the same
17754 request ID was received, and if so, will ignore the second request. This
17755 prevents clients from accidentally creating duplicate commitments.
17756
17757 The request ID must be
17758 a valid UUID with the exception that zero UUID is not supported
17759 (00000000-0000-0000-0000-000000000000).
17760 x__xgafv: string, V1 error format.
17761 Allowed values
17762 1 - v1 error format
17763 2 - v2 error format
17764
17765 Returns:
17766 An object of the form:
17767
17768 { # Represents an Operation resource.
17769 #
17770 # Google Compute Engine has three Operation resources:
17771 #
17772 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
17773 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
17774 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
17775 #
17776 # You can use an operation resource to manage asynchronous API requests.
17777 # For more information, readHandling
17778 # API responses.
17779 #
17780 # Operations can be global, regional or zonal.
17781 #
17782 # - For global operations, use the `globalOperations`
17783 # resource.
17784 # - For regional operations, use the
17785 # `regionOperations` resource.
17786 # - For zonal operations, use
17787 # the `zoneOperations` resource.
17788 #
17789 #
17790 #
17791 # For more information, read
17792 # Global, Regional, and Zonal Resources.
17793 #
17794 # Note that completed Operation resources have a limited
17795 # retention period.
17796 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
17797 # Not present otherwise.
17798 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
17799 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
17800 # set when the operation is created.
17801 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
17802 # text format.
17803 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
17804 # this field will be populated.
17805 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
17806 # operation.
17807 {
17808 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
17809 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
17810 # details. There is a set of defined message types to use for providing
17811 # details.The syntax depends on the error code. For example,
17812 # QuotaExceededInfo will have details when the error code is
17813 # QUOTA_EXCEEDED.
17814 {
17815 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
17816 #
17817 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
17818 # is not enabled:
17819 #
17820 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
17821 # &quot;domain&quot;: &quot;googleapis.com&quot;
17822 # &quot;metadata&quot;: {
17823 # &quot;resource&quot;: &quot;projects/123&quot;,
17824 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
17825 # }
17826 # }
17827 #
17828 # This response indicates that the pubsub.googleapis.com API is not enabled.
17829 #
17830 # Example of an error that is returned when attempting to create a Spanner
17831 # instance in a region that is out of stock:
17832 #
17833 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
17834 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
17835 # &quot;metadata&quot;: {
17836 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
17837 # }
17838 # }
17839 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
17840 # is typically the registered service name of the tool or product that
17841 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
17842 # generated by some common infrastructure, the error domain must be a
17843 # globally unique value that identifies the infrastructure. For Google API
17844 # infrastructure, the error domain is &quot;googleapis.com&quot;.
17845 &quot;metadatas&quot;: { # Additional structured details about this error.
17846 #
17847 # Keys must match a regular expression of `a-z+` but should
17848 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
17849 # length. When identifying the current value of an exceeded limit, the units
17850 # should be contained in the key, not the value. For example, rather than
17851 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
17852 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
17853 # instances that can be created in a single (batch) request.
17854 &quot;a_key&quot;: &quot;A String&quot;,
17855 },
17856 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
17857 # proximate cause of the error. Error reasons are unique within a particular
17858 # domain of errors. This should be at most 63 characters and match a
17859 # regular expression of `A-Z+[A-Z0-9]`, which represents
17860 # UPPER_SNAKE_CASE.
17861 },
17862 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
17863 #
17864 # For example, if a quota check failed with an error indicating the calling
17865 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
17866 # directly to the right place in the developer console to flip the bit.
17867 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
17868 { # Describes a URL link.
17869 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
17870 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
17871 },
17872 ],
17873 },
17874 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
17875 # which can be attached to an RPC error.
17876 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
17877 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
17878 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
17879 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
17880 },
17881 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
17882 &quot;dimensions&quot;: { # The map holding related quota dimensions.
17883 &quot;a_key&quot;: &quot;A String&quot;,
17884 },
17885 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
17886 # type or metric.
17887 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
17888 # or metric.
17889 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
17890 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
17891 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
17892 },
17893 },
17894 ],
17895 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
17896 # This property is optional.
17897 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
17898 },
17899 ],
17900 },
17901 &quot;getVersionOperationMetadata&quot;: {
17902 &quot;inlineSbomInfo&quot;: {
17903 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
17904 # appropriate identifiers.
17905 &quot;a_key&quot;: &quot;A String&quot;,
17906 },
17907 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
17908 # identifiers.
17909 &quot;a_key&quot;: &quot;A String&quot;,
17910 },
17911 },
17912 },
17913 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
17914 # message that was returned, such as `NOT FOUND`.
17915 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
17916 # status code that was returned. For example, a `404` means the
17917 # resource was not found.
17918 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
17919 # defined by the server.
17920 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
17921 # This value is inRFC3339
17922 # text format.
17923 &quot;instancesBulkInsertOperationMetadata&quot;: {
17924 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
17925 # Example key: zones/us-central1-a
17926 &quot;a_key&quot;: {
17927 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
17928 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
17929 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
17930 # error.
17931 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
17932 # if the flow is rolling forward or rolling back.
17933 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
17934 },
17935 },
17936 },
17937 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
17938 # Operation resources.
17939 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
17940 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
17941 # group of operations results from a `bulkInsert` API request.
17942 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
17943 # `update`, or `delete`, and so on.
17944 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
17945 # There is no requirement that this be linear or support any granularity of
17946 # operations. This should not be used to guess when the operation will be
17947 # complete. This number should monotonically increase as the operation
17948 # progresses.
17949 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
17950 # applicable when performing regional operations.
17951 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
17952 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
17953 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
17954 # this field will contain information on all underlying zonal actions and
17955 # their state.
17956 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
17957 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
17958 # Example key: zones/us-central1-a
17959 &quot;a_key&quot;: {
17960 &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
17961 # populated.
17962 # different programming environments, including REST APIs and RPC APIs. It is
17963 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
17964 # three pieces of data: error code, error message, and error details.
17965 #
17966 # You can find out more about this error model and how to work with it in the
17967 # [API Design Guide](https://cloud.google.com/apis/design/errors).
17968 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
17969 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
17970 # message types for APIs to use.
17971 {
17972 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
17973 },
17974 ],
17975 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
17976 # user-facing error message should be localized and sent in the
17977 # google.rpc.Status.details field, or localized by the client.
17978 },
17979 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
17980 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
17981 },
17982 },
17983 },
17984 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
17985 # This value is inRFC3339
17986 # text format.
17987 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
17988 # following:
17989 # `PENDING`, `RUNNING`, or `DONE`.
17990 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
17991 # operation.
17992 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
17993 # of the target resource.
17994 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
17995 # operations related to creating a snapshot, this points to the disk
17996 # that the snapshot was created from.
17997 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
17998 # `[email protected]` or
17999 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
18000 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
18001 # operation, this field will be populated.
18002 {
18003 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
18004 # Engine returns NO_RESULTS_ON_PAGE if there
18005 # are no results in the response.
18006 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
18007 # value format. For example:
18008 #
18009 # &quot;data&quot;: [
18010 # {
18011 # &quot;key&quot;: &quot;scope&quot;,
18012 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
18013 # }
18014 {
18015 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
18016 # returned. For example, for warnings where there are no results in a list
18017 # request for a particular zone, this key might be scope and
18018 # the key value might be the zone name. Other examples might be a key
18019 # indicating a deprecated resource and a suggested replacement, or a
18020 # warning about invalid network settings (for example, if an instance
18021 # attempts to perform IP forwarding but is not enabled for IP forwarding).
18022 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
18023 },
18024 ],
18025 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
18026 },
18027 ],
18028 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
18029 # applicable when performing per-zone operations.
18030 }</pre>
18031 </div>
18032
18033 <div class="method">
18034 <code class="details" id="updatePerInstanceConfigs">updatePerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
18035 <pre>Inserts or updates per-instance configurations for the managed instance
18036 group. perInstanceConfig.name serves as a key used to
18037 distinguish whether to perform insert or patch.
18038
18039 Args:
18040 project: string, Project ID for this request. (required)
18041 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
18042 instanceGroupManager: string, The name of the managed instance group.
18043 It should conform to RFC1035. (required)
18044 body: object, The request body.
18045 The object takes the form of:
18046
18047 { # RegionInstanceGroupManagers.updatePerInstanceConfigs
18048 &quot;perInstanceConfigs&quot;: [ # The list of per-instance configurations to insert or patch on this managed
18049 # instance group.
18050 {
18051 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
18052 # optimistic locking. It is ignored when inserting a per-instance
18053 # config. An up-to-date fingerprint must be provided in order to update an
18054 # existing per-instance configuration or the field needs to be unset.
18055 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
18056 # Serves as a merge key during UpdatePerInstanceConfigs
18057 # operations, that is, if a per-instance configuration with the same name
18058 # exists then it will be updated, otherwise a new one will be created for the
18059 # VM instance with the same name. An attempt to create a per-instance
18060 # configuration for a VM instance that either doesn&#x27;t exist or is not part
18061 # of the group will result in an error.
18062 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
18063 # preserved state generated from a stateful policy.
18064 &quot;disks&quot;: { # Preserved disks defined for this instance.
18065 # This map is keyed with the device names of the disks.
18066 &quot;a_key&quot;: {
18067 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
18068 # update, instance recreate operations. This flag is used to configure
18069 # if the disk should be deleted after it is no longer used by the group,
18070 # e.g. when the given instance or the whole MIG is deleted.
18071 # Note: disks attached in READ_ONLY mode cannot be
18072 # auto-deleted.
18073 &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
18074 # disk in READ_WRITE mode.
18075 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
18076 # to the VM instance.
18077 },
18078 },
18079 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
18080 # This map is keyed with the name of the network interface.
18081 &quot;a_key&quot;: {
18082 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
18083 # update or VM instance recreate operations.
18084 # This flag is used to configure if the IP reservation should be deleted
18085 # after it is no longer used by the group, e.g. when the given instance
18086 # or the whole group is deleted.
18087 &quot;ipAddress&quot;: { # Ip address representation
18088 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
18089 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
18090 # network interface.
18091 },
18092 },
18093 },
18094 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
18095 # This map is keyed with the name of the network interface.
18096 &quot;a_key&quot;: {
18097 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
18098 # update or VM instance recreate operations.
18099 # This flag is used to configure if the IP reservation should be deleted
18100 # after it is no longer used by the group, e.g. when the given instance
18101 # or the whole group is deleted.
18102 &quot;ipAddress&quot;: { # Ip address representation
18103 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
18104 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
18105 # network interface.
18106 },
18107 },
18108 },
18109 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
18110 &quot;a_key&quot;: &quot;A String&quot;,
18111 },
18112 },
18113 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
18114 # managed instance.
18115 },
18116 ],
18117 }
18118
18119 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
18120 that if you must retry your request, the server will know to ignore the
18121 request if it has already been completed.
18122
18123 For example, consider a situation where you make an initial request and
18124 the request times out. If you make the request again with the same
18125 request ID, the server can check if original operation with the same
18126 request ID was received, and if so, will ignore the second request. This
18127 prevents clients from accidentally creating duplicate commitments.
18128
18129 The request ID must be
18130 a valid UUID with the exception that zero UUID is not supported
18131 (00000000-0000-0000-0000-000000000000).
18132 x__xgafv: string, V1 error format.
18133 Allowed values
18134 1 - v1 error format
18135 2 - v2 error format
18136
18137 Returns:
18138 An object of the form:
18139
18140 { # Represents an Operation resource.
18141 #
18142 # Google Compute Engine has three Operation resources:
18143 #
18144 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
18145 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
18146 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
18147 #
18148 # You can use an operation resource to manage asynchronous API requests.
18149 # For more information, readHandling
18150 # API responses.
18151 #
18152 # Operations can be global, regional or zonal.
18153 #
18154 # - For global operations, use the `globalOperations`
18155 # resource.
18156 # - For regional operations, use the
18157 # `regionOperations` resource.
18158 # - For zonal operations, use
18159 # the `zoneOperations` resource.
18160 #
18161 #
18162 #
18163 # For more information, read
18164 # Global, Regional, and Zonal Resources.
18165 #
18166 # Note that completed Operation resources have a limited
18167 # retention period.
18168 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
18169 # Not present otherwise.
18170 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
18171 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
18172 # set when the operation is created.
18173 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
18174 # text format.
18175 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
18176 # this field will be populated.
18177 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
18178 # operation.
18179 {
18180 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
18181 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
18182 # details. There is a set of defined message types to use for providing
18183 # details.The syntax depends on the error code. For example,
18184 # QuotaExceededInfo will have details when the error code is
18185 # QUOTA_EXCEEDED.
18186 {
18187 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
18188 #
18189 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
18190 # is not enabled:
18191 #
18192 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
18193 # &quot;domain&quot;: &quot;googleapis.com&quot;
18194 # &quot;metadata&quot;: {
18195 # &quot;resource&quot;: &quot;projects/123&quot;,
18196 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
18197 # }
18198 # }
18199 #
18200 # This response indicates that the pubsub.googleapis.com API is not enabled.
18201 #
18202 # Example of an error that is returned when attempting to create a Spanner
18203 # instance in a region that is out of stock:
18204 #
18205 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
18206 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
18207 # &quot;metadata&quot;: {
18208 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
18209 # }
18210 # }
18211 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
18212 # is typically the registered service name of the tool or product that
18213 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
18214 # generated by some common infrastructure, the error domain must be a
18215 # globally unique value that identifies the infrastructure. For Google API
18216 # infrastructure, the error domain is &quot;googleapis.com&quot;.
18217 &quot;metadatas&quot;: { # Additional structured details about this error.
18218 #
18219 # Keys must match a regular expression of `a-z+` but should
18220 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
18221 # length. When identifying the current value of an exceeded limit, the units
18222 # should be contained in the key, not the value. For example, rather than
18223 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
18224 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
18225 # instances that can be created in a single (batch) request.
18226 &quot;a_key&quot;: &quot;A String&quot;,
18227 },
18228 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
18229 # proximate cause of the error. Error reasons are unique within a particular
18230 # domain of errors. This should be at most 63 characters and match a
18231 # regular expression of `A-Z+[A-Z0-9]`, which represents
18232 # UPPER_SNAKE_CASE.
18233 },
18234 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
18235 #
18236 # For example, if a quota check failed with an error indicating the calling
18237 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
18238 # directly to the right place in the developer console to flip the bit.
18239 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
18240 { # Describes a URL link.
18241 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
18242 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
18243 },
18244 ],
18245 },
18246 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
18247 # which can be attached to an RPC error.
18248 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
18249 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
18250 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
18251 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
18252 },
18253 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
18254 &quot;dimensions&quot;: { # The map holding related quota dimensions.
18255 &quot;a_key&quot;: &quot;A String&quot;,
18256 },
18257 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
18258 # type or metric.
18259 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
18260 # or metric.
18261 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
18262 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
18263 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
18264 },
18265 },
18266 ],
18267 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
18268 # This property is optional.
18269 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
18270 },
18271 ],
18272 },
18273 &quot;getVersionOperationMetadata&quot;: {
18274 &quot;inlineSbomInfo&quot;: {
18275 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
18276 # appropriate identifiers.
18277 &quot;a_key&quot;: &quot;A String&quot;,
18278 },
18279 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
18280 # identifiers.
18281 &quot;a_key&quot;: &quot;A String&quot;,
18282 },
18283 },
18284 },
18285 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
18286 # message that was returned, such as `NOT FOUND`.
18287 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
18288 # status code that was returned. For example, a `404` means the
18289 # resource was not found.
18290 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
18291 # defined by the server.
18292 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
18293 # This value is inRFC3339
18294 # text format.
18295 &quot;instancesBulkInsertOperationMetadata&quot;: {
18296 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
18297 # Example key: zones/us-central1-a
18298 &quot;a_key&quot;: {
18299 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
18300 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
18301 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
18302 # error.
18303 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
18304 # if the flow is rolling forward or rolling back.
18305 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
18306 },
18307 },
18308 },
18309 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
18310 # Operation resources.
18311 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
18312 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
18313 # group of operations results from a `bulkInsert` API request.
18314 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
18315 # `update`, or `delete`, and so on.
18316 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
18317 # There is no requirement that this be linear or support any granularity of
18318 # operations. This should not be used to guess when the operation will be
18319 # complete. This number should monotonically increase as the operation
18320 # progresses.
18321 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
18322 # applicable when performing regional operations.
18323 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
18324 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
18325 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
18326 # this field will contain information on all underlying zonal actions and
18327 # their state.
18328 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
18329 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
18330 # Example key: zones/us-central1-a
18331 &quot;a_key&quot;: {
18332 &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
18333 # populated.
18334 # different programming environments, including REST APIs and RPC APIs. It is
18335 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
18336 # three pieces of data: error code, error message, and error details.
18337 #
18338 # You can find out more about this error model and how to work with it in the
18339 # [API Design Guide](https://cloud.google.com/apis/design/errors).
18340 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
18341 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
18342 # message types for APIs to use.
18343 {
18344 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
18345 },
18346 ],
18347 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
18348 # user-facing error message should be localized and sent in the
18349 # google.rpc.Status.details field, or localized by the client.
18350 },
18351 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
18352 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
18353 },
18354 },
18355 },
18356 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
18357 # This value is inRFC3339
18358 # text format.
18359 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
18360 # following:
18361 # `PENDING`, `RUNNING`, or `DONE`.
18362 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
18363 # operation.
18364 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
18365 # of the target resource.
18366 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
18367 # operations related to creating a snapshot, this points to the disk
18368 # that the snapshot was created from.
18369 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
18370 # `[email protected]` or
18371 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
18372 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
18373 # operation, this field will be populated.
18374 {
18375 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
18376 # Engine returns NO_RESULTS_ON_PAGE if there
18377 # are no results in the response.
18378 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
18379 # value format. For example:
18380 #
18381 # &quot;data&quot;: [
18382 # {
18383 # &quot;key&quot;: &quot;scope&quot;,
18384 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
18385 # }
18386 {
18387 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
18388 # returned. For example, for warnings where there are no results in a list
18389 # request for a particular zone, this key might be scope and
18390 # the key value might be the zone name. Other examples might be a key
18391 # indicating a deprecated resource and a suggested replacement, or a
18392 # warning about invalid network settings (for example, if an instance
18393 # attempts to perform IP forwarding but is not enabled for IP forwarding).
18394 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
18395 },
18396 ],
18397 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
18398 },
18399 ],
18400 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
18401 # applicable when performing per-zone operations.
18402 }</pre>
18403 </div>
18404
18405 </body></html>