Debian Codegraph @

docs/dyn/compute_beta.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_beta.html">Compute Engine API</a> . <a href="compute_beta.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/beta/globalOperations)
235 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
236 # * [Zonal](/compute/docs/reference/rest/beta/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;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
415 # this field will contain information on all underlying zonal actions and
416 # their state.
417 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
418 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
419 # Example key: zones/us-central1-a
420 &quot;a_key&quot;: {
421 &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
422 # populated.
423 # different programming environments, including REST APIs and RPC APIs. It is
424 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
425 # three pieces of data: error code, error message, and error details.
426 #
427 # You can find out more about this error model and how to work with it in the
428 # [API Design Guide](https://cloud.google.com/apis/design/errors).
429 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
430 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
431 # message types for APIs to use.
432 {
433 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
434 },
435 ],
436 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
437 # user-facing error message should be localized and sent in the
438 # google.rpc.Status.details field, or localized by the client.
439 },
440 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
441 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
442 },
443 },
444 },
445 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
446 # This value is inRFC3339
447 # text format.
448 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
449 # following:
450 # `PENDING`, `RUNNING`, or `DONE`.
451 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
452 # operation.
453 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
454 # of the target resource.
455 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
456 # operations related to creating a snapshot, this points to the disk
457 # that the snapshot was created from.
458 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
459 # `[email protected]` or
460 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
461 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
462 # operation, this field will be populated.
463 {
464 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
465 # Engine returns NO_RESULTS_ON_PAGE if there
466 # are no results in the response.
467 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
468 # value format. For example:
469 #
470 # &quot;data&quot;: [
471 # {
472 # &quot;key&quot;: &quot;scope&quot;,
473 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
474 # }
475 {
476 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
477 # returned. For example, for warnings where there are no results in a list
478 # request for a particular zone, this key might be scope and
479 # the key value might be the zone name. Other examples might be a key
480 # indicating a deprecated resource and a suggested replacement, or a
481 # warning about invalid network settings (for example, if an instance
482 # attempts to perform IP forwarding but is not enabled for IP forwarding).
483 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
484 },
485 ],
486 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
487 },
488 ],
489 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
490 # applicable when performing per-zone operations.
491 }</pre>
492 </div>
493
494 <div class="method">
495 <code class="details" id="adoptInstances">adoptInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
496 <pre>Flags the specified instances to be adopted to the managed instance
497 group. Adopting an instance does not change the instance status, but it
498 adds the instance to any target pools that are applied by the managed
499 instance group. This method increases the targetSize of the managed
500 instance group by the number of instances that you adopt. This operation
501 is marked as DONE when the action is scheduled even if the instances have
502 not been adopted to the group yet. You must separately verify the status
503 of the adopting action with the listManagedInstances method.
504
505 Args:
506 project: string, Project ID for this request. (required)
507 region: string, Name of the region scoping this request. It should conform to RFC1035. (required)
508 instanceGroupManager: string, Name of the managed instance group. It should conform to RFC1035 or be a
509 resource ID. (required)
510 body: object, The request body.
511 The object takes the form of:
512
513 {
514 &quot;instances&quot;: [ # The list of per-instance configs specifying instances to adopt.
515 {
516 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
517 # optimistic locking. It is ignored when inserting a per-instance
518 # config. An up-to-date fingerprint must be provided in order to update an
519 # existing per-instance configuration or the field needs to be unset.
520 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
521 # Serves as a merge key during UpdatePerInstanceConfigs
522 # operations, that is, if a per-instance configuration with the same name
523 # exists then it will be updated, otherwise a new one will be created for the
524 # VM instance with the same name. An attempt to create a per-instance
525 # configuration for a VM instance that either doesn&#x27;t exist or is not part
526 # of the group will result in an error.
527 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
528 # preserved state generated from a stateful policy.
529 &quot;disks&quot;: { # Preserved disks defined for this instance.
530 # This map is keyed with the device names of the disks.
531 &quot;a_key&quot;: {
532 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
533 # update, instance recreate operations. This flag is used to configure
534 # if the disk should be deleted after it is no longer used by the group,
535 # e.g. when the given instance or the whole MIG is deleted.
536 # Note: disks attached in READ_ONLY mode cannot be
537 # auto-deleted.
538 &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
539 # disk in READ_WRITE mode.
540 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
541 # to the VM instance.
542 },
543 },
544 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
545 # This map is keyed with the name of the network interface.
546 &quot;a_key&quot;: {
547 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
548 # update or VM instance recreate operations.
549 # This flag is used to configure if the IP reservation should be deleted
550 # after it is no longer used by the group, e.g. when the given instance
551 # or the whole group is deleted.
552 &quot;ipAddress&quot;: { # Ip address representation
553 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
554 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
555 # network interface.
556 },
557 },
558 },
559 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
560 # This map is keyed with the name of the network interface.
561 &quot;a_key&quot;: {
562 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
563 # update or VM instance recreate operations.
564 # This flag is used to configure if the IP reservation should be deleted
565 # after it is no longer used by the group, e.g. when the given instance
566 # or the whole group is deleted.
567 &quot;ipAddress&quot;: { # Ip address representation
568 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
569 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
570 # network interface.
571 },
572 },
573 },
574 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
575 &quot;a_key&quot;: &quot;A String&quot;,
576 },
577 },
578 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
579 # managed instance.
580 },
581 ],
582 }
583
584 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
585 that if you must retry your request, the server will know to ignore the
586 request if it has already been completed.
587
588 For example, consider a situation where you make an initial request and
589 the request times out. If you make the request again with the same
590 request ID, the server can check if original operation with the same
591 request ID was received, and if so, will ignore the second request. This
592 prevents clients from accidentally creating duplicate commitments.
593
594 The request ID must be
595 a valid UUID with the exception that zero UUID is not supported
596 (00000000-0000-0000-0000-000000000000).
597 x__xgafv: string, V1 error format.
598 Allowed values
599 1 - v1 error format
600 2 - v2 error format
601
602 Returns:
603 An object of the form:
604
605 { # Represents an Operation resource.
606 #
607 # Google Compute Engine has three Operation resources:
608 #
609 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
610 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
611 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
612 #
613 # You can use an operation resource to manage asynchronous API requests.
614 # For more information, readHandling
615 # API responses.
616 #
617 # Operations can be global, regional or zonal.
618 #
619 # - For global operations, use the `globalOperations`
620 # resource.
621 # - For regional operations, use the
622 # `regionOperations` resource.
623 # - For zonal operations, use
624 # the `zoneOperations` resource.
625 #
626 #
627 #
628 # For more information, read
629 # Global, Regional, and Zonal Resources.
630 #
631 # Note that completed Operation resources have a limited
632 # retention period.
633 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
634 # Not present otherwise.
635 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
636 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
637 # set when the operation is created.
638 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
639 # text format.
640 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
641 # this field will be populated.
642 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
643 # operation.
644 {
645 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
646 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
647 # details. There is a set of defined message types to use for providing
648 # details.The syntax depends on the error code. For example,
649 # QuotaExceededInfo will have details when the error code is
650 # QUOTA_EXCEEDED.
651 {
652 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
653 #
654 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
655 # is not enabled:
656 #
657 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
658 # &quot;domain&quot;: &quot;googleapis.com&quot;
659 # &quot;metadata&quot;: {
660 # &quot;resource&quot;: &quot;projects/123&quot;,
661 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
662 # }
663 # }
664 #
665 # This response indicates that the pubsub.googleapis.com API is not enabled.
666 #
667 # Example of an error that is returned when attempting to create a Spanner
668 # instance in a region that is out of stock:
669 #
670 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
671 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
672 # &quot;metadata&quot;: {
673 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
674 # }
675 # }
676 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
677 # is typically the registered service name of the tool or product that
678 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
679 # generated by some common infrastructure, the error domain must be a
680 # globally unique value that identifies the infrastructure. For Google API
681 # infrastructure, the error domain is &quot;googleapis.com&quot;.
682 &quot;metadatas&quot;: { # Additional structured details about this error.
683 #
684 # Keys must match a regular expression of `a-z+` but should
685 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
686 # length. When identifying the current value of an exceeded limit, the units
687 # should be contained in the key, not the value. For example, rather than
688 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
689 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
690 # instances that can be created in a single (batch) request.
691 &quot;a_key&quot;: &quot;A String&quot;,
692 },
693 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
694 # proximate cause of the error. Error reasons are unique within a particular
695 # domain of errors. This should be at most 63 characters and match a
696 # regular expression of `A-Z+[A-Z0-9]`, which represents
697 # UPPER_SNAKE_CASE.
698 },
699 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
700 #
701 # For example, if a quota check failed with an error indicating the calling
702 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
703 # directly to the right place in the developer console to flip the bit.
704 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
705 { # Describes a URL link.
706 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
707 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
708 },
709 ],
710 },
711 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
712 # which can be attached to an RPC error.
713 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
714 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
715 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
716 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
717 },
718 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
719 &quot;dimensions&quot;: { # The map holding related quota dimensions.
720 &quot;a_key&quot;: &quot;A String&quot;,
721 },
722 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
723 # type or metric.
724 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
725 # or metric.
726 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
727 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
728 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
729 },
730 },
731 ],
732 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
733 # This property is optional.
734 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
735 },
736 ],
737 },
738 &quot;getVersionOperationMetadata&quot;: {
739 &quot;inlineSbomInfo&quot;: {
740 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
741 # appropriate identifiers.
742 &quot;a_key&quot;: &quot;A String&quot;,
743 },
744 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
745 # identifiers.
746 &quot;a_key&quot;: &quot;A String&quot;,
747 },
748 },
749 },
750 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
751 # message that was returned, such as `NOT FOUND`.
752 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
753 # status code that was returned. For example, a `404` means the
754 # resource was not found.
755 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
756 # defined by the server.
757 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
758 # This value is inRFC3339
759 # text format.
760 &quot;instancesBulkInsertOperationMetadata&quot;: {
761 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
762 # Example key: zones/us-central1-a
763 &quot;a_key&quot;: {
764 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
765 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
766 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
767 # error.
768 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
769 # if the flow is rolling forward or rolling back.
770 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
771 },
772 },
773 },
774 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
775 # Operation resources.
776 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
777 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
778 # group of operations results from a `bulkInsert` API request.
779 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
780 # `update`, or `delete`, and so on.
781 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
782 # There is no requirement that this be linear or support any granularity of
783 # operations. This should not be used to guess when the operation will be
784 # complete. This number should monotonically increase as the operation
785 # progresses.
786 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
787 # applicable when performing regional operations.
788 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
789 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
790 # this field will contain information on all underlying zonal actions and
791 # their state.
792 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
793 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
794 # Example key: zones/us-central1-a
795 &quot;a_key&quot;: {
796 &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
797 # populated.
798 # different programming environments, including REST APIs and RPC APIs. It is
799 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
800 # three pieces of data: error code, error message, and error details.
801 #
802 # You can find out more about this error model and how to work with it in the
803 # [API Design Guide](https://cloud.google.com/apis/design/errors).
804 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
805 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
806 # message types for APIs to use.
807 {
808 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
809 },
810 ],
811 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
812 # user-facing error message should be localized and sent in the
813 # google.rpc.Status.details field, or localized by the client.
814 },
815 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
816 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
817 },
818 },
819 },
820 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
821 # This value is inRFC3339
822 # text format.
823 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
824 # following:
825 # `PENDING`, `RUNNING`, or `DONE`.
826 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
827 # operation.
828 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
829 # of the target resource.
830 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
831 # operations related to creating a snapshot, this points to the disk
832 # that the snapshot was created from.
833 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
834 # `[email protected]` or
835 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
836 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
837 # operation, this field will be populated.
838 {
839 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
840 # Engine returns NO_RESULTS_ON_PAGE if there
841 # are no results in the response.
842 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
843 # value format. For example:
844 #
845 # &quot;data&quot;: [
846 # {
847 # &quot;key&quot;: &quot;scope&quot;,
848 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
849 # }
850 {
851 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
852 # returned. For example, for warnings where there are no results in a list
853 # request for a particular zone, this key might be scope and
854 # the key value might be the zone name. Other examples might be a key
855 # indicating a deprecated resource and a suggested replacement, or a
856 # warning about invalid network settings (for example, if an instance
857 # attempts to perform IP forwarding but is not enabled for IP forwarding).
858 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
859 },
860 ],
861 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
862 },
863 ],
864 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
865 # applicable when performing per-zone operations.
866 }</pre>
867 </div>
868
869 <div class="method">
870 <code class="details" id="applyUpdatesToInstances">applyUpdatesToInstances(project, region, instanceGroupManager, body=None, x__xgafv=None)</code>
871 <pre>Apply updates to selected instances the managed instance group.
872
873 Args:
874 project: string, Project ID for this request. (required)
875 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
876 instanceGroupManager: string, The name of the managed instance group, should conform to RFC1035. (required)
877 body: object, The request body.
878 The object takes the form of:
879
880 { # RegionInstanceGroupManagers.applyUpdatesToInstances
881 &quot;allInstances&quot;: True or False, # Flag to update all instances instead of specified list of “instances”.
882 # If the flag is set to true then the instances may not be specified
883 # in the request.
884 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
885 &quot;A String&quot;,
886 ],
887 &quot;instances&quot;: [ # The list of URLs of one or more instances for which you want to apply
888 # updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].
889 &quot;A String&quot;,
890 ],
891 &quot;minimalAction&quot;: &quot;A String&quot;, # The minimal action that you want to perform on each instance during the
892 # update:
893 #
894 #
895 # - REPLACE: At minimum, delete the instance and create it
896 # again.
897 # - RESTART: Stop the instance and start it
898 # again.
899 # - REFRESH: Do not stop the instance and limit
900 # disruption as much as possible.
901 # - NONE: Do not
902 # disrupt the instance at all.
903 #
904 #
905 # By default, the minimum action is NONE. If your update
906 # requires a more disruptive action than you set with this flag, the
907 # necessary action is performed to execute the update.
908 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # The most disruptive action that you want to perform on each instance during
909 # the update:
910 #
911 #
912 # - REPLACE: Delete the instance and create it again.
913 # - RESTART: Stop the instance and start it again.
914 # - REFRESH: Do not stop the instance and limit disruption
915 # as much as possible.
916 # - NONE: Do not disrupt the
917 # instance at all.
918 #
919 #
920 # By default, the most disruptive allowed action is REPLACE. If
921 # your update requires a more disruptive action than you set with this flag,
922 # the update request will fail.
923 }
924
925 x__xgafv: string, V1 error format.
926 Allowed values
927 1 - v1 error format
928 2 - v2 error format
929
930 Returns:
931 An object of the form:
932
933 { # Represents an Operation resource.
934 #
935 # Google Compute Engine has three Operation resources:
936 #
937 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
938 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
939 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
940 #
941 # You can use an operation resource to manage asynchronous API requests.
942 # For more information, readHandling
943 # API responses.
944 #
945 # Operations can be global, regional or zonal.
946 #
947 # - For global operations, use the `globalOperations`
948 # resource.
949 # - For regional operations, use the
950 # `regionOperations` resource.
951 # - For zonal operations, use
952 # the `zoneOperations` resource.
953 #
954 #
955 #
956 # For more information, read
957 # Global, Regional, and Zonal Resources.
958 #
959 # Note that completed Operation resources have a limited
960 # retention period.
961 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
962 # Not present otherwise.
963 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
964 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
965 # set when the operation is created.
966 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
967 # text format.
968 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
969 # this field will be populated.
970 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
971 # operation.
972 {
973 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
974 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
975 # details. There is a set of defined message types to use for providing
976 # details.The syntax depends on the error code. For example,
977 # QuotaExceededInfo will have details when the error code is
978 # QUOTA_EXCEEDED.
979 {
980 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
981 #
982 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
983 # is not enabled:
984 #
985 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
986 # &quot;domain&quot;: &quot;googleapis.com&quot;
987 # &quot;metadata&quot;: {
988 # &quot;resource&quot;: &quot;projects/123&quot;,
989 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
990 # }
991 # }
992 #
993 # This response indicates that the pubsub.googleapis.com API is not enabled.
994 #
995 # Example of an error that is returned when attempting to create a Spanner
996 # instance in a region that is out of stock:
997 #
998 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
999 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1000 # &quot;metadata&quot;: {
1001 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1002 # }
1003 # }
1004 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1005 # is typically the registered service name of the tool or product that
1006 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1007 # generated by some common infrastructure, the error domain must be a
1008 # globally unique value that identifies the infrastructure. For Google API
1009 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1010 &quot;metadatas&quot;: { # Additional structured details about this error.
1011 #
1012 # Keys must match a regular expression of `a-z+` but should
1013 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1014 # length. When identifying the current value of an exceeded limit, the units
1015 # should be contained in the key, not the value. For example, rather than
1016 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1017 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1018 # instances that can be created in a single (batch) request.
1019 &quot;a_key&quot;: &quot;A String&quot;,
1020 },
1021 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1022 # proximate cause of the error. Error reasons are unique within a particular
1023 # domain of errors. This should be at most 63 characters and match a
1024 # regular expression of `A-Z+[A-Z0-9]`, which represents
1025 # UPPER_SNAKE_CASE.
1026 },
1027 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1028 #
1029 # For example, if a quota check failed with an error indicating the calling
1030 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1031 # directly to the right place in the developer console to flip the bit.
1032 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1033 { # Describes a URL link.
1034 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1035 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1036 },
1037 ],
1038 },
1039 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1040 # which can be attached to an RPC error.
1041 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1042 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1043 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1044 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1045 },
1046 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1047 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1048 &quot;a_key&quot;: &quot;A String&quot;,
1049 },
1050 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1051 # type or metric.
1052 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1053 # or metric.
1054 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1055 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1056 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1057 },
1058 },
1059 ],
1060 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1061 # This property is optional.
1062 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1063 },
1064 ],
1065 },
1066 &quot;getVersionOperationMetadata&quot;: {
1067 &quot;inlineSbomInfo&quot;: {
1068 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1069 # appropriate identifiers.
1070 &quot;a_key&quot;: &quot;A String&quot;,
1071 },
1072 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1073 # identifiers.
1074 &quot;a_key&quot;: &quot;A String&quot;,
1075 },
1076 },
1077 },
1078 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1079 # message that was returned, such as `NOT FOUND`.
1080 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1081 # status code that was returned. For example, a `404` means the
1082 # resource was not found.
1083 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1084 # defined by the server.
1085 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1086 # This value is inRFC3339
1087 # text format.
1088 &quot;instancesBulkInsertOperationMetadata&quot;: {
1089 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1090 # Example key: zones/us-central1-a
1091 &quot;a_key&quot;: {
1092 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1093 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1094 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1095 # error.
1096 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1097 # if the flow is rolling forward or rolling back.
1098 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1099 },
1100 },
1101 },
1102 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1103 # Operation resources.
1104 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1105 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1106 # group of operations results from a `bulkInsert` API request.
1107 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1108 # `update`, or `delete`, and so on.
1109 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1110 # There is no requirement that this be linear or support any granularity of
1111 # operations. This should not be used to guess when the operation will be
1112 # complete. This number should monotonically increase as the operation
1113 # progresses.
1114 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1115 # applicable when performing regional operations.
1116 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1117 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1118 # this field will contain information on all underlying zonal actions and
1119 # their state.
1120 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1121 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1122 # Example key: zones/us-central1-a
1123 &quot;a_key&quot;: {
1124 &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
1125 # populated.
1126 # different programming environments, including REST APIs and RPC APIs. It is
1127 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1128 # three pieces of data: error code, error message, and error details.
1129 #
1130 # You can find out more about this error model and how to work with it in the
1131 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1132 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1133 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1134 # message types for APIs to use.
1135 {
1136 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1137 },
1138 ],
1139 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1140 # user-facing error message should be localized and sent in the
1141 # google.rpc.Status.details field, or localized by the client.
1142 },
1143 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1144 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1145 },
1146 },
1147 },
1148 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1149 # This value is inRFC3339
1150 # text format.
1151 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1152 # following:
1153 # `PENDING`, `RUNNING`, or `DONE`.
1154 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1155 # operation.
1156 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1157 # of the target resource.
1158 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1159 # operations related to creating a snapshot, this points to the disk
1160 # that the snapshot was created from.
1161 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1162 # `[email protected]` or
1163 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1164 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1165 # operation, this field will be populated.
1166 {
1167 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1168 # Engine returns NO_RESULTS_ON_PAGE if there
1169 # are no results in the response.
1170 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1171 # value format. For example:
1172 #
1173 # &quot;data&quot;: [
1174 # {
1175 # &quot;key&quot;: &quot;scope&quot;,
1176 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1177 # }
1178 {
1179 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1180 # returned. For example, for warnings where there are no results in a list
1181 # request for a particular zone, this key might be scope and
1182 # the key value might be the zone name. Other examples might be a key
1183 # indicating a deprecated resource and a suggested replacement, or a
1184 # warning about invalid network settings (for example, if an instance
1185 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1186 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1187 },
1188 ],
1189 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1190 },
1191 ],
1192 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1193 # applicable when performing per-zone operations.
1194 }</pre>
1195 </div>
1196
1197 <div class="method">
1198 <code class="details" id="close">close()</code>
1199 <pre>Close httplib2 connections.</pre>
1200 </div>
1201
1202 <div class="method">
1203 <code class="details" id="createInstances">createInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
1204 <pre>Creates instances with per-instance configurations in this regional managed
1205 instance group. Instances are created using the current instance template.
1206 The create instances operation is marked DONE if
1207 the createInstances request is successful. The underlying
1208 actions take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances
1209 method.
1210
1211 Args:
1212 project: string, Project ID for this request. (required)
1213 region: string, The name of theregion
1214 where the managed instance group is located.
1215 It should conform to RFC1035. (required)
1216 instanceGroupManager: string, The name of the managed instance group.
1217 It should conform to RFC1035. (required)
1218 body: object, The request body.
1219 The object takes the form of:
1220
1221 { # RegionInstanceGroupManagers.createInstances
1222 &quot;instances&quot;: [ # [Required] List of specifications of per-instance configs.
1223 {
1224 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
1225 # optimistic locking. It is ignored when inserting a per-instance
1226 # config. An up-to-date fingerprint must be provided in order to update an
1227 # existing per-instance configuration or the field needs to be unset.
1228 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
1229 # Serves as a merge key during UpdatePerInstanceConfigs
1230 # operations, that is, if a per-instance configuration with the same name
1231 # exists then it will be updated, otherwise a new one will be created for the
1232 # VM instance with the same name. An attempt to create a per-instance
1233 # configuration for a VM instance that either doesn&#x27;t exist or is not part
1234 # of the group will result in an error.
1235 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
1236 # preserved state generated from a stateful policy.
1237 &quot;disks&quot;: { # Preserved disks defined for this instance.
1238 # This map is keyed with the device names of the disks.
1239 &quot;a_key&quot;: {
1240 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
1241 # update, instance recreate operations. This flag is used to configure
1242 # if the disk should be deleted after it is no longer used by the group,
1243 # e.g. when the given instance or the whole MIG is deleted.
1244 # Note: disks attached in READ_ONLY mode cannot be
1245 # auto-deleted.
1246 &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
1247 # disk in READ_WRITE mode.
1248 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
1249 # to the VM instance.
1250 },
1251 },
1252 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
1253 # This map is keyed with the name of the network interface.
1254 &quot;a_key&quot;: {
1255 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1256 # update or VM instance recreate operations.
1257 # This flag is used to configure if the IP reservation should be deleted
1258 # after it is no longer used by the group, e.g. when the given instance
1259 # or the whole group is deleted.
1260 &quot;ipAddress&quot;: { # Ip address representation
1261 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1262 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1263 # network interface.
1264 },
1265 },
1266 },
1267 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
1268 # This map is keyed with the name of the network interface.
1269 &quot;a_key&quot;: {
1270 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1271 # update or VM instance recreate operations.
1272 # This flag is used to configure if the IP reservation should be deleted
1273 # after it is no longer used by the group, e.g. when the given instance
1274 # or the whole group is deleted.
1275 &quot;ipAddress&quot;: { # Ip address representation
1276 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1277 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1278 # network interface.
1279 },
1280 },
1281 },
1282 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
1283 &quot;a_key&quot;: &quot;A String&quot;,
1284 },
1285 },
1286 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
1287 # managed instance.
1288 },
1289 ],
1290 }
1291
1292 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1293 that if you must retry your request, the server will know to ignore the
1294 request if it has already been completed.
1295
1296 For example, consider a situation where you make an initial request and
1297 the request times out. If you make the request again with the same
1298 request ID, the server can check if original operation with the same
1299 request ID was received, and if so, will ignore the second request.
1300
1301 The request ID must be
1302 a valid UUID with the exception that zero UUID is not supported
1303 (00000000-0000-0000-0000-000000000000).
1304 x__xgafv: string, V1 error format.
1305 Allowed values
1306 1 - v1 error format
1307 2 - v2 error format
1308
1309 Returns:
1310 An object of the form:
1311
1312 { # Represents an Operation resource.
1313 #
1314 # Google Compute Engine has three Operation resources:
1315 #
1316 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
1317 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
1318 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
1319 #
1320 # You can use an operation resource to manage asynchronous API requests.
1321 # For more information, readHandling
1322 # API responses.
1323 #
1324 # Operations can be global, regional or zonal.
1325 #
1326 # - For global operations, use the `globalOperations`
1327 # resource.
1328 # - For regional operations, use the
1329 # `regionOperations` resource.
1330 # - For zonal operations, use
1331 # the `zoneOperations` resource.
1332 #
1333 #
1334 #
1335 # For more information, read
1336 # Global, Regional, and Zonal Resources.
1337 #
1338 # Note that completed Operation resources have a limited
1339 # retention period.
1340 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1341 # Not present otherwise.
1342 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1343 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1344 # set when the operation is created.
1345 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1346 # text format.
1347 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1348 # this field will be populated.
1349 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1350 # operation.
1351 {
1352 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1353 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1354 # details. There is a set of defined message types to use for providing
1355 # details.The syntax depends on the error code. For example,
1356 # QuotaExceededInfo will have details when the error code is
1357 # QUOTA_EXCEEDED.
1358 {
1359 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1360 #
1361 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1362 # is not enabled:
1363 #
1364 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1365 # &quot;domain&quot;: &quot;googleapis.com&quot;
1366 # &quot;metadata&quot;: {
1367 # &quot;resource&quot;: &quot;projects/123&quot;,
1368 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1369 # }
1370 # }
1371 #
1372 # This response indicates that the pubsub.googleapis.com API is not enabled.
1373 #
1374 # Example of an error that is returned when attempting to create a Spanner
1375 # instance in a region that is out of stock:
1376 #
1377 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1378 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1379 # &quot;metadata&quot;: {
1380 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1381 # }
1382 # }
1383 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1384 # is typically the registered service name of the tool or product that
1385 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1386 # generated by some common infrastructure, the error domain must be a
1387 # globally unique value that identifies the infrastructure. For Google API
1388 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1389 &quot;metadatas&quot;: { # Additional structured details about this error.
1390 #
1391 # Keys must match a regular expression of `a-z+` but should
1392 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1393 # length. When identifying the current value of an exceeded limit, the units
1394 # should be contained in the key, not the value. For example, rather than
1395 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1396 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1397 # instances that can be created in a single (batch) request.
1398 &quot;a_key&quot;: &quot;A String&quot;,
1399 },
1400 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1401 # proximate cause of the error. Error reasons are unique within a particular
1402 # domain of errors. This should be at most 63 characters and match a
1403 # regular expression of `A-Z+[A-Z0-9]`, which represents
1404 # UPPER_SNAKE_CASE.
1405 },
1406 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1407 #
1408 # For example, if a quota check failed with an error indicating the calling
1409 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1410 # directly to the right place in the developer console to flip the bit.
1411 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1412 { # Describes a URL link.
1413 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1414 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1415 },
1416 ],
1417 },
1418 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1419 # which can be attached to an RPC error.
1420 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1421 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1422 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1423 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1424 },
1425 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1426 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1427 &quot;a_key&quot;: &quot;A String&quot;,
1428 },
1429 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1430 # type or metric.
1431 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1432 # or metric.
1433 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1434 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1435 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1436 },
1437 },
1438 ],
1439 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1440 # This property is optional.
1441 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1442 },
1443 ],
1444 },
1445 &quot;getVersionOperationMetadata&quot;: {
1446 &quot;inlineSbomInfo&quot;: {
1447 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1448 # appropriate identifiers.
1449 &quot;a_key&quot;: &quot;A String&quot;,
1450 },
1451 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1452 # identifiers.
1453 &quot;a_key&quot;: &quot;A String&quot;,
1454 },
1455 },
1456 },
1457 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1458 # message that was returned, such as `NOT FOUND`.
1459 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1460 # status code that was returned. For example, a `404` means the
1461 # resource was not found.
1462 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1463 # defined by the server.
1464 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1465 # This value is inRFC3339
1466 # text format.
1467 &quot;instancesBulkInsertOperationMetadata&quot;: {
1468 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1469 # Example key: zones/us-central1-a
1470 &quot;a_key&quot;: {
1471 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1472 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1473 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1474 # error.
1475 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1476 # if the flow is rolling forward or rolling back.
1477 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1478 },
1479 },
1480 },
1481 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1482 # Operation resources.
1483 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1484 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1485 # group of operations results from a `bulkInsert` API request.
1486 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1487 # `update`, or `delete`, and so on.
1488 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1489 # There is no requirement that this be linear or support any granularity of
1490 # operations. This should not be used to guess when the operation will be
1491 # complete. This number should monotonically increase as the operation
1492 # progresses.
1493 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1494 # applicable when performing regional operations.
1495 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1496 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1497 # this field will contain information on all underlying zonal actions and
1498 # their state.
1499 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1500 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1501 # Example key: zones/us-central1-a
1502 &quot;a_key&quot;: {
1503 &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
1504 # populated.
1505 # different programming environments, including REST APIs and RPC APIs. It is
1506 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1507 # three pieces of data: error code, error message, and error details.
1508 #
1509 # You can find out more about this error model and how to work with it in the
1510 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1511 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1512 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1513 # message types for APIs to use.
1514 {
1515 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1516 },
1517 ],
1518 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1519 # user-facing error message should be localized and sent in the
1520 # google.rpc.Status.details field, or localized by the client.
1521 },
1522 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1523 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1524 },
1525 },
1526 },
1527 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1528 # This value is inRFC3339
1529 # text format.
1530 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1531 # following:
1532 # `PENDING`, `RUNNING`, or `DONE`.
1533 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1534 # operation.
1535 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1536 # of the target resource.
1537 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1538 # operations related to creating a snapshot, this points to the disk
1539 # that the snapshot was created from.
1540 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1541 # `[email protected]` or
1542 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1543 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1544 # operation, this field will be populated.
1545 {
1546 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1547 # Engine returns NO_RESULTS_ON_PAGE if there
1548 # are no results in the response.
1549 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1550 # value format. For example:
1551 #
1552 # &quot;data&quot;: [
1553 # {
1554 # &quot;key&quot;: &quot;scope&quot;,
1555 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1556 # }
1557 {
1558 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1559 # returned. For example, for warnings where there are no results in a list
1560 # request for a particular zone, this key might be scope and
1561 # the key value might be the zone name. Other examples might be a key
1562 # indicating a deprecated resource and a suggested replacement, or a
1563 # warning about invalid network settings (for example, if an instance
1564 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1565 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1566 },
1567 ],
1568 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1569 },
1570 ],
1571 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1572 # applicable when performing per-zone operations.
1573 }</pre>
1574 </div>
1575
1576 <div class="method">
1577 <code class="details" id="delete">delete(project, region, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
1578 <pre>Deletes the specified managed instance group and all of the instances
1579 in that group.
1580
1581 Args:
1582 project: string, Project ID for this request. (required)
1583 region: string, Name of the region scoping this request. (required)
1584 instanceGroupManager: string, Name of the managed instance group to delete. (required)
1585 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it&#x27;s
1586 configured for the instances.
1587 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1588 that if you must retry your request, the server will know to ignore the
1589 request if it has already been completed.
1590
1591 For example, consider a situation where you make an initial request and
1592 the request times out. If you make the request again with the same
1593 request ID, the server can check if original operation with the same
1594 request ID was received, and if so, will ignore the second request. This
1595 prevents clients from accidentally creating duplicate commitments.
1596
1597 The request ID must be
1598 a valid UUID with the exception that zero UUID is not supported
1599 (00000000-0000-0000-0000-000000000000).
1600 x__xgafv: string, V1 error format.
1601 Allowed values
1602 1 - v1 error format
1603 2 - v2 error format
1604
1605 Returns:
1606 An object of the form:
1607
1608 { # Represents an Operation resource.
1609 #
1610 # Google Compute Engine has three Operation resources:
1611 #
1612 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
1613 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
1614 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
1615 #
1616 # You can use an operation resource to manage asynchronous API requests.
1617 # For more information, readHandling
1618 # API responses.
1619 #
1620 # Operations can be global, regional or zonal.
1621 #
1622 # - For global operations, use the `globalOperations`
1623 # resource.
1624 # - For regional operations, use the
1625 # `regionOperations` resource.
1626 # - For zonal operations, use
1627 # the `zoneOperations` resource.
1628 #
1629 #
1630 #
1631 # For more information, read
1632 # Global, Regional, and Zonal Resources.
1633 #
1634 # Note that completed Operation resources have a limited
1635 # retention period.
1636 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1637 # Not present otherwise.
1638 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1639 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1640 # set when the operation is created.
1641 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1642 # text format.
1643 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1644 # this field will be populated.
1645 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1646 # operation.
1647 {
1648 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1649 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1650 # details. There is a set of defined message types to use for providing
1651 # details.The syntax depends on the error code. For example,
1652 # QuotaExceededInfo will have details when the error code is
1653 # QUOTA_EXCEEDED.
1654 {
1655 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1656 #
1657 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1658 # is not enabled:
1659 #
1660 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1661 # &quot;domain&quot;: &quot;googleapis.com&quot;
1662 # &quot;metadata&quot;: {
1663 # &quot;resource&quot;: &quot;projects/123&quot;,
1664 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1665 # }
1666 # }
1667 #
1668 # This response indicates that the pubsub.googleapis.com API is not enabled.
1669 #
1670 # Example of an error that is returned when attempting to create a Spanner
1671 # instance in a region that is out of stock:
1672 #
1673 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1674 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1675 # &quot;metadata&quot;: {
1676 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1677 # }
1678 # }
1679 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1680 # is typically the registered service name of the tool or product that
1681 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1682 # generated by some common infrastructure, the error domain must be a
1683 # globally unique value that identifies the infrastructure. For Google API
1684 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1685 &quot;metadatas&quot;: { # Additional structured details about this error.
1686 #
1687 # Keys must match a regular expression of `a-z+` but should
1688 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1689 # length. When identifying the current value of an exceeded limit, the units
1690 # should be contained in the key, not the value. For example, rather than
1691 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1692 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1693 # instances that can be created in a single (batch) request.
1694 &quot;a_key&quot;: &quot;A String&quot;,
1695 },
1696 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1697 # proximate cause of the error. Error reasons are unique within a particular
1698 # domain of errors. This should be at most 63 characters and match a
1699 # regular expression of `A-Z+[A-Z0-9]`, which represents
1700 # UPPER_SNAKE_CASE.
1701 },
1702 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1703 #
1704 # For example, if a quota check failed with an error indicating the calling
1705 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1706 # directly to the right place in the developer console to flip the bit.
1707 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1708 { # Describes a URL link.
1709 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1710 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1711 },
1712 ],
1713 },
1714 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1715 # which can be attached to an RPC error.
1716 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1717 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1718 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1719 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1720 },
1721 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1722 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1723 &quot;a_key&quot;: &quot;A String&quot;,
1724 },
1725 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1726 # type or metric.
1727 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1728 # or metric.
1729 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1730 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1731 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1732 },
1733 },
1734 ],
1735 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1736 # This property is optional.
1737 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1738 },
1739 ],
1740 },
1741 &quot;getVersionOperationMetadata&quot;: {
1742 &quot;inlineSbomInfo&quot;: {
1743 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1744 # appropriate identifiers.
1745 &quot;a_key&quot;: &quot;A String&quot;,
1746 },
1747 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1748 # identifiers.
1749 &quot;a_key&quot;: &quot;A String&quot;,
1750 },
1751 },
1752 },
1753 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1754 # message that was returned, such as `NOT FOUND`.
1755 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1756 # status code that was returned. For example, a `404` means the
1757 # resource was not found.
1758 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1759 # defined by the server.
1760 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1761 # This value is inRFC3339
1762 # text format.
1763 &quot;instancesBulkInsertOperationMetadata&quot;: {
1764 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1765 # Example key: zones/us-central1-a
1766 &quot;a_key&quot;: {
1767 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1768 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1769 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1770 # error.
1771 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1772 # if the flow is rolling forward or rolling back.
1773 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1774 },
1775 },
1776 },
1777 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1778 # Operation resources.
1779 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1780 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1781 # group of operations results from a `bulkInsert` API request.
1782 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1783 # `update`, or `delete`, and so on.
1784 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1785 # There is no requirement that this be linear or support any granularity of
1786 # operations. This should not be used to guess when the operation will be
1787 # complete. This number should monotonically increase as the operation
1788 # progresses.
1789 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1790 # applicable when performing regional operations.
1791 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1792 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1793 # this field will contain information on all underlying zonal actions and
1794 # their state.
1795 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1796 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1797 # Example key: zones/us-central1-a
1798 &quot;a_key&quot;: {
1799 &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
1800 # populated.
1801 # different programming environments, including REST APIs and RPC APIs. It is
1802 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1803 # three pieces of data: error code, error message, and error details.
1804 #
1805 # You can find out more about this error model and how to work with it in the
1806 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1807 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1808 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1809 # message types for APIs to use.
1810 {
1811 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1812 },
1813 ],
1814 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1815 # user-facing error message should be localized and sent in the
1816 # google.rpc.Status.details field, or localized by the client.
1817 },
1818 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1819 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1820 },
1821 },
1822 },
1823 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1824 # This value is inRFC3339
1825 # text format.
1826 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1827 # following:
1828 # `PENDING`, `RUNNING`, or `DONE`.
1829 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1830 # operation.
1831 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1832 # of the target resource.
1833 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1834 # operations related to creating a snapshot, this points to the disk
1835 # that the snapshot was created from.
1836 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1837 # `[email protected]` or
1838 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1839 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1840 # operation, this field will be populated.
1841 {
1842 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1843 # Engine returns NO_RESULTS_ON_PAGE if there
1844 # are no results in the response.
1845 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1846 # value format. For example:
1847 #
1848 # &quot;data&quot;: [
1849 # {
1850 # &quot;key&quot;: &quot;scope&quot;,
1851 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1852 # }
1853 {
1854 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1855 # returned. For example, for warnings where there are no results in a list
1856 # request for a particular zone, this key might be scope and
1857 # the key value might be the zone name. Other examples might be a key
1858 # indicating a deprecated resource and a suggested replacement, or a
1859 # warning about invalid network settings (for example, if an instance
1860 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1861 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1862 },
1863 ],
1864 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1865 },
1866 ],
1867 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1868 # applicable when performing per-zone operations.
1869 }</pre>
1870 </div>
1871
1872 <div class="method">
1873 <code class="details" id="deleteInstances">deleteInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
1874 <pre>Flags the specified instances in the managed instance group to be
1875 immediately deleted. The instances are also removed from any target
1876 pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of
1877 instances that you delete.
1878 The deleteInstances operation is marked DONE if
1879 the deleteInstances request is successful. The underlying
1880 actions take additional time. You must separately verify the status of thedeleting action with thelistmanagedinstances
1881 method.
1882
1883 If the group is part of a backend
1884 service that has enabled
1885 connection draining, it can take up to 60 seconds after the connection
1886 draining duration has elapsed before the VM instance is removed or deleted.
1887
1888 You can specify a maximum of 1000 instances with this method per request.
1889
1890 Args:
1891 project: string, Project ID for this request. (required)
1892 region: string, Name of the region scoping this request. (required)
1893 instanceGroupManager: string, Name of the managed instance group. (required)
1894 body: object, The request body.
1895 The object takes the form of:
1896
1897 {
1898 &quot;instances&quot;: [ # The URLs of one or more instances to delete. This can be a full URL or
1899 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
1900 &quot;A String&quot;,
1901 ],
1902 &quot;skipInstancesOnValidationError&quot;: True or False, # Specifies whether the request should proceed despite the inclusion of
1903 # instances that are not members of the group or that are already in the
1904 # process of being deleted or abandoned. If this field is set to `false` and
1905 # such an instance is specified in the request, the operation fails. The
1906 # operation always fails if the request contains a malformed instance URL or
1907 # a reference to an instance that exists in a zone or region other than the
1908 # group&#x27;s zone or region.
1909 }
1910
1911 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it&#x27;s
1912 configured for the instances.
1913 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1914 that if you must retry your request, the server will know to ignore the
1915 request if it has already been completed.
1916
1917 For example, consider a situation where you make an initial request and
1918 the request times out. If you make the request again with the same
1919 request ID, the server can check if original operation with the same
1920 request ID was received, and if so, will ignore the second request. This
1921 prevents clients from accidentally creating duplicate commitments.
1922
1923 The request ID must be
1924 a valid UUID with the exception that zero UUID is not supported
1925 (00000000-0000-0000-0000-000000000000).
1926 x__xgafv: string, V1 error format.
1927 Allowed values
1928 1 - v1 error format
1929 2 - v2 error format
1930
1931 Returns:
1932 An object of the form:
1933
1934 { # Represents an Operation resource.
1935 #
1936 # Google Compute Engine has three Operation resources:
1937 #
1938 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
1939 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
1940 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
1941 #
1942 # You can use an operation resource to manage asynchronous API requests.
1943 # For more information, readHandling
1944 # API responses.
1945 #
1946 # Operations can be global, regional or zonal.
1947 #
1948 # - For global operations, use the `globalOperations`
1949 # resource.
1950 # - For regional operations, use the
1951 # `regionOperations` resource.
1952 # - For zonal operations, use
1953 # the `zoneOperations` resource.
1954 #
1955 #
1956 #
1957 # For more information, read
1958 # Global, Regional, and Zonal Resources.
1959 #
1960 # Note that completed Operation resources have a limited
1961 # retention period.
1962 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1963 # Not present otherwise.
1964 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1965 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1966 # set when the operation is created.
1967 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1968 # text format.
1969 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1970 # this field will be populated.
1971 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1972 # operation.
1973 {
1974 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1975 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1976 # details. There is a set of defined message types to use for providing
1977 # details.The syntax depends on the error code. For example,
1978 # QuotaExceededInfo will have details when the error code is
1979 # QUOTA_EXCEEDED.
1980 {
1981 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1982 #
1983 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1984 # is not enabled:
1985 #
1986 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1987 # &quot;domain&quot;: &quot;googleapis.com&quot;
1988 # &quot;metadata&quot;: {
1989 # &quot;resource&quot;: &quot;projects/123&quot;,
1990 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1991 # }
1992 # }
1993 #
1994 # This response indicates that the pubsub.googleapis.com API is not enabled.
1995 #
1996 # Example of an error that is returned when attempting to create a Spanner
1997 # instance in a region that is out of stock:
1998 #
1999 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2000 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2001 # &quot;metadata&quot;: {
2002 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2003 # }
2004 # }
2005 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2006 # is typically the registered service name of the tool or product that
2007 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2008 # generated by some common infrastructure, the error domain must be a
2009 # globally unique value that identifies the infrastructure. For Google API
2010 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2011 &quot;metadatas&quot;: { # Additional structured details about this error.
2012 #
2013 # Keys must match a regular expression of `a-z+` but should
2014 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2015 # length. When identifying the current value of an exceeded limit, the units
2016 # should be contained in the key, not the value. For example, rather than
2017 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2018 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2019 # instances that can be created in a single (batch) request.
2020 &quot;a_key&quot;: &quot;A String&quot;,
2021 },
2022 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2023 # proximate cause of the error. Error reasons are unique within a particular
2024 # domain of errors. This should be at most 63 characters and match a
2025 # regular expression of `A-Z+[A-Z0-9]`, which represents
2026 # UPPER_SNAKE_CASE.
2027 },
2028 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2029 #
2030 # For example, if a quota check failed with an error indicating the calling
2031 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2032 # directly to the right place in the developer console to flip the bit.
2033 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2034 { # Describes a URL link.
2035 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2036 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2037 },
2038 ],
2039 },
2040 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2041 # which can be attached to an RPC error.
2042 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2043 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2044 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2045 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2046 },
2047 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2048 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2049 &quot;a_key&quot;: &quot;A String&quot;,
2050 },
2051 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2052 # type or metric.
2053 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2054 # or metric.
2055 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2056 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2057 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2058 },
2059 },
2060 ],
2061 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2062 # This property is optional.
2063 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2064 },
2065 ],
2066 },
2067 &quot;getVersionOperationMetadata&quot;: {
2068 &quot;inlineSbomInfo&quot;: {
2069 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2070 # appropriate identifiers.
2071 &quot;a_key&quot;: &quot;A String&quot;,
2072 },
2073 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2074 # identifiers.
2075 &quot;a_key&quot;: &quot;A String&quot;,
2076 },
2077 },
2078 },
2079 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2080 # message that was returned, such as `NOT FOUND`.
2081 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2082 # status code that was returned. For example, a `404` means the
2083 # resource was not found.
2084 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2085 # defined by the server.
2086 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2087 # This value is inRFC3339
2088 # text format.
2089 &quot;instancesBulkInsertOperationMetadata&quot;: {
2090 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2091 # Example key: zones/us-central1-a
2092 &quot;a_key&quot;: {
2093 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2094 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2095 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2096 # error.
2097 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2098 # if the flow is rolling forward or rolling back.
2099 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2100 },
2101 },
2102 },
2103 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2104 # Operation resources.
2105 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2106 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2107 # group of operations results from a `bulkInsert` API request.
2108 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2109 # `update`, or `delete`, and so on.
2110 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2111 # There is no requirement that this be linear or support any granularity of
2112 # operations. This should not be used to guess when the operation will be
2113 # complete. This number should monotonically increase as the operation
2114 # progresses.
2115 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2116 # applicable when performing regional operations.
2117 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2118 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2119 # this field will contain information on all underlying zonal actions and
2120 # their state.
2121 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2122 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2123 # Example key: zones/us-central1-a
2124 &quot;a_key&quot;: {
2125 &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
2126 # populated.
2127 # different programming environments, including REST APIs and RPC APIs. It is
2128 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2129 # three pieces of data: error code, error message, and error details.
2130 #
2131 # You can find out more about this error model and how to work with it in the
2132 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2133 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2134 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2135 # message types for APIs to use.
2136 {
2137 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2138 },
2139 ],
2140 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2141 # user-facing error message should be localized and sent in the
2142 # google.rpc.Status.details field, or localized by the client.
2143 },
2144 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2145 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2146 },
2147 },
2148 },
2149 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2150 # This value is inRFC3339
2151 # text format.
2152 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2153 # following:
2154 # `PENDING`, `RUNNING`, or `DONE`.
2155 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2156 # operation.
2157 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2158 # of the target resource.
2159 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2160 # operations related to creating a snapshot, this points to the disk
2161 # that the snapshot was created from.
2162 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2163 # `[email protected]` or
2164 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2165 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2166 # operation, this field will be populated.
2167 {
2168 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2169 # Engine returns NO_RESULTS_ON_PAGE if there
2170 # are no results in the response.
2171 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2172 # value format. For example:
2173 #
2174 # &quot;data&quot;: [
2175 # {
2176 # &quot;key&quot;: &quot;scope&quot;,
2177 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2178 # }
2179 {
2180 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2181 # returned. For example, for warnings where there are no results in a list
2182 # request for a particular zone, this key might be scope and
2183 # the key value might be the zone name. Other examples might be a key
2184 # indicating a deprecated resource and a suggested replacement, or a
2185 # warning about invalid network settings (for example, if an instance
2186 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2187 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2188 },
2189 ],
2190 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2191 },
2192 ],
2193 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2194 # applicable when performing per-zone operations.
2195 }</pre>
2196 </div>
2197
2198 <div class="method">
2199 <code class="details" id="deletePerInstanceConfigs">deletePerInstanceConfigs(project, region, instanceGroupManager, body=None, x__xgafv=None)</code>
2200 <pre>Deletes selected per-instance configurations for the managed instance
2201 group.
2202
2203 Args:
2204 project: string, Project ID for this request. (required)
2205 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
2206 instanceGroupManager: string, The name of the managed instance group. It should conform to RFC1035. (required)
2207 body: object, The request body.
2208 The object takes the form of:
2209
2210 { # RegionInstanceGroupManagers.deletePerInstanceConfigs
2211 &quot;names&quot;: [ # The list of instance names for which we want to delete per-instance configs
2212 # on this managed instance group.
2213 &quot;A String&quot;,
2214 ],
2215 }
2216
2217 x__xgafv: string, V1 error format.
2218 Allowed values
2219 1 - v1 error format
2220 2 - v2 error format
2221
2222 Returns:
2223 An object of the form:
2224
2225 { # Represents an Operation resource.
2226 #
2227 # Google Compute Engine has three Operation resources:
2228 #
2229 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
2230 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
2231 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
2232 #
2233 # You can use an operation resource to manage asynchronous API requests.
2234 # For more information, readHandling
2235 # API responses.
2236 #
2237 # Operations can be global, regional or zonal.
2238 #
2239 # - For global operations, use the `globalOperations`
2240 # resource.
2241 # - For regional operations, use the
2242 # `regionOperations` resource.
2243 # - For zonal operations, use
2244 # the `zoneOperations` resource.
2245 #
2246 #
2247 #
2248 # For more information, read
2249 # Global, Regional, and Zonal Resources.
2250 #
2251 # Note that completed Operation resources have a limited
2252 # retention period.
2253 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2254 # Not present otherwise.
2255 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2256 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2257 # set when the operation is created.
2258 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2259 # text format.
2260 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2261 # this field will be populated.
2262 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2263 # operation.
2264 {
2265 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2266 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2267 # details. There is a set of defined message types to use for providing
2268 # details.The syntax depends on the error code. For example,
2269 # QuotaExceededInfo will have details when the error code is
2270 # QUOTA_EXCEEDED.
2271 {
2272 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2273 #
2274 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2275 # is not enabled:
2276 #
2277 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2278 # &quot;domain&quot;: &quot;googleapis.com&quot;
2279 # &quot;metadata&quot;: {
2280 # &quot;resource&quot;: &quot;projects/123&quot;,
2281 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2282 # }
2283 # }
2284 #
2285 # This response indicates that the pubsub.googleapis.com API is not enabled.
2286 #
2287 # Example of an error that is returned when attempting to create a Spanner
2288 # instance in a region that is out of stock:
2289 #
2290 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2291 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2292 # &quot;metadata&quot;: {
2293 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2294 # }
2295 # }
2296 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2297 # is typically the registered service name of the tool or product that
2298 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2299 # generated by some common infrastructure, the error domain must be a
2300 # globally unique value that identifies the infrastructure. For Google API
2301 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2302 &quot;metadatas&quot;: { # Additional structured details about this error.
2303 #
2304 # Keys must match a regular expression of `a-z+` but should
2305 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2306 # length. When identifying the current value of an exceeded limit, the units
2307 # should be contained in the key, not the value. For example, rather than
2308 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2309 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2310 # instances that can be created in a single (batch) request.
2311 &quot;a_key&quot;: &quot;A String&quot;,
2312 },
2313 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2314 # proximate cause of the error. Error reasons are unique within a particular
2315 # domain of errors. This should be at most 63 characters and match a
2316 # regular expression of `A-Z+[A-Z0-9]`, which represents
2317 # UPPER_SNAKE_CASE.
2318 },
2319 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2320 #
2321 # For example, if a quota check failed with an error indicating the calling
2322 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2323 # directly to the right place in the developer console to flip the bit.
2324 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2325 { # Describes a URL link.
2326 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2327 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2328 },
2329 ],
2330 },
2331 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2332 # which can be attached to an RPC error.
2333 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2334 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2335 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2336 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2337 },
2338 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2339 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2340 &quot;a_key&quot;: &quot;A String&quot;,
2341 },
2342 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2343 # type or metric.
2344 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2345 # or metric.
2346 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2347 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2348 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2349 },
2350 },
2351 ],
2352 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2353 # This property is optional.
2354 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2355 },
2356 ],
2357 },
2358 &quot;getVersionOperationMetadata&quot;: {
2359 &quot;inlineSbomInfo&quot;: {
2360 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2361 # appropriate identifiers.
2362 &quot;a_key&quot;: &quot;A String&quot;,
2363 },
2364 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2365 # identifiers.
2366 &quot;a_key&quot;: &quot;A String&quot;,
2367 },
2368 },
2369 },
2370 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2371 # message that was returned, such as `NOT FOUND`.
2372 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2373 # status code that was returned. For example, a `404` means the
2374 # resource was not found.
2375 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2376 # defined by the server.
2377 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2378 # This value is inRFC3339
2379 # text format.
2380 &quot;instancesBulkInsertOperationMetadata&quot;: {
2381 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2382 # Example key: zones/us-central1-a
2383 &quot;a_key&quot;: {
2384 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2385 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2386 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2387 # error.
2388 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2389 # if the flow is rolling forward or rolling back.
2390 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2391 },
2392 },
2393 },
2394 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2395 # Operation resources.
2396 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2397 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2398 # group of operations results from a `bulkInsert` API request.
2399 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2400 # `update`, or `delete`, and so on.
2401 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2402 # There is no requirement that this be linear or support any granularity of
2403 # operations. This should not be used to guess when the operation will be
2404 # complete. This number should monotonically increase as the operation
2405 # progresses.
2406 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2407 # applicable when performing regional operations.
2408 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2409 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2410 # this field will contain information on all underlying zonal actions and
2411 # their state.
2412 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2413 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2414 # Example key: zones/us-central1-a
2415 &quot;a_key&quot;: {
2416 &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
2417 # populated.
2418 # different programming environments, including REST APIs and RPC APIs. It is
2419 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2420 # three pieces of data: error code, error message, and error details.
2421 #
2422 # You can find out more about this error model and how to work with it in the
2423 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2424 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2425 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2426 # message types for APIs to use.
2427 {
2428 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2429 },
2430 ],
2431 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2432 # user-facing error message should be localized and sent in the
2433 # google.rpc.Status.details field, or localized by the client.
2434 },
2435 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2436 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2437 },
2438 },
2439 },
2440 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2441 # This value is inRFC3339
2442 # text format.
2443 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2444 # following:
2445 # `PENDING`, `RUNNING`, or `DONE`.
2446 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2447 # operation.
2448 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2449 # of the target resource.
2450 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2451 # operations related to creating a snapshot, this points to the disk
2452 # that the snapshot was created from.
2453 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2454 # `[email protected]` or
2455 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2456 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2457 # operation, this field will be populated.
2458 {
2459 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2460 # Engine returns NO_RESULTS_ON_PAGE if there
2461 # are no results in the response.
2462 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2463 # value format. For example:
2464 #
2465 # &quot;data&quot;: [
2466 # {
2467 # &quot;key&quot;: &quot;scope&quot;,
2468 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2469 # }
2470 {
2471 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2472 # returned. For example, for warnings where there are no results in a list
2473 # request for a particular zone, this key might be scope and
2474 # the key value might be the zone name. Other examples might be a key
2475 # indicating a deprecated resource and a suggested replacement, or a
2476 # warning about invalid network settings (for example, if an instance
2477 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2478 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2479 },
2480 ],
2481 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2482 },
2483 ],
2484 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2485 # applicable when performing per-zone operations.
2486 }</pre>
2487 </div>
2488
2489 <div class="method">
2490 <code class="details" id="get">get(project, region, instanceGroupManager, x__xgafv=None)</code>
2491 <pre>Returns all of the details about the specified managed instance group.
2492
2493 Args:
2494 project: string, Project ID for this request. (required)
2495 region: string, Name of the region scoping this request. (required)
2496 instanceGroupManager: string, Name of the managed instance group to return. (required)
2497 x__xgafv: string, V1 error format.
2498 Allowed values
2499 1 - v1 error format
2500 2 - v2 error format
2501
2502 Returns:
2503 An object of the form:
2504
2505 { # Represents a Managed Instance Group resource.
2506 #
2507 # An instance group is a collection of VM instances that you can manage as a
2508 # single entity. For more information, readInstance groups.
2509 #
2510 # For zonal Managed Instance Group, use the instanceGroupManagers
2511 # resource.
2512 #
2513 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
2514 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
2515 # for the group.
2516 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
2517 #
2518 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
2519 # instances to apply the configuration. To apply the configuration, set the
2520 # group&#x27;s updatePolicy.type field to use proactive updates or
2521 # use the applyUpdatesToInstances method.
2522 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
2523 &quot;a_key&quot;: &quot;A String&quot;,
2524 },
2525 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
2526 # more information, see Project and
2527 # instance metadata.
2528 &quot;a_key&quot;: &quot;A String&quot;,
2529 },
2530 },
2531 },
2532 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
2533 # only one value.
2534 {
2535 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
2536 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
2537 # initialize and run its startup script. During a VM&#x27;s initial delay
2538 # period, the MIG ignores unsuccessful health checks because the VM might
2539 # be in the startup process. This prevents the MIG from prematurely
2540 # recreating a VM. If the health check receives a healthy response during
2541 # the initial delay, it indicates that the startup process is complete and
2542 # the VM is ready. The value of initial delay must be between 0 and 3600
2543 # seconds. The default value is 0.
2544 },
2545 ],
2546 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
2547 # all VMs in a MIG. The maximum character length is 58 and the name must
2548 # comply with RFC1035 format.
2549 #
2550 # When a VM is created in the group, the MIG appends a hyphen and a random
2551 # four-character string to the base instance name. If you want the MIG to
2552 # assign sequential numbers instead of a random string, then end the base
2553 # instance name with a hyphen followed by one or more hash symbols. The hash
2554 # symbols indicate the number of digits. For example, a base instance name of
2555 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
2556 # @pattern
2557 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
2558 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
2559 # text format.
2560 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
2561 # in this managed instance group that are scheduled for each of those
2562 # actions.
2563 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
2564 # that are scheduled to be abandoned. Abandoning an instance removes it
2565 # from the managed instance group without deleting it.
2566 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
2567 # are scheduled to be adopted or are currently being adopted.
2568 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
2569 # are scheduled to be created or are currently being created. If the group
2570 # fails to create any of these instances, it tries again until it creates
2571 # the instance successfully.
2572 #
2573 # If you have disabled creation retries, this field will not be populated;
2574 # instead, the creatingWithoutRetries field will be populated.
2575 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
2576 # will attempt to create. The group attempts to create each instance
2577 # only once. If the group fails to create any of these instances, it
2578 # decreases the group&#x27;s targetSize value accordingly.
2579 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
2580 # are scheduled to be deleted or are currently being deleted.
2581 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
2582 # are running and have no scheduled actions.
2583 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
2584 # are scheduled to be recreated or are currently being being recreated.
2585 # Recreating an instance deletes the existing root persistent disk
2586 # and creates a new disk from the image that is defined in the
2587 # instance template.
2588 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
2589 # are being reconfigured with properties that do not require a restart
2590 # or a recreate action. For example, setting or removing target
2591 # pools for the instance.
2592 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
2593 # are scheduled to be restarted or are currently being restarted.
2594 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
2595 # are scheduled to be restarted or are currently being restarted.
2596 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
2597 # are scheduled to be resumed or are currently being resumed.
2598 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
2599 # are scheduled to be started or are currently being started.
2600 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
2601 # are scheduled to be stopped or are currently being stopped.
2602 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
2603 # are scheduled to be suspended or are currently being suspended.
2604 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
2605 # are being verified. See the managedInstances[].currentAction
2606 # property in the listManagedInstances method documentation.
2607 },
2608 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
2609 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
2610 # zones in a regional managed instance group.
2611 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
2612 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
2613 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
2614 # its instances.
2615 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
2616 # instances, even if an AI zone is available in the specified region. To
2617 # create instances in an AI zone in the selected region, you must explicitly
2618 # specify it in the distribution policy together with the other preferred
2619 # zones.
2620 {
2621 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
2622 # The zone must exist in the region where the managed instance group is
2623 # located.
2624 },
2625 ],
2626 },
2627 &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.
2628 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
2629 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
2630 # fingerprint must be provided in order to update the InstanceGroupManager,
2631 # otherwise the request will fail with error412 conditionNotMet.
2632 #
2633 # To see the latest fingerprint, make a get() request to
2634 # retrieve an InstanceGroupManager.
2635 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
2636 # generates this identifier.
2637 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
2638 # types of machines.
2639 # Instance flexibility configuration on MIG overrides instance
2640 # template configuration.
2641 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
2642 # when creating new VMs.
2643 &quot;a_key&quot;: {
2644 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
2645 # selection.
2646 { # An instance-attached disk resource.
2647 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
2648 # or X86_64.
2649 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
2650 # deleted (but not when the disk is detached from the instance).
2651 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
2652 # partition of the disk for its root filesystem.
2653 &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
2654 # running within the instance. This name can be used to reference the device
2655 # for mounting, resizing, and so on, from within the instance.
2656 #
2657 # If not specified, the server chooses a default device name to apply to this
2658 # disk, in the form persistent-disk-x, where x is a number
2659 # assigned by Google Compute Engine. This field is only applicable for
2660 # persistent disks.
2661 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
2662 # encryption key.
2663 #
2664 # If you are creating a new disk, this field encrypts the new disk using
2665 # an encryption key that you provide. If you are attaching an existing
2666 # disk that is already encrypted, this field decrypts the disk using
2667 # the customer-supplied encryption key.
2668 #
2669 # If you encrypt a disk using a customer-supplied key, you must provide the
2670 # same key again when you attempt to use this resource at a later time. For
2671 # example, you must provide the key when you create a snapshot or an image
2672 # from the disk or when you attach the disk to a virtual machine instance.
2673 #
2674 # If you do not provide an encryption key, then the disk will be encrypted
2675 # using an automatically generated key and you do not need to provide a key
2676 # to use the disk later.
2677 #
2678 # Note:
2679 #
2680 # Instance templates do not storecustomer-supplied
2681 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
2682 #
2683 # You cannot create VMs that have disks with customer-supplied keys using
2684 # the bulk
2685 # insert method.
2686 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2687 # For example:
2688 #
2689 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2690 # key_region/cryptoKeys/key
2691 #
2692 # The fully-qualifed key name may be returned for resource GET requests. For
2693 # example:
2694 #
2695 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2696 # key_region/cryptoKeys/key
2697 # /cryptoKeyVersions/1
2698 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2699 # key. If absent, the Compute Engine default service account is used.
2700 # For example:
2701 #
2702 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2703 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2704 # encryption key, encoded in RFC
2705 # 4648 base64 to either encrypt or decrypt this resource. You can
2706 # provide either the rawKey or thersaEncryptedKey.
2707 # For example:
2708 #
2709 # &quot;rawKey&quot;:
2710 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2711 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2712 # customer-supplied encryption key to either encrypt or decrypt this
2713 # resource. You can provide either the rawKey or thersaEncryptedKey.
2714 # For example:
2715 #
2716 # &quot;rsaEncryptedKey&quot;:
2717 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2718 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2719 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2720 #
2721 # The key must meet the following requirements before you can provide it to
2722 # Compute Engine:
2723 #
2724 # 1. The key is wrapped using a RSA public key certificate provided by
2725 # Google.
2726 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2727 # encoding.
2728 #
2729 # Gets the RSA public key certificate provided by Google at:
2730 #
2731 #
2732 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2733 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2734 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2735 # encryption key that protects this resource.
2736 },
2737 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
2738 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
2739 # currently attached to another instance. If you try to force attach a zonal
2740 # disk to an instance, you will receive an error.
2741 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2742 # only for bootable images. Read
2743 # Enabling guest operating system features to see a list of available
2744 # options.
2745 { # Guest OS features.
2746 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
2747 # separate values. Set to one or more of the following values:
2748 #
2749 # - VIRTIO_SCSI_MULTIQUEUE
2750 # - WINDOWS
2751 # - MULTI_IP_SUBNET
2752 # - UEFI_COMPATIBLE
2753 # - GVNIC
2754 # - SEV_CAPABLE
2755 # - SUSPEND_RESUME_COMPATIBLE
2756 # - SEV_LIVE_MIGRATABLE_V2
2757 # - SEV_SNP_CAPABLE
2758 # - TDX_CAPABLE
2759 # - IDPF
2760 # - SNP_SVSM_CAPABLE
2761 # - CCA_CAPABLE
2762 #
2763 #
2764 # For more information, see
2765 # Enabling guest operating system features.
2766 },
2767 ],
2768 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
2769 # boot disk. If you have many disks attached to an instance, each
2770 # disk would have a unique index number.
2771 &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
2772 # alongside the new instance. Use initialization parameters to create boot
2773 # disks or local SSDs attached to the new instance.
2774 #
2775 # This property is mutually exclusive with the source property;
2776 # you can only define one or the other, but not both.
2777 # alongside the new instance. Use initialization parameters to create boot
2778 # disks or local SSDs attached to the new instance.
2779 #
2780 # This field is persisted and returned for instanceTemplate and not returned
2781 # in the context of instance.
2782 #
2783 # This property is mutually exclusive with the source property;
2784 # you can only define one or the other, but not both.
2785 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
2786 # arm64 or x86_64.
2787 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
2788 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
2789 # of the instance. If a disk with the same name already exists in the given
2790 # region, the existing disk is attached to the new instance and the
2791 # new disk is not created.
2792 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
2793 # 10 GB. If you specify a sourceImage, which is required for
2794 # boot disks, the default size is the size of the sourceImage.
2795 # If you do not specify a sourceImage, the default disk size
2796 # is 500 GB.
2797 &quot;diskType&quot;: &quot;A String&quot;,
2798 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
2799 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
2800 # only for bootable images. Read
2801 # Enabling guest operating system features to see a list of available
2802 # options.
2803 #
2804 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
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;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
2829 # persistent disks.
2830 &quot;a_key&quot;: &quot;A String&quot;,
2831 },
2832 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
2833 &quot;A String&quot;,
2834 ],
2835 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
2836 # more than one instance.
2837 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
2838 # is to use the existing disk.
2839 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
2840 # of I/O operations per second that the disk can handle. Values must be
2841 # between 10,000 and 120,000. For more details, see theExtreme persistent
2842 # disk documentation.
2843 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
2844 # number of throughput mb per second that the disk can handle. Values must
2845 # greater than or equal to 1.
2846 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
2847 # the URLs of the zones where the disk should be replicated to.
2848 # You must provide exactly two replica zones, and one zone must be the same
2849 # as the instance zone.
2850 &quot;A String&quot;,
2851 ],
2852 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
2853 # have the same definition as resource
2854 # manager tags. Keys and values can be either in numeric format,
2855 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
2856 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
2857 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
2858 # empty.
2859 &quot;a_key&quot;: &quot;A String&quot;,
2860 },
2861 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
2862 # Specified using the full or partial URL. For instance template, specify
2863 # only the resource policy name.
2864 &quot;A String&quot;,
2865 ],
2866 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
2867 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
2868 # is required.
2869 #
2870 # To create a disk with one of the public operating system
2871 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
2872 #
2873 # projects/debian-cloud/global/images/family/debian-9
2874 #
2875 #
2876 # Alternatively, use a specific version of a public operating system image:
2877 #
2878 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
2879 #
2880 #
2881 # To create a disk with a custom image that you created, specify the
2882 # image name in the following format:
2883 #
2884 # global/images/my-custom-image
2885 #
2886 #
2887 # You can also specify a custom image by its image family, which returns
2888 # the latest version of the image in that family. Replace the image name
2889 # with family/family-name:
2890 #
2891 # global/images/family/my-image-family
2892 #
2893 #
2894 # If the source image is deleted later, this field will not be set.
2895 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
2896 # encryption key of the source image. Required if the source image is
2897 # protected by a customer-supplied encryption key.
2898 #
2899 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
2900 # encryption keys, so you cannot create disks for instances in a managed instance group if the
2901 # source images are encrypted with your own keys.
2902 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2903 # For example:
2904 #
2905 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2906 # key_region/cryptoKeys/key
2907 #
2908 # The fully-qualifed key name may be returned for resource GET requests. For
2909 # example:
2910 #
2911 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2912 # key_region/cryptoKeys/key
2913 # /cryptoKeyVersions/1
2914 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2915 # key. If absent, the Compute Engine default service account is used.
2916 # For example:
2917 #
2918 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
2919 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
2920 # encryption key, encoded in RFC
2921 # 4648 base64 to either encrypt or decrypt this resource. You can
2922 # provide either the rawKey or thersaEncryptedKey.
2923 # For example:
2924 #
2925 # &quot;rawKey&quot;:
2926 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
2927 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
2928 # customer-supplied encryption key to either encrypt or decrypt this
2929 # resource. You can provide either the rawKey or thersaEncryptedKey.
2930 # For example:
2931 #
2932 # &quot;rsaEncryptedKey&quot;:
2933 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
2934 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
2935 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
2936 #
2937 # The key must meet the following requirements before you can provide it to
2938 # Compute Engine:
2939 #
2940 # 1. The key is wrapped using a RSA public key certificate provided by
2941 # Google.
2942 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
2943 # encoding.
2944 #
2945 # Gets the RSA public key certificate provided by Google at:
2946 #
2947 #
2948 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
2949 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
2950 # 4648 base64 encoded SHA-256 hash of the customer-supplied
2951 # encryption key that protects this resource.
2952 },
2953 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
2954 # instance boot disk, one of initializeParams.sourceSnapshot
2955 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
2956 # is required.
2957 #
2958 # To create a disk with a snapshot that you created, specify the
2959 # snapshot name in the following format:
2960 #
2961 # us-central1-a/instantSnapshots/my-backup
2962 #
2963 #
2964 # If the source instant-snapshot is deleted later, this field will not be
2965 # set.
2966 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
2967 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
2968 # is required.
2969 #
2970 # To create a disk with a snapshot that you created, specify the
2971 # snapshot name in the following format:
2972 #
2973 # global/snapshots/my-backup
2974 #
2975 #
2976 # If the source snapshot is deleted later, this field will not be set.
2977 #
2978 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
2979 # an image instead when you create VMs using
2980 # the bulk
2981 # insert method.
2982 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
2983 # encryption key of the source snapshot.
2984 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
2985 # For example:
2986 #
2987 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2988 # key_region/cryptoKeys/key
2989 #
2990 # The fully-qualifed key name may be returned for resource GET requests. For
2991 # example:
2992 #
2993 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
2994 # key_region/cryptoKeys/key
2995 # /cryptoKeyVersions/1
2996 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
2997 # key. If absent, the Compute Engine default service account is used.
2998 # For example:
2999 #
3000 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3001 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3002 # encryption key, encoded in RFC
3003 # 4648 base64 to either encrypt or decrypt this resource. You can
3004 # provide either the rawKey or thersaEncryptedKey.
3005 # For example:
3006 #
3007 # &quot;rawKey&quot;:
3008 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3009 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3010 # customer-supplied encryption key to either encrypt or decrypt this
3011 # resource. You can provide either the rawKey or thersaEncryptedKey.
3012 # For example:
3013 #
3014 # &quot;rsaEncryptedKey&quot;:
3015 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3016 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3017 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3018 #
3019 # The key must meet the following requirements before you can provide it to
3020 # Compute Engine:
3021 #
3022 # 1. The key is wrapped using a RSA public key certificate provided by
3023 # Google.
3024 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3025 # encoding.
3026 #
3027 # Gets the RSA public key certificate provided by Google at:
3028 #
3029 #
3030 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
3031 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
3032 # 4648 base64 encoded SHA-256 hash of the customer-supplied
3033 # encryption key that protects this resource.
3034 },
3035 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
3036 # this as a partial or full URL to the resource. For example, the following
3037 # are valid values:
3038 #
3039 #
3040 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
3041 # - projects/project/zones/zone/storagePools/storagePool
3042 # - zones/zone/storagePools/storagePool
3043 },
3044 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
3045 # either SCSI or NVME. For most machine types, the
3046 # default is SCSI. Local SSDs can use either NVME or SCSI.
3047 # In certain configurations, persistent disks can use NVMe. For more
3048 # information, seeAbout
3049 # persistent disks.
3050 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
3051 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
3052 &quot;A String&quot;,
3053 ],
3054 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
3055 # disk is not allowed to be detached from the instance, or to be used as the
3056 # source of the snapshot creation, and the image creation. The instance with
3057 # at least one locked attached disk is not allow to be used as source of
3058 # machine image creation, instant snapshot creation, and not allowed to be
3059 # deleted with --keep-disk parameter set to true for locked disks.
3060 &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
3061 # in READ_WRITE mode.
3062 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
3063 # field is set to PRESERVED if the LocalSSD data has been saved
3064 # to a persistent location by customer request. (see the
3065 # discard_local_ssd option on Stop/Suspend).
3066 # Read-only in the api.
3067 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
3068 # these are public keys which are safe to store in public
3069 &quot;dbs&quot;: [ # The Key Database (db).
3070 {
3071 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3072 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3073 },
3074 ],
3075 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
3076 {
3077 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3078 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3079 },
3080 ],
3081 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
3082 {
3083 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3084 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3085 },
3086 ],
3087 &quot;pk&quot;: { # The Platform Key (PK).
3088 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
3089 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
3090 },
3091 },
3092 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
3093 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
3094 # is required.
3095 #
3096 # If desired, you can also attach existing non-root persistent disks using
3097 # this property. This field is only applicable for persistent disks.
3098 #
3099 # Note that for InstanceTemplate, specify the disk name for zonal disk,
3100 # and the URL for regional disk.
3101 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
3102 },
3103 ],
3104 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
3105 &quot;A String&quot;,
3106 ],
3107 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
3108 # e.g. &#x27;Intel Ice Lake&#x27;.
3109 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
3110 # preference. MIG will first try to create a VM based on the machine-type
3111 # with lowest rank and fallback to next rank based on availability.
3112 # Machine types and instance selections with the same rank have the same
3113 # preference.
3114 },
3115 },
3116 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
3117 # create instances.
3118 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
3119 # more preemption than the minimum capacity user needs. MIG will create
3120 # only Standard VMs until it reaches standard_capacity_base and only
3121 # then will start using standard_capacity_percent_above_base to mix Spot
3122 # with Standard VMs.
3123 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
3124 # remaining percentage will use Spot VMs. The percentage applies only to
3125 # the capacity above standard_capacity_base.
3126 },
3127 },
3128 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
3129 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
3130 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
3131 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
3132 # applies to the VMs on which your application fails a health check.
3133 # Valid values are
3134 #
3135 # - REPAIR (default): MIG automatically repairs a failed VM
3136 # by recreating it. For more information, see About
3137 # repairing VMs in a MIG.
3138 # - DO_NOTHING: MIG does not repair a failed VM.
3139 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
3140 # configuration when repairing a VM. Valid options are:
3141 #
3142 #
3143 #
3144 # - NO (default): If configuration updates are available, they are not
3145 # forcefully applied during repair. Instead, configuration updates are
3146 # applied according to the group&#x27;s update policy.
3147 #
3148 # - YES: If configuration updates are available, they are applied
3149 # during repair.
3150 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
3151 # unhealthy when the application running on that VM fails a health check.
3152 # Valid values are:
3153 #
3154 # - DEFAULT_ACTION (default): MIG uses the same action
3155 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
3156 # - REPAIR: MIG automatically repairs an unhealthy VM by
3157 # recreating it.
3158 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
3159 # For more information, see
3160 # About repairing VMs in a MIG.
3161 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
3162 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
3163 # Valid values are:
3164 #
3165 # - NO (default): MIG cannot change a VM&#x27;s zone during a
3166 # repair.
3167 # - YES: MIG can select a different zone for the VM during
3168 # a repair.
3169 },
3170 },
3171 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
3172 # instance group. The group uses this template to create all new instances
3173 # in the managed instance group. The templates for existing instances in the
3174 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
3175 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
3176 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
3177 # this managed instance group.
3178 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
3179 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
3180 # long, and comply withRFC1035.
3181 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
3182 # to this Instance Group Manager.
3183 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
3184 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
3185 # The name must be 1-63 characters long, and comply withRFC1035.
3186 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
3187 },
3188 ],
3189 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
3190 # as part of resource payload.
3191 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
3192 # key-value pairs. Keys and values can be either in numeric format,
3193 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
3194 # format such as `{org_id|project_id}/{tag_key_short_name}` and
3195 # `{tag_value_short_name}`. For more information, seeManage tags
3196 # for resources.
3197 &quot;a_key&quot;: &quot;A String&quot;,
3198 },
3199 },
3200 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
3201 # where the managed instance group resides (for regional resources).
3202 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
3203 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
3204 # instance group.
3205 # It can be a full or partial URL. For example, the following are
3206 # all valid URLs to a workload policy:
3207 #
3208 #
3209 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
3210 # - projects/project/regions/region/resourcePolicies/resourcePolicy
3211 # - regions/region/resourcePolicies/resourcePolicy
3212 },
3213 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
3214 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
3215 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
3216 # this URL.
3217 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
3218 # by the managed instance group on instances. The service accounts needs all
3219 # permissions required to create and delete instances.
3220 # By default, the service account
3221 # {projectNumber}@cloudservices.gserviceaccount.com is used.
3222 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
3223 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
3224 # stop a VM after that VM was created. The initial delay gives the
3225 # initialization script the time to prepare your VM for a quick scale out.
3226 # The value of initial delay must be between 0 and 3600 seconds. The
3227 # default value is 0.
3228 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
3229 # group scales out. The default mode is `MANUAL`.
3230 },
3231 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
3232 &quot;preservedState&quot;: { # Configuration of preserved resources.
3233 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
3234 # delete, update, etc. This map is keyed with the device names of
3235 # the disks.
3236 &quot;a_key&quot;: {
3237 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
3238 # update or VM instance recreate operations.
3239 # This flag is used to configure if the disk should be deleted after it
3240 # is no longer used by the group, e.g. when the given instance or
3241 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
3242 },
3243 },
3244 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
3245 # instance delete, update, etc. This map is keyed with the network
3246 # interface name.
3247 &quot;a_key&quot;: {
3248 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
3249 # update or VM instance recreate operations.
3250 # This flag is used to configure if the IP reservation should be deleted
3251 # after it is no longer used by the group, e.g. when the given instance
3252 # or the whole group is deleted.
3253 },
3254 },
3255 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
3256 # instance delete, update, etc. This map is keyed with the network
3257 # interface name.
3258 &quot;a_key&quot;: {
3259 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
3260 # update or VM instance recreate operations.
3261 # This flag is used to configure if the IP reservation should be deleted
3262 # after it is no longer used by the group, e.g. when the given instance
3263 # or the whole group is deleted.
3264 },
3265 },
3266 },
3267 },
3268 &quot;status&quot;: { # Output only. The status of this managed instance group.
3269 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
3270 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
3271 # This value is in RFC3339 text format.
3272 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
3273 # been applied to all managed instances in the group.
3274 },
3275 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
3276 # Currently only one accelerator topology is supported.
3277 {
3278 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
3279 # The value is the same as configured in the WorkloadPolicy.
3280 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
3281 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
3282 # check.
3283 &quot;error&quot;: { # Output only. Encountered errors.
3284 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3285 # operation.
3286 {
3287 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3288 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3289 # details. There is a set of defined message types to use for providing
3290 # details.The syntax depends on the error code. For example,
3291 # QuotaExceededInfo will have details when the error code is
3292 # QUOTA_EXCEEDED.
3293 {
3294 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3295 #
3296 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3297 # is not enabled:
3298 #
3299 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3300 # &quot;domain&quot;: &quot;googleapis.com&quot;
3301 # &quot;metadata&quot;: {
3302 # &quot;resource&quot;: &quot;projects/123&quot;,
3303 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3304 # }
3305 # }
3306 #
3307 # This response indicates that the pubsub.googleapis.com API is not enabled.
3308 #
3309 # Example of an error that is returned when attempting to create a Spanner
3310 # instance in a region that is out of stock:
3311 #
3312 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3313 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3314 # &quot;metadata&quot;: {
3315 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3316 # }
3317 # }
3318 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3319 # is typically the registered service name of the tool or product that
3320 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3321 # generated by some common infrastructure, the error domain must be a
3322 # globally unique value that identifies the infrastructure. For Google API
3323 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3324 &quot;metadatas&quot;: { # Additional structured details about this error.
3325 #
3326 # Keys must match a regular expression of `a-z+` but should
3327 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3328 # length. When identifying the current value of an exceeded limit, the units
3329 # should be contained in the key, not the value. For example, rather than
3330 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3331 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3332 # instances that can be created in a single (batch) request.
3333 &quot;a_key&quot;: &quot;A String&quot;,
3334 },
3335 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3336 # proximate cause of the error. Error reasons are unique within a particular
3337 # domain of errors. This should be at most 63 characters and match a
3338 # regular expression of `A-Z+[A-Z0-9]`, which represents
3339 # UPPER_SNAKE_CASE.
3340 },
3341 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3342 #
3343 # For example, if a quota check failed with an error indicating the calling
3344 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3345 # directly to the right place in the developer console to flip the bit.
3346 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3347 { # Describes a URL link.
3348 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3349 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3350 },
3351 ],
3352 },
3353 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3354 # which can be attached to an RPC error.
3355 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3356 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3357 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3358 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3359 },
3360 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3361 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3362 &quot;a_key&quot;: &quot;A String&quot;,
3363 },
3364 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3365 # type or metric.
3366 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3367 # or metric.
3368 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3369 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3370 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3371 },
3372 },
3373 ],
3374 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3375 # This property is optional.
3376 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3377 },
3378 ],
3379 },
3380 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
3381 # has // RFC3339 //
3382 # text format.
3383 },
3384 },
3385 ],
3386 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
3387 # that targets this instance group manager.
3388 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
3389 # targetSizePolicy.mode is set to BULK.
3390 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
3391 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
3392 # operation.
3393 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
3394 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3395 # operation.
3396 {
3397 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3398 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3399 # details. There is a set of defined message types to use for providing
3400 # details.The syntax depends on the error code. For example,
3401 # QuotaExceededInfo will have details when the error code is
3402 # QUOTA_EXCEEDED.
3403 {
3404 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3405 #
3406 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3407 # is not enabled:
3408 #
3409 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3410 # &quot;domain&quot;: &quot;googleapis.com&quot;
3411 # &quot;metadata&quot;: {
3412 # &quot;resource&quot;: &quot;projects/123&quot;,
3413 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3414 # }
3415 # }
3416 #
3417 # This response indicates that the pubsub.googleapis.com API is not enabled.
3418 #
3419 # Example of an error that is returned when attempting to create a Spanner
3420 # instance in a region that is out of stock:
3421 #
3422 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3423 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3424 # &quot;metadata&quot;: {
3425 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3426 # }
3427 # }
3428 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3429 # is typically the registered service name of the tool or product that
3430 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3431 # generated by some common infrastructure, the error domain must be a
3432 # globally unique value that identifies the infrastructure. For Google API
3433 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3434 &quot;metadatas&quot;: { # Additional structured details about this error.
3435 #
3436 # Keys must match a regular expression of `a-z+` but should
3437 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3438 # length. When identifying the current value of an exceeded limit, the units
3439 # should be contained in the key, not the value. For example, rather than
3440 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3441 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3442 # instances that can be created in a single (batch) request.
3443 &quot;a_key&quot;: &quot;A String&quot;,
3444 },
3445 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3446 # proximate cause of the error. Error reasons are unique within a particular
3447 # domain of errors. This should be at most 63 characters and match a
3448 # regular expression of `A-Z+[A-Z0-9]`, which represents
3449 # UPPER_SNAKE_CASE.
3450 },
3451 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3452 #
3453 # For example, if a quota check failed with an error indicating the calling
3454 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3455 # directly to the right place in the developer console to flip the bit.
3456 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3457 { # Describes a URL link.
3458 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3459 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3460 },
3461 ],
3462 },
3463 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3464 # which can be attached to an RPC error.
3465 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3466 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3467 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3468 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3469 },
3470 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3471 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3472 &quot;a_key&quot;: &quot;A String&quot;,
3473 },
3474 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3475 # type or metric.
3476 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3477 # or metric.
3478 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3479 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3480 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3481 },
3482 },
3483 ],
3484 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3485 # This property is optional.
3486 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3487 },
3488 ],
3489 },
3490 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
3491 # operation. Timestamp is in RFC3339 text format.
3492 },
3493 },
3494 &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
3495 # in this managed instance group that have the status. Currently only shown
3496 # for TPU MIGs
3497 # instance group that have the status. For more information about how to
3498 # interpret each status check the instance lifecycle documentation.
3499 # Currently only shown for TPU MIGs.
3500 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
3501 # that have DEPROVISIONING status.
3502 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
3503 # have been deleted. Includes only instances that would be shown in the
3504 # listManagedInstances method and not all instances that have been
3505 # deleted in the lifetime of the MIG.
3506 # Does not include FlexStart instances that are waiting for the resources
3507 # availability, they are considered as &#x27;pending&#x27;.
3508 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
3509 # that have PENDING status, that is FlexStart instances that are waiting
3510 # for resources. Instances that do not exist because of the other reasons
3511 # are counted as &#x27;non_existent&#x27;.
3512 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
3513 # that have PENDING_STOP status.
3514 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
3515 # that have PROVISIONING status.
3516 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
3517 # that have REPAIRING status.
3518 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
3519 # that have RUNNING status.
3520 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
3521 # that have STAGING status.
3522 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
3523 # that have STOPPED status.
3524 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
3525 # that have STOPPING status.
3526 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
3527 # that have SUSPENDED status.
3528 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
3529 # that have SUSPENDING status.
3530 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
3531 # that have TERMINATED status.
3532 },
3533 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
3534 # stable state. A stable state means that: none of the instances in the
3535 # managed instance group is currently undergoing any type of change (for
3536 # example, creation, restart, or deletion); no future changes are scheduled
3537 # for instances in the managed instance group; and the managed instance
3538 # group itself is not being modified.
3539 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
3540 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
3541 # has stateful configuration, that is, if you have configured any items
3542 # in a stateful policy or in per-instance configs.
3543 # The group might report that it has no stateful configuration even when
3544 # there is still some preserved state on a managed instance, for example,
3545 # if you have deleted all PICs but not yet applied those deletions.
3546 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
3547 # has stateful configuration, that is, if you have configured any items
3548 # in a stateful policy or in per-instance configs.
3549 # The group might report that it has no stateful configuration even when
3550 # there is still some preserved state on a managed instance, for example,
3551 # if you have deleted all PICs but not yet applied those deletions. This
3552 # field is deprecated in favor of has_stateful_config.
3553 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
3554 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
3555 # (listed in the output of a listPerInstanceConfigs API call) have
3556 # status EFFECTIVE or there are no per-instance-configs.
3557 },
3558 },
3559 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
3560 # target version specified by version field on Instance Group
3561 # Manager.
3562 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
3563 # in this managed instance group, i.e. all instances are in their target
3564 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
3565 },
3566 },
3567 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
3568 # apply to all of the instances in the managed instance group.
3569 &quot;A String&quot;,
3570 ],
3571 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
3572 # You can reduce this number by using the instanceGroupManager
3573 # deleteInstances or abandonInstances methods. Resizing the group also
3574 # changes this number.
3575 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
3576 # size.
3577 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
3578 # individually or all at once.
3579 },
3580 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
3581 # This number changes when you:
3582 #
3583 # - Stop instance using the stopInstances
3584 # method or start instances using the startInstances
3585 # method.
3586 # - Manually change the targetStoppedSize using the update
3587 # method.
3588 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
3589 # This number changes when you:
3590 #
3591 # - Suspend instance using the suspendInstances
3592 # method or resume instances using the resumeInstances
3593 # method.
3594 # - Manually change the targetSuspendedSize using the update
3595 # method.
3596 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
3597 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
3598 &quot;A String&quot;,
3599 ],
3600 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
3601 # instance redistribution policy for regional managed instance groups.
3602 # Valid values are:
3603 #
3604 # - PROACTIVE (default): The group attempts to maintain an
3605 # even distribution of VM instances across zones in the region.
3606 # - NONE: For non-autoscaled groups, proactive
3607 # redistribution is disabled.
3608 &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
3609 # either a fixed number or, if the group has 10 or more instances, a
3610 # percentage. If you set a percentage, the number of instances is rounded
3611 # if necessary. The default value for maxSurge is a fixed
3612 # value equal to the number of zones in which the managed instance group
3613 # operates.
3614 #
3615 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
3616 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
3617 #
3618 #
3619 #
3620 # - If the value is fixed, then the calculated
3621 # value is equal to the fixed value.
3622 # - If the value is a percent, then the
3623 # calculated
3624 # value is percent/100 * targetSize. For example,
3625 # the calculated value of a 80% of a managed instance group
3626 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
3627 # is a remainder, the number is rounded.
3628 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
3629 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
3630 # example, specify 80 for 80%.
3631 },
3632 &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
3633 # process. An instance is considered available if all of the following
3634 # conditions are satisfied:
3635 #
3636 #
3637 #
3638 # - The instance&#x27;s status is
3639 # RUNNING.
3640 # - If there is a health
3641 # check on the instance group, the instance&#x27;s health check status
3642 # must be HEALTHY at least once. If there is no health check
3643 # on the group, then the instance only needs to have a status of
3644 # RUNNING to be considered available.
3645 #
3646 #
3647 # This value can be either a fixed number or, if the group has 10 or more
3648 # instances, a percentage. If you set a percentage, the number of instances
3649 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
3650 # in which the managed instance group operates.
3651 #
3652 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
3653 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
3654 #
3655 #
3656 #
3657 # - If the value is fixed, then the calculated
3658 # value is equal to the fixed value.
3659 # - If the value is a percent, then the
3660 # calculated
3661 # value is percent/100 * targetSize. For example,
3662 # the calculated value of a 80% of a managed instance group
3663 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
3664 # is a remainder, the number is rounded.
3665 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
3666 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
3667 # example, specify 80 for 80%.
3668 },
3669 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
3670 # becomes available. This value must be from range [0, 3600].
3671 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
3672 # disruption as much as possible or to apply a more disruptive action than
3673 # is necessary.
3674 #
3675 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
3676 # Compute Engine performs the necessary action to execute the update.
3677 # - To apply a more disruptive action than is strictly necessary, set the
3678 # minimal action to RESTART or REPLACE. For
3679 # example, Compute Engine does not need to restart a VM to change its
3680 # metadata. But if your application reads instance metadata only when a VM
3681 # is restarted, you can set the minimal action to RESTART in
3682 # order to pick up metadata changes.
3683 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
3684 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
3685 # as much as possible. RESTART to allow actions that can be
3686 # applied without instance replacing or REPLACE to allow all
3687 # possible actions. If the Updater determines that the minimal update
3688 # action needed is more disruptive than most disruptive allowed action you
3689 # specify it will not perform the update at all.
3690 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
3691 # See minimal_action.REPLACE
3692 &quot;type&quot;: &quot;A String&quot;, # The type
3693 # of update process. You can specify either PROACTIVE so
3694 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
3695 # to update.
3696 },
3697 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
3698 # create instances.
3699 #
3700 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
3701 # group. This field overrides the top-level instanceTemplate
3702 # field. Read more about therelationships
3703 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
3704 # remaining instances. For more information, read aboutcanary
3705 # updates.
3706 {
3707 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
3708 # instance group. The group uses this template to create new instances in
3709 # the managed instance group until the `targetSize` for this version is
3710 # reached. The templates for existing instances in the group do not change
3711 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
3712 # existing instances are updated until the `targetSize` for this version is
3713 # reached.
3714 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
3715 # managed instance group.
3716 &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
3717 # from the template will be equal to:
3718 #
3719 #
3720 # - If expressed as a fixed number, the minimum of either
3721 # targetSize.fixed or
3722 # instanceGroupManager.targetSize is used.
3723 # - if expressed as a percent, the targetSize
3724 # would be (targetSize.percent/100 *
3725 # InstanceGroupManager.targetSize) If there is a remainder, the
3726 # number is rounded.
3727 #
3728 # If unset, this version will update any remaining instances not
3729 # updated by another version. ReadStarting
3730 # a canary update for more information.
3731 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
3732 #
3733 #
3734 #
3735 # - If the value is fixed, then the calculated
3736 # value is equal to the fixed value.
3737 # - If the value is a percent, then the
3738 # calculated
3739 # value is percent/100 * targetSize. For example,
3740 # the calculated value of a 80% of a managed instance group
3741 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
3742 # is a remainder, the number is rounded.
3743 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
3744 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
3745 # example, specify 80 for 80%.
3746 },
3747 },
3748 ],
3749 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
3750 # where the managed instance group is located (for zonal resources).
3751 }</pre>
3752 </div>
3753
3754 <div class="method">
3755 <code class="details" id="insert">insert(project, region, body=None, requestId=None, x__xgafv=None)</code>
3756 <pre>Creates a managed instance group using the information that you specify
3757 in the request. After the group is created, instances in the group are
3758 created using the specified instance template.
3759 This operation is marked as DONE when the group is created
3760 even if the instances in the group have not yet been created. You must
3761 separately verify the status of the individual instances with thelistmanagedinstances
3762 method.
3763
3764 A regional managed instance group can contain up to 2000 instances.
3765
3766 Args:
3767 project: string, Project ID for this request. (required)
3768 region: string, Name of the region scoping this request. (required)
3769 body: object, The request body.
3770 The object takes the form of:
3771
3772 { # Represents a Managed Instance Group resource.
3773 #
3774 # An instance group is a collection of VM instances that you can manage as a
3775 # single entity. For more information, readInstance groups.
3776 #
3777 # For zonal Managed Instance Group, use the instanceGroupManagers
3778 # resource.
3779 #
3780 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
3781 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
3782 # for the group.
3783 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
3784 #
3785 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
3786 # instances to apply the configuration. To apply the configuration, set the
3787 # group&#x27;s updatePolicy.type field to use proactive updates or
3788 # use the applyUpdatesToInstances method.
3789 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
3790 &quot;a_key&quot;: &quot;A String&quot;,
3791 },
3792 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
3793 # more information, see Project and
3794 # instance metadata.
3795 &quot;a_key&quot;: &quot;A String&quot;,
3796 },
3797 },
3798 },
3799 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
3800 # only one value.
3801 {
3802 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
3803 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
3804 # initialize and run its startup script. During a VM&#x27;s initial delay
3805 # period, the MIG ignores unsuccessful health checks because the VM might
3806 # be in the startup process. This prevents the MIG from prematurely
3807 # recreating a VM. If the health check receives a healthy response during
3808 # the initial delay, it indicates that the startup process is complete and
3809 # the VM is ready. The value of initial delay must be between 0 and 3600
3810 # seconds. The default value is 0.
3811 },
3812 ],
3813 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
3814 # all VMs in a MIG. The maximum character length is 58 and the name must
3815 # comply with RFC1035 format.
3816 #
3817 # When a VM is created in the group, the MIG appends a hyphen and a random
3818 # four-character string to the base instance name. If you want the MIG to
3819 # assign sequential numbers instead of a random string, then end the base
3820 # instance name with a hyphen followed by one or more hash symbols. The hash
3821 # symbols indicate the number of digits. For example, a base instance name of
3822 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
3823 # @pattern
3824 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
3825 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
3826 # text format.
3827 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
3828 # in this managed instance group that are scheduled for each of those
3829 # actions.
3830 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
3831 # that are scheduled to be abandoned. Abandoning an instance removes it
3832 # from the managed instance group without deleting it.
3833 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
3834 # are scheduled to be adopted or are currently being adopted.
3835 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
3836 # are scheduled to be created or are currently being created. If the group
3837 # fails to create any of these instances, it tries again until it creates
3838 # the instance successfully.
3839 #
3840 # If you have disabled creation retries, this field will not be populated;
3841 # instead, the creatingWithoutRetries field will be populated.
3842 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
3843 # will attempt to create. The group attempts to create each instance
3844 # only once. If the group fails to create any of these instances, it
3845 # decreases the group&#x27;s targetSize value accordingly.
3846 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
3847 # are scheduled to be deleted or are currently being deleted.
3848 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
3849 # are running and have no scheduled actions.
3850 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
3851 # are scheduled to be recreated or are currently being being recreated.
3852 # Recreating an instance deletes the existing root persistent disk
3853 # and creates a new disk from the image that is defined in the
3854 # instance template.
3855 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
3856 # are being reconfigured with properties that do not require a restart
3857 # or a recreate action. For example, setting or removing target
3858 # pools for the instance.
3859 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
3860 # are scheduled to be restarted or are currently being restarted.
3861 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
3862 # are scheduled to be restarted or are currently being restarted.
3863 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
3864 # are scheduled to be resumed or are currently being resumed.
3865 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
3866 # are scheduled to be started or are currently being started.
3867 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
3868 # are scheduled to be stopped or are currently being stopped.
3869 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
3870 # are scheduled to be suspended or are currently being suspended.
3871 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
3872 # are being verified. See the managedInstances[].currentAction
3873 # property in the listManagedInstances method documentation.
3874 },
3875 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
3876 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
3877 # zones in a regional managed instance group.
3878 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
3879 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
3880 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
3881 # its instances.
3882 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
3883 # instances, even if an AI zone is available in the specified region. To
3884 # create instances in an AI zone in the selected region, you must explicitly
3885 # specify it in the distribution policy together with the other preferred
3886 # zones.
3887 {
3888 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
3889 # The zone must exist in the region where the managed instance group is
3890 # located.
3891 },
3892 ],
3893 },
3894 &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.
3895 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
3896 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
3897 # fingerprint must be provided in order to update the InstanceGroupManager,
3898 # otherwise the request will fail with error412 conditionNotMet.
3899 #
3900 # To see the latest fingerprint, make a get() request to
3901 # retrieve an InstanceGroupManager.
3902 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
3903 # generates this identifier.
3904 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
3905 # types of machines.
3906 # Instance flexibility configuration on MIG overrides instance
3907 # template configuration.
3908 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
3909 # when creating new VMs.
3910 &quot;a_key&quot;: {
3911 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
3912 # selection.
3913 { # An instance-attached disk resource.
3914 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
3915 # or X86_64.
3916 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
3917 # deleted (but not when the disk is detached from the instance).
3918 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
3919 # partition of the disk for its root filesystem.
3920 &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
3921 # running within the instance. This name can be used to reference the device
3922 # for mounting, resizing, and so on, from within the instance.
3923 #
3924 # If not specified, the server chooses a default device name to apply to this
3925 # disk, in the form persistent-disk-x, where x is a number
3926 # assigned by Google Compute Engine. This field is only applicable for
3927 # persistent disks.
3928 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
3929 # encryption key.
3930 #
3931 # If you are creating a new disk, this field encrypts the new disk using
3932 # an encryption key that you provide. If you are attaching an existing
3933 # disk that is already encrypted, this field decrypts the disk using
3934 # the customer-supplied encryption key.
3935 #
3936 # If you encrypt a disk using a customer-supplied key, you must provide the
3937 # same key again when you attempt to use this resource at a later time. For
3938 # example, you must provide the key when you create a snapshot or an image
3939 # from the disk or when you attach the disk to a virtual machine instance.
3940 #
3941 # If you do not provide an encryption key, then the disk will be encrypted
3942 # using an automatically generated key and you do not need to provide a key
3943 # to use the disk later.
3944 #
3945 # Note:
3946 #
3947 # Instance templates do not storecustomer-supplied
3948 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
3949 #
3950 # You cannot create VMs that have disks with customer-supplied keys using
3951 # the bulk
3952 # insert method.
3953 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
3954 # For example:
3955 #
3956 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3957 # key_region/cryptoKeys/key
3958 #
3959 # The fully-qualifed key name may be returned for resource GET requests. For
3960 # example:
3961 #
3962 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
3963 # key_region/cryptoKeys/key
3964 # /cryptoKeyVersions/1
3965 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
3966 # key. If absent, the Compute Engine default service account is used.
3967 # For example:
3968 #
3969 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
3970 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
3971 # encryption key, encoded in RFC
3972 # 4648 base64 to either encrypt or decrypt this resource. You can
3973 # provide either the rawKey or thersaEncryptedKey.
3974 # For example:
3975 #
3976 # &quot;rawKey&quot;:
3977 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
3978 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
3979 # customer-supplied encryption key to either encrypt or decrypt this
3980 # resource. You can provide either the rawKey or thersaEncryptedKey.
3981 # For example:
3982 #
3983 # &quot;rsaEncryptedKey&quot;:
3984 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
3985 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
3986 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
3987 #
3988 # The key must meet the following requirements before you can provide it to
3989 # Compute Engine:
3990 #
3991 # 1. The key is wrapped using a RSA public key certificate provided by
3992 # Google.
3993 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
3994 # encoding.
3995 #
3996 # Gets the RSA public key certificate provided by Google at:
3997 #
3998 #
3999 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4000 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4001 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4002 # encryption key that protects this resource.
4003 },
4004 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
4005 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
4006 # currently attached to another instance. If you try to force attach a zonal
4007 # disk to an instance, you will receive an error.
4008 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4009 # only for bootable images. Read
4010 # Enabling guest operating system features to see a list of available
4011 # options.
4012 { # Guest OS features.
4013 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4014 # separate values. Set to one or more of the following values:
4015 #
4016 # - VIRTIO_SCSI_MULTIQUEUE
4017 # - WINDOWS
4018 # - MULTI_IP_SUBNET
4019 # - UEFI_COMPATIBLE
4020 # - GVNIC
4021 # - SEV_CAPABLE
4022 # - SUSPEND_RESUME_COMPATIBLE
4023 # - SEV_LIVE_MIGRATABLE_V2
4024 # - SEV_SNP_CAPABLE
4025 # - TDX_CAPABLE
4026 # - IDPF
4027 # - SNP_SVSM_CAPABLE
4028 # - CCA_CAPABLE
4029 #
4030 #
4031 # For more information, see
4032 # Enabling guest operating system features.
4033 },
4034 ],
4035 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
4036 # boot disk. If you have many disks attached to an instance, each
4037 # disk would have a unique index number.
4038 &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
4039 # alongside the new instance. Use initialization parameters to create boot
4040 # disks or local SSDs attached to the new instance.
4041 #
4042 # This property is mutually exclusive with the source property;
4043 # you can only define one or the other, but not both.
4044 # alongside the new instance. Use initialization parameters to create boot
4045 # disks or local SSDs attached to the new instance.
4046 #
4047 # This field is persisted and returned for instanceTemplate and not returned
4048 # in the context of instance.
4049 #
4050 # This property is mutually exclusive with the source property;
4051 # you can only define one or the other, but not both.
4052 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
4053 # arm64 or x86_64.
4054 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
4055 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
4056 # of the instance. If a disk with the same name already exists in the given
4057 # region, the existing disk is attached to the new instance and the
4058 # new disk is not created.
4059 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
4060 # 10 GB. If you specify a sourceImage, which is required for
4061 # boot disks, the default size is the size of the sourceImage.
4062 # If you do not specify a sourceImage, the default disk size
4063 # is 500 GB.
4064 &quot;diskType&quot;: &quot;A String&quot;,
4065 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
4066 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4067 # only for bootable images. Read
4068 # Enabling guest operating system features to see a list of available
4069 # options.
4070 #
4071 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
4072 { # Guest OS features.
4073 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4074 # separate values. Set to one or more of the following values:
4075 #
4076 # - VIRTIO_SCSI_MULTIQUEUE
4077 # - WINDOWS
4078 # - MULTI_IP_SUBNET
4079 # - UEFI_COMPATIBLE
4080 # - GVNIC
4081 # - SEV_CAPABLE
4082 # - SUSPEND_RESUME_COMPATIBLE
4083 # - SEV_LIVE_MIGRATABLE_V2
4084 # - SEV_SNP_CAPABLE
4085 # - TDX_CAPABLE
4086 # - IDPF
4087 # - SNP_SVSM_CAPABLE
4088 # - CCA_CAPABLE
4089 #
4090 #
4091 # For more information, see
4092 # Enabling guest operating system features.
4093 },
4094 ],
4095 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
4096 # persistent disks.
4097 &quot;a_key&quot;: &quot;A String&quot;,
4098 },
4099 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
4100 &quot;A String&quot;,
4101 ],
4102 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
4103 # more than one instance.
4104 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
4105 # is to use the existing disk.
4106 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
4107 # of I/O operations per second that the disk can handle. Values must be
4108 # between 10,000 and 120,000. For more details, see theExtreme persistent
4109 # disk documentation.
4110 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
4111 # number of throughput mb per second that the disk can handle. Values must
4112 # greater than or equal to 1.
4113 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
4114 # the URLs of the zones where the disk should be replicated to.
4115 # You must provide exactly two replica zones, and one zone must be the same
4116 # as the instance zone.
4117 &quot;A String&quot;,
4118 ],
4119 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
4120 # have the same definition as resource
4121 # manager tags. Keys and values can be either in numeric format,
4122 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4123 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4124 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
4125 # empty.
4126 &quot;a_key&quot;: &quot;A String&quot;,
4127 },
4128 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
4129 # Specified using the full or partial URL. For instance template, specify
4130 # only the resource policy name.
4131 &quot;A String&quot;,
4132 ],
4133 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
4134 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4135 # is required.
4136 #
4137 # To create a disk with one of the public operating system
4138 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
4139 #
4140 # projects/debian-cloud/global/images/family/debian-9
4141 #
4142 #
4143 # Alternatively, use a specific version of a public operating system image:
4144 #
4145 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
4146 #
4147 #
4148 # To create a disk with a custom image that you created, specify the
4149 # image name in the following format:
4150 #
4151 # global/images/my-custom-image
4152 #
4153 #
4154 # You can also specify a custom image by its image family, which returns
4155 # the latest version of the image in that family. Replace the image name
4156 # with family/family-name:
4157 #
4158 # global/images/family/my-image-family
4159 #
4160 #
4161 # If the source image is deleted later, this field will not be set.
4162 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
4163 # encryption key of the source image. Required if the source image is
4164 # protected by a customer-supplied encryption key.
4165 #
4166 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
4167 # encryption keys, so you cannot create disks for instances in a managed instance group if the
4168 # source images are encrypted with your own keys.
4169 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4170 # For example:
4171 #
4172 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4173 # key_region/cryptoKeys/key
4174 #
4175 # The fully-qualifed key name may be returned for resource GET requests. For
4176 # example:
4177 #
4178 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4179 # key_region/cryptoKeys/key
4180 # /cryptoKeyVersions/1
4181 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4182 # key. If absent, the Compute Engine default service account is used.
4183 # For example:
4184 #
4185 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4186 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4187 # encryption key, encoded in RFC
4188 # 4648 base64 to either encrypt or decrypt this resource. You can
4189 # provide either the rawKey or thersaEncryptedKey.
4190 # For example:
4191 #
4192 # &quot;rawKey&quot;:
4193 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4194 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4195 # customer-supplied encryption key to either encrypt or decrypt this
4196 # resource. You can provide either the rawKey or thersaEncryptedKey.
4197 # For example:
4198 #
4199 # &quot;rsaEncryptedKey&quot;:
4200 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4201 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4202 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4203 #
4204 # The key must meet the following requirements before you can provide it to
4205 # Compute Engine:
4206 #
4207 # 1. The key is wrapped using a RSA public key certificate provided by
4208 # Google.
4209 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4210 # encoding.
4211 #
4212 # Gets the RSA public key certificate provided by Google at:
4213 #
4214 #
4215 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4216 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4217 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4218 # encryption key that protects this resource.
4219 },
4220 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
4221 # instance boot disk, one of initializeParams.sourceSnapshot
4222 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
4223 # is required.
4224 #
4225 # To create a disk with a snapshot that you created, specify the
4226 # snapshot name in the following format:
4227 #
4228 # us-central1-a/instantSnapshots/my-backup
4229 #
4230 #
4231 # If the source instant-snapshot is deleted later, this field will not be
4232 # set.
4233 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
4234 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
4235 # is required.
4236 #
4237 # To create a disk with a snapshot that you created, specify the
4238 # snapshot name in the following format:
4239 #
4240 # global/snapshots/my-backup
4241 #
4242 #
4243 # If the source snapshot is deleted later, this field will not be set.
4244 #
4245 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
4246 # an image instead when you create VMs using
4247 # the bulk
4248 # insert method.
4249 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
4250 # encryption key of the source snapshot.
4251 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4252 # For example:
4253 #
4254 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4255 # key_region/cryptoKeys/key
4256 #
4257 # The fully-qualifed key name may be returned for resource GET requests. For
4258 # example:
4259 #
4260 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4261 # key_region/cryptoKeys/key
4262 # /cryptoKeyVersions/1
4263 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4264 # key. If absent, the Compute Engine default service account is used.
4265 # For example:
4266 #
4267 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4268 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4269 # encryption key, encoded in RFC
4270 # 4648 base64 to either encrypt or decrypt this resource. You can
4271 # provide either the rawKey or thersaEncryptedKey.
4272 # For example:
4273 #
4274 # &quot;rawKey&quot;:
4275 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4276 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4277 # customer-supplied encryption key to either encrypt or decrypt this
4278 # resource. You can provide either the rawKey or thersaEncryptedKey.
4279 # For example:
4280 #
4281 # &quot;rsaEncryptedKey&quot;:
4282 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4283 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4284 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4285 #
4286 # The key must meet the following requirements before you can provide it to
4287 # Compute Engine:
4288 #
4289 # 1. The key is wrapped using a RSA public key certificate provided by
4290 # Google.
4291 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4292 # encoding.
4293 #
4294 # Gets the RSA public key certificate provided by Google at:
4295 #
4296 #
4297 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4298 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4299 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4300 # encryption key that protects this resource.
4301 },
4302 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
4303 # this as a partial or full URL to the resource. For example, the following
4304 # are valid values:
4305 #
4306 #
4307 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
4308 # - projects/project/zones/zone/storagePools/storagePool
4309 # - zones/zone/storagePools/storagePool
4310 },
4311 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
4312 # either SCSI or NVME. For most machine types, the
4313 # default is SCSI. Local SSDs can use either NVME or SCSI.
4314 # In certain configurations, persistent disks can use NVMe. For more
4315 # information, seeAbout
4316 # persistent disks.
4317 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
4318 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
4319 &quot;A String&quot;,
4320 ],
4321 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
4322 # disk is not allowed to be detached from the instance, or to be used as the
4323 # source of the snapshot creation, and the image creation. The instance with
4324 # at least one locked attached disk is not allow to be used as source of
4325 # machine image creation, instant snapshot creation, and not allowed to be
4326 # deleted with --keep-disk parameter set to true for locked disks.
4327 &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
4328 # in READ_WRITE mode.
4329 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
4330 # field is set to PRESERVED if the LocalSSD data has been saved
4331 # to a persistent location by customer request. (see the
4332 # discard_local_ssd option on Stop/Suspend).
4333 # Read-only in the api.
4334 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
4335 # these are public keys which are safe to store in public
4336 &quot;dbs&quot;: [ # The Key Database (db).
4337 {
4338 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4339 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4340 },
4341 ],
4342 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
4343 {
4344 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4345 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4346 },
4347 ],
4348 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
4349 {
4350 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4351 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4352 },
4353 ],
4354 &quot;pk&quot;: { # The Platform Key (PK).
4355 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4356 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4357 },
4358 },
4359 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
4360 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4361 # is required.
4362 #
4363 # If desired, you can also attach existing non-root persistent disks using
4364 # this property. This field is only applicable for persistent disks.
4365 #
4366 # Note that for InstanceTemplate, specify the disk name for zonal disk,
4367 # and the URL for regional disk.
4368 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
4369 },
4370 ],
4371 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
4372 &quot;A String&quot;,
4373 ],
4374 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
4375 # e.g. &#x27;Intel Ice Lake&#x27;.
4376 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
4377 # preference. MIG will first try to create a VM based on the machine-type
4378 # with lowest rank and fallback to next rank based on availability.
4379 # Machine types and instance selections with the same rank have the same
4380 # preference.
4381 },
4382 },
4383 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
4384 # create instances.
4385 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
4386 # more preemption than the minimum capacity user needs. MIG will create
4387 # only Standard VMs until it reaches standard_capacity_base and only
4388 # then will start using standard_capacity_percent_above_base to mix Spot
4389 # with Standard VMs.
4390 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
4391 # remaining percentage will use Spot VMs. The percentage applies only to
4392 # the capacity above standard_capacity_base.
4393 },
4394 },
4395 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
4396 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
4397 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
4398 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
4399 # applies to the VMs on which your application fails a health check.
4400 # Valid values are
4401 #
4402 # - REPAIR (default): MIG automatically repairs a failed VM
4403 # by recreating it. For more information, see About
4404 # repairing VMs in a MIG.
4405 # - DO_NOTHING: MIG does not repair a failed VM.
4406 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
4407 # configuration when repairing a VM. Valid options are:
4408 #
4409 #
4410 #
4411 # - NO (default): If configuration updates are available, they are not
4412 # forcefully applied during repair. Instead, configuration updates are
4413 # applied according to the group&#x27;s update policy.
4414 #
4415 # - YES: If configuration updates are available, they are applied
4416 # during repair.
4417 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
4418 # unhealthy when the application running on that VM fails a health check.
4419 # Valid values are:
4420 #
4421 # - DEFAULT_ACTION (default): MIG uses the same action
4422 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
4423 # - REPAIR: MIG automatically repairs an unhealthy VM by
4424 # recreating it.
4425 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
4426 # For more information, see
4427 # About repairing VMs in a MIG.
4428 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
4429 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
4430 # Valid values are:
4431 #
4432 # - NO (default): MIG cannot change a VM&#x27;s zone during a
4433 # repair.
4434 # - YES: MIG can select a different zone for the VM during
4435 # a repair.
4436 },
4437 },
4438 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
4439 # instance group. The group uses this template to create all new instances
4440 # in the managed instance group. The templates for existing instances in the
4441 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
4442 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
4443 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
4444 # this managed instance group.
4445 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
4446 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
4447 # long, and comply withRFC1035.
4448 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
4449 # to this Instance Group Manager.
4450 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
4451 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
4452 # The name must be 1-63 characters long, and comply withRFC1035.
4453 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
4454 },
4455 ],
4456 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
4457 # as part of resource payload.
4458 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
4459 # key-value pairs. Keys and values can be either in numeric format,
4460 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
4461 # format such as `{org_id|project_id}/{tag_key_short_name}` and
4462 # `{tag_value_short_name}`. For more information, seeManage tags
4463 # for resources.
4464 &quot;a_key&quot;: &quot;A String&quot;,
4465 },
4466 },
4467 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
4468 # where the managed instance group resides (for regional resources).
4469 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
4470 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
4471 # instance group.
4472 # It can be a full or partial URL. For example, the following are
4473 # all valid URLs to a workload policy:
4474 #
4475 #
4476 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
4477 # - projects/project/regions/region/resourcePolicies/resourcePolicy
4478 # - regions/region/resourcePolicies/resourcePolicy
4479 },
4480 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
4481 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
4482 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
4483 # this URL.
4484 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
4485 # by the managed instance group on instances. The service accounts needs all
4486 # permissions required to create and delete instances.
4487 # By default, the service account
4488 # {projectNumber}@cloudservices.gserviceaccount.com is used.
4489 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
4490 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
4491 # stop a VM after that VM was created. The initial delay gives the
4492 # initialization script the time to prepare your VM for a quick scale out.
4493 # The value of initial delay must be between 0 and 3600 seconds. The
4494 # default value is 0.
4495 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
4496 # group scales out. The default mode is `MANUAL`.
4497 },
4498 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
4499 &quot;preservedState&quot;: { # Configuration of preserved resources.
4500 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
4501 # delete, update, etc. This map is keyed with the device names of
4502 # the disks.
4503 &quot;a_key&quot;: {
4504 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
4505 # update or VM instance recreate operations.
4506 # This flag is used to configure if the disk should be deleted after it
4507 # is no longer used by the group, e.g. when the given instance or
4508 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
4509 },
4510 },
4511 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
4512 # instance delete, update, etc. This map is keyed with the network
4513 # interface name.
4514 &quot;a_key&quot;: {
4515 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
4516 # update or VM instance recreate operations.
4517 # This flag is used to configure if the IP reservation should be deleted
4518 # after it is no longer used by the group, e.g. when the given instance
4519 # or the whole group is deleted.
4520 },
4521 },
4522 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
4523 # instance delete, update, etc. This map is keyed with the network
4524 # interface name.
4525 &quot;a_key&quot;: {
4526 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
4527 # update or VM instance recreate operations.
4528 # This flag is used to configure if the IP reservation should be deleted
4529 # after it is no longer used by the group, e.g. when the given instance
4530 # or the whole group is deleted.
4531 },
4532 },
4533 },
4534 },
4535 &quot;status&quot;: { # Output only. The status of this managed instance group.
4536 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
4537 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
4538 # This value is in RFC3339 text format.
4539 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
4540 # been applied to all managed instances in the group.
4541 },
4542 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
4543 # Currently only one accelerator topology is supported.
4544 {
4545 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
4546 # The value is the same as configured in the WorkloadPolicy.
4547 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
4548 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
4549 # check.
4550 &quot;error&quot;: { # Output only. Encountered errors.
4551 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4552 # operation.
4553 {
4554 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4555 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4556 # details. There is a set of defined message types to use for providing
4557 # details.The syntax depends on the error code. For example,
4558 # QuotaExceededInfo will have details when the error code is
4559 # QUOTA_EXCEEDED.
4560 {
4561 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4562 #
4563 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4564 # is not enabled:
4565 #
4566 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4567 # &quot;domain&quot;: &quot;googleapis.com&quot;
4568 # &quot;metadata&quot;: {
4569 # &quot;resource&quot;: &quot;projects/123&quot;,
4570 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4571 # }
4572 # }
4573 #
4574 # This response indicates that the pubsub.googleapis.com API is not enabled.
4575 #
4576 # Example of an error that is returned when attempting to create a Spanner
4577 # instance in a region that is out of stock:
4578 #
4579 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4580 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4581 # &quot;metadata&quot;: {
4582 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4583 # }
4584 # }
4585 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4586 # is typically the registered service name of the tool or product that
4587 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4588 # generated by some common infrastructure, the error domain must be a
4589 # globally unique value that identifies the infrastructure. For Google API
4590 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4591 &quot;metadatas&quot;: { # Additional structured details about this error.
4592 #
4593 # Keys must match a regular expression of `a-z+` but should
4594 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4595 # length. When identifying the current value of an exceeded limit, the units
4596 # should be contained in the key, not the value. For example, rather than
4597 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4598 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4599 # instances that can be created in a single (batch) request.
4600 &quot;a_key&quot;: &quot;A String&quot;,
4601 },
4602 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4603 # proximate cause of the error. Error reasons are unique within a particular
4604 # domain of errors. This should be at most 63 characters and match a
4605 # regular expression of `A-Z+[A-Z0-9]`, which represents
4606 # UPPER_SNAKE_CASE.
4607 },
4608 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4609 #
4610 # For example, if a quota check failed with an error indicating the calling
4611 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4612 # directly to the right place in the developer console to flip the bit.
4613 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4614 { # Describes a URL link.
4615 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4616 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4617 },
4618 ],
4619 },
4620 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4621 # which can be attached to an RPC error.
4622 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4623 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4624 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4625 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4626 },
4627 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4628 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4629 &quot;a_key&quot;: &quot;A String&quot;,
4630 },
4631 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4632 # type or metric.
4633 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4634 # or metric.
4635 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4636 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4637 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4638 },
4639 },
4640 ],
4641 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4642 # This property is optional.
4643 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4644 },
4645 ],
4646 },
4647 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
4648 # has // RFC3339 //
4649 # text format.
4650 },
4651 },
4652 ],
4653 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
4654 # that targets this instance group manager.
4655 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
4656 # targetSizePolicy.mode is set to BULK.
4657 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
4658 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
4659 # operation.
4660 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
4661 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4662 # operation.
4663 {
4664 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4665 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4666 # details. There is a set of defined message types to use for providing
4667 # details.The syntax depends on the error code. For example,
4668 # QuotaExceededInfo will have details when the error code is
4669 # QUOTA_EXCEEDED.
4670 {
4671 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4672 #
4673 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4674 # is not enabled:
4675 #
4676 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4677 # &quot;domain&quot;: &quot;googleapis.com&quot;
4678 # &quot;metadata&quot;: {
4679 # &quot;resource&quot;: &quot;projects/123&quot;,
4680 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4681 # }
4682 # }
4683 #
4684 # This response indicates that the pubsub.googleapis.com API is not enabled.
4685 #
4686 # Example of an error that is returned when attempting to create a Spanner
4687 # instance in a region that is out of stock:
4688 #
4689 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4690 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4691 # &quot;metadata&quot;: {
4692 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4693 # }
4694 # }
4695 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4696 # is typically the registered service name of the tool or product that
4697 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4698 # generated by some common infrastructure, the error domain must be a
4699 # globally unique value that identifies the infrastructure. For Google API
4700 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4701 &quot;metadatas&quot;: { # Additional structured details about this error.
4702 #
4703 # Keys must match a regular expression of `a-z+` but should
4704 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4705 # length. When identifying the current value of an exceeded limit, the units
4706 # should be contained in the key, not the value. For example, rather than
4707 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4708 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4709 # instances that can be created in a single (batch) request.
4710 &quot;a_key&quot;: &quot;A String&quot;,
4711 },
4712 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4713 # proximate cause of the error. Error reasons are unique within a particular
4714 # domain of errors. This should be at most 63 characters and match a
4715 # regular expression of `A-Z+[A-Z0-9]`, which represents
4716 # UPPER_SNAKE_CASE.
4717 },
4718 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4719 #
4720 # For example, if a quota check failed with an error indicating the calling
4721 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4722 # directly to the right place in the developer console to flip the bit.
4723 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4724 { # Describes a URL link.
4725 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4726 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4727 },
4728 ],
4729 },
4730 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4731 # which can be attached to an RPC error.
4732 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4733 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4734 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4735 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4736 },
4737 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4738 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4739 &quot;a_key&quot;: &quot;A String&quot;,
4740 },
4741 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4742 # type or metric.
4743 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4744 # or metric.
4745 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4746 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4747 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4748 },
4749 },
4750 ],
4751 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4752 # This property is optional.
4753 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4754 },
4755 ],
4756 },
4757 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
4758 # operation. Timestamp is in RFC3339 text format.
4759 },
4760 },
4761 &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
4762 # in this managed instance group that have the status. Currently only shown
4763 # for TPU MIGs
4764 # instance group that have the status. For more information about how to
4765 # interpret each status check the instance lifecycle documentation.
4766 # Currently only shown for TPU MIGs.
4767 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
4768 # that have DEPROVISIONING status.
4769 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
4770 # have been deleted. Includes only instances that would be shown in the
4771 # listManagedInstances method and not all instances that have been
4772 # deleted in the lifetime of the MIG.
4773 # Does not include FlexStart instances that are waiting for the resources
4774 # availability, they are considered as &#x27;pending&#x27;.
4775 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
4776 # that have PENDING status, that is FlexStart instances that are waiting
4777 # for resources. Instances that do not exist because of the other reasons
4778 # are counted as &#x27;non_existent&#x27;.
4779 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
4780 # that have PENDING_STOP status.
4781 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
4782 # that have PROVISIONING status.
4783 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
4784 # that have REPAIRING status.
4785 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
4786 # that have RUNNING status.
4787 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
4788 # that have STAGING status.
4789 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
4790 # that have STOPPED status.
4791 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
4792 # that have STOPPING status.
4793 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
4794 # that have SUSPENDED status.
4795 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
4796 # that have SUSPENDING status.
4797 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
4798 # that have TERMINATED status.
4799 },
4800 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
4801 # stable state. A stable state means that: none of the instances in the
4802 # managed instance group is currently undergoing any type of change (for
4803 # example, creation, restart, or deletion); no future changes are scheduled
4804 # for instances in the managed instance group; and the managed instance
4805 # group itself is not being modified.
4806 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
4807 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
4808 # has stateful configuration, that is, if you have configured any items
4809 # in a stateful policy or in per-instance configs.
4810 # The group might report that it has no stateful configuration even when
4811 # there is still some preserved state on a managed instance, for example,
4812 # if you have deleted all PICs but not yet applied those deletions.
4813 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
4814 # has stateful configuration, that is, if you have configured any items
4815 # in a stateful policy or in per-instance configs.
4816 # The group might report that it has no stateful configuration even when
4817 # there is still some preserved state on a managed instance, for example,
4818 # if you have deleted all PICs but not yet applied those deletions. This
4819 # field is deprecated in favor of has_stateful_config.
4820 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
4821 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
4822 # (listed in the output of a listPerInstanceConfigs API call) have
4823 # status EFFECTIVE or there are no per-instance-configs.
4824 },
4825 },
4826 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
4827 # target version specified by version field on Instance Group
4828 # Manager.
4829 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
4830 # in this managed instance group, i.e. all instances are in their target
4831 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
4832 },
4833 },
4834 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
4835 # apply to all of the instances in the managed instance group.
4836 &quot;A String&quot;,
4837 ],
4838 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
4839 # You can reduce this number by using the instanceGroupManager
4840 # deleteInstances or abandonInstances methods. Resizing the group also
4841 # changes this number.
4842 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
4843 # size.
4844 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
4845 # individually or all at once.
4846 },
4847 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
4848 # This number changes when you:
4849 #
4850 # - Stop instance using the stopInstances
4851 # method or start instances using the startInstances
4852 # method.
4853 # - Manually change the targetStoppedSize using the update
4854 # method.
4855 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
4856 # This number changes when you:
4857 #
4858 # - Suspend instance using the suspendInstances
4859 # method or resume instances using the resumeInstances
4860 # method.
4861 # - Manually change the targetSuspendedSize using the update
4862 # method.
4863 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
4864 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
4865 &quot;A String&quot;,
4866 ],
4867 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
4868 # instance redistribution policy for regional managed instance groups.
4869 # Valid values are:
4870 #
4871 # - PROACTIVE (default): The group attempts to maintain an
4872 # even distribution of VM instances across zones in the region.
4873 # - NONE: For non-autoscaled groups, proactive
4874 # redistribution is disabled.
4875 &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
4876 # either a fixed number or, if the group has 10 or more instances, a
4877 # percentage. If you set a percentage, the number of instances is rounded
4878 # if necessary. The default value for maxSurge is a fixed
4879 # value equal to the number of zones in which the managed instance group
4880 # operates.
4881 #
4882 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
4883 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
4884 #
4885 #
4886 #
4887 # - If the value is fixed, then the calculated
4888 # value is equal to the fixed value.
4889 # - If the value is a percent, then the
4890 # calculated
4891 # value is percent/100 * targetSize. For example,
4892 # the calculated value of a 80% of a managed instance group
4893 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
4894 # is a remainder, the number is rounded.
4895 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
4896 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
4897 # example, specify 80 for 80%.
4898 },
4899 &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
4900 # process. An instance is considered available if all of the following
4901 # conditions are satisfied:
4902 #
4903 #
4904 #
4905 # - The instance&#x27;s status is
4906 # RUNNING.
4907 # - If there is a health
4908 # check on the instance group, the instance&#x27;s health check status
4909 # must be HEALTHY at least once. If there is no health check
4910 # on the group, then the instance only needs to have a status of
4911 # RUNNING to be considered available.
4912 #
4913 #
4914 # This value can be either a fixed number or, if the group has 10 or more
4915 # instances, a percentage. If you set a percentage, the number of instances
4916 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
4917 # in which the managed instance group operates.
4918 #
4919 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
4920 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
4921 #
4922 #
4923 #
4924 # - If the value is fixed, then the calculated
4925 # value is equal to the fixed value.
4926 # - If the value is a percent, then the
4927 # calculated
4928 # value is percent/100 * targetSize. For example,
4929 # the calculated value of a 80% of a managed instance group
4930 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
4931 # is a remainder, the number is rounded.
4932 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
4933 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
4934 # example, specify 80 for 80%.
4935 },
4936 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
4937 # becomes available. This value must be from range [0, 3600].
4938 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
4939 # disruption as much as possible or to apply a more disruptive action than
4940 # is necessary.
4941 #
4942 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
4943 # Compute Engine performs the necessary action to execute the update.
4944 # - To apply a more disruptive action than is strictly necessary, set the
4945 # minimal action to RESTART or REPLACE. For
4946 # example, Compute Engine does not need to restart a VM to change its
4947 # metadata. But if your application reads instance metadata only when a VM
4948 # is restarted, you can set the minimal action to RESTART in
4949 # order to pick up metadata changes.
4950 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
4951 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
4952 # as much as possible. RESTART to allow actions that can be
4953 # applied without instance replacing or REPLACE to allow all
4954 # possible actions. If the Updater determines that the minimal update
4955 # action needed is more disruptive than most disruptive allowed action you
4956 # specify it will not perform the update at all.
4957 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
4958 # See minimal_action.REPLACE
4959 &quot;type&quot;: &quot;A String&quot;, # The type
4960 # of update process. You can specify either PROACTIVE so
4961 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
4962 # to update.
4963 },
4964 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
4965 # create instances.
4966 #
4967 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
4968 # group. This field overrides the top-level instanceTemplate
4969 # field. Read more about therelationships
4970 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
4971 # remaining instances. For more information, read aboutcanary
4972 # updates.
4973 {
4974 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
4975 # instance group. The group uses this template to create new instances in
4976 # the managed instance group until the `targetSize` for this version is
4977 # reached. The templates for existing instances in the group do not change
4978 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
4979 # existing instances are updated until the `targetSize` for this version is
4980 # reached.
4981 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
4982 # managed instance group.
4983 &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
4984 # from the template will be equal to:
4985 #
4986 #
4987 # - If expressed as a fixed number, the minimum of either
4988 # targetSize.fixed or
4989 # instanceGroupManager.targetSize is used.
4990 # - if expressed as a percent, the targetSize
4991 # would be (targetSize.percent/100 *
4992 # InstanceGroupManager.targetSize) If there is a remainder, the
4993 # number is rounded.
4994 #
4995 # If unset, this version will update any remaining instances not
4996 # updated by another version. ReadStarting
4997 # a canary update for more information.
4998 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
4999 #
5000 #
5001 #
5002 # - If the value is fixed, then the calculated
5003 # value is equal to the fixed value.
5004 # - If the value is a percent, then the
5005 # calculated
5006 # value is percent/100 * targetSize. For example,
5007 # the calculated value of a 80% of a managed instance group
5008 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
5009 # is a remainder, the number is rounded.
5010 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
5011 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
5012 # example, specify 80 for 80%.
5013 },
5014 },
5015 ],
5016 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
5017 # where the managed instance group is located (for zonal resources).
5018 }
5019
5020 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
5021 that if you must retry your request, the server will know to ignore the
5022 request if it has already been completed.
5023
5024 For example, consider a situation where you make an initial request and
5025 the request times out. If you make the request again with the same
5026 request ID, the server can check if original operation with the same
5027 request ID was received, and if so, will ignore the second request. This
5028 prevents clients from accidentally creating duplicate commitments.
5029
5030 The request ID must be
5031 a valid UUID with the exception that zero UUID is not supported
5032 (00000000-0000-0000-0000-000000000000).
5033 x__xgafv: string, V1 error format.
5034 Allowed values
5035 1 - v1 error format
5036 2 - v2 error format
5037
5038 Returns:
5039 An object of the form:
5040
5041 { # Represents an Operation resource.
5042 #
5043 # Google Compute Engine has three Operation resources:
5044 #
5045 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
5046 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
5047 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
5048 #
5049 # You can use an operation resource to manage asynchronous API requests.
5050 # For more information, readHandling
5051 # API responses.
5052 #
5053 # Operations can be global, regional or zonal.
5054 #
5055 # - For global operations, use the `globalOperations`
5056 # resource.
5057 # - For regional operations, use the
5058 # `regionOperations` resource.
5059 # - For zonal operations, use
5060 # the `zoneOperations` resource.
5061 #
5062 #
5063 #
5064 # For more information, read
5065 # Global, Regional, and Zonal Resources.
5066 #
5067 # Note that completed Operation resources have a limited
5068 # retention period.
5069 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
5070 # Not present otherwise.
5071 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
5072 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
5073 # set when the operation is created.
5074 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
5075 # text format.
5076 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
5077 # this field will be populated.
5078 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
5079 # operation.
5080 {
5081 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
5082 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
5083 # details. There is a set of defined message types to use for providing
5084 # details.The syntax depends on the error code. For example,
5085 # QuotaExceededInfo will have details when the error code is
5086 # QUOTA_EXCEEDED.
5087 {
5088 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
5089 #
5090 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
5091 # is not enabled:
5092 #
5093 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
5094 # &quot;domain&quot;: &quot;googleapis.com&quot;
5095 # &quot;metadata&quot;: {
5096 # &quot;resource&quot;: &quot;projects/123&quot;,
5097 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
5098 # }
5099 # }
5100 #
5101 # This response indicates that the pubsub.googleapis.com API is not enabled.
5102 #
5103 # Example of an error that is returned when attempting to create a Spanner
5104 # instance in a region that is out of stock:
5105 #
5106 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
5107 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
5108 # &quot;metadata&quot;: {
5109 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
5110 # }
5111 # }
5112 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
5113 # is typically the registered service name of the tool or product that
5114 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
5115 # generated by some common infrastructure, the error domain must be a
5116 # globally unique value that identifies the infrastructure. For Google API
5117 # infrastructure, the error domain is &quot;googleapis.com&quot;.
5118 &quot;metadatas&quot;: { # Additional structured details about this error.
5119 #
5120 # Keys must match a regular expression of `a-z+` but should
5121 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
5122 # length. When identifying the current value of an exceeded limit, the units
5123 # should be contained in the key, not the value. For example, rather than
5124 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
5125 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
5126 # instances that can be created in a single (batch) request.
5127 &quot;a_key&quot;: &quot;A String&quot;,
5128 },
5129 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
5130 # proximate cause of the error. Error reasons are unique within a particular
5131 # domain of errors. This should be at most 63 characters and match a
5132 # regular expression of `A-Z+[A-Z0-9]`, which represents
5133 # UPPER_SNAKE_CASE.
5134 },
5135 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
5136 #
5137 # For example, if a quota check failed with an error indicating the calling
5138 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
5139 # directly to the right place in the developer console to flip the bit.
5140 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
5141 { # Describes a URL link.
5142 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
5143 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
5144 },
5145 ],
5146 },
5147 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
5148 # which can be attached to an RPC error.
5149 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
5150 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
5151 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
5152 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
5153 },
5154 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
5155 &quot;dimensions&quot;: { # The map holding related quota dimensions.
5156 &quot;a_key&quot;: &quot;A String&quot;,
5157 },
5158 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
5159 # type or metric.
5160 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
5161 # or metric.
5162 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
5163 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
5164 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
5165 },
5166 },
5167 ],
5168 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
5169 # This property is optional.
5170 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
5171 },
5172 ],
5173 },
5174 &quot;getVersionOperationMetadata&quot;: {
5175 &quot;inlineSbomInfo&quot;: {
5176 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
5177 # appropriate identifiers.
5178 &quot;a_key&quot;: &quot;A String&quot;,
5179 },
5180 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
5181 # identifiers.
5182 &quot;a_key&quot;: &quot;A String&quot;,
5183 },
5184 },
5185 },
5186 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
5187 # message that was returned, such as `NOT FOUND`.
5188 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
5189 # status code that was returned. For example, a `404` means the
5190 # resource was not found.
5191 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
5192 # defined by the server.
5193 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
5194 # This value is inRFC3339
5195 # text format.
5196 &quot;instancesBulkInsertOperationMetadata&quot;: {
5197 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
5198 # Example key: zones/us-central1-a
5199 &quot;a_key&quot;: {
5200 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
5201 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
5202 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
5203 # error.
5204 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
5205 # if the flow is rolling forward or rolling back.
5206 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
5207 },
5208 },
5209 },
5210 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
5211 # Operation resources.
5212 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
5213 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
5214 # group of operations results from a `bulkInsert` API request.
5215 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
5216 # `update`, or `delete`, and so on.
5217 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
5218 # There is no requirement that this be linear or support any granularity of
5219 # operations. This should not be used to guess when the operation will be
5220 # complete. This number should monotonically increase as the operation
5221 # progresses.
5222 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
5223 # applicable when performing regional operations.
5224 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
5225 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
5226 # this field will contain information on all underlying zonal actions and
5227 # their state.
5228 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
5229 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
5230 # Example key: zones/us-central1-a
5231 &quot;a_key&quot;: {
5232 &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
5233 # populated.
5234 # different programming environments, including REST APIs and RPC APIs. It is
5235 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
5236 # three pieces of data: error code, error message, and error details.
5237 #
5238 # You can find out more about this error model and how to work with it in the
5239 # [API Design Guide](https://cloud.google.com/apis/design/errors).
5240 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
5241 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
5242 # message types for APIs to use.
5243 {
5244 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
5245 },
5246 ],
5247 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
5248 # user-facing error message should be localized and sent in the
5249 # google.rpc.Status.details field, or localized by the client.
5250 },
5251 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
5252 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
5253 },
5254 },
5255 },
5256 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
5257 # This value is inRFC3339
5258 # text format.
5259 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
5260 # following:
5261 # `PENDING`, `RUNNING`, or `DONE`.
5262 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
5263 # operation.
5264 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
5265 # of the target resource.
5266 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
5267 # operations related to creating a snapshot, this points to the disk
5268 # that the snapshot was created from.
5269 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
5270 # `[email protected]` or
5271 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
5272 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
5273 # operation, this field will be populated.
5274 {
5275 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
5276 # Engine returns NO_RESULTS_ON_PAGE if there
5277 # are no results in the response.
5278 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
5279 # value format. For example:
5280 #
5281 # &quot;data&quot;: [
5282 # {
5283 # &quot;key&quot;: &quot;scope&quot;,
5284 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
5285 # }
5286 {
5287 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
5288 # returned. For example, for warnings where there are no results in a list
5289 # request for a particular zone, this key might be scope and
5290 # the key value might be the zone name. Other examples might be a key
5291 # indicating a deprecated resource and a suggested replacement, or a
5292 # warning about invalid network settings (for example, if an instance
5293 # attempts to perform IP forwarding but is not enabled for IP forwarding).
5294 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
5295 },
5296 ],
5297 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
5298 },
5299 ],
5300 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
5301 # applicable when performing per-zone operations.
5302 }</pre>
5303 </div>
5304
5305 <div class="method">
5306 <code class="details" id="list">list(project, region, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
5307 <pre>Retrieves the list of managed instance groups that are contained
5308 within the specified region.
5309
5310 Args:
5311 project: string, Project ID for this request. (required)
5312 region: string, Name of the region scoping this request. (required)
5313 filter: string, A filter expression that filters resources listed in the response. Most
5314 Compute resources support two types of filter expressions:
5315 expressions that support regular expressions and expressions that follow
5316 API improvement proposal AIP-160.
5317 These two types of filter expressions cannot be mixed in one request.
5318
5319 If you want to use AIP-160, your expression must specify the field name, an
5320 operator, and the value that you want to use for filtering. The value
5321 must be a string, a number, or a boolean. The operator
5322 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
5323
5324 For example, if you are filtering Compute Engine instances, you can
5325 exclude instances named `example-instance` by specifying
5326 `name != example-instance`.
5327
5328 The `:*` comparison can be used to test whether a key has been defined.
5329 For example, to find all objects with `owner` label use:
5330 ```
5331 labels.owner:*
5332 ```
5333
5334 You can also filter nested fields. For example, you could specify
5335 `scheduling.automaticRestart = false` to include instances only
5336 if they are not scheduled for automatic restarts. You can use filtering
5337 on nested fields to filter based onresource labels.
5338
5339 To filter on multiple expressions, provide each separate expression within
5340 parentheses. For example:
5341 ```
5342 (scheduling.automaticRestart = true)
5343 (cpuPlatform = &quot;Intel Skylake&quot;)
5344 ```
5345 By default, each expression is an `AND` expression. However, you
5346 can include `AND` and `OR` expressions explicitly.
5347 For example:
5348 ```
5349 (cpuPlatform = &quot;Intel Skylake&quot;) OR
5350 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
5351 (scheduling.automaticRestart = true)
5352 ```
5353
5354 If you want to use a regular expression, use the `eq` (equal) or `ne`
5355 (not equal) operator against a single un-parenthesized expression with or
5356 without quotes or against multiple parenthesized expressions. Examples:
5357
5358 `fieldname eq unquoted literal`
5359 `fieldname eq &#x27;single quoted literal&#x27;`
5360 `fieldname eq &quot;double quoted literal&quot;`
5361 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
5362
5363 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
5364 The literal value must match the entire field.
5365
5366 For example, to filter for instances that do not end with name &quot;instance&quot;,
5367 you would use `name ne .*instance`.
5368
5369 You cannot combine constraints on multiple fields using regular
5370 expressions.
5371 maxResults: integer, The maximum number of results per page that should be returned.
5372 If the number of available results is larger than `maxResults`,
5373 Compute Engine returns a `nextPageToken` that can be used to get
5374 the next page of results in subsequent list requests. Acceptable values are
5375 `0` to `500`, inclusive. (Default: `500`)
5376 orderBy: string, Sorts list results by a certain order. By default, results
5377 are returned in alphanumerical order based on the resource name.
5378
5379 You can also sort results in descending order based on the creation
5380 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
5381 results based on the `creationTimestamp` field in
5382 reverse chronological order (newest result first). Use this to sort
5383 resources like operations so that the newest operation is returned first.
5384
5385 Currently, only sorting by `name` or
5386 `creationTimestamp desc` is supported.
5387 pageToken: string, Specifies a page token to use. Set `pageToken` to the
5388 `nextPageToken` returned by a previous list request to get
5389 the next page of results.
5390 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
5391 of failure. The default value is false.
5392
5393 For example, when partial success behavior is enabled, aggregatedList for a
5394 single zone scope either returns all resources in the zone or no resources,
5395 with an error code.
5396 x__xgafv: string, V1 error format.
5397 Allowed values
5398 1 - v1 error format
5399 2 - v2 error format
5400
5401 Returns:
5402 An object of the form:
5403
5404 { # Contains a list of managed instance groups.
5405 &quot;id&quot;: &quot;A String&quot;, # Output only. Unique identifier for the resource; defined by the server.
5406 &quot;items&quot;: [ # A list of InstanceGroupManager resources.
5407 { # Represents a Managed Instance Group resource.
5408 #
5409 # An instance group is a collection of VM instances that you can manage as a
5410 # single entity. For more information, readInstance groups.
5411 #
5412 # For zonal Managed Instance Group, use the instanceGroupManagers
5413 # resource.
5414 #
5415 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
5416 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
5417 # for the group.
5418 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
5419 #
5420 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
5421 # instances to apply the configuration. To apply the configuration, set the
5422 # group&#x27;s updatePolicy.type field to use proactive updates or
5423 # use the applyUpdatesToInstances method.
5424 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
5425 &quot;a_key&quot;: &quot;A String&quot;,
5426 },
5427 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
5428 # more information, see Project and
5429 # instance metadata.
5430 &quot;a_key&quot;: &quot;A String&quot;,
5431 },
5432 },
5433 },
5434 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
5435 # only one value.
5436 {
5437 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
5438 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
5439 # initialize and run its startup script. During a VM&#x27;s initial delay
5440 # period, the MIG ignores unsuccessful health checks because the VM might
5441 # be in the startup process. This prevents the MIG from prematurely
5442 # recreating a VM. If the health check receives a healthy response during
5443 # the initial delay, it indicates that the startup process is complete and
5444 # the VM is ready. The value of initial delay must be between 0 and 3600
5445 # seconds. The default value is 0.
5446 },
5447 ],
5448 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
5449 # all VMs in a MIG. The maximum character length is 58 and the name must
5450 # comply with RFC1035 format.
5451 #
5452 # When a VM is created in the group, the MIG appends a hyphen and a random
5453 # four-character string to the base instance name. If you want the MIG to
5454 # assign sequential numbers instead of a random string, then end the base
5455 # instance name with a hyphen followed by one or more hash symbols. The hash
5456 # symbols indicate the number of digits. For example, a base instance name of
5457 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
5458 # @pattern
5459 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
5460 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
5461 # text format.
5462 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
5463 # in this managed instance group that are scheduled for each of those
5464 # actions.
5465 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
5466 # that are scheduled to be abandoned. Abandoning an instance removes it
5467 # from the managed instance group without deleting it.
5468 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
5469 # are scheduled to be adopted or are currently being adopted.
5470 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
5471 # are scheduled to be created or are currently being created. If the group
5472 # fails to create any of these instances, it tries again until it creates
5473 # the instance successfully.
5474 #
5475 # If you have disabled creation retries, this field will not be populated;
5476 # instead, the creatingWithoutRetries field will be populated.
5477 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
5478 # will attempt to create. The group attempts to create each instance
5479 # only once. If the group fails to create any of these instances, it
5480 # decreases the group&#x27;s targetSize value accordingly.
5481 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
5482 # are scheduled to be deleted or are currently being deleted.
5483 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
5484 # are running and have no scheduled actions.
5485 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
5486 # are scheduled to be recreated or are currently being being recreated.
5487 # Recreating an instance deletes the existing root persistent disk
5488 # and creates a new disk from the image that is defined in the
5489 # instance template.
5490 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
5491 # are being reconfigured with properties that do not require a restart
5492 # or a recreate action. For example, setting or removing target
5493 # pools for the instance.
5494 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
5495 # are scheduled to be restarted or are currently being restarted.
5496 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
5497 # are scheduled to be restarted or are currently being restarted.
5498 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
5499 # are scheduled to be resumed or are currently being resumed.
5500 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
5501 # are scheduled to be started or are currently being started.
5502 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
5503 # are scheduled to be stopped or are currently being stopped.
5504 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
5505 # are scheduled to be suspended or are currently being suspended.
5506 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
5507 # are being verified. See the managedInstances[].currentAction
5508 # property in the listManagedInstances method documentation.
5509 },
5510 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
5511 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
5512 # zones in a regional managed instance group.
5513 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
5514 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
5515 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
5516 # its instances.
5517 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
5518 # instances, even if an AI zone is available in the specified region. To
5519 # create instances in an AI zone in the selected region, you must explicitly
5520 # specify it in the distribution policy together with the other preferred
5521 # zones.
5522 {
5523 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
5524 # The zone must exist in the region where the managed instance group is
5525 # located.
5526 },
5527 ],
5528 },
5529 &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.
5530 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
5531 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
5532 # fingerprint must be provided in order to update the InstanceGroupManager,
5533 # otherwise the request will fail with error412 conditionNotMet.
5534 #
5535 # To see the latest fingerprint, make a get() request to
5536 # retrieve an InstanceGroupManager.
5537 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
5538 # generates this identifier.
5539 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
5540 # types of machines.
5541 # Instance flexibility configuration on MIG overrides instance
5542 # template configuration.
5543 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
5544 # when creating new VMs.
5545 &quot;a_key&quot;: {
5546 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
5547 # selection.
5548 { # An instance-attached disk resource.
5549 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
5550 # or X86_64.
5551 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
5552 # deleted (but not when the disk is detached from the instance).
5553 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
5554 # partition of the disk for its root filesystem.
5555 &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
5556 # running within the instance. This name can be used to reference the device
5557 # for mounting, resizing, and so on, from within the instance.
5558 #
5559 # If not specified, the server chooses a default device name to apply to this
5560 # disk, in the form persistent-disk-x, where x is a number
5561 # assigned by Google Compute Engine. This field is only applicable for
5562 # persistent disks.
5563 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
5564 # encryption key.
5565 #
5566 # If you are creating a new disk, this field encrypts the new disk using
5567 # an encryption key that you provide. If you are attaching an existing
5568 # disk that is already encrypted, this field decrypts the disk using
5569 # the customer-supplied encryption key.
5570 #
5571 # If you encrypt a disk using a customer-supplied key, you must provide the
5572 # same key again when you attempt to use this resource at a later time. For
5573 # example, you must provide the key when you create a snapshot or an image
5574 # from the disk or when you attach the disk to a virtual machine instance.
5575 #
5576 # If you do not provide an encryption key, then the disk will be encrypted
5577 # using an automatically generated key and you do not need to provide a key
5578 # to use the disk later.
5579 #
5580 # Note:
5581 #
5582 # Instance templates do not storecustomer-supplied
5583 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
5584 #
5585 # You cannot create VMs that have disks with customer-supplied keys using
5586 # the bulk
5587 # insert method.
5588 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5589 # For example:
5590 #
5591 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5592 # key_region/cryptoKeys/key
5593 #
5594 # The fully-qualifed key name may be returned for resource GET requests. For
5595 # example:
5596 #
5597 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5598 # key_region/cryptoKeys/key
5599 # /cryptoKeyVersions/1
5600 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5601 # key. If absent, the Compute Engine default service account is used.
5602 # For example:
5603 #
5604 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5605 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5606 # encryption key, encoded in RFC
5607 # 4648 base64 to either encrypt or decrypt this resource. You can
5608 # provide either the rawKey or thersaEncryptedKey.
5609 # For example:
5610 #
5611 # &quot;rawKey&quot;:
5612 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5613 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5614 # customer-supplied encryption key to either encrypt or decrypt this
5615 # resource. You can provide either the rawKey or thersaEncryptedKey.
5616 # For example:
5617 #
5618 # &quot;rsaEncryptedKey&quot;:
5619 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5620 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5621 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5622 #
5623 # The key must meet the following requirements before you can provide it to
5624 # Compute Engine:
5625 #
5626 # 1. The key is wrapped using a RSA public key certificate provided by
5627 # Google.
5628 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5629 # encoding.
5630 #
5631 # Gets the RSA public key certificate provided by Google at:
5632 #
5633 #
5634 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5635 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5636 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5637 # encryption key that protects this resource.
5638 },
5639 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
5640 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
5641 # currently attached to another instance. If you try to force attach a zonal
5642 # disk to an instance, you will receive an error.
5643 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5644 # only for bootable images. Read
5645 # Enabling guest operating system features to see a list of available
5646 # options.
5647 { # Guest OS features.
5648 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5649 # separate values. Set to one or more of the following values:
5650 #
5651 # - VIRTIO_SCSI_MULTIQUEUE
5652 # - WINDOWS
5653 # - MULTI_IP_SUBNET
5654 # - UEFI_COMPATIBLE
5655 # - GVNIC
5656 # - SEV_CAPABLE
5657 # - SUSPEND_RESUME_COMPATIBLE
5658 # - SEV_LIVE_MIGRATABLE_V2
5659 # - SEV_SNP_CAPABLE
5660 # - TDX_CAPABLE
5661 # - IDPF
5662 # - SNP_SVSM_CAPABLE
5663 # - CCA_CAPABLE
5664 #
5665 #
5666 # For more information, see
5667 # Enabling guest operating system features.
5668 },
5669 ],
5670 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
5671 # boot disk. If you have many disks attached to an instance, each
5672 # disk would have a unique index number.
5673 &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
5674 # alongside the new instance. Use initialization parameters to create boot
5675 # disks or local SSDs attached to the new instance.
5676 #
5677 # This property is mutually exclusive with the source property;
5678 # you can only define one or the other, but not both.
5679 # alongside the new instance. Use initialization parameters to create boot
5680 # disks or local SSDs attached to the new instance.
5681 #
5682 # This field is persisted and returned for instanceTemplate and not returned
5683 # in the context of instance.
5684 #
5685 # This property is mutually exclusive with the source property;
5686 # you can only define one or the other, but not both.
5687 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
5688 # arm64 or x86_64.
5689 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
5690 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
5691 # of the instance. If a disk with the same name already exists in the given
5692 # region, the existing disk is attached to the new instance and the
5693 # new disk is not created.
5694 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
5695 # 10 GB. If you specify a sourceImage, which is required for
5696 # boot disks, the default size is the size of the sourceImage.
5697 # If you do not specify a sourceImage, the default disk size
5698 # is 500 GB.
5699 &quot;diskType&quot;: &quot;A String&quot;,
5700 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
5701 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5702 # only for bootable images. Read
5703 # Enabling guest operating system features to see a list of available
5704 # options.
5705 #
5706 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
5707 { # Guest OS features.
5708 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5709 # separate values. Set to one or more of the following values:
5710 #
5711 # - VIRTIO_SCSI_MULTIQUEUE
5712 # - WINDOWS
5713 # - MULTI_IP_SUBNET
5714 # - UEFI_COMPATIBLE
5715 # - GVNIC
5716 # - SEV_CAPABLE
5717 # - SUSPEND_RESUME_COMPATIBLE
5718 # - SEV_LIVE_MIGRATABLE_V2
5719 # - SEV_SNP_CAPABLE
5720 # - TDX_CAPABLE
5721 # - IDPF
5722 # - SNP_SVSM_CAPABLE
5723 # - CCA_CAPABLE
5724 #
5725 #
5726 # For more information, see
5727 # Enabling guest operating system features.
5728 },
5729 ],
5730 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
5731 # persistent disks.
5732 &quot;a_key&quot;: &quot;A String&quot;,
5733 },
5734 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
5735 &quot;A String&quot;,
5736 ],
5737 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
5738 # more than one instance.
5739 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
5740 # is to use the existing disk.
5741 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
5742 # of I/O operations per second that the disk can handle. Values must be
5743 # between 10,000 and 120,000. For more details, see theExtreme persistent
5744 # disk documentation.
5745 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
5746 # number of throughput mb per second that the disk can handle. Values must
5747 # greater than or equal to 1.
5748 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
5749 # the URLs of the zones where the disk should be replicated to.
5750 # You must provide exactly two replica zones, and one zone must be the same
5751 # as the instance zone.
5752 &quot;A String&quot;,
5753 ],
5754 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
5755 # have the same definition as resource
5756 # manager tags. Keys and values can be either in numeric format,
5757 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
5758 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
5759 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
5760 # empty.
5761 &quot;a_key&quot;: &quot;A String&quot;,
5762 },
5763 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
5764 # Specified using the full or partial URL. For instance template, specify
5765 # only the resource policy name.
5766 &quot;A String&quot;,
5767 ],
5768 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
5769 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5770 # is required.
5771 #
5772 # To create a disk with one of the public operating system
5773 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
5774 #
5775 # projects/debian-cloud/global/images/family/debian-9
5776 #
5777 #
5778 # Alternatively, use a specific version of a public operating system image:
5779 #
5780 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
5781 #
5782 #
5783 # To create a disk with a custom image that you created, specify the
5784 # image name in the following format:
5785 #
5786 # global/images/my-custom-image
5787 #
5788 #
5789 # You can also specify a custom image by its image family, which returns
5790 # the latest version of the image in that family. Replace the image name
5791 # with family/family-name:
5792 #
5793 # global/images/family/my-image-family
5794 #
5795 #
5796 # If the source image is deleted later, this field will not be set.
5797 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
5798 # encryption key of the source image. Required if the source image is
5799 # protected by a customer-supplied encryption key.
5800 #
5801 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
5802 # encryption keys, so you cannot create disks for instances in a managed instance group if the
5803 # source images are encrypted with your own keys.
5804 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5805 # For example:
5806 #
5807 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5808 # key_region/cryptoKeys/key
5809 #
5810 # The fully-qualifed key name may be returned for resource GET requests. For
5811 # example:
5812 #
5813 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5814 # key_region/cryptoKeys/key
5815 # /cryptoKeyVersions/1
5816 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5817 # key. If absent, the Compute Engine default service account is used.
5818 # For example:
5819 #
5820 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5821 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5822 # encryption key, encoded in RFC
5823 # 4648 base64 to either encrypt or decrypt this resource. You can
5824 # provide either the rawKey or thersaEncryptedKey.
5825 # For example:
5826 #
5827 # &quot;rawKey&quot;:
5828 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5829 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5830 # customer-supplied encryption key to either encrypt or decrypt this
5831 # resource. You can provide either the rawKey or thersaEncryptedKey.
5832 # For example:
5833 #
5834 # &quot;rsaEncryptedKey&quot;:
5835 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5836 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5837 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5838 #
5839 # The key must meet the following requirements before you can provide it to
5840 # Compute Engine:
5841 #
5842 # 1. The key is wrapped using a RSA public key certificate provided by
5843 # Google.
5844 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5845 # encoding.
5846 #
5847 # Gets the RSA public key certificate provided by Google at:
5848 #
5849 #
5850 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5851 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5852 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5853 # encryption key that protects this resource.
5854 },
5855 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
5856 # instance boot disk, one of initializeParams.sourceSnapshot
5857 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
5858 # is required.
5859 #
5860 # To create a disk with a snapshot that you created, specify the
5861 # snapshot name in the following format:
5862 #
5863 # us-central1-a/instantSnapshots/my-backup
5864 #
5865 #
5866 # If the source instant-snapshot is deleted later, this field will not be
5867 # set.
5868 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
5869 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
5870 # is required.
5871 #
5872 # To create a disk with a snapshot that you created, specify the
5873 # snapshot name in the following format:
5874 #
5875 # global/snapshots/my-backup
5876 #
5877 #
5878 # If the source snapshot is deleted later, this field will not be set.
5879 #
5880 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
5881 # an image instead when you create VMs using
5882 # the bulk
5883 # insert method.
5884 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
5885 # encryption key of the source snapshot.
5886 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5887 # For example:
5888 #
5889 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5890 # key_region/cryptoKeys/key
5891 #
5892 # The fully-qualifed key name may be returned for resource GET requests. For
5893 # example:
5894 #
5895 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5896 # key_region/cryptoKeys/key
5897 # /cryptoKeyVersions/1
5898 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5899 # key. If absent, the Compute Engine default service account is used.
5900 # For example:
5901 #
5902 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5903 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5904 # encryption key, encoded in RFC
5905 # 4648 base64 to either encrypt or decrypt this resource. You can
5906 # provide either the rawKey or thersaEncryptedKey.
5907 # For example:
5908 #
5909 # &quot;rawKey&quot;:
5910 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5911 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5912 # customer-supplied encryption key to either encrypt or decrypt this
5913 # resource. You can provide either the rawKey or thersaEncryptedKey.
5914 # For example:
5915 #
5916 # &quot;rsaEncryptedKey&quot;:
5917 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5918 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5919 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5920 #
5921 # The key must meet the following requirements before you can provide it to
5922 # Compute Engine:
5923 #
5924 # 1. The key is wrapped using a RSA public key certificate provided by
5925 # Google.
5926 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5927 # encoding.
5928 #
5929 # Gets the RSA public key certificate provided by Google at:
5930 #
5931 #
5932 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5933 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5934 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5935 # encryption key that protects this resource.
5936 },
5937 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
5938 # this as a partial or full URL to the resource. For example, the following
5939 # are valid values:
5940 #
5941 #
5942 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
5943 # - projects/project/zones/zone/storagePools/storagePool
5944 # - zones/zone/storagePools/storagePool
5945 },
5946 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
5947 # either SCSI or NVME. For most machine types, the
5948 # default is SCSI. Local SSDs can use either NVME or SCSI.
5949 # In certain configurations, persistent disks can use NVMe. For more
5950 # information, seeAbout
5951 # persistent disks.
5952 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
5953 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
5954 &quot;A String&quot;,
5955 ],
5956 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
5957 # disk is not allowed to be detached from the instance, or to be used as the
5958 # source of the snapshot creation, and the image creation. The instance with
5959 # at least one locked attached disk is not allow to be used as source of
5960 # machine image creation, instant snapshot creation, and not allowed to be
5961 # deleted with --keep-disk parameter set to true for locked disks.
5962 &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
5963 # in READ_WRITE mode.
5964 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
5965 # field is set to PRESERVED if the LocalSSD data has been saved
5966 # to a persistent location by customer request. (see the
5967 # discard_local_ssd option on Stop/Suspend).
5968 # Read-only in the api.
5969 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
5970 # these are public keys which are safe to store in public
5971 &quot;dbs&quot;: [ # The Key Database (db).
5972 {
5973 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5974 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5975 },
5976 ],
5977 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
5978 {
5979 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5980 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5981 },
5982 ],
5983 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
5984 {
5985 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5986 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5987 },
5988 ],
5989 &quot;pk&quot;: { # The Platform Key (PK).
5990 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5991 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5992 },
5993 },
5994 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
5995 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5996 # is required.
5997 #
5998 # If desired, you can also attach existing non-root persistent disks using
5999 # this property. This field is only applicable for persistent disks.
6000 #
6001 # Note that for InstanceTemplate, specify the disk name for zonal disk,
6002 # and the URL for regional disk.
6003 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
6004 },
6005 ],
6006 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
6007 &quot;A String&quot;,
6008 ],
6009 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
6010 # e.g. &#x27;Intel Ice Lake&#x27;.
6011 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
6012 # preference. MIG will first try to create a VM based on the machine-type
6013 # with lowest rank and fallback to next rank based on availability.
6014 # Machine types and instance selections with the same rank have the same
6015 # preference.
6016 },
6017 },
6018 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
6019 # create instances.
6020 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
6021 # more preemption than the minimum capacity user needs. MIG will create
6022 # only Standard VMs until it reaches standard_capacity_base and only
6023 # then will start using standard_capacity_percent_above_base to mix Spot
6024 # with Standard VMs.
6025 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
6026 # remaining percentage will use Spot VMs. The percentage applies only to
6027 # the capacity above standard_capacity_base.
6028 },
6029 },
6030 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
6031 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
6032 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
6033 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
6034 # applies to the VMs on which your application fails a health check.
6035 # Valid values are
6036 #
6037 # - REPAIR (default): MIG automatically repairs a failed VM
6038 # by recreating it. For more information, see About
6039 # repairing VMs in a MIG.
6040 # - DO_NOTHING: MIG does not repair a failed VM.
6041 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
6042 # configuration when repairing a VM. Valid options are:
6043 #
6044 #
6045 #
6046 # - NO (default): If configuration updates are available, they are not
6047 # forcefully applied during repair. Instead, configuration updates are
6048 # applied according to the group&#x27;s update policy.
6049 #
6050 # - YES: If configuration updates are available, they are applied
6051 # during repair.
6052 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
6053 # unhealthy when the application running on that VM fails a health check.
6054 # Valid values are:
6055 #
6056 # - DEFAULT_ACTION (default): MIG uses the same action
6057 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
6058 # - REPAIR: MIG automatically repairs an unhealthy VM by
6059 # recreating it.
6060 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
6061 # For more information, see
6062 # About repairing VMs in a MIG.
6063 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
6064 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
6065 # Valid values are:
6066 #
6067 # - NO (default): MIG cannot change a VM&#x27;s zone during a
6068 # repair.
6069 # - YES: MIG can select a different zone for the VM during
6070 # a repair.
6071 },
6072 },
6073 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
6074 # instance group. The group uses this template to create all new instances
6075 # in the managed instance group. The templates for existing instances in the
6076 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
6077 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
6078 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
6079 # this managed instance group.
6080 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
6081 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
6082 # long, and comply withRFC1035.
6083 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
6084 # to this Instance Group Manager.
6085 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
6086 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
6087 # The name must be 1-63 characters long, and comply withRFC1035.
6088 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
6089 },
6090 ],
6091 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
6092 # as part of resource payload.
6093 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
6094 # key-value pairs. Keys and values can be either in numeric format,
6095 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
6096 # format such as `{org_id|project_id}/{tag_key_short_name}` and
6097 # `{tag_value_short_name}`. For more information, seeManage tags
6098 # for resources.
6099 &quot;a_key&quot;: &quot;A String&quot;,
6100 },
6101 },
6102 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
6103 # where the managed instance group resides (for regional resources).
6104 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
6105 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
6106 # instance group.
6107 # It can be a full or partial URL. For example, the following are
6108 # all valid URLs to a workload policy:
6109 #
6110 #
6111 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
6112 # - projects/project/regions/region/resourcePolicies/resourcePolicy
6113 # - regions/region/resourcePolicies/resourcePolicy
6114 },
6115 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
6116 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
6117 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
6118 # this URL.
6119 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
6120 # by the managed instance group on instances. The service accounts needs all
6121 # permissions required to create and delete instances.
6122 # By default, the service account
6123 # {projectNumber}@cloudservices.gserviceaccount.com is used.
6124 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
6125 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
6126 # stop a VM after that VM was created. The initial delay gives the
6127 # initialization script the time to prepare your VM for a quick scale out.
6128 # The value of initial delay must be between 0 and 3600 seconds. The
6129 # default value is 0.
6130 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
6131 # group scales out. The default mode is `MANUAL`.
6132 },
6133 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
6134 &quot;preservedState&quot;: { # Configuration of preserved resources.
6135 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
6136 # delete, update, etc. This map is keyed with the device names of
6137 # the disks.
6138 &quot;a_key&quot;: {
6139 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
6140 # update or VM instance recreate operations.
6141 # This flag is used to configure if the disk should be deleted after it
6142 # is no longer used by the group, e.g. when the given instance or
6143 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
6144 },
6145 },
6146 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
6147 # instance delete, update, etc. This map is keyed with the network
6148 # interface name.
6149 &quot;a_key&quot;: {
6150 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
6151 # update or VM instance recreate operations.
6152 # This flag is used to configure if the IP reservation should be deleted
6153 # after it is no longer used by the group, e.g. when the given instance
6154 # or the whole group is deleted.
6155 },
6156 },
6157 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
6158 # instance delete, update, etc. This map is keyed with the network
6159 # interface name.
6160 &quot;a_key&quot;: {
6161 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
6162 # update or VM instance recreate operations.
6163 # This flag is used to configure if the IP reservation should be deleted
6164 # after it is no longer used by the group, e.g. when the given instance
6165 # or the whole group is deleted.
6166 },
6167 },
6168 },
6169 },
6170 &quot;status&quot;: { # Output only. The status of this managed instance group.
6171 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
6172 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
6173 # This value is in RFC3339 text format.
6174 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
6175 # been applied to all managed instances in the group.
6176 },
6177 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
6178 # Currently only one accelerator topology is supported.
6179 {
6180 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
6181 # The value is the same as configured in the WorkloadPolicy.
6182 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
6183 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
6184 # check.
6185 &quot;error&quot;: { # Output only. Encountered errors.
6186 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6187 # operation.
6188 {
6189 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6190 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6191 # details. There is a set of defined message types to use for providing
6192 # details.The syntax depends on the error code. For example,
6193 # QuotaExceededInfo will have details when the error code is
6194 # QUOTA_EXCEEDED.
6195 {
6196 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6197 #
6198 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6199 # is not enabled:
6200 #
6201 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6202 # &quot;domain&quot;: &quot;googleapis.com&quot;
6203 # &quot;metadata&quot;: {
6204 # &quot;resource&quot;: &quot;projects/123&quot;,
6205 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6206 # }
6207 # }
6208 #
6209 # This response indicates that the pubsub.googleapis.com API is not enabled.
6210 #
6211 # Example of an error that is returned when attempting to create a Spanner
6212 # instance in a region that is out of stock:
6213 #
6214 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6215 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6216 # &quot;metadata&quot;: {
6217 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6218 # }
6219 # }
6220 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6221 # is typically the registered service name of the tool or product that
6222 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6223 # generated by some common infrastructure, the error domain must be a
6224 # globally unique value that identifies the infrastructure. For Google API
6225 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6226 &quot;metadatas&quot;: { # Additional structured details about this error.
6227 #
6228 # Keys must match a regular expression of `a-z+` but should
6229 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6230 # length. When identifying the current value of an exceeded limit, the units
6231 # should be contained in the key, not the value. For example, rather than
6232 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6233 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6234 # instances that can be created in a single (batch) request.
6235 &quot;a_key&quot;: &quot;A String&quot;,
6236 },
6237 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6238 # proximate cause of the error. Error reasons are unique within a particular
6239 # domain of errors. This should be at most 63 characters and match a
6240 # regular expression of `A-Z+[A-Z0-9]`, which represents
6241 # UPPER_SNAKE_CASE.
6242 },
6243 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6244 #
6245 # For example, if a quota check failed with an error indicating the calling
6246 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6247 # directly to the right place in the developer console to flip the bit.
6248 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6249 { # Describes a URL link.
6250 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6251 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6252 },
6253 ],
6254 },
6255 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6256 # which can be attached to an RPC error.
6257 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6258 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6259 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6260 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6261 },
6262 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6263 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6264 &quot;a_key&quot;: &quot;A String&quot;,
6265 },
6266 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6267 # type or metric.
6268 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6269 # or metric.
6270 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6271 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6272 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6273 },
6274 },
6275 ],
6276 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6277 # This property is optional.
6278 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6279 },
6280 ],
6281 },
6282 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
6283 # has // RFC3339 //
6284 # text format.
6285 },
6286 },
6287 ],
6288 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
6289 # that targets this instance group manager.
6290 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
6291 # targetSizePolicy.mode is set to BULK.
6292 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
6293 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
6294 # operation.
6295 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
6296 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6297 # operation.
6298 {
6299 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6300 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6301 # details. There is a set of defined message types to use for providing
6302 # details.The syntax depends on the error code. For example,
6303 # QuotaExceededInfo will have details when the error code is
6304 # QUOTA_EXCEEDED.
6305 {
6306 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6307 #
6308 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6309 # is not enabled:
6310 #
6311 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6312 # &quot;domain&quot;: &quot;googleapis.com&quot;
6313 # &quot;metadata&quot;: {
6314 # &quot;resource&quot;: &quot;projects/123&quot;,
6315 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6316 # }
6317 # }
6318 #
6319 # This response indicates that the pubsub.googleapis.com API is not enabled.
6320 #
6321 # Example of an error that is returned when attempting to create a Spanner
6322 # instance in a region that is out of stock:
6323 #
6324 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6325 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6326 # &quot;metadata&quot;: {
6327 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6328 # }
6329 # }
6330 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6331 # is typically the registered service name of the tool or product that
6332 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6333 # generated by some common infrastructure, the error domain must be a
6334 # globally unique value that identifies the infrastructure. For Google API
6335 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6336 &quot;metadatas&quot;: { # Additional structured details about this error.
6337 #
6338 # Keys must match a regular expression of `a-z+` but should
6339 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6340 # length. When identifying the current value of an exceeded limit, the units
6341 # should be contained in the key, not the value. For example, rather than
6342 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6343 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6344 # instances that can be created in a single (batch) request.
6345 &quot;a_key&quot;: &quot;A String&quot;,
6346 },
6347 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6348 # proximate cause of the error. Error reasons are unique within a particular
6349 # domain of errors. This should be at most 63 characters and match a
6350 # regular expression of `A-Z+[A-Z0-9]`, which represents
6351 # UPPER_SNAKE_CASE.
6352 },
6353 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6354 #
6355 # For example, if a quota check failed with an error indicating the calling
6356 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6357 # directly to the right place in the developer console to flip the bit.
6358 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6359 { # Describes a URL link.
6360 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6361 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6362 },
6363 ],
6364 },
6365 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6366 # which can be attached to an RPC error.
6367 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6368 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6369 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6370 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6371 },
6372 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6373 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6374 &quot;a_key&quot;: &quot;A String&quot;,
6375 },
6376 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6377 # type or metric.
6378 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6379 # or metric.
6380 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6381 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6382 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6383 },
6384 },
6385 ],
6386 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6387 # This property is optional.
6388 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6389 },
6390 ],
6391 },
6392 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
6393 # operation. Timestamp is in RFC3339 text format.
6394 },
6395 },
6396 &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
6397 # in this managed instance group that have the status. Currently only shown
6398 # for TPU MIGs
6399 # instance group that have the status. For more information about how to
6400 # interpret each status check the instance lifecycle documentation.
6401 # Currently only shown for TPU MIGs.
6402 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
6403 # that have DEPROVISIONING status.
6404 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
6405 # have been deleted. Includes only instances that would be shown in the
6406 # listManagedInstances method and not all instances that have been
6407 # deleted in the lifetime of the MIG.
6408 # Does not include FlexStart instances that are waiting for the resources
6409 # availability, they are considered as &#x27;pending&#x27;.
6410 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
6411 # that have PENDING status, that is FlexStart instances that are waiting
6412 # for resources. Instances that do not exist because of the other reasons
6413 # are counted as &#x27;non_existent&#x27;.
6414 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
6415 # that have PENDING_STOP status.
6416 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
6417 # that have PROVISIONING status.
6418 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
6419 # that have REPAIRING status.
6420 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
6421 # that have RUNNING status.
6422 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
6423 # that have STAGING status.
6424 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
6425 # that have STOPPED status.
6426 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
6427 # that have STOPPING status.
6428 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
6429 # that have SUSPENDED status.
6430 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
6431 # that have SUSPENDING status.
6432 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
6433 # that have TERMINATED status.
6434 },
6435 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
6436 # stable state. A stable state means that: none of the instances in the
6437 # managed instance group is currently undergoing any type of change (for
6438 # example, creation, restart, or deletion); no future changes are scheduled
6439 # for instances in the managed instance group; and the managed instance
6440 # group itself is not being modified.
6441 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
6442 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
6443 # has stateful configuration, that is, if you have configured any items
6444 # in a stateful policy or in per-instance configs.
6445 # The group might report that it has no stateful configuration even when
6446 # there is still some preserved state on a managed instance, for example,
6447 # if you have deleted all PICs but not yet applied those deletions.
6448 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
6449 # has stateful configuration, that is, if you have configured any items
6450 # in a stateful policy or in per-instance configs.
6451 # The group might report that it has no stateful configuration even when
6452 # there is still some preserved state on a managed instance, for example,
6453 # if you have deleted all PICs but not yet applied those deletions. This
6454 # field is deprecated in favor of has_stateful_config.
6455 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
6456 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
6457 # (listed in the output of a listPerInstanceConfigs API call) have
6458 # status EFFECTIVE or there are no per-instance-configs.
6459 },
6460 },
6461 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
6462 # target version specified by version field on Instance Group
6463 # Manager.
6464 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
6465 # in this managed instance group, i.e. all instances are in their target
6466 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
6467 },
6468 },
6469 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
6470 # apply to all of the instances in the managed instance group.
6471 &quot;A String&quot;,
6472 ],
6473 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
6474 # You can reduce this number by using the instanceGroupManager
6475 # deleteInstances or abandonInstances methods. Resizing the group also
6476 # changes this number.
6477 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
6478 # size.
6479 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
6480 # individually or all at once.
6481 },
6482 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
6483 # This number changes when you:
6484 #
6485 # - Stop instance using the stopInstances
6486 # method or start instances using the startInstances
6487 # method.
6488 # - Manually change the targetStoppedSize using the update
6489 # method.
6490 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
6491 # This number changes when you:
6492 #
6493 # - Suspend instance using the suspendInstances
6494 # method or resume instances using the resumeInstances
6495 # method.
6496 # - Manually change the targetSuspendedSize using the update
6497 # method.
6498 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
6499 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
6500 &quot;A String&quot;,
6501 ],
6502 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
6503 # instance redistribution policy for regional managed instance groups.
6504 # Valid values are:
6505 #
6506 # - PROACTIVE (default): The group attempts to maintain an
6507 # even distribution of VM instances across zones in the region.
6508 # - NONE: For non-autoscaled groups, proactive
6509 # redistribution is disabled.
6510 &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
6511 # either a fixed number or, if the group has 10 or more instances, a
6512 # percentage. If you set a percentage, the number of instances is rounded
6513 # if necessary. The default value for maxSurge is a fixed
6514 # value equal to the number of zones in which the managed instance group
6515 # operates.
6516 #
6517 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
6518 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6519 #
6520 #
6521 #
6522 # - If the value is fixed, then the calculated
6523 # value is equal to the fixed value.
6524 # - If the value is a percent, then the
6525 # calculated
6526 # value is percent/100 * targetSize. For example,
6527 # the calculated value of a 80% of a managed instance group
6528 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6529 # is a remainder, the number is rounded.
6530 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6531 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6532 # example, specify 80 for 80%.
6533 },
6534 &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
6535 # process. An instance is considered available if all of the following
6536 # conditions are satisfied:
6537 #
6538 #
6539 #
6540 # - The instance&#x27;s status is
6541 # RUNNING.
6542 # - If there is a health
6543 # check on the instance group, the instance&#x27;s health check status
6544 # must be HEALTHY at least once. If there is no health check
6545 # on the group, then the instance only needs to have a status of
6546 # RUNNING to be considered available.
6547 #
6548 #
6549 # This value can be either a fixed number or, if the group has 10 or more
6550 # instances, a percentage. If you set a percentage, the number of instances
6551 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
6552 # in which the managed instance group operates.
6553 #
6554 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
6555 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6556 #
6557 #
6558 #
6559 # - If the value is fixed, then the calculated
6560 # value is equal to the fixed value.
6561 # - If the value is a percent, then the
6562 # calculated
6563 # value is percent/100 * targetSize. For example,
6564 # the calculated value of a 80% of a managed instance group
6565 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6566 # is a remainder, the number is rounded.
6567 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6568 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6569 # example, specify 80 for 80%.
6570 },
6571 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
6572 # becomes available. This value must be from range [0, 3600].
6573 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
6574 # disruption as much as possible or to apply a more disruptive action than
6575 # is necessary.
6576 #
6577 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
6578 # Compute Engine performs the necessary action to execute the update.
6579 # - To apply a more disruptive action than is strictly necessary, set the
6580 # minimal action to RESTART or REPLACE. For
6581 # example, Compute Engine does not need to restart a VM to change its
6582 # metadata. But if your application reads instance metadata only when a VM
6583 # is restarted, you can set the minimal action to RESTART in
6584 # order to pick up metadata changes.
6585 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
6586 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
6587 # as much as possible. RESTART to allow actions that can be
6588 # applied without instance replacing or REPLACE to allow all
6589 # possible actions. If the Updater determines that the minimal update
6590 # action needed is more disruptive than most disruptive allowed action you
6591 # specify it will not perform the update at all.
6592 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
6593 # See minimal_action.REPLACE
6594 &quot;type&quot;: &quot;A String&quot;, # The type
6595 # of update process. You can specify either PROACTIVE so
6596 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
6597 # to update.
6598 },
6599 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
6600 # create instances.
6601 #
6602 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
6603 # group. This field overrides the top-level instanceTemplate
6604 # field. Read more about therelationships
6605 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
6606 # remaining instances. For more information, read aboutcanary
6607 # updates.
6608 {
6609 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
6610 # instance group. The group uses this template to create new instances in
6611 # the managed instance group until the `targetSize` for this version is
6612 # reached. The templates for existing instances in the group do not change
6613 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
6614 # existing instances are updated until the `targetSize` for this version is
6615 # reached.
6616 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
6617 # managed instance group.
6618 &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
6619 # from the template will be equal to:
6620 #
6621 #
6622 # - If expressed as a fixed number, the minimum of either
6623 # targetSize.fixed or
6624 # instanceGroupManager.targetSize is used.
6625 # - if expressed as a percent, the targetSize
6626 # would be (targetSize.percent/100 *
6627 # InstanceGroupManager.targetSize) If there is a remainder, the
6628 # number is rounded.
6629 #
6630 # If unset, this version will update any remaining instances not
6631 # updated by another version. ReadStarting
6632 # a canary update for more information.
6633 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6634 #
6635 #
6636 #
6637 # - If the value is fixed, then the calculated
6638 # value is equal to the fixed value.
6639 # - If the value is a percent, then the
6640 # calculated
6641 # value is percent/100 * targetSize. For example,
6642 # the calculated value of a 80% of a managed instance group
6643 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6644 # is a remainder, the number is rounded.
6645 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6646 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6647 # example, specify 80 for 80%.
6648 },
6649 },
6650 ],
6651 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
6652 # where the managed instance group is located (for zonal resources).
6653 },
6654 ],
6655 &quot;kind&quot;: &quot;compute#regionInstanceGroupManagerList&quot;, # Output only. The resource type, which is always compute#instanceGroupManagerList for a
6656 # list of managed instance groups that exist in th regional scope.
6657 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. This token allows you to get the next page of results for
6658 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
6659 # the query parameter pageToken in the next list request.
6660 # Subsequent list requests will have their own nextPageToken to
6661 # continue paging through the results.
6662 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource.
6663 &quot;warning&quot;: { # Output only. Informational warning message.
6664 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6665 # Engine returns NO_RESULTS_ON_PAGE if there
6666 # are no results in the response.
6667 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6668 # value format. For example:
6669 #
6670 # &quot;data&quot;: [
6671 # {
6672 # &quot;key&quot;: &quot;scope&quot;,
6673 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6674 # }
6675 {
6676 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6677 # returned. For example, for warnings where there are no results in a list
6678 # request for a particular zone, this key might be scope and
6679 # the key value might be the zone name. Other examples might be a key
6680 # indicating a deprecated resource and a suggested replacement, or a
6681 # warning about invalid network settings (for example, if an instance
6682 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6683 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6684 },
6685 ],
6686 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6687 },
6688 }</pre>
6689 </div>
6690
6691 <div class="method">
6692 <code class="details" id="listErrors">listErrors(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
6693 <pre>Lists all errors thrown by actions on instances for a given regional
6694 managed instance group. The filter andorderBy query parameters are not supported.
6695
6696 Args:
6697 project: string, Project ID for this request. (required)
6698 region: string, Name of the region scoping this request.
6699 This should conform to RFC1035. (required)
6700 instanceGroupManager: string, The name of the managed instance group.
6701 It must be a string that meets the requirements in RFC1035, or an
6702 unsigned long integer: must match regexp pattern:
6703 (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. (required)
6704 filter: string, A filter expression that filters resources listed in the response. Most
6705 Compute resources support two types of filter expressions:
6706 expressions that support regular expressions and expressions that follow
6707 API improvement proposal AIP-160.
6708 These two types of filter expressions cannot be mixed in one request.
6709
6710 If you want to use AIP-160, your expression must specify the field name, an
6711 operator, and the value that you want to use for filtering. The value
6712 must be a string, a number, or a boolean. The operator
6713 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
6714
6715 For example, if you are filtering Compute Engine instances, you can
6716 exclude instances named `example-instance` by specifying
6717 `name != example-instance`.
6718
6719 The `:*` comparison can be used to test whether a key has been defined.
6720 For example, to find all objects with `owner` label use:
6721 ```
6722 labels.owner:*
6723 ```
6724
6725 You can also filter nested fields. For example, you could specify
6726 `scheduling.automaticRestart = false` to include instances only
6727 if they are not scheduled for automatic restarts. You can use filtering
6728 on nested fields to filter based onresource labels.
6729
6730 To filter on multiple expressions, provide each separate expression within
6731 parentheses. For example:
6732 ```
6733 (scheduling.automaticRestart = true)
6734 (cpuPlatform = &quot;Intel Skylake&quot;)
6735 ```
6736 By default, each expression is an `AND` expression. However, you
6737 can include `AND` and `OR` expressions explicitly.
6738 For example:
6739 ```
6740 (cpuPlatform = &quot;Intel Skylake&quot;) OR
6741 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
6742 (scheduling.automaticRestart = true)
6743 ```
6744
6745 If you want to use a regular expression, use the `eq` (equal) or `ne`
6746 (not equal) operator against a single un-parenthesized expression with or
6747 without quotes or against multiple parenthesized expressions. Examples:
6748
6749 `fieldname eq unquoted literal`
6750 `fieldname eq &#x27;single quoted literal&#x27;`
6751 `fieldname eq &quot;double quoted literal&quot;`
6752 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
6753
6754 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
6755 The literal value must match the entire field.
6756
6757 For example, to filter for instances that do not end with name &quot;instance&quot;,
6758 you would use `name ne .*instance`.
6759
6760 You cannot combine constraints on multiple fields using regular
6761 expressions.
6762 maxResults: integer, The maximum number of results per page that should be returned.
6763 If the number of available results is larger than `maxResults`,
6764 Compute Engine returns a `nextPageToken` that can be used to get
6765 the next page of results in subsequent list requests. Acceptable values are
6766 `0` to `500`, inclusive. (Default: `500`)
6767 orderBy: string, Sorts list results by a certain order. By default, results
6768 are returned in alphanumerical order based on the resource name.
6769
6770 You can also sort results in descending order based on the creation
6771 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
6772 results based on the `creationTimestamp` field in
6773 reverse chronological order (newest result first). Use this to sort
6774 resources like operations so that the newest operation is returned first.
6775
6776 Currently, only sorting by `name` or
6777 `creationTimestamp desc` is supported.
6778 pageToken: string, Specifies a page token to use. Set `pageToken` to the
6779 `nextPageToken` returned by a previous list request to get
6780 the next page of results.
6781 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
6782 of failure. The default value is false.
6783
6784 For example, when partial success behavior is enabled, aggregatedList for a
6785 single zone scope either returns all resources in the zone or no resources,
6786 with an error code.
6787 x__xgafv: string, V1 error format.
6788 Allowed values
6789 1 - v1 error format
6790 2 - v2 error format
6791
6792 Returns:
6793 An object of the form:
6794
6795 {
6796 &quot;items&quot;: [ # [Output Only] The list of errors of the managed instance group.
6797 {
6798 &quot;error&quot;: { # Output only. Contents of the error.
6799 &quot;code&quot;: &quot;A String&quot;, # Output only. Error code.
6800 &quot;message&quot;: &quot;A String&quot;, # Output only. Error message.
6801 },
6802 &quot;instanceActionDetails&quot;: { # Output only. Details of the instance action that triggered this error.
6803 # May be null, if the error was not caused by an action on an instance.
6804 # This field is optional.
6805 &quot;action&quot;: &quot;A String&quot;, # Output only. Action that managed instance group was executing on the instance when the
6806 # error occurred. Possible values:
6807 &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
6808 # yet been created.
6809 &quot;version&quot;: { # Output only. Version this instance was created from, or was being
6810 # created from, but the creation failed. Corresponds to one of the versions
6811 # that were set on the Instance Group Manager resource at the time this
6812 # instance was being created.
6813 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
6814 # when current_action is one of { DELETING, ABANDONING }.
6815 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] Name of the version.
6816 },
6817 },
6818 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. The time that this error occurred. This value is in RFC3339 text format.
6819 },
6820 ],
6821 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
6822 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
6823 # the query parameter pageToken in the next list request.
6824 # Subsequent list requests will have their own nextPageToken to
6825 # continue paging through the results.
6826 }</pre>
6827 </div>
6828
6829 <div class="method">
6830 <code class="details" id="listErrors_next">listErrors_next()</code>
6831 <pre>Retrieves the next page of results.
6832
6833 Args:
6834 previous_request: The request for the previous page. (required)
6835 previous_response: The response from the request for the previous page. (required)
6836
6837 Returns:
6838 A request object that you can call &#x27;execute()&#x27; on to request the next
6839 page. Returns None if there are no more items in the collection.
6840 </pre>
6841 </div>
6842
6843 <div class="method">
6844 <code class="details" id="listManagedInstances">listManagedInstances(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
6845 <pre>Lists the instances in the managed instance group and instances that are
6846 scheduled to be created. The list includes any current actions
6847 that the group has scheduled for its instances. The orderBy
6848 query parameter is not supported. The `pageToken` query parameter is
6849 supported only if the group&#x27;s `listManagedInstancesResults` field is set
6850 to `PAGINATED`.
6851
6852 Args:
6853 project: string, Project ID for this request. (required)
6854 region: string, Name of the region scoping this request. (required)
6855 instanceGroupManager: string, The name of the managed instance group. (required)
6856 filter: string, A filter expression that filters resources listed in the response. Most
6857 Compute resources support two types of filter expressions:
6858 expressions that support regular expressions and expressions that follow
6859 API improvement proposal AIP-160.
6860 These two types of filter expressions cannot be mixed in one request.
6861
6862 If you want to use AIP-160, your expression must specify the field name, an
6863 operator, and the value that you want to use for filtering. The value
6864 must be a string, a number, or a boolean. The operator
6865 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
6866
6867 For example, if you are filtering Compute Engine instances, you can
6868 exclude instances named `example-instance` by specifying
6869 `name != example-instance`.
6870
6871 The `:*` comparison can be used to test whether a key has been defined.
6872 For example, to find all objects with `owner` label use:
6873 ```
6874 labels.owner:*
6875 ```
6876
6877 You can also filter nested fields. For example, you could specify
6878 `scheduling.automaticRestart = false` to include instances only
6879 if they are not scheduled for automatic restarts. You can use filtering
6880 on nested fields to filter based onresource labels.
6881
6882 To filter on multiple expressions, provide each separate expression within
6883 parentheses. For example:
6884 ```
6885 (scheduling.automaticRestart = true)
6886 (cpuPlatform = &quot;Intel Skylake&quot;)
6887 ```
6888 By default, each expression is an `AND` expression. However, you
6889 can include `AND` and `OR` expressions explicitly.
6890 For example:
6891 ```
6892 (cpuPlatform = &quot;Intel Skylake&quot;) OR
6893 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
6894 (scheduling.automaticRestart = true)
6895 ```
6896
6897 If you want to use a regular expression, use the `eq` (equal) or `ne`
6898 (not equal) operator against a single un-parenthesized expression with or
6899 without quotes or against multiple parenthesized expressions. Examples:
6900
6901 `fieldname eq unquoted literal`
6902 `fieldname eq &#x27;single quoted literal&#x27;`
6903 `fieldname eq &quot;double quoted literal&quot;`
6904 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
6905
6906 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
6907 The literal value must match the entire field.
6908
6909 For example, to filter for instances that do not end with name &quot;instance&quot;,
6910 you would use `name ne .*instance`.
6911
6912 You cannot combine constraints on multiple fields using regular
6913 expressions.
6914 maxResults: integer, The maximum number of results per page that should be returned.
6915 If the number of available results is larger than `maxResults`,
6916 Compute Engine returns a `nextPageToken` that can be used to get
6917 the next page of results in subsequent list requests. Acceptable values are
6918 `0` to `500`, inclusive. (Default: `500`)
6919 orderBy: string, Sorts list results by a certain order. By default, results
6920 are returned in alphanumerical order based on the resource name.
6921
6922 You can also sort results in descending order based on the creation
6923 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
6924 results based on the `creationTimestamp` field in
6925 reverse chronological order (newest result first). Use this to sort
6926 resources like operations so that the newest operation is returned first.
6927
6928 Currently, only sorting by `name` or
6929 `creationTimestamp desc` is supported.
6930 pageToken: string, Specifies a page token to use. Set `pageToken` to the
6931 `nextPageToken` returned by a previous list request to get
6932 the next page of results.
6933 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
6934 of failure. The default value is false.
6935
6936 For example, when partial success behavior is enabled, aggregatedList for a
6937 single zone scope either returns all resources in the zone or no resources,
6938 with an error code.
6939 x__xgafv: string, V1 error format.
6940 Allowed values
6941 1 - v1 error format
6942 2 - v2 error format
6943
6944 Returns:
6945 An object of the form:
6946
6947 {
6948 &quot;managedInstances&quot;: [ # A list of managed instances.
6949 { # A Managed Instance resource.
6950 &quot;allInstancesConfig&quot;: { # Output only. [Output Only] Current all-instances configuration revision applied to this
6951 # instance.
6952 &quot;revision&quot;: &quot;A String&quot;, # Output only. [Output Only] Current all-instances configuration revision.
6953 # This value is in RFC3339 text format.
6954 },
6955 &quot;currentAction&quot;: &quot;A String&quot;, # Output only. [Output Only] The current action that the managed instance group has
6956 # scheduled for the instance. Possible values:
6957 #
6958 # - NONE The instance is running, and the managed
6959 # instance group does not have any scheduled actions for this instance.
6960 # - CREATING The managed instance group is creating this
6961 # instance. If the group fails to create this instance, it will try again
6962 # until it is successful.
6963 # - CREATING_WITHOUT_RETRIES The managed instance group
6964 # is attempting to create this instance only once. If the group fails
6965 # to create this instance, it does not try again and the group&#x27;stargetSize value is decreased instead.
6966 # - RECREATING The managed instance group is recreating
6967 # this instance.
6968 # - DELETING The managed instance group is permanently
6969 # deleting this instance.
6970 # - ABANDONING The managed instance group is abandoning
6971 # this instance. The instance will be removed from the instance group
6972 # and from any target pools that are associated with this group.
6973 # - RESTARTING The managed instance group is restarting
6974 # the instance.
6975 # - REFRESHING The managed instance group is applying
6976 # configuration changes to the instance without stopping it. For example,
6977 # the group can update the target pool list for an instance without
6978 # stopping that instance.
6979 # - VERIFYING The managed instance group has created the
6980 # instance and it is in the process of being verified.
6981 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output only] The unique identifier for this resource. This field is empty
6982 # when instance does not exist.
6983 &quot;instance&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of the instance. The URL can exist even if the
6984 # instance has not yet been created.
6985 &quot;instanceHealth&quot;: [ # Output only. [Output Only] Health state of the instance per health-check.
6986 {
6987 &quot;detailedHealthState&quot;: &quot;A String&quot;, # Output only. [Output Only] The current detailed instance health state.
6988 &quot;healthCheck&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for the health check that verifies whether the
6989 # instance is healthy.
6990 },
6991 ],
6992 &quot;instanceStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the instance. This field is empty when
6993 # the instance does not exist.
6994 &quot;lastAttempt&quot;: { # Output only. [Output Only] Information about the last attempt to create or delete
6995 # the instance.
6996 &quot;errors&quot;: { # Output only. [Output Only] Encountered errors during the last attempt to create or
6997 # delete the instance.
6998 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6999 # operation.
7000 {
7001 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7002 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7003 # details. There is a set of defined message types to use for providing
7004 # details.The syntax depends on the error code. For example,
7005 # QuotaExceededInfo will have details when the error code is
7006 # QUOTA_EXCEEDED.
7007 {
7008 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7009 #
7010 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7011 # is not enabled:
7012 #
7013 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7014 # &quot;domain&quot;: &quot;googleapis.com&quot;
7015 # &quot;metadata&quot;: {
7016 # &quot;resource&quot;: &quot;projects/123&quot;,
7017 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7018 # }
7019 # }
7020 #
7021 # This response indicates that the pubsub.googleapis.com API is not enabled.
7022 #
7023 # Example of an error that is returned when attempting to create a Spanner
7024 # instance in a region that is out of stock:
7025 #
7026 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7027 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7028 # &quot;metadata&quot;: {
7029 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7030 # }
7031 # }
7032 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7033 # is typically the registered service name of the tool or product that
7034 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7035 # generated by some common infrastructure, the error domain must be a
7036 # globally unique value that identifies the infrastructure. For Google API
7037 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7038 &quot;metadatas&quot;: { # Additional structured details about this error.
7039 #
7040 # Keys must match a regular expression of `a-z+` but should
7041 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7042 # length. When identifying the current value of an exceeded limit, the units
7043 # should be contained in the key, not the value. For example, rather than
7044 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7045 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7046 # instances that can be created in a single (batch) request.
7047 &quot;a_key&quot;: &quot;A String&quot;,
7048 },
7049 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7050 # proximate cause of the error. Error reasons are unique within a particular
7051 # domain of errors. This should be at most 63 characters and match a
7052 # regular expression of `A-Z+[A-Z0-9]`, which represents
7053 # UPPER_SNAKE_CASE.
7054 },
7055 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7056 #
7057 # For example, if a quota check failed with an error indicating the calling
7058 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7059 # directly to the right place in the developer console to flip the bit.
7060 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7061 { # Describes a URL link.
7062 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7063 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7064 },
7065 ],
7066 },
7067 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7068 # which can be attached to an RPC error.
7069 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7070 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7071 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7072 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7073 },
7074 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7075 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7076 &quot;a_key&quot;: &quot;A String&quot;,
7077 },
7078 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7079 # type or metric.
7080 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7081 # or metric.
7082 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7083 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7084 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7085 },
7086 },
7087 ],
7088 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7089 # This property is optional.
7090 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7091 },
7092 ],
7093 },
7094 },
7095 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] The name of the instance. The name always exists even if the
7096 # instance has not yet been created.
7097 &quot;preservedStateFromConfig&quot;: { # Preserved state for a given instance. # Output only. [Output Only] Preserved state applied from per-instance config
7098 # for this instance.
7099 &quot;disks&quot;: { # Preserved disks defined for this instance.
7100 # This map is keyed with the device names of the disks.
7101 &quot;a_key&quot;: {
7102 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
7103 # update, instance recreate operations. This flag is used to configure
7104 # if the disk should be deleted after it is no longer used by the group,
7105 # e.g. when the given instance or the whole MIG is deleted.
7106 # Note: disks attached in READ_ONLY mode cannot be
7107 # auto-deleted.
7108 &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
7109 # disk in READ_WRITE mode.
7110 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
7111 # to the VM instance.
7112 },
7113 },
7114 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
7115 # This map is keyed with the name of the network interface.
7116 &quot;a_key&quot;: {
7117 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7118 # update or VM instance recreate operations.
7119 # This flag is used to configure if the IP reservation should be deleted
7120 # after it is no longer used by the group, e.g. when the given instance
7121 # or the whole group is deleted.
7122 &quot;ipAddress&quot;: { # Ip address representation
7123 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
7124 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
7125 # network interface.
7126 },
7127 },
7128 },
7129 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
7130 # This map is keyed with the name of the network interface.
7131 &quot;a_key&quot;: {
7132 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7133 # update or VM instance recreate operations.
7134 # This flag is used to configure if the IP reservation should be deleted
7135 # after it is no longer used by the group, e.g. when the given instance
7136 # or the whole group is deleted.
7137 &quot;ipAddress&quot;: { # Ip address representation
7138 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
7139 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
7140 # network interface.
7141 },
7142 },
7143 },
7144 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
7145 &quot;a_key&quot;: &quot;A String&quot;,
7146 },
7147 },
7148 &quot;preservedStateFromPolicy&quot;: { # Preserved state for a given instance. # Output only. [Output Only] Preserved state generated based on stateful policy
7149 # for this instance.
7150 &quot;disks&quot;: { # Preserved disks defined for this instance.
7151 # This map is keyed with the device names of the disks.
7152 &quot;a_key&quot;: {
7153 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
7154 # update, instance recreate operations. This flag is used to configure
7155 # if the disk should be deleted after it is no longer used by the group,
7156 # e.g. when the given instance or the whole MIG is deleted.
7157 # Note: disks attached in READ_ONLY mode cannot be
7158 # auto-deleted.
7159 &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
7160 # disk in READ_WRITE mode.
7161 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
7162 # to the VM instance.
7163 },
7164 },
7165 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
7166 # This map is keyed with the name of the network interface.
7167 &quot;a_key&quot;: {
7168 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7169 # update or VM instance recreate operations.
7170 # This flag is used to configure if the IP reservation should be deleted
7171 # after it is no longer used by the group, e.g. when the given instance
7172 # or the whole group is deleted.
7173 &quot;ipAddress&quot;: { # Ip address representation
7174 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
7175 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
7176 # network interface.
7177 },
7178 },
7179 },
7180 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
7181 # This map is keyed with the name of the network interface.
7182 &quot;a_key&quot;: {
7183 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7184 # update or VM instance recreate operations.
7185 # This flag is used to configure if the IP reservation should be deleted
7186 # after it is no longer used by the group, e.g. when the given instance
7187 # or the whole group is deleted.
7188 &quot;ipAddress&quot;: { # Ip address representation
7189 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
7190 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
7191 # network interface.
7192 },
7193 },
7194 },
7195 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
7196 &quot;a_key&quot;: &quot;A String&quot;,
7197 },
7198 },
7199 &quot;propertiesFromFlexibilityPolicy&quot;: { # Output only. [Output Only] Instance properties selected for this instance resulting from
7200 # InstanceFlexibilityPolicy.
7201 &quot;disks&quot;: [ # List of disks to be attached to the instance.
7202 { # An instance-attached disk resource.
7203 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
7204 # or X86_64.
7205 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
7206 # deleted (but not when the disk is detached from the instance).
7207 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
7208 # partition of the disk for its root filesystem.
7209 &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
7210 # running within the instance. This name can be used to reference the device
7211 # for mounting, resizing, and so on, from within the instance.
7212 #
7213 # If not specified, the server chooses a default device name to apply to this
7214 # disk, in the form persistent-disk-x, where x is a number
7215 # assigned by Google Compute Engine. This field is only applicable for
7216 # persistent disks.
7217 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
7218 # encryption key.
7219 #
7220 # If you are creating a new disk, this field encrypts the new disk using
7221 # an encryption key that you provide. If you are attaching an existing
7222 # disk that is already encrypted, this field decrypts the disk using
7223 # the customer-supplied encryption key.
7224 #
7225 # If you encrypt a disk using a customer-supplied key, you must provide the
7226 # same key again when you attempt to use this resource at a later time. For
7227 # example, you must provide the key when you create a snapshot or an image
7228 # from the disk or when you attach the disk to a virtual machine instance.
7229 #
7230 # If you do not provide an encryption key, then the disk will be encrypted
7231 # using an automatically generated key and you do not need to provide a key
7232 # to use the disk later.
7233 #
7234 # Note:
7235 #
7236 # Instance templates do not storecustomer-supplied
7237 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
7238 #
7239 # You cannot create VMs that have disks with customer-supplied keys using
7240 # the bulk
7241 # insert method.
7242 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7243 # For example:
7244 #
7245 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7246 # key_region/cryptoKeys/key
7247 #
7248 # The fully-qualifed key name may be returned for resource GET requests. For
7249 # example:
7250 #
7251 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7252 # key_region/cryptoKeys/key
7253 # /cryptoKeyVersions/1
7254 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7255 # key. If absent, the Compute Engine default service account is used.
7256 # For example:
7257 #
7258 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7259 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7260 # encryption key, encoded in RFC
7261 # 4648 base64 to either encrypt or decrypt this resource. You can
7262 # provide either the rawKey or thersaEncryptedKey.
7263 # For example:
7264 #
7265 # &quot;rawKey&quot;:
7266 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7267 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7268 # customer-supplied encryption key to either encrypt or decrypt this
7269 # resource. You can provide either the rawKey or thersaEncryptedKey.
7270 # For example:
7271 #
7272 # &quot;rsaEncryptedKey&quot;:
7273 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7274 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7275 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7276 #
7277 # The key must meet the following requirements before you can provide it to
7278 # Compute Engine:
7279 #
7280 # 1. The key is wrapped using a RSA public key certificate provided by
7281 # Google.
7282 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7283 # encoding.
7284 #
7285 # Gets the RSA public key certificate provided by Google at:
7286 #
7287 #
7288 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7289 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7290 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7291 # encryption key that protects this resource.
7292 },
7293 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
7294 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
7295 # currently attached to another instance. If you try to force attach a zonal
7296 # disk to an instance, you will receive an error.
7297 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7298 # only for bootable images. Read
7299 # Enabling guest operating system features to see a list of available
7300 # options.
7301 { # Guest OS features.
7302 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7303 # separate values. Set to one or more of the following values:
7304 #
7305 # - VIRTIO_SCSI_MULTIQUEUE
7306 # - WINDOWS
7307 # - MULTI_IP_SUBNET
7308 # - UEFI_COMPATIBLE
7309 # - GVNIC
7310 # - SEV_CAPABLE
7311 # - SUSPEND_RESUME_COMPATIBLE
7312 # - SEV_LIVE_MIGRATABLE_V2
7313 # - SEV_SNP_CAPABLE
7314 # - TDX_CAPABLE
7315 # - IDPF
7316 # - SNP_SVSM_CAPABLE
7317 # - CCA_CAPABLE
7318 #
7319 #
7320 # For more information, see
7321 # Enabling guest operating system features.
7322 },
7323 ],
7324 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
7325 # boot disk. If you have many disks attached to an instance, each
7326 # disk would have a unique index number.
7327 &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
7328 # alongside the new instance. Use initialization parameters to create boot
7329 # disks or local SSDs attached to the new instance.
7330 #
7331 # This property is mutually exclusive with the source property;
7332 # you can only define one or the other, but not both.
7333 # alongside the new instance. Use initialization parameters to create boot
7334 # disks or local SSDs attached to the new instance.
7335 #
7336 # This field is persisted and returned for instanceTemplate and not returned
7337 # in the context of instance.
7338 #
7339 # This property is mutually exclusive with the source property;
7340 # you can only define one or the other, but not both.
7341 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
7342 # arm64 or x86_64.
7343 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
7344 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
7345 # of the instance. If a disk with the same name already exists in the given
7346 # region, the existing disk is attached to the new instance and the
7347 # new disk is not created.
7348 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
7349 # 10 GB. If you specify a sourceImage, which is required for
7350 # boot disks, the default size is the size of the sourceImage.
7351 # If you do not specify a sourceImage, the default disk size
7352 # is 500 GB.
7353 &quot;diskType&quot;: &quot;A String&quot;,
7354 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
7355 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7356 # only for bootable images. Read
7357 # Enabling guest operating system features to see a list of available
7358 # options.
7359 #
7360 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
7361 { # Guest OS features.
7362 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7363 # separate values. Set to one or more of the following values:
7364 #
7365 # - VIRTIO_SCSI_MULTIQUEUE
7366 # - WINDOWS
7367 # - MULTI_IP_SUBNET
7368 # - UEFI_COMPATIBLE
7369 # - GVNIC
7370 # - SEV_CAPABLE
7371 # - SUSPEND_RESUME_COMPATIBLE
7372 # - SEV_LIVE_MIGRATABLE_V2
7373 # - SEV_SNP_CAPABLE
7374 # - TDX_CAPABLE
7375 # - IDPF
7376 # - SNP_SVSM_CAPABLE
7377 # - CCA_CAPABLE
7378 #
7379 #
7380 # For more information, see
7381 # Enabling guest operating system features.
7382 },
7383 ],
7384 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
7385 # persistent disks.
7386 &quot;a_key&quot;: &quot;A String&quot;,
7387 },
7388 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
7389 &quot;A String&quot;,
7390 ],
7391 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
7392 # more than one instance.
7393 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
7394 # is to use the existing disk.
7395 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
7396 # of I/O operations per second that the disk can handle. Values must be
7397 # between 10,000 and 120,000. For more details, see theExtreme persistent
7398 # disk documentation.
7399 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
7400 # number of throughput mb per second that the disk can handle. Values must
7401 # greater than or equal to 1.
7402 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
7403 # the URLs of the zones where the disk should be replicated to.
7404 # You must provide exactly two replica zones, and one zone must be the same
7405 # as the instance zone.
7406 &quot;A String&quot;,
7407 ],
7408 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
7409 # have the same definition as resource
7410 # manager tags. Keys and values can be either in numeric format,
7411 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
7412 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
7413 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
7414 # empty.
7415 &quot;a_key&quot;: &quot;A String&quot;,
7416 },
7417 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
7418 # Specified using the full or partial URL. For instance template, specify
7419 # only the resource policy name.
7420 &quot;A String&quot;,
7421 ],
7422 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
7423 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7424 # is required.
7425 #
7426 # To create a disk with one of the public operating system
7427 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
7428 #
7429 # projects/debian-cloud/global/images/family/debian-9
7430 #
7431 #
7432 # Alternatively, use a specific version of a public operating system image:
7433 #
7434 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
7435 #
7436 #
7437 # To create a disk with a custom image that you created, specify the
7438 # image name in the following format:
7439 #
7440 # global/images/my-custom-image
7441 #
7442 #
7443 # You can also specify a custom image by its image family, which returns
7444 # the latest version of the image in that family. Replace the image name
7445 # with family/family-name:
7446 #
7447 # global/images/family/my-image-family
7448 #
7449 #
7450 # If the source image is deleted later, this field will not be set.
7451 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
7452 # encryption key of the source image. Required if the source image is
7453 # protected by a customer-supplied encryption key.
7454 #
7455 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
7456 # encryption keys, so you cannot create disks for instances in a managed instance group if the
7457 # source images are encrypted with your own keys.
7458 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7459 # For example:
7460 #
7461 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7462 # key_region/cryptoKeys/key
7463 #
7464 # The fully-qualifed key name may be returned for resource GET requests. For
7465 # example:
7466 #
7467 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7468 # key_region/cryptoKeys/key
7469 # /cryptoKeyVersions/1
7470 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7471 # key. If absent, the Compute Engine default service account is used.
7472 # For example:
7473 #
7474 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7475 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7476 # encryption key, encoded in RFC
7477 # 4648 base64 to either encrypt or decrypt this resource. You can
7478 # provide either the rawKey or thersaEncryptedKey.
7479 # For example:
7480 #
7481 # &quot;rawKey&quot;:
7482 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7483 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7484 # customer-supplied encryption key to either encrypt or decrypt this
7485 # resource. You can provide either the rawKey or thersaEncryptedKey.
7486 # For example:
7487 #
7488 # &quot;rsaEncryptedKey&quot;:
7489 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7490 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7491 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7492 #
7493 # The key must meet the following requirements before you can provide it to
7494 # Compute Engine:
7495 #
7496 # 1. The key is wrapped using a RSA public key certificate provided by
7497 # Google.
7498 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7499 # encoding.
7500 #
7501 # Gets the RSA public key certificate provided by Google at:
7502 #
7503 #
7504 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7505 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7506 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7507 # encryption key that protects this resource.
7508 },
7509 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
7510 # instance boot disk, one of initializeParams.sourceSnapshot
7511 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
7512 # is required.
7513 #
7514 # To create a disk with a snapshot that you created, specify the
7515 # snapshot name in the following format:
7516 #
7517 # us-central1-a/instantSnapshots/my-backup
7518 #
7519 #
7520 # If the source instant-snapshot is deleted later, this field will not be
7521 # set.
7522 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
7523 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.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 # global/snapshots/my-backup
7530 #
7531 #
7532 # If the source snapshot is deleted later, this field will not be set.
7533 #
7534 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
7535 # an image instead when you create VMs using
7536 # the bulk
7537 # insert method.
7538 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
7539 # encryption key of the source snapshot.
7540 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7541 # For example:
7542 #
7543 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7544 # key_region/cryptoKeys/key
7545 #
7546 # The fully-qualifed key name may be returned for resource GET requests. For
7547 # example:
7548 #
7549 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7550 # key_region/cryptoKeys/key
7551 # /cryptoKeyVersions/1
7552 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7553 # key. If absent, the Compute Engine default service account is used.
7554 # For example:
7555 #
7556 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7557 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7558 # encryption key, encoded in RFC
7559 # 4648 base64 to either encrypt or decrypt this resource. You can
7560 # provide either the rawKey or thersaEncryptedKey.
7561 # For example:
7562 #
7563 # &quot;rawKey&quot;:
7564 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7565 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7566 # customer-supplied encryption key to either encrypt or decrypt this
7567 # resource. You can provide either the rawKey or thersaEncryptedKey.
7568 # For example:
7569 #
7570 # &quot;rsaEncryptedKey&quot;:
7571 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7572 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7573 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7574 #
7575 # The key must meet the following requirements before you can provide it to
7576 # Compute Engine:
7577 #
7578 # 1. The key is wrapped using a RSA public key certificate provided by
7579 # Google.
7580 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7581 # encoding.
7582 #
7583 # Gets the RSA public key certificate provided by Google at:
7584 #
7585 #
7586 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7587 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7588 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7589 # encryption key that protects this resource.
7590 },
7591 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7592 # this as a partial or full URL to the resource. For example, the following
7593 # are valid values:
7594 #
7595 #
7596 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7597 # - projects/project/zones/zone/storagePools/storagePool
7598 # - zones/zone/storagePools/storagePool
7599 },
7600 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
7601 # either SCSI or NVME. For most machine types, the
7602 # default is SCSI. Local SSDs can use either NVME or SCSI.
7603 # In certain configurations, persistent disks can use NVMe. For more
7604 # information, seeAbout
7605 # persistent disks.
7606 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
7607 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
7608 &quot;A String&quot;,
7609 ],
7610 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
7611 # disk is not allowed to be detached from the instance, or to be used as the
7612 # source of the snapshot creation, and the image creation. The instance with
7613 # at least one locked attached disk is not allow to be used as source of
7614 # machine image creation, instant snapshot creation, and not allowed to be
7615 # deleted with --keep-disk parameter set to true for locked disks.
7616 &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
7617 # in READ_WRITE mode.
7618 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
7619 # field is set to PRESERVED if the LocalSSD data has been saved
7620 # to a persistent location by customer request. (see the
7621 # discard_local_ssd option on Stop/Suspend).
7622 # Read-only in the api.
7623 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
7624 # these are public keys which are safe to store in public
7625 &quot;dbs&quot;: [ # The Key Database (db).
7626 {
7627 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7628 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7629 },
7630 ],
7631 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
7632 {
7633 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7634 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7635 },
7636 ],
7637 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
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;pk&quot;: { # The Platform Key (PK).
7644 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7645 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7646 },
7647 },
7648 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
7649 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7650 # is required.
7651 #
7652 # If desired, you can also attach existing non-root persistent disks using
7653 # this property. This field is only applicable for persistent disks.
7654 #
7655 # Note that for InstanceTemplate, specify the disk name for zonal disk,
7656 # and the URL for regional disk.
7657 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
7658 },
7659 ],
7660 &quot;machineType&quot;: &quot;A String&quot;, # Output only. The machine type to be used for this instance.
7661 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance.
7662 # e.g. &#x27;Intel Ice Lake&#x27;.
7663 &quot;provisioningModel&quot;: &quot;A String&quot;, # Output only. The provisioning model to be used for this instance.
7664 },
7665 &quot;scheduling&quot;: { # Output only. [Output Only] Information about the termination timestamp of the instance,
7666 # if applicable.
7667 &quot;gracefulShutdownTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The timestamp at which the underlying instance will be
7668 # triggered for graceful shutdown if it is configured. This is in RFC3339 text format.
7669 &quot;terminationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The timestamp at which the managed instance will be
7670 # terminated. This is in RFC3339 text format.
7671 },
7672 &quot;shutdownDetails&quot;: { # Output only. [Output Only] Specifies the graceful shutdown details if the instance is in
7673 # `PENDING_STOP` state or there is a programmed stop scheduled.
7674 &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
7675 # the instance is in `PENDING_STOP` state.
7676 # as a count of seconds and fractions of seconds at nanosecond
7677 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
7678 # or &quot;month&quot;. Range is approximately 10,000 years.
7679 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
7680 # Durations less than one second are represented with a 0
7681 # `seconds` field and a positive `nanos` field. Must be from 0
7682 # to 999,999,999 inclusive.
7683 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
7684 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
7685 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
7686 },
7687 &quot;requestTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Past timestamp indicating the beginning of `PENDING_STOP`
7688 # state of instance in RFC3339 text format.
7689 },
7690 &quot;targetStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] The eventual status of the instance. The instance group
7691 # manager will not be identified as stable till each managed instance reaches
7692 # its targetStatus.
7693 &quot;version&quot;: { # Output only. [Output Only] Intended version of this instance.
7694 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
7695 # when current_action is one of { DELETING, ABANDONING }.
7696 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] Name of the version.
7697 },
7698 },
7699 ],
7700 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
7701 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
7702 # the query parameter pageToken in the next list request.
7703 # Subsequent list requests will have their own nextPageToken to
7704 # continue paging through the results.
7705 }</pre>
7706 </div>
7707
7708 <div class="method">
7709 <code class="details" id="listManagedInstances_next">listManagedInstances_next()</code>
7710 <pre>Retrieves the next page of results.
7711
7712 Args:
7713 previous_request: The request for the previous page. (required)
7714 previous_response: The response from the request for the previous page. (required)
7715
7716 Returns:
7717 A request object that you can call &#x27;execute()&#x27; on to request the next
7718 page. Returns None if there are no more items in the collection.
7719 </pre>
7720 </div>
7721
7722 <div class="method">
7723 <code class="details" id="listPerInstanceConfigs">listPerInstanceConfigs(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
7724 <pre>Lists all of the per-instance configurations defined for the managed
7725 instance group. The orderBy query parameter is not supported.
7726
7727 Args:
7728 project: string, Project ID for this request. (required)
7729 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
7730 instanceGroupManager: string, The name of the managed instance group. It should conform to RFC1035. (required)
7731 filter: string, A filter expression that filters resources listed in the response. Most
7732 Compute resources support two types of filter expressions:
7733 expressions that support regular expressions and expressions that follow
7734 API improvement proposal AIP-160.
7735 These two types of filter expressions cannot be mixed in one request.
7736
7737 If you want to use AIP-160, your expression must specify the field name, an
7738 operator, and the value that you want to use for filtering. The value
7739 must be a string, a number, or a boolean. The operator
7740 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
7741
7742 For example, if you are filtering Compute Engine instances, you can
7743 exclude instances named `example-instance` by specifying
7744 `name != example-instance`.
7745
7746 The `:*` comparison can be used to test whether a key has been defined.
7747 For example, to find all objects with `owner` label use:
7748 ```
7749 labels.owner:*
7750 ```
7751
7752 You can also filter nested fields. For example, you could specify
7753 `scheduling.automaticRestart = false` to include instances only
7754 if they are not scheduled for automatic restarts. You can use filtering
7755 on nested fields to filter based onresource labels.
7756
7757 To filter on multiple expressions, provide each separate expression within
7758 parentheses. For example:
7759 ```
7760 (scheduling.automaticRestart = true)
7761 (cpuPlatform = &quot;Intel Skylake&quot;)
7762 ```
7763 By default, each expression is an `AND` expression. However, you
7764 can include `AND` and `OR` expressions explicitly.
7765 For example:
7766 ```
7767 (cpuPlatform = &quot;Intel Skylake&quot;) OR
7768 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
7769 (scheduling.automaticRestart = true)
7770 ```
7771
7772 If you want to use a regular expression, use the `eq` (equal) or `ne`
7773 (not equal) operator against a single un-parenthesized expression with or
7774 without quotes or against multiple parenthesized expressions. Examples:
7775
7776 `fieldname eq unquoted literal`
7777 `fieldname eq &#x27;single quoted literal&#x27;`
7778 `fieldname eq &quot;double quoted literal&quot;`
7779 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
7780
7781 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
7782 The literal value must match the entire field.
7783
7784 For example, to filter for instances that do not end with name &quot;instance&quot;,
7785 you would use `name ne .*instance`.
7786
7787 You cannot combine constraints on multiple fields using regular
7788 expressions.
7789 maxResults: integer, The maximum number of results per page that should be returned.
7790 If the number of available results is larger than `maxResults`,
7791 Compute Engine returns a `nextPageToken` that can be used to get
7792 the next page of results in subsequent list requests. Acceptable values are
7793 `0` to `500`, inclusive. (Default: `500`)
7794 orderBy: string, Sorts list results by a certain order. By default, results
7795 are returned in alphanumerical order based on the resource name.
7796
7797 You can also sort results in descending order based on the creation
7798 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
7799 results based on the `creationTimestamp` field in
7800 reverse chronological order (newest result first). Use this to sort
7801 resources like operations so that the newest operation is returned first.
7802
7803 Currently, only sorting by `name` or
7804 `creationTimestamp desc` is supported.
7805 pageToken: string, Specifies a page token to use. Set `pageToken` to the
7806 `nextPageToken` returned by a previous list request to get
7807 the next page of results.
7808 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
7809 of failure. The default value is false.
7810
7811 For example, when partial success behavior is enabled, aggregatedList for a
7812 single zone scope either returns all resources in the zone or no resources,
7813 with an error code.
7814 x__xgafv: string, V1 error format.
7815 Allowed values
7816 1 - v1 error format
7817 2 - v2 error format
7818
7819 Returns:
7820 An object of the form:
7821
7822 {
7823 &quot;items&quot;: [ # Output only. [Output Only] The list of PerInstanceConfig.
7824 {
7825 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
7826 # optimistic locking. It is ignored when inserting a per-instance
7827 # config. An up-to-date fingerprint must be provided in order to update an
7828 # existing per-instance configuration or the field needs to be unset.
7829 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
7830 # Serves as a merge key during UpdatePerInstanceConfigs
7831 # operations, that is, if a per-instance configuration with the same name
7832 # exists then it will be updated, otherwise a new one will be created for the
7833 # VM instance with the same name. An attempt to create a per-instance
7834 # configuration for a VM instance that either doesn&#x27;t exist or is not part
7835 # of the group will result in an error.
7836 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
7837 # preserved state generated from a stateful policy.
7838 &quot;disks&quot;: { # Preserved disks defined for this instance.
7839 # This map is keyed with the device names of the disks.
7840 &quot;a_key&quot;: {
7841 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
7842 # update, instance recreate operations. This flag is used to configure
7843 # if the disk should be deleted after it is no longer used by the group,
7844 # e.g. when the given instance or the whole MIG is deleted.
7845 # Note: disks attached in READ_ONLY mode cannot be
7846 # auto-deleted.
7847 &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
7848 # disk in READ_WRITE mode.
7849 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
7850 # to the VM instance.
7851 },
7852 },
7853 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
7854 # This map is keyed with the name of the network interface.
7855 &quot;a_key&quot;: {
7856 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7857 # update or VM instance recreate operations.
7858 # This flag is used to configure if the IP reservation should be deleted
7859 # after it is no longer used by the group, e.g. when the given instance
7860 # or the whole group is deleted.
7861 &quot;ipAddress&quot;: { # Ip address representation
7862 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
7863 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
7864 # network interface.
7865 },
7866 },
7867 },
7868 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
7869 # This map is keyed with the name of the network interface.
7870 &quot;a_key&quot;: {
7871 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7872 # update or VM instance recreate operations.
7873 # This flag is used to configure if the IP reservation should be deleted
7874 # after it is no longer used by the group, e.g. when the given instance
7875 # or the whole group is deleted.
7876 &quot;ipAddress&quot;: { # Ip address representation
7877 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
7878 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
7879 # network interface.
7880 },
7881 },
7882 },
7883 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
7884 &quot;a_key&quot;: &quot;A String&quot;,
7885 },
7886 },
7887 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
7888 # managed instance.
7889 },
7890 ],
7891 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
7892 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
7893 # the query parameter pageToken in the next list request.
7894 # Subsequent list requests will have their own nextPageToken to
7895 # continue paging through the results.
7896 &quot;warning&quot;: { # Output only. [Output Only] Informational warning message.
7897 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
7898 # Engine returns NO_RESULTS_ON_PAGE if there
7899 # are no results in the response.
7900 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
7901 # value format. For example:
7902 #
7903 # &quot;data&quot;: [
7904 # {
7905 # &quot;key&quot;: &quot;scope&quot;,
7906 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
7907 # }
7908 {
7909 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
7910 # returned. For example, for warnings where there are no results in a list
7911 # request for a particular zone, this key might be scope and
7912 # the key value might be the zone name. Other examples might be a key
7913 # indicating a deprecated resource and a suggested replacement, or a
7914 # warning about invalid network settings (for example, if an instance
7915 # attempts to perform IP forwarding but is not enabled for IP forwarding).
7916 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
7917 },
7918 ],
7919 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
7920 },
7921 }</pre>
7922 </div>
7923
7924 <div class="method">
7925 <code class="details" id="listPerInstanceConfigs_next">listPerInstanceConfigs_next()</code>
7926 <pre>Retrieves the next page of results.
7927
7928 Args:
7929 previous_request: The request for the previous page. (required)
7930 previous_response: The response from the request for the previous page. (required)
7931
7932 Returns:
7933 A request object that you can call &#x27;execute()&#x27; on to request the next
7934 page. Returns None if there are no more items in the collection.
7935 </pre>
7936 </div>
7937
7938 <div class="method">
7939 <code class="details" id="list_next">list_next()</code>
7940 <pre>Retrieves the next page of results.
7941
7942 Args:
7943 previous_request: The request for the previous page. (required)
7944 previous_response: The response from the request for the previous page. (required)
7945
7946 Returns:
7947 A request object that you can call &#x27;execute()&#x27; on to request the next
7948 page. Returns None if there are no more items in the collection.
7949 </pre>
7950 </div>
7951
7952 <div class="method">
7953 <code class="details" id="patch">patch(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
7954 <pre>Updates a managed instance group using the information that you specify
7955 in the request.
7956 This operation is marked as DONE when the group is patched
7957 even if the instances in the group are still in the process of being
7958 patched. You must separately verify the status of the individual instances
7959 with the listmanagedinstances
7960 method. This method supportsPATCH
7961 semantics and uses theJSON merge
7962 patch format and processing rules.
7963
7964 If you update your group to specify a new template or instance
7965 configuration, it&#x27;s possible that your intended specification for each VM
7966 in the group is different from the current state of that VM. To learn how
7967 to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
7968 a MIG.
7969
7970 Args:
7971 project: string, Project ID for this request. (required)
7972 region: string, Name of the region scoping this request. (required)
7973 instanceGroupManager: string, The name of the instance group manager. (required)
7974 body: object, The request body.
7975 The object takes the form of:
7976
7977 { # Represents a Managed Instance Group resource.
7978 #
7979 # An instance group is a collection of VM instances that you can manage as a
7980 # single entity. For more information, readInstance groups.
7981 #
7982 # For zonal Managed Instance Group, use the instanceGroupManagers
7983 # resource.
7984 #
7985 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
7986 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
7987 # for the group.
7988 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
7989 #
7990 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
7991 # instances to apply the configuration. To apply the configuration, set the
7992 # group&#x27;s updatePolicy.type field to use proactive updates or
7993 # use the applyUpdatesToInstances method.
7994 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
7995 &quot;a_key&quot;: &quot;A String&quot;,
7996 },
7997 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
7998 # more information, see Project and
7999 # instance metadata.
8000 &quot;a_key&quot;: &quot;A String&quot;,
8001 },
8002 },
8003 },
8004 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
8005 # only one value.
8006 {
8007 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
8008 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
8009 # initialize and run its startup script. During a VM&#x27;s initial delay
8010 # period, the MIG ignores unsuccessful health checks because the VM might
8011 # be in the startup process. This prevents the MIG from prematurely
8012 # recreating a VM. If the health check receives a healthy response during
8013 # the initial delay, it indicates that the startup process is complete and
8014 # the VM is ready. The value of initial delay must be between 0 and 3600
8015 # seconds. The default value is 0.
8016 },
8017 ],
8018 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
8019 # all VMs in a MIG. The maximum character length is 58 and the name must
8020 # comply with RFC1035 format.
8021 #
8022 # When a VM is created in the group, the MIG appends a hyphen and a random
8023 # four-character string to the base instance name. If you want the MIG to
8024 # assign sequential numbers instead of a random string, then end the base
8025 # instance name with a hyphen followed by one or more hash symbols. The hash
8026 # symbols indicate the number of digits. For example, a base instance name of
8027 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
8028 # @pattern
8029 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
8030 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
8031 # text format.
8032 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
8033 # in this managed instance group that are scheduled for each of those
8034 # actions.
8035 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
8036 # that are scheduled to be abandoned. Abandoning an instance removes it
8037 # from the managed instance group without deleting it.
8038 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
8039 # are scheduled to be adopted or are currently being adopted.
8040 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
8041 # are scheduled to be created or are currently being created. If the group
8042 # fails to create any of these instances, it tries again until it creates
8043 # the instance successfully.
8044 #
8045 # If you have disabled creation retries, this field will not be populated;
8046 # instead, the creatingWithoutRetries field will be populated.
8047 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
8048 # will attempt to create. The group attempts to create each instance
8049 # only once. If the group fails to create any of these instances, it
8050 # decreases the group&#x27;s targetSize value accordingly.
8051 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
8052 # are scheduled to be deleted or are currently being deleted.
8053 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
8054 # are running and have no scheduled actions.
8055 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
8056 # are scheduled to be recreated or are currently being being recreated.
8057 # Recreating an instance deletes the existing root persistent disk
8058 # and creates a new disk from the image that is defined in the
8059 # instance template.
8060 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
8061 # are being reconfigured with properties that do not require a restart
8062 # or a recreate action. For example, setting or removing target
8063 # pools for the instance.
8064 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
8065 # are scheduled to be restarted or are currently being restarted.
8066 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
8067 # are scheduled to be restarted or are currently being restarted.
8068 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
8069 # are scheduled to be resumed or are currently being resumed.
8070 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
8071 # are scheduled to be started or are currently being started.
8072 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
8073 # are scheduled to be stopped or are currently being stopped.
8074 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
8075 # are scheduled to be suspended or are currently being suspended.
8076 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
8077 # are being verified. See the managedInstances[].currentAction
8078 # property in the listManagedInstances method documentation.
8079 },
8080 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
8081 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
8082 # zones in a regional managed instance group.
8083 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
8084 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
8085 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
8086 # its instances.
8087 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
8088 # instances, even if an AI zone is available in the specified region. To
8089 # create instances in an AI zone in the selected region, you must explicitly
8090 # specify it in the distribution policy together with the other preferred
8091 # zones.
8092 {
8093 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
8094 # The zone must exist in the region where the managed instance group is
8095 # located.
8096 },
8097 ],
8098 },
8099 &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.
8100 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
8101 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
8102 # fingerprint must be provided in order to update the InstanceGroupManager,
8103 # otherwise the request will fail with error412 conditionNotMet.
8104 #
8105 # To see the latest fingerprint, make a get() request to
8106 # retrieve an InstanceGroupManager.
8107 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
8108 # generates this identifier.
8109 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
8110 # types of machines.
8111 # Instance flexibility configuration on MIG overrides instance
8112 # template configuration.
8113 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
8114 # when creating new VMs.
8115 &quot;a_key&quot;: {
8116 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
8117 # selection.
8118 { # An instance-attached disk resource.
8119 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
8120 # or X86_64.
8121 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
8122 # deleted (but not when the disk is detached from the instance).
8123 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
8124 # partition of the disk for its root filesystem.
8125 &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
8126 # running within the instance. This name can be used to reference the device
8127 # for mounting, resizing, and so on, from within the instance.
8128 #
8129 # If not specified, the server chooses a default device name to apply to this
8130 # disk, in the form persistent-disk-x, where x is a number
8131 # assigned by Google Compute Engine. This field is only applicable for
8132 # persistent disks.
8133 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
8134 # encryption key.
8135 #
8136 # If you are creating a new disk, this field encrypts the new disk using
8137 # an encryption key that you provide. If you are attaching an existing
8138 # disk that is already encrypted, this field decrypts the disk using
8139 # the customer-supplied encryption key.
8140 #
8141 # If you encrypt a disk using a customer-supplied key, you must provide the
8142 # same key again when you attempt to use this resource at a later time. For
8143 # example, you must provide the key when you create a snapshot or an image
8144 # from the disk or when you attach the disk to a virtual machine instance.
8145 #
8146 # If you do not provide an encryption key, then the disk will be encrypted
8147 # using an automatically generated key and you do not need to provide a key
8148 # to use the disk later.
8149 #
8150 # Note:
8151 #
8152 # Instance templates do not storecustomer-supplied
8153 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
8154 #
8155 # You cannot create VMs that have disks with customer-supplied keys using
8156 # the bulk
8157 # insert method.
8158 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
8159 # For example:
8160 #
8161 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8162 # key_region/cryptoKeys/key
8163 #
8164 # The fully-qualifed key name may be returned for resource GET requests. For
8165 # example:
8166 #
8167 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8168 # key_region/cryptoKeys/key
8169 # /cryptoKeyVersions/1
8170 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
8171 # key. If absent, the Compute Engine default service account is used.
8172 # For example:
8173 #
8174 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
8175 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
8176 # encryption key, encoded in RFC
8177 # 4648 base64 to either encrypt or decrypt this resource. You can
8178 # provide either the rawKey or thersaEncryptedKey.
8179 # For example:
8180 #
8181 # &quot;rawKey&quot;:
8182 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
8183 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
8184 # customer-supplied encryption key to either encrypt or decrypt this
8185 # resource. You can provide either the rawKey or thersaEncryptedKey.
8186 # For example:
8187 #
8188 # &quot;rsaEncryptedKey&quot;:
8189 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
8190 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
8191 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
8192 #
8193 # The key must meet the following requirements before you can provide it to
8194 # Compute Engine:
8195 #
8196 # 1. The key is wrapped using a RSA public key certificate provided by
8197 # Google.
8198 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
8199 # encoding.
8200 #
8201 # Gets the RSA public key certificate provided by Google at:
8202 #
8203 #
8204 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
8205 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
8206 # 4648 base64 encoded SHA-256 hash of the customer-supplied
8207 # encryption key that protects this resource.
8208 },
8209 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
8210 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
8211 # currently attached to another instance. If you try to force attach a zonal
8212 # disk to an instance, you will receive an error.
8213 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
8214 # only for bootable images. Read
8215 # Enabling guest operating system features to see a list of available
8216 # options.
8217 { # Guest OS features.
8218 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
8219 # separate values. Set to one or more of the following values:
8220 #
8221 # - VIRTIO_SCSI_MULTIQUEUE
8222 # - WINDOWS
8223 # - MULTI_IP_SUBNET
8224 # - UEFI_COMPATIBLE
8225 # - GVNIC
8226 # - SEV_CAPABLE
8227 # - SUSPEND_RESUME_COMPATIBLE
8228 # - SEV_LIVE_MIGRATABLE_V2
8229 # - SEV_SNP_CAPABLE
8230 # - TDX_CAPABLE
8231 # - IDPF
8232 # - SNP_SVSM_CAPABLE
8233 # - CCA_CAPABLE
8234 #
8235 #
8236 # For more information, see
8237 # Enabling guest operating system features.
8238 },
8239 ],
8240 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
8241 # boot disk. If you have many disks attached to an instance, each
8242 # disk would have a unique index number.
8243 &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
8244 # alongside the new instance. Use initialization parameters to create boot
8245 # disks or local SSDs attached to the new instance.
8246 #
8247 # This property is mutually exclusive with the source property;
8248 # you can only define one or the other, but not both.
8249 # alongside the new instance. Use initialization parameters to create boot
8250 # disks or local SSDs attached to the new instance.
8251 #
8252 # This field is persisted and returned for instanceTemplate and not returned
8253 # in the context of instance.
8254 #
8255 # This property is mutually exclusive with the source property;
8256 # you can only define one or the other, but not both.
8257 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
8258 # arm64 or x86_64.
8259 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
8260 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
8261 # of the instance. If a disk with the same name already exists in the given
8262 # region, the existing disk is attached to the new instance and the
8263 # new disk is not created.
8264 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
8265 # 10 GB. If you specify a sourceImage, which is required for
8266 # boot disks, the default size is the size of the sourceImage.
8267 # If you do not specify a sourceImage, the default disk size
8268 # is 500 GB.
8269 &quot;diskType&quot;: &quot;A String&quot;,
8270 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
8271 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
8272 # only for bootable images. Read
8273 # Enabling guest operating system features to see a list of available
8274 # options.
8275 #
8276 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
8277 { # Guest OS features.
8278 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
8279 # separate values. Set to one or more of the following values:
8280 #
8281 # - VIRTIO_SCSI_MULTIQUEUE
8282 # - WINDOWS
8283 # - MULTI_IP_SUBNET
8284 # - UEFI_COMPATIBLE
8285 # - GVNIC
8286 # - SEV_CAPABLE
8287 # - SUSPEND_RESUME_COMPATIBLE
8288 # - SEV_LIVE_MIGRATABLE_V2
8289 # - SEV_SNP_CAPABLE
8290 # - TDX_CAPABLE
8291 # - IDPF
8292 # - SNP_SVSM_CAPABLE
8293 # - CCA_CAPABLE
8294 #
8295 #
8296 # For more information, see
8297 # Enabling guest operating system features.
8298 },
8299 ],
8300 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
8301 # persistent disks.
8302 &quot;a_key&quot;: &quot;A String&quot;,
8303 },
8304 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
8305 &quot;A String&quot;,
8306 ],
8307 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
8308 # more than one instance.
8309 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
8310 # is to use the existing disk.
8311 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
8312 # of I/O operations per second that the disk can handle. Values must be
8313 # between 10,000 and 120,000. For more details, see theExtreme persistent
8314 # disk documentation.
8315 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
8316 # number of throughput mb per second that the disk can handle. Values must
8317 # greater than or equal to 1.
8318 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
8319 # the URLs of the zones where the disk should be replicated to.
8320 # You must provide exactly two replica zones, and one zone must be the same
8321 # as the instance zone.
8322 &quot;A String&quot;,
8323 ],
8324 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
8325 # have the same definition as resource
8326 # manager tags. Keys and values can be either in numeric format,
8327 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
8328 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
8329 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
8330 # empty.
8331 &quot;a_key&quot;: &quot;A String&quot;,
8332 },
8333 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
8334 # Specified using the full or partial URL. For instance template, specify
8335 # only the resource policy name.
8336 &quot;A String&quot;,
8337 ],
8338 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
8339 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
8340 # is required.
8341 #
8342 # To create a disk with one of the public operating system
8343 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
8344 #
8345 # projects/debian-cloud/global/images/family/debian-9
8346 #
8347 #
8348 # Alternatively, use a specific version of a public operating system image:
8349 #
8350 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
8351 #
8352 #
8353 # To create a disk with a custom image that you created, specify the
8354 # image name in the following format:
8355 #
8356 # global/images/my-custom-image
8357 #
8358 #
8359 # You can also specify a custom image by its image family, which returns
8360 # the latest version of the image in that family. Replace the image name
8361 # with family/family-name:
8362 #
8363 # global/images/family/my-image-family
8364 #
8365 #
8366 # If the source image is deleted later, this field will not be set.
8367 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
8368 # encryption key of the source image. Required if the source image is
8369 # protected by a customer-supplied encryption key.
8370 #
8371 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
8372 # encryption keys, so you cannot create disks for instances in a managed instance group if the
8373 # source images are encrypted with your own keys.
8374 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
8375 # For example:
8376 #
8377 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8378 # key_region/cryptoKeys/key
8379 #
8380 # The fully-qualifed key name may be returned for resource GET requests. For
8381 # example:
8382 #
8383 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8384 # key_region/cryptoKeys/key
8385 # /cryptoKeyVersions/1
8386 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
8387 # key. If absent, the Compute Engine default service account is used.
8388 # For example:
8389 #
8390 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
8391 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
8392 # encryption key, encoded in RFC
8393 # 4648 base64 to either encrypt or decrypt this resource. You can
8394 # provide either the rawKey or thersaEncryptedKey.
8395 # For example:
8396 #
8397 # &quot;rawKey&quot;:
8398 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
8399 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
8400 # customer-supplied encryption key to either encrypt or decrypt this
8401 # resource. You can provide either the rawKey or thersaEncryptedKey.
8402 # For example:
8403 #
8404 # &quot;rsaEncryptedKey&quot;:
8405 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
8406 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
8407 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
8408 #
8409 # The key must meet the following requirements before you can provide it to
8410 # Compute Engine:
8411 #
8412 # 1. The key is wrapped using a RSA public key certificate provided by
8413 # Google.
8414 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
8415 # encoding.
8416 #
8417 # Gets the RSA public key certificate provided by Google at:
8418 #
8419 #
8420 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
8421 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
8422 # 4648 base64 encoded SHA-256 hash of the customer-supplied
8423 # encryption key that protects this resource.
8424 },
8425 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
8426 # instance boot disk, one of initializeParams.sourceSnapshot
8427 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
8428 # is required.
8429 #
8430 # To create a disk with a snapshot that you created, specify the
8431 # snapshot name in the following format:
8432 #
8433 # us-central1-a/instantSnapshots/my-backup
8434 #
8435 #
8436 # If the source instant-snapshot is deleted later, this field will not be
8437 # set.
8438 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
8439 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
8440 # is required.
8441 #
8442 # To create a disk with a snapshot that you created, specify the
8443 # snapshot name in the following format:
8444 #
8445 # global/snapshots/my-backup
8446 #
8447 #
8448 # If the source snapshot is deleted later, this field will not be set.
8449 #
8450 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
8451 # an image instead when you create VMs using
8452 # the bulk
8453 # insert method.
8454 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
8455 # encryption key of the source snapshot.
8456 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
8457 # For example:
8458 #
8459 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8460 # key_region/cryptoKeys/key
8461 #
8462 # The fully-qualifed key name may be returned for resource GET requests. For
8463 # example:
8464 #
8465 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8466 # key_region/cryptoKeys/key
8467 # /cryptoKeyVersions/1
8468 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
8469 # key. If absent, the Compute Engine default service account is used.
8470 # For example:
8471 #
8472 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
8473 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
8474 # encryption key, encoded in RFC
8475 # 4648 base64 to either encrypt or decrypt this resource. You can
8476 # provide either the rawKey or thersaEncryptedKey.
8477 # For example:
8478 #
8479 # &quot;rawKey&quot;:
8480 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
8481 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
8482 # customer-supplied encryption key to either encrypt or decrypt this
8483 # resource. You can provide either the rawKey or thersaEncryptedKey.
8484 # For example:
8485 #
8486 # &quot;rsaEncryptedKey&quot;:
8487 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
8488 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
8489 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
8490 #
8491 # The key must meet the following requirements before you can provide it to
8492 # Compute Engine:
8493 #
8494 # 1. The key is wrapped using a RSA public key certificate provided by
8495 # Google.
8496 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
8497 # encoding.
8498 #
8499 # Gets the RSA public key certificate provided by Google at:
8500 #
8501 #
8502 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
8503 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
8504 # 4648 base64 encoded SHA-256 hash of the customer-supplied
8505 # encryption key that protects this resource.
8506 },
8507 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
8508 # this as a partial or full URL to the resource. For example, the following
8509 # are valid values:
8510 #
8511 #
8512 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
8513 # - projects/project/zones/zone/storagePools/storagePool
8514 # - zones/zone/storagePools/storagePool
8515 },
8516 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
8517 # either SCSI or NVME. For most machine types, the
8518 # default is SCSI. Local SSDs can use either NVME or SCSI.
8519 # In certain configurations, persistent disks can use NVMe. For more
8520 # information, seeAbout
8521 # persistent disks.
8522 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
8523 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
8524 &quot;A String&quot;,
8525 ],
8526 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
8527 # disk is not allowed to be detached from the instance, or to be used as the
8528 # source of the snapshot creation, and the image creation. The instance with
8529 # at least one locked attached disk is not allow to be used as source of
8530 # machine image creation, instant snapshot creation, and not allowed to be
8531 # deleted with --keep-disk parameter set to true for locked disks.
8532 &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
8533 # in READ_WRITE mode.
8534 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
8535 # field is set to PRESERVED if the LocalSSD data has been saved
8536 # to a persistent location by customer request. (see the
8537 # discard_local_ssd option on Stop/Suspend).
8538 # Read-only in the api.
8539 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
8540 # these are public keys which are safe to store in public
8541 &quot;dbs&quot;: [ # The Key Database (db).
8542 {
8543 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
8544 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
8545 },
8546 ],
8547 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
8548 {
8549 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
8550 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
8551 },
8552 ],
8553 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
8554 {
8555 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
8556 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
8557 },
8558 ],
8559 &quot;pk&quot;: { # The Platform Key (PK).
8560 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
8561 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
8562 },
8563 },
8564 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
8565 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
8566 # is required.
8567 #
8568 # If desired, you can also attach existing non-root persistent disks using
8569 # this property. This field is only applicable for persistent disks.
8570 #
8571 # Note that for InstanceTemplate, specify the disk name for zonal disk,
8572 # and the URL for regional disk.
8573 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
8574 },
8575 ],
8576 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
8577 &quot;A String&quot;,
8578 ],
8579 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
8580 # e.g. &#x27;Intel Ice Lake&#x27;.
8581 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
8582 # preference. MIG will first try to create a VM based on the machine-type
8583 # with lowest rank and fallback to next rank based on availability.
8584 # Machine types and instance selections with the same rank have the same
8585 # preference.
8586 },
8587 },
8588 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
8589 # create instances.
8590 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
8591 # more preemption than the minimum capacity user needs. MIG will create
8592 # only Standard VMs until it reaches standard_capacity_base and only
8593 # then will start using standard_capacity_percent_above_base to mix Spot
8594 # with Standard VMs.
8595 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
8596 # remaining percentage will use Spot VMs. The percentage applies only to
8597 # the capacity above standard_capacity_base.
8598 },
8599 },
8600 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
8601 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
8602 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
8603 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
8604 # applies to the VMs on which your application fails a health check.
8605 # Valid values are
8606 #
8607 # - REPAIR (default): MIG automatically repairs a failed VM
8608 # by recreating it. For more information, see About
8609 # repairing VMs in a MIG.
8610 # - DO_NOTHING: MIG does not repair a failed VM.
8611 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
8612 # configuration when repairing a VM. Valid options are:
8613 #
8614 #
8615 #
8616 # - NO (default): If configuration updates are available, they are not
8617 # forcefully applied during repair. Instead, configuration updates are
8618 # applied according to the group&#x27;s update policy.
8619 #
8620 # - YES: If configuration updates are available, they are applied
8621 # during repair.
8622 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
8623 # unhealthy when the application running on that VM fails a health check.
8624 # Valid values are:
8625 #
8626 # - DEFAULT_ACTION (default): MIG uses the same action
8627 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
8628 # - REPAIR: MIG automatically repairs an unhealthy VM by
8629 # recreating it.
8630 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
8631 # For more information, see
8632 # About repairing VMs in a MIG.
8633 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
8634 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
8635 # Valid values are:
8636 #
8637 # - NO (default): MIG cannot change a VM&#x27;s zone during a
8638 # repair.
8639 # - YES: MIG can select a different zone for the VM during
8640 # a repair.
8641 },
8642 },
8643 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
8644 # instance group. The group uses this template to create all new instances
8645 # in the managed instance group. The templates for existing instances in the
8646 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
8647 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
8648 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
8649 # this managed instance group.
8650 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
8651 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
8652 # long, and comply withRFC1035.
8653 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
8654 # to this Instance Group Manager.
8655 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
8656 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
8657 # The name must be 1-63 characters long, and comply withRFC1035.
8658 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
8659 },
8660 ],
8661 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
8662 # as part of resource payload.
8663 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
8664 # key-value pairs. Keys and values can be either in numeric format,
8665 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
8666 # format such as `{org_id|project_id}/{tag_key_short_name}` and
8667 # `{tag_value_short_name}`. For more information, seeManage tags
8668 # for resources.
8669 &quot;a_key&quot;: &quot;A String&quot;,
8670 },
8671 },
8672 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
8673 # where the managed instance group resides (for regional resources).
8674 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
8675 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
8676 # instance group.
8677 # It can be a full or partial URL. For example, the following are
8678 # all valid URLs to a workload policy:
8679 #
8680 #
8681 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
8682 # - projects/project/regions/region/resourcePolicies/resourcePolicy
8683 # - regions/region/resourcePolicies/resourcePolicy
8684 },
8685 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
8686 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
8687 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
8688 # this URL.
8689 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
8690 # by the managed instance group on instances. The service accounts needs all
8691 # permissions required to create and delete instances.
8692 # By default, the service account
8693 # {projectNumber}@cloudservices.gserviceaccount.com is used.
8694 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
8695 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
8696 # stop a VM after that VM was created. The initial delay gives the
8697 # initialization script the time to prepare your VM for a quick scale out.
8698 # The value of initial delay must be between 0 and 3600 seconds. The
8699 # default value is 0.
8700 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
8701 # group scales out. The default mode is `MANUAL`.
8702 },
8703 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
8704 &quot;preservedState&quot;: { # Configuration of preserved resources.
8705 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
8706 # delete, update, etc. This map is keyed with the device names of
8707 # the disks.
8708 &quot;a_key&quot;: {
8709 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
8710 # update or VM instance recreate operations.
8711 # This flag is used to configure if the disk should be deleted after it
8712 # is no longer used by the group, e.g. when the given instance or
8713 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
8714 },
8715 },
8716 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
8717 # instance delete, update, etc. This map is keyed with the network
8718 # interface name.
8719 &quot;a_key&quot;: {
8720 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
8721 # update or VM instance recreate operations.
8722 # This flag is used to configure if the IP reservation should be deleted
8723 # after it is no longer used by the group, e.g. when the given instance
8724 # or the whole group is deleted.
8725 },
8726 },
8727 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
8728 # instance delete, update, etc. This map is keyed with the network
8729 # interface name.
8730 &quot;a_key&quot;: {
8731 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
8732 # update or VM instance recreate operations.
8733 # This flag is used to configure if the IP reservation should be deleted
8734 # after it is no longer used by the group, e.g. when the given instance
8735 # or the whole group is deleted.
8736 },
8737 },
8738 },
8739 },
8740 &quot;status&quot;: { # Output only. The status of this managed instance group.
8741 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
8742 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
8743 # This value is in RFC3339 text format.
8744 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
8745 # been applied to all managed instances in the group.
8746 },
8747 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
8748 # Currently only one accelerator topology is supported.
8749 {
8750 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
8751 # The value is the same as configured in the WorkloadPolicy.
8752 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
8753 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
8754 # check.
8755 &quot;error&quot;: { # Output only. Encountered errors.
8756 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8757 # operation.
8758 {
8759 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8760 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8761 # details. There is a set of defined message types to use for providing
8762 # details.The syntax depends on the error code. For example,
8763 # QuotaExceededInfo will have details when the error code is
8764 # QUOTA_EXCEEDED.
8765 {
8766 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8767 #
8768 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8769 # is not enabled:
8770 #
8771 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8772 # &quot;domain&quot;: &quot;googleapis.com&quot;
8773 # &quot;metadata&quot;: {
8774 # &quot;resource&quot;: &quot;projects/123&quot;,
8775 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8776 # }
8777 # }
8778 #
8779 # This response indicates that the pubsub.googleapis.com API is not enabled.
8780 #
8781 # Example of an error that is returned when attempting to create a Spanner
8782 # instance in a region that is out of stock:
8783 #
8784 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8785 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8786 # &quot;metadata&quot;: {
8787 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8788 # }
8789 # }
8790 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8791 # is typically the registered service name of the tool or product that
8792 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8793 # generated by some common infrastructure, the error domain must be a
8794 # globally unique value that identifies the infrastructure. For Google API
8795 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8796 &quot;metadatas&quot;: { # Additional structured details about this error.
8797 #
8798 # Keys must match a regular expression of `a-z+` but should
8799 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8800 # length. When identifying the current value of an exceeded limit, the units
8801 # should be contained in the key, not the value. For example, rather than
8802 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8803 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8804 # instances that can be created in a single (batch) request.
8805 &quot;a_key&quot;: &quot;A String&quot;,
8806 },
8807 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8808 # proximate cause of the error. Error reasons are unique within a particular
8809 # domain of errors. This should be at most 63 characters and match a
8810 # regular expression of `A-Z+[A-Z0-9]`, which represents
8811 # UPPER_SNAKE_CASE.
8812 },
8813 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8814 #
8815 # For example, if a quota check failed with an error indicating the calling
8816 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8817 # directly to the right place in the developer console to flip the bit.
8818 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8819 { # Describes a URL link.
8820 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8821 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8822 },
8823 ],
8824 },
8825 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8826 # which can be attached to an RPC error.
8827 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8828 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8829 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8830 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8831 },
8832 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8833 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8834 &quot;a_key&quot;: &quot;A String&quot;,
8835 },
8836 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8837 # type or metric.
8838 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8839 # or metric.
8840 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8841 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8842 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8843 },
8844 },
8845 ],
8846 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8847 # This property is optional.
8848 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8849 },
8850 ],
8851 },
8852 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
8853 # has // RFC3339 //
8854 # text format.
8855 },
8856 },
8857 ],
8858 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
8859 # that targets this instance group manager.
8860 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
8861 # targetSizePolicy.mode is set to BULK.
8862 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
8863 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
8864 # operation.
8865 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
8866 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8867 # operation.
8868 {
8869 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8870 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8871 # details. There is a set of defined message types to use for providing
8872 # details.The syntax depends on the error code. For example,
8873 # QuotaExceededInfo will have details when the error code is
8874 # QUOTA_EXCEEDED.
8875 {
8876 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8877 #
8878 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8879 # is not enabled:
8880 #
8881 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8882 # &quot;domain&quot;: &quot;googleapis.com&quot;
8883 # &quot;metadata&quot;: {
8884 # &quot;resource&quot;: &quot;projects/123&quot;,
8885 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8886 # }
8887 # }
8888 #
8889 # This response indicates that the pubsub.googleapis.com API is not enabled.
8890 #
8891 # Example of an error that is returned when attempting to create a Spanner
8892 # instance in a region that is out of stock:
8893 #
8894 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8895 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8896 # &quot;metadata&quot;: {
8897 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8898 # }
8899 # }
8900 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8901 # is typically the registered service name of the tool or product that
8902 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8903 # generated by some common infrastructure, the error domain must be a
8904 # globally unique value that identifies the infrastructure. For Google API
8905 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8906 &quot;metadatas&quot;: { # Additional structured details about this error.
8907 #
8908 # Keys must match a regular expression of `a-z+` but should
8909 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8910 # length. When identifying the current value of an exceeded limit, the units
8911 # should be contained in the key, not the value. For example, rather than
8912 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8913 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8914 # instances that can be created in a single (batch) request.
8915 &quot;a_key&quot;: &quot;A String&quot;,
8916 },
8917 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8918 # proximate cause of the error. Error reasons are unique within a particular
8919 # domain of errors. This should be at most 63 characters and match a
8920 # regular expression of `A-Z+[A-Z0-9]`, which represents
8921 # UPPER_SNAKE_CASE.
8922 },
8923 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8924 #
8925 # For example, if a quota check failed with an error indicating the calling
8926 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8927 # directly to the right place in the developer console to flip the bit.
8928 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8929 { # Describes a URL link.
8930 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8931 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8932 },
8933 ],
8934 },
8935 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8936 # which can be attached to an RPC error.
8937 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8938 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8939 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8940 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8941 },
8942 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8943 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8944 &quot;a_key&quot;: &quot;A String&quot;,
8945 },
8946 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8947 # type or metric.
8948 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8949 # or metric.
8950 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8951 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8952 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8953 },
8954 },
8955 ],
8956 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8957 # This property is optional.
8958 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8959 },
8960 ],
8961 },
8962 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
8963 # operation. Timestamp is in RFC3339 text format.
8964 },
8965 },
8966 &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
8967 # in this managed instance group that have the status. Currently only shown
8968 # for TPU MIGs
8969 # instance group that have the status. For more information about how to
8970 # interpret each status check the instance lifecycle documentation.
8971 # Currently only shown for TPU MIGs.
8972 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
8973 # that have DEPROVISIONING status.
8974 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
8975 # have been deleted. Includes only instances that would be shown in the
8976 # listManagedInstances method and not all instances that have been
8977 # deleted in the lifetime of the MIG.
8978 # Does not include FlexStart instances that are waiting for the resources
8979 # availability, they are considered as &#x27;pending&#x27;.
8980 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
8981 # that have PENDING status, that is FlexStart instances that are waiting
8982 # for resources. Instances that do not exist because of the other reasons
8983 # are counted as &#x27;non_existent&#x27;.
8984 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
8985 # that have PENDING_STOP status.
8986 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
8987 # that have PROVISIONING status.
8988 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
8989 # that have REPAIRING status.
8990 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
8991 # that have RUNNING status.
8992 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
8993 # that have STAGING status.
8994 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
8995 # that have STOPPED status.
8996 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
8997 # that have STOPPING status.
8998 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
8999 # that have SUSPENDED status.
9000 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
9001 # that have SUSPENDING status.
9002 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
9003 # that have TERMINATED status.
9004 },
9005 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
9006 # stable state. A stable state means that: none of the instances in the
9007 # managed instance group is currently undergoing any type of change (for
9008 # example, creation, restart, or deletion); no future changes are scheduled
9009 # for instances in the managed instance group; and the managed instance
9010 # group itself is not being modified.
9011 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
9012 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
9013 # has stateful configuration, that is, if you have configured any items
9014 # in a stateful policy or in per-instance configs.
9015 # The group might report that it has no stateful configuration even when
9016 # there is still some preserved state on a managed instance, for example,
9017 # if you have deleted all PICs but not yet applied those deletions.
9018 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
9019 # has stateful configuration, that is, if you have configured any items
9020 # in a stateful policy or in per-instance configs.
9021 # The group might report that it has no stateful configuration even when
9022 # there is still some preserved state on a managed instance, for example,
9023 # if you have deleted all PICs but not yet applied those deletions. This
9024 # field is deprecated in favor of has_stateful_config.
9025 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
9026 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
9027 # (listed in the output of a listPerInstanceConfigs API call) have
9028 # status EFFECTIVE or there are no per-instance-configs.
9029 },
9030 },
9031 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
9032 # target version specified by version field on Instance Group
9033 # Manager.
9034 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
9035 # in this managed instance group, i.e. all instances are in their target
9036 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
9037 },
9038 },
9039 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
9040 # apply to all of the instances in the managed instance group.
9041 &quot;A String&quot;,
9042 ],
9043 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
9044 # You can reduce this number by using the instanceGroupManager
9045 # deleteInstances or abandonInstances methods. Resizing the group also
9046 # changes this number.
9047 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
9048 # size.
9049 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
9050 # individually or all at once.
9051 },
9052 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
9053 # This number changes when you:
9054 #
9055 # - Stop instance using the stopInstances
9056 # method or start instances using the startInstances
9057 # method.
9058 # - Manually change the targetStoppedSize using the update
9059 # method.
9060 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
9061 # This number changes when you:
9062 #
9063 # - Suspend instance using the suspendInstances
9064 # method or resume instances using the resumeInstances
9065 # method.
9066 # - Manually change the targetSuspendedSize using the update
9067 # method.
9068 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
9069 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
9070 &quot;A String&quot;,
9071 ],
9072 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
9073 # instance redistribution policy for regional managed instance groups.
9074 # Valid values are:
9075 #
9076 # - PROACTIVE (default): The group attempts to maintain an
9077 # even distribution of VM instances across zones in the region.
9078 # - NONE: For non-autoscaled groups, proactive
9079 # redistribution is disabled.
9080 &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
9081 # either a fixed number or, if the group has 10 or more instances, a
9082 # percentage. If you set a percentage, the number of instances is rounded
9083 # if necessary. The default value for maxSurge is a fixed
9084 # value equal to the number of zones in which the managed instance group
9085 # operates.
9086 #
9087 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
9088 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
9089 #
9090 #
9091 #
9092 # - If the value is fixed, then the calculated
9093 # value is equal to the fixed value.
9094 # - If the value is a percent, then the
9095 # calculated
9096 # value is percent/100 * targetSize. For example,
9097 # the calculated value of a 80% of a managed instance group
9098 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
9099 # is a remainder, the number is rounded.
9100 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
9101 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
9102 # example, specify 80 for 80%.
9103 },
9104 &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
9105 # process. An instance is considered available if all of the following
9106 # conditions are satisfied:
9107 #
9108 #
9109 #
9110 # - The instance&#x27;s status is
9111 # RUNNING.
9112 # - If there is a health
9113 # check on the instance group, the instance&#x27;s health check status
9114 # must be HEALTHY at least once. If there is no health check
9115 # on the group, then the instance only needs to have a status of
9116 # RUNNING to be considered available.
9117 #
9118 #
9119 # This value can be either a fixed number or, if the group has 10 or more
9120 # instances, a percentage. If you set a percentage, the number of instances
9121 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
9122 # in which the managed instance group operates.
9123 #
9124 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
9125 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
9126 #
9127 #
9128 #
9129 # - If the value is fixed, then the calculated
9130 # value is equal to the fixed value.
9131 # - If the value is a percent, then the
9132 # calculated
9133 # value is percent/100 * targetSize. For example,
9134 # the calculated value of a 80% of a managed instance group
9135 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
9136 # is a remainder, the number is rounded.
9137 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
9138 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
9139 # example, specify 80 for 80%.
9140 },
9141 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
9142 # becomes available. This value must be from range [0, 3600].
9143 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
9144 # disruption as much as possible or to apply a more disruptive action than
9145 # is necessary.
9146 #
9147 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
9148 # Compute Engine performs the necessary action to execute the update.
9149 # - To apply a more disruptive action than is strictly necessary, set the
9150 # minimal action to RESTART or REPLACE. For
9151 # example, Compute Engine does not need to restart a VM to change its
9152 # metadata. But if your application reads instance metadata only when a VM
9153 # is restarted, you can set the minimal action to RESTART in
9154 # order to pick up metadata changes.
9155 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
9156 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
9157 # as much as possible. RESTART to allow actions that can be
9158 # applied without instance replacing or REPLACE to allow all
9159 # possible actions. If the Updater determines that the minimal update
9160 # action needed is more disruptive than most disruptive allowed action you
9161 # specify it will not perform the update at all.
9162 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
9163 # See minimal_action.REPLACE
9164 &quot;type&quot;: &quot;A String&quot;, # The type
9165 # of update process. You can specify either PROACTIVE so
9166 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
9167 # to update.
9168 },
9169 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
9170 # create instances.
9171 #
9172 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
9173 # group. This field overrides the top-level instanceTemplate
9174 # field. Read more about therelationships
9175 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
9176 # remaining instances. For more information, read aboutcanary
9177 # updates.
9178 {
9179 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
9180 # instance group. The group uses this template to create new instances in
9181 # the managed instance group until the `targetSize` for this version is
9182 # reached. The templates for existing instances in the group do not change
9183 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
9184 # existing instances are updated until the `targetSize` for this version is
9185 # reached.
9186 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
9187 # managed instance group.
9188 &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
9189 # from the template will be equal to:
9190 #
9191 #
9192 # - If expressed as a fixed number, the minimum of either
9193 # targetSize.fixed or
9194 # instanceGroupManager.targetSize is used.
9195 # - if expressed as a percent, the targetSize
9196 # would be (targetSize.percent/100 *
9197 # InstanceGroupManager.targetSize) If there is a remainder, the
9198 # number is rounded.
9199 #
9200 # If unset, this version will update any remaining instances not
9201 # updated by another version. ReadStarting
9202 # a canary update for more information.
9203 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
9204 #
9205 #
9206 #
9207 # - If the value is fixed, then the calculated
9208 # value is equal to the fixed value.
9209 # - If the value is a percent, then the
9210 # calculated
9211 # value is percent/100 * targetSize. For example,
9212 # the calculated value of a 80% of a managed instance group
9213 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
9214 # is a remainder, the number is rounded.
9215 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
9216 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
9217 # example, specify 80 for 80%.
9218 },
9219 },
9220 ],
9221 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
9222 # where the managed instance group is located (for zonal resources).
9223 }
9224
9225 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
9226 that if you must retry your request, the server will know to ignore the
9227 request if it has already been completed.
9228
9229 For example, consider a situation where you make an initial request and
9230 the request times out. If you make the request again with the same
9231 request ID, the server can check if original operation with the same
9232 request ID was received, and if so, will ignore the second request. This
9233 prevents clients from accidentally creating duplicate commitments.
9234
9235 The request ID must be
9236 a valid UUID with the exception that zero UUID is not supported
9237 (00000000-0000-0000-0000-000000000000).
9238 x__xgafv: string, V1 error format.
9239 Allowed values
9240 1 - v1 error format
9241 2 - v2 error format
9242
9243 Returns:
9244 An object of the form:
9245
9246 { # Represents an Operation resource.
9247 #
9248 # Google Compute Engine has three Operation resources:
9249 #
9250 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
9251 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
9252 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
9253 #
9254 # You can use an operation resource to manage asynchronous API requests.
9255 # For more information, readHandling
9256 # API responses.
9257 #
9258 # Operations can be global, regional or zonal.
9259 #
9260 # - For global operations, use the `globalOperations`
9261 # resource.
9262 # - For regional operations, use the
9263 # `regionOperations` resource.
9264 # - For zonal operations, use
9265 # the `zoneOperations` resource.
9266 #
9267 #
9268 #
9269 # For more information, read
9270 # Global, Regional, and Zonal Resources.
9271 #
9272 # Note that completed Operation resources have a limited
9273 # retention period.
9274 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
9275 # Not present otherwise.
9276 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
9277 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
9278 # set when the operation is created.
9279 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
9280 # text format.
9281 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
9282 # this field will be populated.
9283 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
9284 # operation.
9285 {
9286 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
9287 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
9288 # details. There is a set of defined message types to use for providing
9289 # details.The syntax depends on the error code. For example,
9290 # QuotaExceededInfo will have details when the error code is
9291 # QUOTA_EXCEEDED.
9292 {
9293 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
9294 #
9295 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
9296 # is not enabled:
9297 #
9298 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
9299 # &quot;domain&quot;: &quot;googleapis.com&quot;
9300 # &quot;metadata&quot;: {
9301 # &quot;resource&quot;: &quot;projects/123&quot;,
9302 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
9303 # }
9304 # }
9305 #
9306 # This response indicates that the pubsub.googleapis.com API is not enabled.
9307 #
9308 # Example of an error that is returned when attempting to create a Spanner
9309 # instance in a region that is out of stock:
9310 #
9311 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
9312 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
9313 # &quot;metadata&quot;: {
9314 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
9315 # }
9316 # }
9317 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
9318 # is typically the registered service name of the tool or product that
9319 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
9320 # generated by some common infrastructure, the error domain must be a
9321 # globally unique value that identifies the infrastructure. For Google API
9322 # infrastructure, the error domain is &quot;googleapis.com&quot;.
9323 &quot;metadatas&quot;: { # Additional structured details about this error.
9324 #
9325 # Keys must match a regular expression of `a-z+` but should
9326 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
9327 # length. When identifying the current value of an exceeded limit, the units
9328 # should be contained in the key, not the value. For example, rather than
9329 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
9330 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
9331 # instances that can be created in a single (batch) request.
9332 &quot;a_key&quot;: &quot;A String&quot;,
9333 },
9334 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
9335 # proximate cause of the error. Error reasons are unique within a particular
9336 # domain of errors. This should be at most 63 characters and match a
9337 # regular expression of `A-Z+[A-Z0-9]`, which represents
9338 # UPPER_SNAKE_CASE.
9339 },
9340 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
9341 #
9342 # For example, if a quota check failed with an error indicating the calling
9343 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
9344 # directly to the right place in the developer console to flip the bit.
9345 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
9346 { # Describes a URL link.
9347 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
9348 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
9349 },
9350 ],
9351 },
9352 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
9353 # which can be attached to an RPC error.
9354 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
9355 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
9356 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
9357 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
9358 },
9359 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
9360 &quot;dimensions&quot;: { # The map holding related quota dimensions.
9361 &quot;a_key&quot;: &quot;A String&quot;,
9362 },
9363 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
9364 # type or metric.
9365 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
9366 # or metric.
9367 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
9368 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
9369 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
9370 },
9371 },
9372 ],
9373 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
9374 # This property is optional.
9375 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
9376 },
9377 ],
9378 },
9379 &quot;getVersionOperationMetadata&quot;: {
9380 &quot;inlineSbomInfo&quot;: {
9381 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
9382 # appropriate identifiers.
9383 &quot;a_key&quot;: &quot;A String&quot;,
9384 },
9385 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
9386 # identifiers.
9387 &quot;a_key&quot;: &quot;A String&quot;,
9388 },
9389 },
9390 },
9391 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
9392 # message that was returned, such as `NOT FOUND`.
9393 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
9394 # status code that was returned. For example, a `404` means the
9395 # resource was not found.
9396 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
9397 # defined by the server.
9398 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
9399 # This value is inRFC3339
9400 # text format.
9401 &quot;instancesBulkInsertOperationMetadata&quot;: {
9402 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
9403 # Example key: zones/us-central1-a
9404 &quot;a_key&quot;: {
9405 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
9406 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
9407 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
9408 # error.
9409 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
9410 # if the flow is rolling forward or rolling back.
9411 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
9412 },
9413 },
9414 },
9415 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
9416 # Operation resources.
9417 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
9418 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
9419 # group of operations results from a `bulkInsert` API request.
9420 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
9421 # `update`, or `delete`, and so on.
9422 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
9423 # There is no requirement that this be linear or support any granularity of
9424 # operations. This should not be used to guess when the operation will be
9425 # complete. This number should monotonically increase as the operation
9426 # progresses.
9427 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
9428 # applicable when performing regional operations.
9429 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
9430 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
9431 # this field will contain information on all underlying zonal actions and
9432 # their state.
9433 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
9434 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
9435 # Example key: zones/us-central1-a
9436 &quot;a_key&quot;: {
9437 &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
9438 # populated.
9439 # different programming environments, including REST APIs and RPC APIs. It is
9440 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
9441 # three pieces of data: error code, error message, and error details.
9442 #
9443 # You can find out more about this error model and how to work with it in the
9444 # [API Design Guide](https://cloud.google.com/apis/design/errors).
9445 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
9446 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
9447 # message types for APIs to use.
9448 {
9449 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
9450 },
9451 ],
9452 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
9453 # user-facing error message should be localized and sent in the
9454 # google.rpc.Status.details field, or localized by the client.
9455 },
9456 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
9457 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
9458 },
9459 },
9460 },
9461 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
9462 # This value is inRFC3339
9463 # text format.
9464 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
9465 # following:
9466 # `PENDING`, `RUNNING`, or `DONE`.
9467 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
9468 # operation.
9469 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
9470 # of the target resource.
9471 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
9472 # operations related to creating a snapshot, this points to the disk
9473 # that the snapshot was created from.
9474 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
9475 # `[email protected]` or
9476 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
9477 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
9478 # operation, this field will be populated.
9479 {
9480 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
9481 # Engine returns NO_RESULTS_ON_PAGE if there
9482 # are no results in the response.
9483 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
9484 # value format. For example:
9485 #
9486 # &quot;data&quot;: [
9487 # {
9488 # &quot;key&quot;: &quot;scope&quot;,
9489 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
9490 # }
9491 {
9492 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
9493 # returned. For example, for warnings where there are no results in a list
9494 # request for a particular zone, this key might be scope and
9495 # the key value might be the zone name. Other examples might be a key
9496 # indicating a deprecated resource and a suggested replacement, or a
9497 # warning about invalid network settings (for example, if an instance
9498 # attempts to perform IP forwarding but is not enabled for IP forwarding).
9499 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
9500 },
9501 ],
9502 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
9503 },
9504 ],
9505 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
9506 # applicable when performing per-zone operations.
9507 }</pre>
9508 </div>
9509
9510 <div class="method">
9511 <code class="details" id="patchPerInstanceConfigs">patchPerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
9512 <pre>Inserts or patches per-instance configurations for the managed instance
9513 group. perInstanceConfig.name serves as a key used to
9514 distinguish whether to perform insert or patch.
9515
9516 Args:
9517 project: string, Project ID for this request. (required)
9518 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
9519 instanceGroupManager: string, The name of the managed instance group.
9520 It should conform to RFC1035. (required)
9521 body: object, The request body.
9522 The object takes the form of:
9523
9524 { # RegionInstanceGroupManagers.patchPerInstanceConfigs
9525 &quot;perInstanceConfigs&quot;: [ # The list of per-instance configurations to insert or patch on this managed
9526 # instance group.
9527 {
9528 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
9529 # optimistic locking. It is ignored when inserting a per-instance
9530 # config. An up-to-date fingerprint must be provided in order to update an
9531 # existing per-instance configuration or the field needs to be unset.
9532 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
9533 # Serves as a merge key during UpdatePerInstanceConfigs
9534 # operations, that is, if a per-instance configuration with the same name
9535 # exists then it will be updated, otherwise a new one will be created for the
9536 # VM instance with the same name. An attempt to create a per-instance
9537 # configuration for a VM instance that either doesn&#x27;t exist or is not part
9538 # of the group will result in an error.
9539 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
9540 # preserved state generated from a stateful policy.
9541 &quot;disks&quot;: { # Preserved disks defined for this instance.
9542 # This map is keyed with the device names of the disks.
9543 &quot;a_key&quot;: {
9544 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
9545 # update, instance recreate operations. This flag is used to configure
9546 # if the disk should be deleted after it is no longer used by the group,
9547 # e.g. when the given instance or the whole MIG is deleted.
9548 # Note: disks attached in READ_ONLY mode cannot be
9549 # auto-deleted.
9550 &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
9551 # disk in READ_WRITE mode.
9552 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
9553 # to the VM instance.
9554 },
9555 },
9556 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
9557 # This map is keyed with the name of the network interface.
9558 &quot;a_key&quot;: {
9559 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9560 # update or VM instance recreate operations.
9561 # This flag is used to configure if the IP reservation should be deleted
9562 # after it is no longer used by the group, e.g. when the given instance
9563 # or the whole group is deleted.
9564 &quot;ipAddress&quot;: { # Ip address representation
9565 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
9566 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
9567 # network interface.
9568 },
9569 },
9570 },
9571 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
9572 # This map is keyed with the name of the network interface.
9573 &quot;a_key&quot;: {
9574 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9575 # update or VM instance recreate operations.
9576 # This flag is used to configure if the IP reservation should be deleted
9577 # after it is no longer used by the group, e.g. when the given instance
9578 # or the whole group is deleted.
9579 &quot;ipAddress&quot;: { # Ip address representation
9580 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
9581 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
9582 # network interface.
9583 },
9584 },
9585 },
9586 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
9587 &quot;a_key&quot;: &quot;A String&quot;,
9588 },
9589 },
9590 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
9591 # managed instance.
9592 },
9593 ],
9594 }
9595
9596 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
9597 that if you must retry your request, the server will know to ignore the
9598 request if it has already been completed.
9599
9600 For example, consider a situation where you make an initial request and
9601 the request times out. If you make the request again with the same
9602 request ID, the server can check if original operation with the same
9603 request ID was received, and if so, will ignore the second request. This
9604 prevents clients from accidentally creating duplicate commitments.
9605
9606 The request ID must be
9607 a valid UUID with the exception that zero UUID is not supported
9608 (00000000-0000-0000-0000-000000000000).
9609 x__xgafv: string, V1 error format.
9610 Allowed values
9611 1 - v1 error format
9612 2 - v2 error format
9613
9614 Returns:
9615 An object of the form:
9616
9617 { # Represents an Operation resource.
9618 #
9619 # Google Compute Engine has three Operation resources:
9620 #
9621 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
9622 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
9623 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
9624 #
9625 # You can use an operation resource to manage asynchronous API requests.
9626 # For more information, readHandling
9627 # API responses.
9628 #
9629 # Operations can be global, regional or zonal.
9630 #
9631 # - For global operations, use the `globalOperations`
9632 # resource.
9633 # - For regional operations, use the
9634 # `regionOperations` resource.
9635 # - For zonal operations, use
9636 # the `zoneOperations` resource.
9637 #
9638 #
9639 #
9640 # For more information, read
9641 # Global, Regional, and Zonal Resources.
9642 #
9643 # Note that completed Operation resources have a limited
9644 # retention period.
9645 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
9646 # Not present otherwise.
9647 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
9648 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
9649 # set when the operation is created.
9650 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
9651 # text format.
9652 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
9653 # this field will be populated.
9654 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
9655 # operation.
9656 {
9657 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
9658 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
9659 # details. There is a set of defined message types to use for providing
9660 # details.The syntax depends on the error code. For example,
9661 # QuotaExceededInfo will have details when the error code is
9662 # QUOTA_EXCEEDED.
9663 {
9664 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
9665 #
9666 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
9667 # is not enabled:
9668 #
9669 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
9670 # &quot;domain&quot;: &quot;googleapis.com&quot;
9671 # &quot;metadata&quot;: {
9672 # &quot;resource&quot;: &quot;projects/123&quot;,
9673 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
9674 # }
9675 # }
9676 #
9677 # This response indicates that the pubsub.googleapis.com API is not enabled.
9678 #
9679 # Example of an error that is returned when attempting to create a Spanner
9680 # instance in a region that is out of stock:
9681 #
9682 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
9683 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
9684 # &quot;metadata&quot;: {
9685 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
9686 # }
9687 # }
9688 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
9689 # is typically the registered service name of the tool or product that
9690 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
9691 # generated by some common infrastructure, the error domain must be a
9692 # globally unique value that identifies the infrastructure. For Google API
9693 # infrastructure, the error domain is &quot;googleapis.com&quot;.
9694 &quot;metadatas&quot;: { # Additional structured details about this error.
9695 #
9696 # Keys must match a regular expression of `a-z+` but should
9697 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
9698 # length. When identifying the current value of an exceeded limit, the units
9699 # should be contained in the key, not the value. For example, rather than
9700 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
9701 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
9702 # instances that can be created in a single (batch) request.
9703 &quot;a_key&quot;: &quot;A String&quot;,
9704 },
9705 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
9706 # proximate cause of the error. Error reasons are unique within a particular
9707 # domain of errors. This should be at most 63 characters and match a
9708 # regular expression of `A-Z+[A-Z0-9]`, which represents
9709 # UPPER_SNAKE_CASE.
9710 },
9711 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
9712 #
9713 # For example, if a quota check failed with an error indicating the calling
9714 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
9715 # directly to the right place in the developer console to flip the bit.
9716 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
9717 { # Describes a URL link.
9718 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
9719 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
9720 },
9721 ],
9722 },
9723 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
9724 # which can be attached to an RPC error.
9725 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
9726 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
9727 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
9728 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
9729 },
9730 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
9731 &quot;dimensions&quot;: { # The map holding related quota dimensions.
9732 &quot;a_key&quot;: &quot;A String&quot;,
9733 },
9734 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
9735 # type or metric.
9736 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
9737 # or metric.
9738 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
9739 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
9740 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
9741 },
9742 },
9743 ],
9744 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
9745 # This property is optional.
9746 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
9747 },
9748 ],
9749 },
9750 &quot;getVersionOperationMetadata&quot;: {
9751 &quot;inlineSbomInfo&quot;: {
9752 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
9753 # appropriate identifiers.
9754 &quot;a_key&quot;: &quot;A String&quot;,
9755 },
9756 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
9757 # identifiers.
9758 &quot;a_key&quot;: &quot;A String&quot;,
9759 },
9760 },
9761 },
9762 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
9763 # message that was returned, such as `NOT FOUND`.
9764 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
9765 # status code that was returned. For example, a `404` means the
9766 # resource was not found.
9767 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
9768 # defined by the server.
9769 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
9770 # This value is inRFC3339
9771 # text format.
9772 &quot;instancesBulkInsertOperationMetadata&quot;: {
9773 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
9774 # Example key: zones/us-central1-a
9775 &quot;a_key&quot;: {
9776 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
9777 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
9778 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
9779 # error.
9780 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
9781 # if the flow is rolling forward or rolling back.
9782 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
9783 },
9784 },
9785 },
9786 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
9787 # Operation resources.
9788 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
9789 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
9790 # group of operations results from a `bulkInsert` API request.
9791 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
9792 # `update`, or `delete`, and so on.
9793 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
9794 # There is no requirement that this be linear or support any granularity of
9795 # operations. This should not be used to guess when the operation will be
9796 # complete. This number should monotonically increase as the operation
9797 # progresses.
9798 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
9799 # applicable when performing regional operations.
9800 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
9801 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
9802 # this field will contain information on all underlying zonal actions and
9803 # their state.
9804 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
9805 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
9806 # Example key: zones/us-central1-a
9807 &quot;a_key&quot;: {
9808 &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
9809 # populated.
9810 # different programming environments, including REST APIs and RPC APIs. It is
9811 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
9812 # three pieces of data: error code, error message, and error details.
9813 #
9814 # You can find out more about this error model and how to work with it in the
9815 # [API Design Guide](https://cloud.google.com/apis/design/errors).
9816 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
9817 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
9818 # message types for APIs to use.
9819 {
9820 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
9821 },
9822 ],
9823 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
9824 # user-facing error message should be localized and sent in the
9825 # google.rpc.Status.details field, or localized by the client.
9826 },
9827 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
9828 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
9829 },
9830 },
9831 },
9832 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
9833 # This value is inRFC3339
9834 # text format.
9835 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
9836 # following:
9837 # `PENDING`, `RUNNING`, or `DONE`.
9838 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
9839 # operation.
9840 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
9841 # of the target resource.
9842 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
9843 # operations related to creating a snapshot, this points to the disk
9844 # that the snapshot was created from.
9845 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
9846 # `[email protected]` or
9847 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
9848 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
9849 # operation, this field will be populated.
9850 {
9851 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
9852 # Engine returns NO_RESULTS_ON_PAGE if there
9853 # are no results in the response.
9854 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
9855 # value format. For example:
9856 #
9857 # &quot;data&quot;: [
9858 # {
9859 # &quot;key&quot;: &quot;scope&quot;,
9860 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
9861 # }
9862 {
9863 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
9864 # returned. For example, for warnings where there are no results in a list
9865 # request for a particular zone, this key might be scope and
9866 # the key value might be the zone name. Other examples might be a key
9867 # indicating a deprecated resource and a suggested replacement, or a
9868 # warning about invalid network settings (for example, if an instance
9869 # attempts to perform IP forwarding but is not enabled for IP forwarding).
9870 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
9871 },
9872 ],
9873 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
9874 },
9875 ],
9876 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
9877 # applicable when performing per-zone operations.
9878 }</pre>
9879 </div>
9880
9881 <div class="method">
9882 <code class="details" id="recreateInstances">recreateInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
9883 <pre>Flags the specified VM instances in the managed instance group to be
9884 immediately recreated. Each instance is recreated using the group&#x27;s current
9885 configuration. This operation is marked as DONE when the flag
9886 is set even if the instances have not yet been recreated. You must
9887 separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking
9888 the status of managed instances.
9889
9890 If the group is part of a backend
9891 service that has enabled
9892 connection draining, it can take up to 60 seconds after the connection
9893 draining duration has elapsed before the VM instance is removed or deleted.
9894
9895 You can specify a maximum of 1000 instances with this method per request.
9896
9897 Args:
9898 project: string, Project ID for this request. (required)
9899 region: string, Name of the region scoping this request. (required)
9900 instanceGroupManager: string, Name of the managed instance group. (required)
9901 body: object, The request body.
9902 The object takes the form of:
9903
9904 {
9905 &quot;instances&quot;: [ # The URLs of one or more instances to recreate. This can be a full URL or
9906 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
9907 &quot;A String&quot;,
9908 ],
9909 }
9910
9911 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance recreation even if it&#x27;s
9912 configured for the instances.
9913 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
9914 that if you must retry your request, the server will know to ignore the
9915 request if it has already been completed.
9916
9917 For example, consider a situation where you make an initial request and
9918 the request times out. If you make the request again with the same
9919 request ID, the server can check if original operation with the same
9920 request ID was received, and if so, will ignore the second request. This
9921 prevents clients from accidentally creating duplicate commitments.
9922
9923 The request ID must be
9924 a valid UUID with the exception that zero UUID is not supported
9925 (00000000-0000-0000-0000-000000000000).
9926 x__xgafv: string, V1 error format.
9927 Allowed values
9928 1 - v1 error format
9929 2 - v2 error format
9930
9931 Returns:
9932 An object of the form:
9933
9934 { # Represents an Operation resource.
9935 #
9936 # Google Compute Engine has three Operation resources:
9937 #
9938 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
9939 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
9940 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
9941 #
9942 # You can use an operation resource to manage asynchronous API requests.
9943 # For more information, readHandling
9944 # API responses.
9945 #
9946 # Operations can be global, regional or zonal.
9947 #
9948 # - For global operations, use the `globalOperations`
9949 # resource.
9950 # - For regional operations, use the
9951 # `regionOperations` resource.
9952 # - For zonal operations, use
9953 # the `zoneOperations` resource.
9954 #
9955 #
9956 #
9957 # For more information, read
9958 # Global, Regional, and Zonal Resources.
9959 #
9960 # Note that completed Operation resources have a limited
9961 # retention period.
9962 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
9963 # Not present otherwise.
9964 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
9965 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
9966 # set when the operation is created.
9967 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
9968 # text format.
9969 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
9970 # this field will be populated.
9971 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
9972 # operation.
9973 {
9974 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
9975 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
9976 # details. There is a set of defined message types to use for providing
9977 # details.The syntax depends on the error code. For example,
9978 # QuotaExceededInfo will have details when the error code is
9979 # QUOTA_EXCEEDED.
9980 {
9981 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
9982 #
9983 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
9984 # is not enabled:
9985 #
9986 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
9987 # &quot;domain&quot;: &quot;googleapis.com&quot;
9988 # &quot;metadata&quot;: {
9989 # &quot;resource&quot;: &quot;projects/123&quot;,
9990 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
9991 # }
9992 # }
9993 #
9994 # This response indicates that the pubsub.googleapis.com API is not enabled.
9995 #
9996 # Example of an error that is returned when attempting to create a Spanner
9997 # instance in a region that is out of stock:
9998 #
9999 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
10000 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
10001 # &quot;metadata&quot;: {
10002 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
10003 # }
10004 # }
10005 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
10006 # is typically the registered service name of the tool or product that
10007 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
10008 # generated by some common infrastructure, the error domain must be a
10009 # globally unique value that identifies the infrastructure. For Google API
10010 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10011 &quot;metadatas&quot;: { # Additional structured details about this error.
10012 #
10013 # Keys must match a regular expression of `a-z+` but should
10014 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10015 # length. When identifying the current value of an exceeded limit, the units
10016 # should be contained in the key, not the value. For example, rather than
10017 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10018 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10019 # instances that can be created in a single (batch) request.
10020 &quot;a_key&quot;: &quot;A String&quot;,
10021 },
10022 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10023 # proximate cause of the error. Error reasons are unique within a particular
10024 # domain of errors. This should be at most 63 characters and match a
10025 # regular expression of `A-Z+[A-Z0-9]`, which represents
10026 # UPPER_SNAKE_CASE.
10027 },
10028 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10029 #
10030 # For example, if a quota check failed with an error indicating the calling
10031 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10032 # directly to the right place in the developer console to flip the bit.
10033 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10034 { # Describes a URL link.
10035 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10036 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
10037 },
10038 ],
10039 },
10040 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
10041 # which can be attached to an RPC error.
10042 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
10043 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
10044 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
10045 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
10046 },
10047 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
10048 &quot;dimensions&quot;: { # The map holding related quota dimensions.
10049 &quot;a_key&quot;: &quot;A String&quot;,
10050 },
10051 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
10052 # type or metric.
10053 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
10054 # or metric.
10055 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
10056 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
10057 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
10058 },
10059 },
10060 ],
10061 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
10062 # This property is optional.
10063 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
10064 },
10065 ],
10066 },
10067 &quot;getVersionOperationMetadata&quot;: {
10068 &quot;inlineSbomInfo&quot;: {
10069 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
10070 # appropriate identifiers.
10071 &quot;a_key&quot;: &quot;A String&quot;,
10072 },
10073 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
10074 # identifiers.
10075 &quot;a_key&quot;: &quot;A String&quot;,
10076 },
10077 },
10078 },
10079 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
10080 # message that was returned, such as `NOT FOUND`.
10081 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
10082 # status code that was returned. For example, a `404` means the
10083 # resource was not found.
10084 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
10085 # defined by the server.
10086 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
10087 # This value is inRFC3339
10088 # text format.
10089 &quot;instancesBulkInsertOperationMetadata&quot;: {
10090 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
10091 # Example key: zones/us-central1-a
10092 &quot;a_key&quot;: {
10093 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
10094 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
10095 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
10096 # error.
10097 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
10098 # if the flow is rolling forward or rolling back.
10099 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
10100 },
10101 },
10102 },
10103 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
10104 # Operation resources.
10105 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
10106 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
10107 # group of operations results from a `bulkInsert` API request.
10108 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
10109 # `update`, or `delete`, and so on.
10110 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
10111 # There is no requirement that this be linear or support any granularity of
10112 # operations. This should not be used to guess when the operation will be
10113 # complete. This number should monotonically increase as the operation
10114 # progresses.
10115 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
10116 # applicable when performing regional operations.
10117 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
10118 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
10119 # this field will contain information on all underlying zonal actions and
10120 # their state.
10121 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
10122 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
10123 # Example key: zones/us-central1-a
10124 &quot;a_key&quot;: {
10125 &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
10126 # populated.
10127 # different programming environments, including REST APIs and RPC APIs. It is
10128 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
10129 # three pieces of data: error code, error message, and error details.
10130 #
10131 # You can find out more about this error model and how to work with it in the
10132 # [API Design Guide](https://cloud.google.com/apis/design/errors).
10133 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
10134 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
10135 # message types for APIs to use.
10136 {
10137 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
10138 },
10139 ],
10140 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
10141 # user-facing error message should be localized and sent in the
10142 # google.rpc.Status.details field, or localized by the client.
10143 },
10144 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
10145 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
10146 },
10147 },
10148 },
10149 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
10150 # This value is inRFC3339
10151 # text format.
10152 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
10153 # following:
10154 # `PENDING`, `RUNNING`, or `DONE`.
10155 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
10156 # operation.
10157 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
10158 # of the target resource.
10159 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
10160 # operations related to creating a snapshot, this points to the disk
10161 # that the snapshot was created from.
10162 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
10163 # `[email protected]` or
10164 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
10165 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
10166 # operation, this field will be populated.
10167 {
10168 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
10169 # Engine returns NO_RESULTS_ON_PAGE if there
10170 # are no results in the response.
10171 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
10172 # value format. For example:
10173 #
10174 # &quot;data&quot;: [
10175 # {
10176 # &quot;key&quot;: &quot;scope&quot;,
10177 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
10178 # }
10179 {
10180 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
10181 # returned. For example, for warnings where there are no results in a list
10182 # request for a particular zone, this key might be scope and
10183 # the key value might be the zone name. Other examples might be a key
10184 # indicating a deprecated resource and a suggested replacement, or a
10185 # warning about invalid network settings (for example, if an instance
10186 # attempts to perform IP forwarding but is not enabled for IP forwarding).
10187 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
10188 },
10189 ],
10190 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
10191 },
10192 ],
10193 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
10194 # applicable when performing per-zone operations.
10195 }</pre>
10196 </div>
10197
10198 <div class="method">
10199 <code class="details" id="resize">resize(project, region, instanceGroupManager, size, requestId=None, x__xgafv=None)</code>
10200 <pre>Changes the intended size of the managed instance group. If you increase
10201 the size, the group creates new instances using the current instance
10202 template. If you decrease the size, the group deletes one or more
10203 instances.
10204
10205 The resize operation is marked DONE if theresize request is successful. The underlying actions take
10206 additional time. You must separately verify the status of thecreating or deleting actions with thelistmanagedinstances
10207 method.
10208
10209 If the group is part of a backend
10210 service that has enabled
10211 connection draining, it can take up to 60 seconds after the connection
10212 draining duration has elapsed before the VM instance is removed or deleted.
10213
10214 Args:
10215 project: string, Project ID for this request. (required)
10216 region: string, Name of the region scoping this request. (required)
10217 instanceGroupManager: string, Name of the managed instance group. (required)
10218 size: integer, Number of instances that should exist in this instance group
10219 manager. (required)
10220 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
10221 that if you must retry your request, the server will know to ignore the
10222 request if it has already been completed.
10223
10224 For example, consider a situation where you make an initial request and
10225 the request times out. If you make the request again with the same
10226 request ID, the server can check if original operation with the same
10227 request ID was received, and if so, will ignore the second request. This
10228 prevents clients from accidentally creating duplicate commitments.
10229
10230 The request ID must be
10231 a valid UUID with the exception that zero UUID is not supported
10232 (00000000-0000-0000-0000-000000000000).
10233 x__xgafv: string, V1 error format.
10234 Allowed values
10235 1 - v1 error format
10236 2 - v2 error format
10237
10238 Returns:
10239 An object of the form:
10240
10241 { # Represents an Operation resource.
10242 #
10243 # Google Compute Engine has three Operation resources:
10244 #
10245 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
10246 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
10247 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
10248 #
10249 # You can use an operation resource to manage asynchronous API requests.
10250 # For more information, readHandling
10251 # API responses.
10252 #
10253 # Operations can be global, regional or zonal.
10254 #
10255 # - For global operations, use the `globalOperations`
10256 # resource.
10257 # - For regional operations, use the
10258 # `regionOperations` resource.
10259 # - For zonal operations, use
10260 # the `zoneOperations` resource.
10261 #
10262 #
10263 #
10264 # For more information, read
10265 # Global, Regional, and Zonal Resources.
10266 #
10267 # Note that completed Operation resources have a limited
10268 # retention period.
10269 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
10270 # Not present otherwise.
10271 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
10272 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
10273 # set when the operation is created.
10274 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
10275 # text format.
10276 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
10277 # this field will be populated.
10278 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
10279 # operation.
10280 {
10281 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
10282 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
10283 # details. There is a set of defined message types to use for providing
10284 # details.The syntax depends on the error code. For example,
10285 # QuotaExceededInfo will have details when the error code is
10286 # QUOTA_EXCEEDED.
10287 {
10288 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
10289 #
10290 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
10291 # is not enabled:
10292 #
10293 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
10294 # &quot;domain&quot;: &quot;googleapis.com&quot;
10295 # &quot;metadata&quot;: {
10296 # &quot;resource&quot;: &quot;projects/123&quot;,
10297 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
10298 # }
10299 # }
10300 #
10301 # This response indicates that the pubsub.googleapis.com API is not enabled.
10302 #
10303 # Example of an error that is returned when attempting to create a Spanner
10304 # instance in a region that is out of stock:
10305 #
10306 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
10307 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
10308 # &quot;metadata&quot;: {
10309 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
10310 # }
10311 # }
10312 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
10313 # is typically the registered service name of the tool or product that
10314 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
10315 # generated by some common infrastructure, the error domain must be a
10316 # globally unique value that identifies the infrastructure. For Google API
10317 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10318 &quot;metadatas&quot;: { # Additional structured details about this error.
10319 #
10320 # Keys must match a regular expression of `a-z+` but should
10321 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10322 # length. When identifying the current value of an exceeded limit, the units
10323 # should be contained in the key, not the value. For example, rather than
10324 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10325 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10326 # instances that can be created in a single (batch) request.
10327 &quot;a_key&quot;: &quot;A String&quot;,
10328 },
10329 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10330 # proximate cause of the error. Error reasons are unique within a particular
10331 # domain of errors. This should be at most 63 characters and match a
10332 # regular expression of `A-Z+[A-Z0-9]`, which represents
10333 # UPPER_SNAKE_CASE.
10334 },
10335 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10336 #
10337 # For example, if a quota check failed with an error indicating the calling
10338 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10339 # directly to the right place in the developer console to flip the bit.
10340 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10341 { # Describes a URL link.
10342 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10343 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
10344 },
10345 ],
10346 },
10347 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
10348 # which can be attached to an RPC error.
10349 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
10350 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
10351 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
10352 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
10353 },
10354 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
10355 &quot;dimensions&quot;: { # The map holding related quota dimensions.
10356 &quot;a_key&quot;: &quot;A String&quot;,
10357 },
10358 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
10359 # type or metric.
10360 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
10361 # or metric.
10362 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
10363 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
10364 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
10365 },
10366 },
10367 ],
10368 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
10369 # This property is optional.
10370 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
10371 },
10372 ],
10373 },
10374 &quot;getVersionOperationMetadata&quot;: {
10375 &quot;inlineSbomInfo&quot;: {
10376 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
10377 # appropriate identifiers.
10378 &quot;a_key&quot;: &quot;A String&quot;,
10379 },
10380 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
10381 # identifiers.
10382 &quot;a_key&quot;: &quot;A String&quot;,
10383 },
10384 },
10385 },
10386 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
10387 # message that was returned, such as `NOT FOUND`.
10388 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
10389 # status code that was returned. For example, a `404` means the
10390 # resource was not found.
10391 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
10392 # defined by the server.
10393 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
10394 # This value is inRFC3339
10395 # text format.
10396 &quot;instancesBulkInsertOperationMetadata&quot;: {
10397 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
10398 # Example key: zones/us-central1-a
10399 &quot;a_key&quot;: {
10400 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
10401 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
10402 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
10403 # error.
10404 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
10405 # if the flow is rolling forward or rolling back.
10406 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
10407 },
10408 },
10409 },
10410 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
10411 # Operation resources.
10412 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
10413 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
10414 # group of operations results from a `bulkInsert` API request.
10415 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
10416 # `update`, or `delete`, and so on.
10417 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
10418 # There is no requirement that this be linear or support any granularity of
10419 # operations. This should not be used to guess when the operation will be
10420 # complete. This number should monotonically increase as the operation
10421 # progresses.
10422 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
10423 # applicable when performing regional operations.
10424 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
10425 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
10426 # this field will contain information on all underlying zonal actions and
10427 # their state.
10428 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
10429 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
10430 # Example key: zones/us-central1-a
10431 &quot;a_key&quot;: {
10432 &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
10433 # populated.
10434 # different programming environments, including REST APIs and RPC APIs. It is
10435 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
10436 # three pieces of data: error code, error message, and error details.
10437 #
10438 # You can find out more about this error model and how to work with it in the
10439 # [API Design Guide](https://cloud.google.com/apis/design/errors).
10440 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
10441 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
10442 # message types for APIs to use.
10443 {
10444 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
10445 },
10446 ],
10447 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
10448 # user-facing error message should be localized and sent in the
10449 # google.rpc.Status.details field, or localized by the client.
10450 },
10451 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
10452 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
10453 },
10454 },
10455 },
10456 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
10457 # This value is inRFC3339
10458 # text format.
10459 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
10460 # following:
10461 # `PENDING`, `RUNNING`, or `DONE`.
10462 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
10463 # operation.
10464 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
10465 # of the target resource.
10466 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
10467 # operations related to creating a snapshot, this points to the disk
10468 # that the snapshot was created from.
10469 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
10470 # `[email protected]` or
10471 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
10472 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
10473 # operation, this field will be populated.
10474 {
10475 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
10476 # Engine returns NO_RESULTS_ON_PAGE if there
10477 # are no results in the response.
10478 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
10479 # value format. For example:
10480 #
10481 # &quot;data&quot;: [
10482 # {
10483 # &quot;key&quot;: &quot;scope&quot;,
10484 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
10485 # }
10486 {
10487 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
10488 # returned. For example, for warnings where there are no results in a list
10489 # request for a particular zone, this key might be scope and
10490 # the key value might be the zone name. Other examples might be a key
10491 # indicating a deprecated resource and a suggested replacement, or a
10492 # warning about invalid network settings (for example, if an instance
10493 # attempts to perform IP forwarding but is not enabled for IP forwarding).
10494 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
10495 },
10496 ],
10497 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
10498 },
10499 ],
10500 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
10501 # applicable when performing per-zone operations.
10502 }</pre>
10503 </div>
10504
10505 <div class="method">
10506 <code class="details" id="resizeAdvanced">resizeAdvanced(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
10507 <pre>Resizes the regional managed instance group with advanced configuration
10508 options like disabling creation retries. This is an extended version of theresize method.
10509
10510 If you increase the size, the group creates new instances using the current
10511 instance template. If you decrease the size, the group deletes one or more
10512 instances.
10513
10514 The resize operation is marked DONE if theresize request is successful. The underlying actions take
10515 additional time. You must separately verify the status of thecreating or deleting actions with the get
10516 orlistmanagedinstances
10517 method.
10518
10519 If the group is part of a backend
10520 service that has enabled
10521 connection draining, it can take up to 60 seconds after the connection
10522 draining duration has elapsed before the VM instance is removed or deleted.
10523
10524 Args:
10525 project: string, Project ID for this request. (required)
10526 region: string, Name of the region scoping this request.
10527 It must be a string that meets the requirements in RFC1035. (required)
10528 instanceGroupManager: string, The name of the managed instance group.
10529 It must be a string that meets the requirements in RFC1035. (required)
10530 body: object, The request body.
10531 The object takes the form of:
10532
10533 {
10534 &quot;noCreationRetries&quot;: True or False, # If this flag is true, the managed instance group attempts to create all
10535 # instances initiated by this resize request only once. If there is an error
10536 # during creation, the managed instance group does not retry create this
10537 # instance, and we will decrease the targetSize of the request
10538 # instead. If the flag is false, the group attempts to recreate each instance
10539 # continuously until it succeeds.
10540 #
10541 # This flag matters only in the first attempt of creation of an instance.
10542 # After an instance is successfully created while this flag is enabled, the
10543 # instance behaves the same way as all the other instances created with a
10544 # regular resize request. In particular, if a running instance dies
10545 # unexpectedly at a later time and needs to be recreated, this mode does not
10546 # affect the recreation behavior in that scenario.
10547 #
10548 # This flag is applicable only to the current resize request. It does not
10549 # influence other resize requests in any way.
10550 #
10551 # You can see which instances ar being created in which mode by calling
10552 # the get or listManagedInstances API.
10553 &quot;targetSize&quot;: 42, # The number of running instances that the managed instance group should
10554 # maintain at any given time. The group automatically adds or removes
10555 # instances to maintain the number of instances specified by this parameter.
10556 }
10557
10558 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
10559 that if you must retry your request, the server will know to ignore the
10560 request if it has already been completed.
10561
10562 For example, consider a situation where you make an initial request and
10563 the request times out. If you make the request again with the same
10564 request ID, the server can check if original operation with the same
10565 request ID was received, and if so, will ignore the second request. This
10566 prevents clients from accidentally creating duplicate commitments.
10567
10568 The request ID must be
10569 a valid UUID with the exception that zero UUID is not supported
10570 (00000000-0000-0000-0000-000000000000).
10571 x__xgafv: string, V1 error format.
10572 Allowed values
10573 1 - v1 error format
10574 2 - v2 error format
10575
10576 Returns:
10577 An object of the form:
10578
10579 { # Represents an Operation resource.
10580 #
10581 # Google Compute Engine has three Operation resources:
10582 #
10583 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
10584 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
10585 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
10586 #
10587 # You can use an operation resource to manage asynchronous API requests.
10588 # For more information, readHandling
10589 # API responses.
10590 #
10591 # Operations can be global, regional or zonal.
10592 #
10593 # - For global operations, use the `globalOperations`
10594 # resource.
10595 # - For regional operations, use the
10596 # `regionOperations` resource.
10597 # - For zonal operations, use
10598 # the `zoneOperations` resource.
10599 #
10600 #
10601 #
10602 # For more information, read
10603 # Global, Regional, and Zonal Resources.
10604 #
10605 # Note that completed Operation resources have a limited
10606 # retention period.
10607 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
10608 # Not present otherwise.
10609 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
10610 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
10611 # set when the operation is created.
10612 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
10613 # text format.
10614 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
10615 # this field will be populated.
10616 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
10617 # operation.
10618 {
10619 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
10620 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
10621 # details. There is a set of defined message types to use for providing
10622 # details.The syntax depends on the error code. For example,
10623 # QuotaExceededInfo will have details when the error code is
10624 # QUOTA_EXCEEDED.
10625 {
10626 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
10627 #
10628 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
10629 # is not enabled:
10630 #
10631 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
10632 # &quot;domain&quot;: &quot;googleapis.com&quot;
10633 # &quot;metadata&quot;: {
10634 # &quot;resource&quot;: &quot;projects/123&quot;,
10635 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
10636 # }
10637 # }
10638 #
10639 # This response indicates that the pubsub.googleapis.com API is not enabled.
10640 #
10641 # Example of an error that is returned when attempting to create a Spanner
10642 # instance in a region that is out of stock:
10643 #
10644 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
10645 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
10646 # &quot;metadata&quot;: {
10647 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
10648 # }
10649 # }
10650 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
10651 # is typically the registered service name of the tool or product that
10652 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
10653 # generated by some common infrastructure, the error domain must be a
10654 # globally unique value that identifies the infrastructure. For Google API
10655 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10656 &quot;metadatas&quot;: { # Additional structured details about this error.
10657 #
10658 # Keys must match a regular expression of `a-z+` but should
10659 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10660 # length. When identifying the current value of an exceeded limit, the units
10661 # should be contained in the key, not the value. For example, rather than
10662 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10663 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10664 # instances that can be created in a single (batch) request.
10665 &quot;a_key&quot;: &quot;A String&quot;,
10666 },
10667 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10668 # proximate cause of the error. Error reasons are unique within a particular
10669 # domain of errors. This should be at most 63 characters and match a
10670 # regular expression of `A-Z+[A-Z0-9]`, which represents
10671 # UPPER_SNAKE_CASE.
10672 },
10673 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10674 #
10675 # For example, if a quota check failed with an error indicating the calling
10676 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10677 # directly to the right place in the developer console to flip the bit.
10678 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10679 { # Describes a URL link.
10680 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10681 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
10682 },
10683 ],
10684 },
10685 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
10686 # which can be attached to an RPC error.
10687 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
10688 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
10689 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
10690 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
10691 },
10692 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
10693 &quot;dimensions&quot;: { # The map holding related quota dimensions.
10694 &quot;a_key&quot;: &quot;A String&quot;,
10695 },
10696 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
10697 # type or metric.
10698 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
10699 # or metric.
10700 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
10701 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
10702 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
10703 },
10704 },
10705 ],
10706 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
10707 # This property is optional.
10708 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
10709 },
10710 ],
10711 },
10712 &quot;getVersionOperationMetadata&quot;: {
10713 &quot;inlineSbomInfo&quot;: {
10714 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
10715 # appropriate identifiers.
10716 &quot;a_key&quot;: &quot;A String&quot;,
10717 },
10718 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
10719 # identifiers.
10720 &quot;a_key&quot;: &quot;A String&quot;,
10721 },
10722 },
10723 },
10724 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
10725 # message that was returned, such as `NOT FOUND`.
10726 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
10727 # status code that was returned. For example, a `404` means the
10728 # resource was not found.
10729 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
10730 # defined by the server.
10731 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
10732 # This value is inRFC3339
10733 # text format.
10734 &quot;instancesBulkInsertOperationMetadata&quot;: {
10735 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
10736 # Example key: zones/us-central1-a
10737 &quot;a_key&quot;: {
10738 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
10739 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
10740 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
10741 # error.
10742 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
10743 # if the flow is rolling forward or rolling back.
10744 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
10745 },
10746 },
10747 },
10748 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
10749 # Operation resources.
10750 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
10751 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
10752 # group of operations results from a `bulkInsert` API request.
10753 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
10754 # `update`, or `delete`, and so on.
10755 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
10756 # There is no requirement that this be linear or support any granularity of
10757 # operations. This should not be used to guess when the operation will be
10758 # complete. This number should monotonically increase as the operation
10759 # progresses.
10760 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
10761 # applicable when performing regional operations.
10762 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
10763 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
10764 # this field will contain information on all underlying zonal actions and
10765 # their state.
10766 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
10767 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
10768 # Example key: zones/us-central1-a
10769 &quot;a_key&quot;: {
10770 &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
10771 # populated.
10772 # different programming environments, including REST APIs and RPC APIs. It is
10773 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
10774 # three pieces of data: error code, error message, and error details.
10775 #
10776 # You can find out more about this error model and how to work with it in the
10777 # [API Design Guide](https://cloud.google.com/apis/design/errors).
10778 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
10779 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
10780 # message types for APIs to use.
10781 {
10782 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
10783 },
10784 ],
10785 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
10786 # user-facing error message should be localized and sent in the
10787 # google.rpc.Status.details field, or localized by the client.
10788 },
10789 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
10790 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
10791 },
10792 },
10793 },
10794 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
10795 # This value is inRFC3339
10796 # text format.
10797 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
10798 # following:
10799 # `PENDING`, `RUNNING`, or `DONE`.
10800 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
10801 # operation.
10802 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
10803 # of the target resource.
10804 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
10805 # operations related to creating a snapshot, this points to the disk
10806 # that the snapshot was created from.
10807 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
10808 # `[email protected]` or
10809 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
10810 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
10811 # operation, this field will be populated.
10812 {
10813 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
10814 # Engine returns NO_RESULTS_ON_PAGE if there
10815 # are no results in the response.
10816 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
10817 # value format. For example:
10818 #
10819 # &quot;data&quot;: [
10820 # {
10821 # &quot;key&quot;: &quot;scope&quot;,
10822 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
10823 # }
10824 {
10825 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
10826 # returned. For example, for warnings where there are no results in a list
10827 # request for a particular zone, this key might be scope and
10828 # the key value might be the zone name. Other examples might be a key
10829 # indicating a deprecated resource and a suggested replacement, or a
10830 # warning about invalid network settings (for example, if an instance
10831 # attempts to perform IP forwarding but is not enabled for IP forwarding).
10832 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
10833 },
10834 ],
10835 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
10836 },
10837 ],
10838 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
10839 # applicable when performing per-zone operations.
10840 }</pre>
10841 </div>
10842
10843 <div class="method">
10844 <code class="details" id="resumeInstances">resumeInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
10845 <pre>Flags the specified instances in the managed instance group to be
10846 resumed. This method increases thetargetSize and decreases the targetSuspendedSize
10847 of the managed instance group by the number of instances that you resume.
10848 The resumeInstances operation is marked DONE if
10849 the resumeInstances request is successful. The underlying
10850 actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances
10851 method.
10852
10853 In this request, you can only specify instances that are suspended. For
10854 example, if an instance was previously suspended using the suspendInstances
10855 method, it can be resumed using the resumeInstances method.
10856
10857 If a health check is attached to the managed instance group, the specified
10858 instances will be verified as healthy after they are resumed.
10859
10860 You can specify a maximum of 1000 instances with this method per request.
10861
10862 Args:
10863 project: string, Project ID for this request. (required)
10864 region: string, Name of the region scoping this request. (required)
10865 instanceGroupManager: string, Name of the managed instance group. (required)
10866 body: object, The request body.
10867 The object takes the form of:
10868
10869 {
10870 &quot;instances&quot;: [ # The URLs of one or more instances to resume. This can be a full URL or
10871 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
10872 &quot;A String&quot;,
10873 ],
10874 }
10875
10876 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
10877 that if you must retry your request, the server will know to ignore the
10878 request if it has already been completed.
10879
10880 For example, consider a situation where you make an initial request and
10881 the request times out. If you make the request again with the same
10882 request ID, the server can check if original operation with the same
10883 request ID was received, and if so, will ignore the second request. This
10884 prevents clients from accidentally creating duplicate commitments.
10885
10886 The request ID must be
10887 a valid UUID with the exception that zero UUID is not supported
10888 (00000000-0000-0000-0000-000000000000).
10889 x__xgafv: string, V1 error format.
10890 Allowed values
10891 1 - v1 error format
10892 2 - v2 error format
10893
10894 Returns:
10895 An object of the form:
10896
10897 { # Represents an Operation resource.
10898 #
10899 # Google Compute Engine has three Operation resources:
10900 #
10901 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
10902 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
10903 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
10904 #
10905 # You can use an operation resource to manage asynchronous API requests.
10906 # For more information, readHandling
10907 # API responses.
10908 #
10909 # Operations can be global, regional or zonal.
10910 #
10911 # - For global operations, use the `globalOperations`
10912 # resource.
10913 # - For regional operations, use the
10914 # `regionOperations` resource.
10915 # - For zonal operations, use
10916 # the `zoneOperations` resource.
10917 #
10918 #
10919 #
10920 # For more information, read
10921 # Global, Regional, and Zonal Resources.
10922 #
10923 # Note that completed Operation resources have a limited
10924 # retention period.
10925 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
10926 # Not present otherwise.
10927 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
10928 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
10929 # set when the operation is created.
10930 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
10931 # text format.
10932 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
10933 # this field will be populated.
10934 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
10935 # operation.
10936 {
10937 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
10938 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
10939 # details. There is a set of defined message types to use for providing
10940 # details.The syntax depends on the error code. For example,
10941 # QuotaExceededInfo will have details when the error code is
10942 # QUOTA_EXCEEDED.
10943 {
10944 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
10945 #
10946 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
10947 # is not enabled:
10948 #
10949 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
10950 # &quot;domain&quot;: &quot;googleapis.com&quot;
10951 # &quot;metadata&quot;: {
10952 # &quot;resource&quot;: &quot;projects/123&quot;,
10953 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
10954 # }
10955 # }
10956 #
10957 # This response indicates that the pubsub.googleapis.com API is not enabled.
10958 #
10959 # Example of an error that is returned when attempting to create a Spanner
10960 # instance in a region that is out of stock:
10961 #
10962 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
10963 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
10964 # &quot;metadata&quot;: {
10965 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
10966 # }
10967 # }
10968 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
10969 # is typically the registered service name of the tool or product that
10970 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
10971 # generated by some common infrastructure, the error domain must be a
10972 # globally unique value that identifies the infrastructure. For Google API
10973 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10974 &quot;metadatas&quot;: { # Additional structured details about this error.
10975 #
10976 # Keys must match a regular expression of `a-z+` but should
10977 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10978 # length. When identifying the current value of an exceeded limit, the units
10979 # should be contained in the key, not the value. For example, rather than
10980 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10981 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10982 # instances that can be created in a single (batch) request.
10983 &quot;a_key&quot;: &quot;A String&quot;,
10984 },
10985 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10986 # proximate cause of the error. Error reasons are unique within a particular
10987 # domain of errors. This should be at most 63 characters and match a
10988 # regular expression of `A-Z+[A-Z0-9]`, which represents
10989 # UPPER_SNAKE_CASE.
10990 },
10991 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10992 #
10993 # For example, if a quota check failed with an error indicating the calling
10994 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10995 # directly to the right place in the developer console to flip the bit.
10996 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10997 { # Describes a URL link.
10998 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10999 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11000 },
11001 ],
11002 },
11003 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11004 # which can be attached to an RPC error.
11005 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11006 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11007 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11008 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11009 },
11010 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11011 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11012 &quot;a_key&quot;: &quot;A String&quot;,
11013 },
11014 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11015 # type or metric.
11016 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11017 # or metric.
11018 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11019 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11020 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11021 },
11022 },
11023 ],
11024 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11025 # This property is optional.
11026 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11027 },
11028 ],
11029 },
11030 &quot;getVersionOperationMetadata&quot;: {
11031 &quot;inlineSbomInfo&quot;: {
11032 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11033 # appropriate identifiers.
11034 &quot;a_key&quot;: &quot;A String&quot;,
11035 },
11036 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11037 # identifiers.
11038 &quot;a_key&quot;: &quot;A String&quot;,
11039 },
11040 },
11041 },
11042 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11043 # message that was returned, such as `NOT FOUND`.
11044 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11045 # status code that was returned. For example, a `404` means the
11046 # resource was not found.
11047 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11048 # defined by the server.
11049 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11050 # This value is inRFC3339
11051 # text format.
11052 &quot;instancesBulkInsertOperationMetadata&quot;: {
11053 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11054 # Example key: zones/us-central1-a
11055 &quot;a_key&quot;: {
11056 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11057 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11058 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11059 # error.
11060 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11061 # if the flow is rolling forward or rolling back.
11062 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11063 },
11064 },
11065 },
11066 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11067 # Operation resources.
11068 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11069 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11070 # group of operations results from a `bulkInsert` API request.
11071 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11072 # `update`, or `delete`, and so on.
11073 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11074 # There is no requirement that this be linear or support any granularity of
11075 # operations. This should not be used to guess when the operation will be
11076 # complete. This number should monotonically increase as the operation
11077 # progresses.
11078 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
11079 # applicable when performing regional operations.
11080 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11081 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
11082 # this field will contain information on all underlying zonal actions and
11083 # their state.
11084 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
11085 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
11086 # Example key: zones/us-central1-a
11087 &quot;a_key&quot;: {
11088 &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
11089 # populated.
11090 # different programming environments, including REST APIs and RPC APIs. It is
11091 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
11092 # three pieces of data: error code, error message, and error details.
11093 #
11094 # You can find out more about this error model and how to work with it in the
11095 # [API Design Guide](https://cloud.google.com/apis/design/errors).
11096 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
11097 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
11098 # message types for APIs to use.
11099 {
11100 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
11101 },
11102 ],
11103 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
11104 # user-facing error message should be localized and sent in the
11105 # google.rpc.Status.details field, or localized by the client.
11106 },
11107 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
11108 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
11109 },
11110 },
11111 },
11112 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
11113 # This value is inRFC3339
11114 # text format.
11115 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
11116 # following:
11117 # `PENDING`, `RUNNING`, or `DONE`.
11118 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
11119 # operation.
11120 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
11121 # of the target resource.
11122 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
11123 # operations related to creating a snapshot, this points to the disk
11124 # that the snapshot was created from.
11125 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
11126 # `[email protected]` or
11127 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
11128 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
11129 # operation, this field will be populated.
11130 {
11131 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
11132 # Engine returns NO_RESULTS_ON_PAGE if there
11133 # are no results in the response.
11134 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
11135 # value format. For example:
11136 #
11137 # &quot;data&quot;: [
11138 # {
11139 # &quot;key&quot;: &quot;scope&quot;,
11140 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
11141 # }
11142 {
11143 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
11144 # returned. For example, for warnings where there are no results in a list
11145 # request for a particular zone, this key might be scope and
11146 # the key value might be the zone name. Other examples might be a key
11147 # indicating a deprecated resource and a suggested replacement, or a
11148 # warning about invalid network settings (for example, if an instance
11149 # attempts to perform IP forwarding but is not enabled for IP forwarding).
11150 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
11151 },
11152 ],
11153 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
11154 },
11155 ],
11156 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
11157 # applicable when performing per-zone operations.
11158 }</pre>
11159 </div>
11160
11161 <div class="method">
11162 <code class="details" id="setAutoHealingPolicies">setAutoHealingPolicies(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
11163 <pre>Modifies the autohealing policy for the instances in this managed
11164 instance group.
11165 [Deprecated] This method is deprecated. UseregionInstanceGroupManagers.patch instead.
11166
11167 Args:
11168 project: string, Project ID for this request. (required)
11169 region: string, Name of the region scoping this request. (required)
11170 instanceGroupManager: string, Name of the managed instance group. (required)
11171 body: object, The request body.
11172 The object takes the form of:
11173
11174 {
11175 &quot;autoHealingPolicies&quot;: [
11176 {
11177 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
11178 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
11179 # initialize and run its startup script. During a VM&#x27;s initial delay
11180 # period, the MIG ignores unsuccessful health checks because the VM might
11181 # be in the startup process. This prevents the MIG from prematurely
11182 # recreating a VM. If the health check receives a healthy response during
11183 # the initial delay, it indicates that the startup process is complete and
11184 # the VM is ready. The value of initial delay must be between 0 and 3600
11185 # seconds. The default value is 0.
11186 },
11187 ],
11188 }
11189
11190 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11191 that if you must retry your request, the server will know to ignore the
11192 request if it has already been completed.
11193
11194 For example, consider a situation where you make an initial request and
11195 the request times out. If you make the request again with the same
11196 request ID, the server can check if original operation with the same
11197 request ID was received, and if so, will ignore the second request. This
11198 prevents clients from accidentally creating duplicate commitments.
11199
11200 The request ID must be
11201 a valid UUID with the exception that zero UUID is not supported
11202 (00000000-0000-0000-0000-000000000000).
11203 x__xgafv: string, V1 error format.
11204 Allowed values
11205 1 - v1 error format
11206 2 - v2 error format
11207
11208 Returns:
11209 An object of the form:
11210
11211 { # Represents an Operation resource.
11212 #
11213 # Google Compute Engine has three Operation resources:
11214 #
11215 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
11216 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
11217 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
11218 #
11219 # You can use an operation resource to manage asynchronous API requests.
11220 # For more information, readHandling
11221 # API responses.
11222 #
11223 # Operations can be global, regional or zonal.
11224 #
11225 # - For global operations, use the `globalOperations`
11226 # resource.
11227 # - For regional operations, use the
11228 # `regionOperations` resource.
11229 # - For zonal operations, use
11230 # the `zoneOperations` resource.
11231 #
11232 #
11233 #
11234 # For more information, read
11235 # Global, Regional, and Zonal Resources.
11236 #
11237 # Note that completed Operation resources have a limited
11238 # retention period.
11239 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11240 # Not present otherwise.
11241 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11242 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11243 # set when the operation is created.
11244 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11245 # text format.
11246 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11247 # this field will be populated.
11248 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11249 # operation.
11250 {
11251 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11252 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11253 # details. There is a set of defined message types to use for providing
11254 # details.The syntax depends on the error code. For example,
11255 # QuotaExceededInfo will have details when the error code is
11256 # QUOTA_EXCEEDED.
11257 {
11258 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11259 #
11260 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11261 # is not enabled:
11262 #
11263 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11264 # &quot;domain&quot;: &quot;googleapis.com&quot;
11265 # &quot;metadata&quot;: {
11266 # &quot;resource&quot;: &quot;projects/123&quot;,
11267 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11268 # }
11269 # }
11270 #
11271 # This response indicates that the pubsub.googleapis.com API is not enabled.
11272 #
11273 # Example of an error that is returned when attempting to create a Spanner
11274 # instance in a region that is out of stock:
11275 #
11276 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11277 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11278 # &quot;metadata&quot;: {
11279 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11280 # }
11281 # }
11282 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11283 # is typically the registered service name of the tool or product that
11284 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11285 # generated by some common infrastructure, the error domain must be a
11286 # globally unique value that identifies the infrastructure. For Google API
11287 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11288 &quot;metadatas&quot;: { # Additional structured details about this error.
11289 #
11290 # Keys must match a regular expression of `a-z+` but should
11291 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11292 # length. When identifying the current value of an exceeded limit, the units
11293 # should be contained in the key, not the value. For example, rather than
11294 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11295 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11296 # instances that can be created in a single (batch) request.
11297 &quot;a_key&quot;: &quot;A String&quot;,
11298 },
11299 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11300 # proximate cause of the error. Error reasons are unique within a particular
11301 # domain of errors. This should be at most 63 characters and match a
11302 # regular expression of `A-Z+[A-Z0-9]`, which represents
11303 # UPPER_SNAKE_CASE.
11304 },
11305 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11306 #
11307 # For example, if a quota check failed with an error indicating the calling
11308 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11309 # directly to the right place in the developer console to flip the bit.
11310 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11311 { # Describes a URL link.
11312 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11313 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11314 },
11315 ],
11316 },
11317 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11318 # which can be attached to an RPC error.
11319 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11320 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11321 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11322 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11323 },
11324 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11325 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11326 &quot;a_key&quot;: &quot;A String&quot;,
11327 },
11328 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11329 # type or metric.
11330 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11331 # or metric.
11332 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11333 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11334 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11335 },
11336 },
11337 ],
11338 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11339 # This property is optional.
11340 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11341 },
11342 ],
11343 },
11344 &quot;getVersionOperationMetadata&quot;: {
11345 &quot;inlineSbomInfo&quot;: {
11346 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11347 # appropriate identifiers.
11348 &quot;a_key&quot;: &quot;A String&quot;,
11349 },
11350 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11351 # identifiers.
11352 &quot;a_key&quot;: &quot;A String&quot;,
11353 },
11354 },
11355 },
11356 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11357 # message that was returned, such as `NOT FOUND`.
11358 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11359 # status code that was returned. For example, a `404` means the
11360 # resource was not found.
11361 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11362 # defined by the server.
11363 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11364 # This value is inRFC3339
11365 # text format.
11366 &quot;instancesBulkInsertOperationMetadata&quot;: {
11367 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11368 # Example key: zones/us-central1-a
11369 &quot;a_key&quot;: {
11370 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11371 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11372 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11373 # error.
11374 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11375 # if the flow is rolling forward or rolling back.
11376 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11377 },
11378 },
11379 },
11380 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11381 # Operation resources.
11382 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11383 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11384 # group of operations results from a `bulkInsert` API request.
11385 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11386 # `update`, or `delete`, and so on.
11387 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11388 # There is no requirement that this be linear or support any granularity of
11389 # operations. This should not be used to guess when the operation will be
11390 # complete. This number should monotonically increase as the operation
11391 # progresses.
11392 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
11393 # applicable when performing regional operations.
11394 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11395 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
11396 # this field will contain information on all underlying zonal actions and
11397 # their state.
11398 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
11399 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
11400 # Example key: zones/us-central1-a
11401 &quot;a_key&quot;: {
11402 &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
11403 # populated.
11404 # different programming environments, including REST APIs and RPC APIs. It is
11405 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
11406 # three pieces of data: error code, error message, and error details.
11407 #
11408 # You can find out more about this error model and how to work with it in the
11409 # [API Design Guide](https://cloud.google.com/apis/design/errors).
11410 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
11411 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
11412 # message types for APIs to use.
11413 {
11414 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
11415 },
11416 ],
11417 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
11418 # user-facing error message should be localized and sent in the
11419 # google.rpc.Status.details field, or localized by the client.
11420 },
11421 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
11422 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
11423 },
11424 },
11425 },
11426 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
11427 # This value is inRFC3339
11428 # text format.
11429 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
11430 # following:
11431 # `PENDING`, `RUNNING`, or `DONE`.
11432 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
11433 # operation.
11434 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
11435 # of the target resource.
11436 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
11437 # operations related to creating a snapshot, this points to the disk
11438 # that the snapshot was created from.
11439 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
11440 # `[email protected]` or
11441 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
11442 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
11443 # operation, this field will be populated.
11444 {
11445 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
11446 # Engine returns NO_RESULTS_ON_PAGE if there
11447 # are no results in the response.
11448 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
11449 # value format. For example:
11450 #
11451 # &quot;data&quot;: [
11452 # {
11453 # &quot;key&quot;: &quot;scope&quot;,
11454 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
11455 # }
11456 {
11457 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
11458 # returned. For example, for warnings where there are no results in a list
11459 # request for a particular zone, this key might be scope and
11460 # the key value might be the zone name. Other examples might be a key
11461 # indicating a deprecated resource and a suggested replacement, or a
11462 # warning about invalid network settings (for example, if an instance
11463 # attempts to perform IP forwarding but is not enabled for IP forwarding).
11464 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
11465 },
11466 ],
11467 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
11468 },
11469 ],
11470 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
11471 # applicable when performing per-zone operations.
11472 }</pre>
11473 </div>
11474
11475 <div class="method">
11476 <code class="details" id="setInstanceTemplate">setInstanceTemplate(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
11477 <pre>Sets the instance template to use when creating new instances or recreating
11478 instances in this group. Existing instances are not affected.
11479
11480 Args:
11481 project: string, Project ID for this request. (required)
11482 region: string, Name of the region scoping this request. (required)
11483 instanceGroupManager: string, The name of the managed instance group. (required)
11484 body: object, The request body.
11485 The object takes the form of:
11486
11487 {
11488 &quot;instanceTemplate&quot;: &quot;A String&quot;, # URL of the InstanceTemplate resource from which all new instances will be
11489 # created.
11490 }
11491
11492 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11493 that if you must retry your request, the server will know to ignore the
11494 request if it has already been completed.
11495
11496 For example, consider a situation where you make an initial request and
11497 the request times out. If you make the request again with the same
11498 request ID, the server can check if original operation with the same
11499 request ID was received, and if so, will ignore the second request. This
11500 prevents clients from accidentally creating duplicate commitments.
11501
11502 The request ID must be
11503 a valid UUID with the exception that zero UUID is not supported
11504 (00000000-0000-0000-0000-000000000000).
11505 x__xgafv: string, V1 error format.
11506 Allowed values
11507 1 - v1 error format
11508 2 - v2 error format
11509
11510 Returns:
11511 An object of the form:
11512
11513 { # Represents an Operation resource.
11514 #
11515 # Google Compute Engine has three Operation resources:
11516 #
11517 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
11518 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
11519 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
11520 #
11521 # You can use an operation resource to manage asynchronous API requests.
11522 # For more information, readHandling
11523 # API responses.
11524 #
11525 # Operations can be global, regional or zonal.
11526 #
11527 # - For global operations, use the `globalOperations`
11528 # resource.
11529 # - For regional operations, use the
11530 # `regionOperations` resource.
11531 # - For zonal operations, use
11532 # the `zoneOperations` resource.
11533 #
11534 #
11535 #
11536 # For more information, read
11537 # Global, Regional, and Zonal Resources.
11538 #
11539 # Note that completed Operation resources have a limited
11540 # retention period.
11541 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11542 # Not present otherwise.
11543 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11544 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11545 # set when the operation is created.
11546 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11547 # text format.
11548 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11549 # this field will be populated.
11550 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11551 # operation.
11552 {
11553 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11554 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11555 # details. There is a set of defined message types to use for providing
11556 # details.The syntax depends on the error code. For example,
11557 # QuotaExceededInfo will have details when the error code is
11558 # QUOTA_EXCEEDED.
11559 {
11560 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11561 #
11562 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11563 # is not enabled:
11564 #
11565 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11566 # &quot;domain&quot;: &quot;googleapis.com&quot;
11567 # &quot;metadata&quot;: {
11568 # &quot;resource&quot;: &quot;projects/123&quot;,
11569 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11570 # }
11571 # }
11572 #
11573 # This response indicates that the pubsub.googleapis.com API is not enabled.
11574 #
11575 # Example of an error that is returned when attempting to create a Spanner
11576 # instance in a region that is out of stock:
11577 #
11578 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11579 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11580 # &quot;metadata&quot;: {
11581 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11582 # }
11583 # }
11584 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11585 # is typically the registered service name of the tool or product that
11586 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11587 # generated by some common infrastructure, the error domain must be a
11588 # globally unique value that identifies the infrastructure. For Google API
11589 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11590 &quot;metadatas&quot;: { # Additional structured details about this error.
11591 #
11592 # Keys must match a regular expression of `a-z+` but should
11593 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11594 # length. When identifying the current value of an exceeded limit, the units
11595 # should be contained in the key, not the value. For example, rather than
11596 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11597 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11598 # instances that can be created in a single (batch) request.
11599 &quot;a_key&quot;: &quot;A String&quot;,
11600 },
11601 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11602 # proximate cause of the error. Error reasons are unique within a particular
11603 # domain of errors. This should be at most 63 characters and match a
11604 # regular expression of `A-Z+[A-Z0-9]`, which represents
11605 # UPPER_SNAKE_CASE.
11606 },
11607 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11608 #
11609 # For example, if a quota check failed with an error indicating the calling
11610 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11611 # directly to the right place in the developer console to flip the bit.
11612 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11613 { # Describes a URL link.
11614 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11615 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11616 },
11617 ],
11618 },
11619 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11620 # which can be attached to an RPC error.
11621 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11622 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11623 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11624 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11625 },
11626 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11627 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11628 &quot;a_key&quot;: &quot;A String&quot;,
11629 },
11630 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11631 # type or metric.
11632 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11633 # or metric.
11634 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11635 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11636 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11637 },
11638 },
11639 ],
11640 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11641 # This property is optional.
11642 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11643 },
11644 ],
11645 },
11646 &quot;getVersionOperationMetadata&quot;: {
11647 &quot;inlineSbomInfo&quot;: {
11648 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11649 # appropriate identifiers.
11650 &quot;a_key&quot;: &quot;A String&quot;,
11651 },
11652 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11653 # identifiers.
11654 &quot;a_key&quot;: &quot;A String&quot;,
11655 },
11656 },
11657 },
11658 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11659 # message that was returned, such as `NOT FOUND`.
11660 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11661 # status code that was returned. For example, a `404` means the
11662 # resource was not found.
11663 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11664 # defined by the server.
11665 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11666 # This value is inRFC3339
11667 # text format.
11668 &quot;instancesBulkInsertOperationMetadata&quot;: {
11669 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11670 # Example key: zones/us-central1-a
11671 &quot;a_key&quot;: {
11672 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11673 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11674 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11675 # error.
11676 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11677 # if the flow is rolling forward or rolling back.
11678 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11679 },
11680 },
11681 },
11682 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11683 # Operation resources.
11684 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11685 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11686 # group of operations results from a `bulkInsert` API request.
11687 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11688 # `update`, or `delete`, and so on.
11689 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11690 # There is no requirement that this be linear or support any granularity of
11691 # operations. This should not be used to guess when the operation will be
11692 # complete. This number should monotonically increase as the operation
11693 # progresses.
11694 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
11695 # applicable when performing regional operations.
11696 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11697 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
11698 # this field will contain information on all underlying zonal actions and
11699 # their state.
11700 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
11701 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
11702 # Example key: zones/us-central1-a
11703 &quot;a_key&quot;: {
11704 &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
11705 # populated.
11706 # different programming environments, including REST APIs and RPC APIs. It is
11707 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
11708 # three pieces of data: error code, error message, and error details.
11709 #
11710 # You can find out more about this error model and how to work with it in the
11711 # [API Design Guide](https://cloud.google.com/apis/design/errors).
11712 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
11713 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
11714 # message types for APIs to use.
11715 {
11716 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
11717 },
11718 ],
11719 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
11720 # user-facing error message should be localized and sent in the
11721 # google.rpc.Status.details field, or localized by the client.
11722 },
11723 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
11724 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
11725 },
11726 },
11727 },
11728 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
11729 # This value is inRFC3339
11730 # text format.
11731 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
11732 # following:
11733 # `PENDING`, `RUNNING`, or `DONE`.
11734 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
11735 # operation.
11736 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
11737 # of the target resource.
11738 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
11739 # operations related to creating a snapshot, this points to the disk
11740 # that the snapshot was created from.
11741 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
11742 # `[email protected]` or
11743 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
11744 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
11745 # operation, this field will be populated.
11746 {
11747 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
11748 # Engine returns NO_RESULTS_ON_PAGE if there
11749 # are no results in the response.
11750 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
11751 # value format. For example:
11752 #
11753 # &quot;data&quot;: [
11754 # {
11755 # &quot;key&quot;: &quot;scope&quot;,
11756 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
11757 # }
11758 {
11759 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
11760 # returned. For example, for warnings where there are no results in a list
11761 # request for a particular zone, this key might be scope and
11762 # the key value might be the zone name. Other examples might be a key
11763 # indicating a deprecated resource and a suggested replacement, or a
11764 # warning about invalid network settings (for example, if an instance
11765 # attempts to perform IP forwarding but is not enabled for IP forwarding).
11766 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
11767 },
11768 ],
11769 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
11770 },
11771 ],
11772 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
11773 # applicable when performing per-zone operations.
11774 }</pre>
11775 </div>
11776
11777 <div class="method">
11778 <code class="details" id="setTargetPools">setTargetPools(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
11779 <pre>Modifies the target pools to which all new instances in this group are
11780 assigned. Existing instances in the group are not affected.
11781
11782 Args:
11783 project: string, Project ID for this request. (required)
11784 region: string, Name of the region scoping this request. (required)
11785 instanceGroupManager: string, Name of the managed instance group. (required)
11786 body: object, The request body.
11787 The object takes the form of:
11788
11789 {
11790 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of the target pools information, which is a hash of the
11791 # contents. This field is used for optimistic locking when you update the
11792 # target pool entries. This field is optional.
11793 &quot;targetPools&quot;: [ # The URL of all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
11794 # apply to all of the instances in the managed instance group.
11795 &quot;A String&quot;,
11796 ],
11797 }
11798
11799 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11800 that if you must retry your request, the server will know to ignore the
11801 request if it has already been completed.
11802
11803 For example, consider a situation where you make an initial request and
11804 the request times out. If you make the request again with the same
11805 request ID, the server can check if original operation with the same
11806 request ID was received, and if so, will ignore the second request. This
11807 prevents clients from accidentally creating duplicate commitments.
11808
11809 The request ID must be
11810 a valid UUID with the exception that zero UUID is not supported
11811 (00000000-0000-0000-0000-000000000000).
11812 x__xgafv: string, V1 error format.
11813 Allowed values
11814 1 - v1 error format
11815 2 - v2 error format
11816
11817 Returns:
11818 An object of the form:
11819
11820 { # Represents an Operation resource.
11821 #
11822 # Google Compute Engine has three Operation resources:
11823 #
11824 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
11825 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
11826 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
11827 #
11828 # You can use an operation resource to manage asynchronous API requests.
11829 # For more information, readHandling
11830 # API responses.
11831 #
11832 # Operations can be global, regional or zonal.
11833 #
11834 # - For global operations, use the `globalOperations`
11835 # resource.
11836 # - For regional operations, use the
11837 # `regionOperations` resource.
11838 # - For zonal operations, use
11839 # the `zoneOperations` resource.
11840 #
11841 #
11842 #
11843 # For more information, read
11844 # Global, Regional, and Zonal Resources.
11845 #
11846 # Note that completed Operation resources have a limited
11847 # retention period.
11848 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11849 # Not present otherwise.
11850 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11851 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11852 # set when the operation is created.
11853 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11854 # text format.
11855 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11856 # this field will be populated.
11857 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11858 # operation.
11859 {
11860 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11861 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11862 # details. There is a set of defined message types to use for providing
11863 # details.The syntax depends on the error code. For example,
11864 # QuotaExceededInfo will have details when the error code is
11865 # QUOTA_EXCEEDED.
11866 {
11867 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11868 #
11869 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11870 # is not enabled:
11871 #
11872 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11873 # &quot;domain&quot;: &quot;googleapis.com&quot;
11874 # &quot;metadata&quot;: {
11875 # &quot;resource&quot;: &quot;projects/123&quot;,
11876 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11877 # }
11878 # }
11879 #
11880 # This response indicates that the pubsub.googleapis.com API is not enabled.
11881 #
11882 # Example of an error that is returned when attempting to create a Spanner
11883 # instance in a region that is out of stock:
11884 #
11885 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11886 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11887 # &quot;metadata&quot;: {
11888 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11889 # }
11890 # }
11891 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11892 # is typically the registered service name of the tool or product that
11893 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11894 # generated by some common infrastructure, the error domain must be a
11895 # globally unique value that identifies the infrastructure. For Google API
11896 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11897 &quot;metadatas&quot;: { # Additional structured details about this error.
11898 #
11899 # Keys must match a regular expression of `a-z+` but should
11900 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11901 # length. When identifying the current value of an exceeded limit, the units
11902 # should be contained in the key, not the value. For example, rather than
11903 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11904 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11905 # instances that can be created in a single (batch) request.
11906 &quot;a_key&quot;: &quot;A String&quot;,
11907 },
11908 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11909 # proximate cause of the error. Error reasons are unique within a particular
11910 # domain of errors. This should be at most 63 characters and match a
11911 # regular expression of `A-Z+[A-Z0-9]`, which represents
11912 # UPPER_SNAKE_CASE.
11913 },
11914 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11915 #
11916 # For example, if a quota check failed with an error indicating the calling
11917 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11918 # directly to the right place in the developer console to flip the bit.
11919 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11920 { # Describes a URL link.
11921 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11922 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11923 },
11924 ],
11925 },
11926 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11927 # which can be attached to an RPC error.
11928 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11929 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11930 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11931 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11932 },
11933 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11934 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11935 &quot;a_key&quot;: &quot;A String&quot;,
11936 },
11937 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11938 # type or metric.
11939 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11940 # or metric.
11941 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11942 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11943 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11944 },
11945 },
11946 ],
11947 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11948 # This property is optional.
11949 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11950 },
11951 ],
11952 },
11953 &quot;getVersionOperationMetadata&quot;: {
11954 &quot;inlineSbomInfo&quot;: {
11955 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11956 # appropriate identifiers.
11957 &quot;a_key&quot;: &quot;A String&quot;,
11958 },
11959 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11960 # identifiers.
11961 &quot;a_key&quot;: &quot;A String&quot;,
11962 },
11963 },
11964 },
11965 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11966 # message that was returned, such as `NOT FOUND`.
11967 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11968 # status code that was returned. For example, a `404` means the
11969 # resource was not found.
11970 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11971 # defined by the server.
11972 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11973 # This value is inRFC3339
11974 # text format.
11975 &quot;instancesBulkInsertOperationMetadata&quot;: {
11976 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11977 # Example key: zones/us-central1-a
11978 &quot;a_key&quot;: {
11979 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11980 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11981 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11982 # error.
11983 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11984 # if the flow is rolling forward or rolling back.
11985 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11986 },
11987 },
11988 },
11989 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11990 # Operation resources.
11991 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11992 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11993 # group of operations results from a `bulkInsert` API request.
11994 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11995 # `update`, or `delete`, and so on.
11996 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11997 # There is no requirement that this be linear or support any granularity of
11998 # operations. This should not be used to guess when the operation will be
11999 # complete. This number should monotonically increase as the operation
12000 # progresses.
12001 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12002 # applicable when performing regional operations.
12003 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12004 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12005 # this field will contain information on all underlying zonal actions and
12006 # their state.
12007 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12008 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12009 # Example key: zones/us-central1-a
12010 &quot;a_key&quot;: {
12011 &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
12012 # populated.
12013 # different programming environments, including REST APIs and RPC APIs. It is
12014 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12015 # three pieces of data: error code, error message, and error details.
12016 #
12017 # You can find out more about this error model and how to work with it in the
12018 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12019 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12020 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12021 # message types for APIs to use.
12022 {
12023 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12024 },
12025 ],
12026 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12027 # user-facing error message should be localized and sent in the
12028 # google.rpc.Status.details field, or localized by the client.
12029 },
12030 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12031 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12032 },
12033 },
12034 },
12035 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12036 # This value is inRFC3339
12037 # text format.
12038 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12039 # following:
12040 # `PENDING`, `RUNNING`, or `DONE`.
12041 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12042 # operation.
12043 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12044 # of the target resource.
12045 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12046 # operations related to creating a snapshot, this points to the disk
12047 # that the snapshot was created from.
12048 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12049 # `[email protected]` or
12050 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12051 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12052 # operation, this field will be populated.
12053 {
12054 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12055 # Engine returns NO_RESULTS_ON_PAGE if there
12056 # are no results in the response.
12057 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12058 # value format. For example:
12059 #
12060 # &quot;data&quot;: [
12061 # {
12062 # &quot;key&quot;: &quot;scope&quot;,
12063 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12064 # }
12065 {
12066 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12067 # returned. For example, for warnings where there are no results in a list
12068 # request for a particular zone, this key might be scope and
12069 # the key value might be the zone name. Other examples might be a key
12070 # indicating a deprecated resource and a suggested replacement, or a
12071 # warning about invalid network settings (for example, if an instance
12072 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12073 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12074 },
12075 ],
12076 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12077 },
12078 ],
12079 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12080 # applicable when performing per-zone operations.
12081 }</pre>
12082 </div>
12083
12084 <div class="method">
12085 <code class="details" id="startInstances">startInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
12086 <pre>Flags the specified instances in the managed instance group to be
12087 started. This method increases thetargetSize and decreases the targetStoppedSize
12088 of the managed instance group by the number of instances that you start.
12089 The startInstances operation is marked DONE if
12090 the startInstances request is successful. The underlying
12091 actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances
12092 method.
12093
12094 In this request, you can only specify instances that are stopped. For
12095 example, if an instance was previously stopped using the stopInstances
12096 method, it can be started using the startInstances method.
12097
12098 If a health check is attached to the managed instance group, the specified
12099 instances will be verified as healthy after they are started.
12100
12101 You can specify a maximum of 1000 instances with this method per request.
12102
12103 Args:
12104 project: string, Project ID for this request. (required)
12105 region: string, Name of the region scoping this request. (required)
12106 instanceGroupManager: string, Name of the managed instance group. (required)
12107 body: object, The request body.
12108 The object takes the form of:
12109
12110 {
12111 &quot;instances&quot;: [ # The URLs of one or more instances to start. This can be a full URL or
12112 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
12113 &quot;A String&quot;,
12114 ],
12115 }
12116
12117 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12118 that if you must retry your request, the server will know to ignore the
12119 request if it has already been completed.
12120
12121 For example, consider a situation where you make an initial request and
12122 the request times out. If you make the request again with the same
12123 request ID, the server can check if original operation with the same
12124 request ID was received, and if so, will ignore the second request. This
12125 prevents clients from accidentally creating duplicate commitments.
12126
12127 The request ID must be
12128 a valid UUID with the exception that zero UUID is not supported
12129 (00000000-0000-0000-0000-000000000000).
12130 x__xgafv: string, V1 error format.
12131 Allowed values
12132 1 - v1 error format
12133 2 - v2 error format
12134
12135 Returns:
12136 An object of the form:
12137
12138 { # Represents an Operation resource.
12139 #
12140 # Google Compute Engine has three Operation resources:
12141 #
12142 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
12143 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
12144 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
12145 #
12146 # You can use an operation resource to manage asynchronous API requests.
12147 # For more information, readHandling
12148 # API responses.
12149 #
12150 # Operations can be global, regional or zonal.
12151 #
12152 # - For global operations, use the `globalOperations`
12153 # resource.
12154 # - For regional operations, use the
12155 # `regionOperations` resource.
12156 # - For zonal operations, use
12157 # the `zoneOperations` resource.
12158 #
12159 #
12160 #
12161 # For more information, read
12162 # Global, Regional, and Zonal Resources.
12163 #
12164 # Note that completed Operation resources have a limited
12165 # retention period.
12166 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12167 # Not present otherwise.
12168 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12169 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12170 # set when the operation is created.
12171 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12172 # text format.
12173 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12174 # this field will be populated.
12175 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12176 # operation.
12177 {
12178 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12179 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12180 # details. There is a set of defined message types to use for providing
12181 # details.The syntax depends on the error code. For example,
12182 # QuotaExceededInfo will have details when the error code is
12183 # QUOTA_EXCEEDED.
12184 {
12185 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12186 #
12187 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12188 # is not enabled:
12189 #
12190 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12191 # &quot;domain&quot;: &quot;googleapis.com&quot;
12192 # &quot;metadata&quot;: {
12193 # &quot;resource&quot;: &quot;projects/123&quot;,
12194 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12195 # }
12196 # }
12197 #
12198 # This response indicates that the pubsub.googleapis.com API is not enabled.
12199 #
12200 # Example of an error that is returned when attempting to create a Spanner
12201 # instance in a region that is out of stock:
12202 #
12203 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12204 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12205 # &quot;metadata&quot;: {
12206 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12207 # }
12208 # }
12209 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12210 # is typically the registered service name of the tool or product that
12211 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12212 # generated by some common infrastructure, the error domain must be a
12213 # globally unique value that identifies the infrastructure. For Google API
12214 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12215 &quot;metadatas&quot;: { # Additional structured details about this error.
12216 #
12217 # Keys must match a regular expression of `a-z+` but should
12218 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12219 # length. When identifying the current value of an exceeded limit, the units
12220 # should be contained in the key, not the value. For example, rather than
12221 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12222 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12223 # instances that can be created in a single (batch) request.
12224 &quot;a_key&quot;: &quot;A String&quot;,
12225 },
12226 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12227 # proximate cause of the error. Error reasons are unique within a particular
12228 # domain of errors. This should be at most 63 characters and match a
12229 # regular expression of `A-Z+[A-Z0-9]`, which represents
12230 # UPPER_SNAKE_CASE.
12231 },
12232 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12233 #
12234 # For example, if a quota check failed with an error indicating the calling
12235 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12236 # directly to the right place in the developer console to flip the bit.
12237 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12238 { # Describes a URL link.
12239 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12240 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12241 },
12242 ],
12243 },
12244 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12245 # which can be attached to an RPC error.
12246 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12247 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12248 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12249 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12250 },
12251 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12252 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12253 &quot;a_key&quot;: &quot;A String&quot;,
12254 },
12255 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12256 # type or metric.
12257 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12258 # or metric.
12259 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12260 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12261 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12262 },
12263 },
12264 ],
12265 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12266 # This property is optional.
12267 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12268 },
12269 ],
12270 },
12271 &quot;getVersionOperationMetadata&quot;: {
12272 &quot;inlineSbomInfo&quot;: {
12273 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12274 # appropriate identifiers.
12275 &quot;a_key&quot;: &quot;A String&quot;,
12276 },
12277 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12278 # identifiers.
12279 &quot;a_key&quot;: &quot;A String&quot;,
12280 },
12281 },
12282 },
12283 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12284 # message that was returned, such as `NOT FOUND`.
12285 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12286 # status code that was returned. For example, a `404` means the
12287 # resource was not found.
12288 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12289 # defined by the server.
12290 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12291 # This value is inRFC3339
12292 # text format.
12293 &quot;instancesBulkInsertOperationMetadata&quot;: {
12294 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12295 # Example key: zones/us-central1-a
12296 &quot;a_key&quot;: {
12297 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12298 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12299 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12300 # error.
12301 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12302 # if the flow is rolling forward or rolling back.
12303 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12304 },
12305 },
12306 },
12307 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12308 # Operation resources.
12309 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12310 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12311 # group of operations results from a `bulkInsert` API request.
12312 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12313 # `update`, or `delete`, and so on.
12314 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12315 # There is no requirement that this be linear or support any granularity of
12316 # operations. This should not be used to guess when the operation will be
12317 # complete. This number should monotonically increase as the operation
12318 # progresses.
12319 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12320 # applicable when performing regional operations.
12321 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12322 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12323 # this field will contain information on all underlying zonal actions and
12324 # their state.
12325 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12326 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12327 # Example key: zones/us-central1-a
12328 &quot;a_key&quot;: {
12329 &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
12330 # populated.
12331 # different programming environments, including REST APIs and RPC APIs. It is
12332 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12333 # three pieces of data: error code, error message, and error details.
12334 #
12335 # You can find out more about this error model and how to work with it in the
12336 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12337 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12338 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12339 # message types for APIs to use.
12340 {
12341 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12342 },
12343 ],
12344 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12345 # user-facing error message should be localized and sent in the
12346 # google.rpc.Status.details field, or localized by the client.
12347 },
12348 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12349 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12350 },
12351 },
12352 },
12353 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12354 # This value is inRFC3339
12355 # text format.
12356 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12357 # following:
12358 # `PENDING`, `RUNNING`, or `DONE`.
12359 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12360 # operation.
12361 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12362 # of the target resource.
12363 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12364 # operations related to creating a snapshot, this points to the disk
12365 # that the snapshot was created from.
12366 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12367 # `[email protected]` or
12368 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12369 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12370 # operation, this field will be populated.
12371 {
12372 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12373 # Engine returns NO_RESULTS_ON_PAGE if there
12374 # are no results in the response.
12375 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12376 # value format. For example:
12377 #
12378 # &quot;data&quot;: [
12379 # {
12380 # &quot;key&quot;: &quot;scope&quot;,
12381 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12382 # }
12383 {
12384 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12385 # returned. For example, for warnings where there are no results in a list
12386 # request for a particular zone, this key might be scope and
12387 # the key value might be the zone name. Other examples might be a key
12388 # indicating a deprecated resource and a suggested replacement, or a
12389 # warning about invalid network settings (for example, if an instance
12390 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12391 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12392 },
12393 ],
12394 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12395 },
12396 ],
12397 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12398 # applicable when performing per-zone operations.
12399 }</pre>
12400 </div>
12401
12402 <div class="method">
12403 <code class="details" id="stopInstances">stopInstances(project, region, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
12404 <pre>Flags the specified instances in the managed instance group to be
12405 immediately stopped. You can only specify instances that are running in
12406 this request. This method reduces thetargetSize and increases the targetStoppedSize
12407 of the managed instance group by the number of instances that you stop.
12408 The stopInstances operation is marked DONE if
12409 the stopInstances request is successful. The underlying
12410 actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances
12411 method.
12412
12413 If the standbyPolicy.initialDelaySec field is set, the group
12414 delays stopping the instances until initialDelaySec have
12415 passed from instance.creationTimestamp (that is, when the
12416 instance was created). This delay gives your application time to
12417 set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
12418 will be zero delay.
12419
12420 If the group is part of a backend
12421 service that has enabled
12422 connection draining, it can take up to 60 seconds after the connection
12423 draining duration has elapsed before the VM instance is stopped.
12424
12425 Stopped instances can be started using the startInstances
12426 method.
12427
12428 You can specify a maximum of 1000 instances with this method per request.
12429
12430 Args:
12431 project: string, Project ID for this request. (required)
12432 region: string, Name of the region scoping this request. (required)
12433 instanceGroupManager: string, The name of the managed instance group. (required)
12434 body: object, The request body.
12435 The object takes the form of:
12436
12437 {
12438 &quot;forceStop&quot;: True or False, # If this flag is set to true, the Instance Group Manager will proceed to
12439 # stop the instances, skipping initialization on them.
12440 &quot;instances&quot;: [ # The URLs of one or more instances to stop. This can be a full URL or
12441 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
12442 &quot;A String&quot;,
12443 ],
12444 }
12445
12446 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance stopping even if it&#x27;s
12447 configured for the instances.
12448 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12449 that if you must retry your request, the server will know to ignore the
12450 request if it has already been completed.
12451
12452 For example, consider a situation where you make an initial request and
12453 the request times out. If you make the request again with the same
12454 request ID, the server can check if original operation with the same
12455 request ID was received, and if so, will ignore the second request. This
12456 prevents clients from accidentally creating duplicate commitments.
12457
12458 The request ID must be
12459 a valid UUID with the exception that zero UUID is not supported
12460 (00000000-0000-0000-0000-000000000000).
12461 x__xgafv: string, V1 error format.
12462 Allowed values
12463 1 - v1 error format
12464 2 - v2 error format
12465
12466 Returns:
12467 An object of the form:
12468
12469 { # Represents an Operation resource.
12470 #
12471 # Google Compute Engine has three Operation resources:
12472 #
12473 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
12474 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
12475 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
12476 #
12477 # You can use an operation resource to manage asynchronous API requests.
12478 # For more information, readHandling
12479 # API responses.
12480 #
12481 # Operations can be global, regional or zonal.
12482 #
12483 # - For global operations, use the `globalOperations`
12484 # resource.
12485 # - For regional operations, use the
12486 # `regionOperations` resource.
12487 # - For zonal operations, use
12488 # the `zoneOperations` resource.
12489 #
12490 #
12491 #
12492 # For more information, read
12493 # Global, Regional, and Zonal Resources.
12494 #
12495 # Note that completed Operation resources have a limited
12496 # retention period.
12497 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12498 # Not present otherwise.
12499 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12500 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12501 # set when the operation is created.
12502 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12503 # text format.
12504 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12505 # this field will be populated.
12506 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12507 # operation.
12508 {
12509 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12510 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12511 # details. There is a set of defined message types to use for providing
12512 # details.The syntax depends on the error code. For example,
12513 # QuotaExceededInfo will have details when the error code is
12514 # QUOTA_EXCEEDED.
12515 {
12516 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12517 #
12518 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12519 # is not enabled:
12520 #
12521 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12522 # &quot;domain&quot;: &quot;googleapis.com&quot;
12523 # &quot;metadata&quot;: {
12524 # &quot;resource&quot;: &quot;projects/123&quot;,
12525 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12526 # }
12527 # }
12528 #
12529 # This response indicates that the pubsub.googleapis.com API is not enabled.
12530 #
12531 # Example of an error that is returned when attempting to create a Spanner
12532 # instance in a region that is out of stock:
12533 #
12534 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12535 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12536 # &quot;metadata&quot;: {
12537 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12538 # }
12539 # }
12540 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12541 # is typically the registered service name of the tool or product that
12542 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12543 # generated by some common infrastructure, the error domain must be a
12544 # globally unique value that identifies the infrastructure. For Google API
12545 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12546 &quot;metadatas&quot;: { # Additional structured details about this error.
12547 #
12548 # Keys must match a regular expression of `a-z+` but should
12549 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12550 # length. When identifying the current value of an exceeded limit, the units
12551 # should be contained in the key, not the value. For example, rather than
12552 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12553 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12554 # instances that can be created in a single (batch) request.
12555 &quot;a_key&quot;: &quot;A String&quot;,
12556 },
12557 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12558 # proximate cause of the error. Error reasons are unique within a particular
12559 # domain of errors. This should be at most 63 characters and match a
12560 # regular expression of `A-Z+[A-Z0-9]`, which represents
12561 # UPPER_SNAKE_CASE.
12562 },
12563 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12564 #
12565 # For example, if a quota check failed with an error indicating the calling
12566 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12567 # directly to the right place in the developer console to flip the bit.
12568 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12569 { # Describes a URL link.
12570 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12571 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12572 },
12573 ],
12574 },
12575 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12576 # which can be attached to an RPC error.
12577 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12578 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12579 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12580 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12581 },
12582 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12583 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12584 &quot;a_key&quot;: &quot;A String&quot;,
12585 },
12586 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12587 # type or metric.
12588 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12589 # or metric.
12590 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12591 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12592 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12593 },
12594 },
12595 ],
12596 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12597 # This property is optional.
12598 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12599 },
12600 ],
12601 },
12602 &quot;getVersionOperationMetadata&quot;: {
12603 &quot;inlineSbomInfo&quot;: {
12604 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12605 # appropriate identifiers.
12606 &quot;a_key&quot;: &quot;A String&quot;,
12607 },
12608 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12609 # identifiers.
12610 &quot;a_key&quot;: &quot;A String&quot;,
12611 },
12612 },
12613 },
12614 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12615 # message that was returned, such as `NOT FOUND`.
12616 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12617 # status code that was returned. For example, a `404` means the
12618 # resource was not found.
12619 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12620 # defined by the server.
12621 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12622 # This value is inRFC3339
12623 # text format.
12624 &quot;instancesBulkInsertOperationMetadata&quot;: {
12625 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12626 # Example key: zones/us-central1-a
12627 &quot;a_key&quot;: {
12628 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12629 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12630 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12631 # error.
12632 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12633 # if the flow is rolling forward or rolling back.
12634 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12635 },
12636 },
12637 },
12638 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12639 # Operation resources.
12640 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12641 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12642 # group of operations results from a `bulkInsert` API request.
12643 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12644 # `update`, or `delete`, and so on.
12645 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12646 # There is no requirement that this be linear or support any granularity of
12647 # operations. This should not be used to guess when the operation will be
12648 # complete. This number should monotonically increase as the operation
12649 # progresses.
12650 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12651 # applicable when performing regional operations.
12652 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12653 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12654 # this field will contain information on all underlying zonal actions and
12655 # their state.
12656 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12657 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12658 # Example key: zones/us-central1-a
12659 &quot;a_key&quot;: {
12660 &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
12661 # populated.
12662 # different programming environments, including REST APIs and RPC APIs. It is
12663 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12664 # three pieces of data: error code, error message, and error details.
12665 #
12666 # You can find out more about this error model and how to work with it in the
12667 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12668 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12669 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12670 # message types for APIs to use.
12671 {
12672 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12673 },
12674 ],
12675 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12676 # user-facing error message should be localized and sent in the
12677 # google.rpc.Status.details field, or localized by the client.
12678 },
12679 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12680 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12681 },
12682 },
12683 },
12684 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12685 # This value is inRFC3339
12686 # text format.
12687 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12688 # following:
12689 # `PENDING`, `RUNNING`, or `DONE`.
12690 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12691 # operation.
12692 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12693 # of the target resource.
12694 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12695 # operations related to creating a snapshot, this points to the disk
12696 # that the snapshot was created from.
12697 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12698 # `[email protected]` or
12699 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12700 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12701 # operation, this field will be populated.
12702 {
12703 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12704 # Engine returns NO_RESULTS_ON_PAGE if there
12705 # are no results in the response.
12706 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12707 # value format. For example:
12708 #
12709 # &quot;data&quot;: [
12710 # {
12711 # &quot;key&quot;: &quot;scope&quot;,
12712 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12713 # }
12714 {
12715 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12716 # returned. For example, for warnings where there are no results in a list
12717 # request for a particular zone, this key might be scope and
12718 # the key value might be the zone name. Other examples might be a key
12719 # indicating a deprecated resource and a suggested replacement, or a
12720 # warning about invalid network settings (for example, if an instance
12721 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12722 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12723 },
12724 ],
12725 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12726 },
12727 ],
12728 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12729 # applicable when performing per-zone operations.
12730 }</pre>
12731 </div>
12732
12733 <div class="method">
12734 <code class="details" id="suspendInstances">suspendInstances(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
12735 <pre>Flags the specified instances in the managed instance group to be
12736 immediately suspended. You can only specify instances that are running in
12737 this request. This method reduces thetargetSize and increases the targetSuspendedSize
12738 of the managed instance group by the number of instances that you suspend.
12739 The suspendInstances operation is marked DONE if
12740 the suspendInstances request is successful. The underlying
12741 actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances
12742 method.
12743
12744 If the standbyPolicy.initialDelaySec field is set, the group
12745 delays suspension of the instances until initialDelaySec have
12746 passed from instance.creationTimestamp (that is, when the
12747 instance was created). This delay gives your application time to
12748 set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
12749 will be zero delay.
12750
12751 If the group is part of a backend
12752 service that has enabled
12753 connection draining, it can take up to 60 seconds after the connection
12754 draining duration has elapsed before the VM instance is suspended.
12755
12756 Suspended instances can be resumed using the resumeInstances
12757 method.
12758
12759 You can specify a maximum of 1000 instances with this method per request.
12760
12761 Args:
12762 project: string, Project ID for this request. (required)
12763 region: string, Name of the region scoping this request. (required)
12764 instanceGroupManager: string, Name of the managed instance group. (required)
12765 body: object, The request body.
12766 The object takes the form of:
12767
12768 {
12769 &quot;forceSuspend&quot;: True or False, # If this flag is set to true, the Instance Group Manager will proceed to
12770 # suspend the instances, skipping initialization on them.
12771 &quot;instances&quot;: [ # The URLs of one or more instances to suspend. This can be a full URL or
12772 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
12773 &quot;A String&quot;,
12774 ],
12775 }
12776
12777 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12778 that if you must retry your request, the server will know to ignore the
12779 request if it has already been completed.
12780
12781 For example, consider a situation where you make an initial request and
12782 the request times out. If you make the request again with the same
12783 request ID, the server can check if original operation with the same
12784 request ID was received, and if so, will ignore the second request. This
12785 prevents clients from accidentally creating duplicate commitments.
12786
12787 The request ID must be
12788 a valid UUID with the exception that zero UUID is not supported
12789 (00000000-0000-0000-0000-000000000000).
12790 x__xgafv: string, V1 error format.
12791 Allowed values
12792 1 - v1 error format
12793 2 - v2 error format
12794
12795 Returns:
12796 An object of the form:
12797
12798 { # Represents an Operation resource.
12799 #
12800 # Google Compute Engine has three Operation resources:
12801 #
12802 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
12803 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
12804 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
12805 #
12806 # You can use an operation resource to manage asynchronous API requests.
12807 # For more information, readHandling
12808 # API responses.
12809 #
12810 # Operations can be global, regional or zonal.
12811 #
12812 # - For global operations, use the `globalOperations`
12813 # resource.
12814 # - For regional operations, use the
12815 # `regionOperations` resource.
12816 # - For zonal operations, use
12817 # the `zoneOperations` resource.
12818 #
12819 #
12820 #
12821 # For more information, read
12822 # Global, Regional, and Zonal Resources.
12823 #
12824 # Note that completed Operation resources have a limited
12825 # retention period.
12826 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12827 # Not present otherwise.
12828 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12829 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12830 # set when the operation is created.
12831 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12832 # text format.
12833 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12834 # this field will be populated.
12835 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12836 # operation.
12837 {
12838 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12839 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12840 # details. There is a set of defined message types to use for providing
12841 # details.The syntax depends on the error code. For example,
12842 # QuotaExceededInfo will have details when the error code is
12843 # QUOTA_EXCEEDED.
12844 {
12845 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12846 #
12847 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12848 # is not enabled:
12849 #
12850 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12851 # &quot;domain&quot;: &quot;googleapis.com&quot;
12852 # &quot;metadata&quot;: {
12853 # &quot;resource&quot;: &quot;projects/123&quot;,
12854 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12855 # }
12856 # }
12857 #
12858 # This response indicates that the pubsub.googleapis.com API is not enabled.
12859 #
12860 # Example of an error that is returned when attempting to create a Spanner
12861 # instance in a region that is out of stock:
12862 #
12863 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12864 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12865 # &quot;metadata&quot;: {
12866 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12867 # }
12868 # }
12869 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12870 # is typically the registered service name of the tool or product that
12871 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12872 # generated by some common infrastructure, the error domain must be a
12873 # globally unique value that identifies the infrastructure. For Google API
12874 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12875 &quot;metadatas&quot;: { # Additional structured details about this error.
12876 #
12877 # Keys must match a regular expression of `a-z+` but should
12878 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12879 # length. When identifying the current value of an exceeded limit, the units
12880 # should be contained in the key, not the value. For example, rather than
12881 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12882 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12883 # instances that can be created in a single (batch) request.
12884 &quot;a_key&quot;: &quot;A String&quot;,
12885 },
12886 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12887 # proximate cause of the error. Error reasons are unique within a particular
12888 # domain of errors. This should be at most 63 characters and match a
12889 # regular expression of `A-Z+[A-Z0-9]`, which represents
12890 # UPPER_SNAKE_CASE.
12891 },
12892 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12893 #
12894 # For example, if a quota check failed with an error indicating the calling
12895 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12896 # directly to the right place in the developer console to flip the bit.
12897 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12898 { # Describes a URL link.
12899 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12900 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12901 },
12902 ],
12903 },
12904 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12905 # which can be attached to an RPC error.
12906 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12907 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12908 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12909 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12910 },
12911 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12912 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12913 &quot;a_key&quot;: &quot;A String&quot;,
12914 },
12915 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12916 # type or metric.
12917 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12918 # or metric.
12919 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12920 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12921 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12922 },
12923 },
12924 ],
12925 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12926 # This property is optional.
12927 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12928 },
12929 ],
12930 },
12931 &quot;getVersionOperationMetadata&quot;: {
12932 &quot;inlineSbomInfo&quot;: {
12933 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12934 # appropriate identifiers.
12935 &quot;a_key&quot;: &quot;A String&quot;,
12936 },
12937 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12938 # identifiers.
12939 &quot;a_key&quot;: &quot;A String&quot;,
12940 },
12941 },
12942 },
12943 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12944 # message that was returned, such as `NOT FOUND`.
12945 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12946 # status code that was returned. For example, a `404` means the
12947 # resource was not found.
12948 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12949 # defined by the server.
12950 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12951 # This value is inRFC3339
12952 # text format.
12953 &quot;instancesBulkInsertOperationMetadata&quot;: {
12954 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12955 # Example key: zones/us-central1-a
12956 &quot;a_key&quot;: {
12957 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12958 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12959 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12960 # error.
12961 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12962 # if the flow is rolling forward or rolling back.
12963 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12964 },
12965 },
12966 },
12967 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12968 # Operation resources.
12969 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12970 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12971 # group of operations results from a `bulkInsert` API request.
12972 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12973 # `update`, or `delete`, and so on.
12974 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12975 # There is no requirement that this be linear or support any granularity of
12976 # operations. This should not be used to guess when the operation will be
12977 # complete. This number should monotonically increase as the operation
12978 # progresses.
12979 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12980 # applicable when performing regional operations.
12981 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12982 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12983 # this field will contain information on all underlying zonal actions and
12984 # their state.
12985 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12986 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12987 # Example key: zones/us-central1-a
12988 &quot;a_key&quot;: {
12989 &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
12990 # populated.
12991 # different programming environments, including REST APIs and RPC APIs. It is
12992 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12993 # three pieces of data: error code, error message, and error details.
12994 #
12995 # You can find out more about this error model and how to work with it in the
12996 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12997 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12998 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12999 # message types for APIs to use.
13000 {
13001 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
13002 },
13003 ],
13004 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
13005 # user-facing error message should be localized and sent in the
13006 # google.rpc.Status.details field, or localized by the client.
13007 },
13008 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
13009 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
13010 },
13011 },
13012 },
13013 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
13014 # This value is inRFC3339
13015 # text format.
13016 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
13017 # following:
13018 # `PENDING`, `RUNNING`, or `DONE`.
13019 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
13020 # operation.
13021 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
13022 # of the target resource.
13023 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
13024 # operations related to creating a snapshot, this points to the disk
13025 # that the snapshot was created from.
13026 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
13027 # `[email protected]` or
13028 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
13029 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
13030 # operation, this field will be populated.
13031 {
13032 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
13033 # Engine returns NO_RESULTS_ON_PAGE if there
13034 # are no results in the response.
13035 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
13036 # value format. For example:
13037 #
13038 # &quot;data&quot;: [
13039 # {
13040 # &quot;key&quot;: &quot;scope&quot;,
13041 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
13042 # }
13043 {
13044 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
13045 # returned. For example, for warnings where there are no results in a list
13046 # request for a particular zone, this key might be scope and
13047 # the key value might be the zone name. Other examples might be a key
13048 # indicating a deprecated resource and a suggested replacement, or a
13049 # warning about invalid network settings (for example, if an instance
13050 # attempts to perform IP forwarding but is not enabled for IP forwarding).
13051 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
13052 },
13053 ],
13054 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
13055 },
13056 ],
13057 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
13058 # applicable when performing per-zone operations.
13059 }</pre>
13060 </div>
13061
13062 <div class="method">
13063 <code class="details" id="testIamPermissions">testIamPermissions(project, region, resource, body=None, x__xgafv=None)</code>
13064 <pre>Returns permissions that a caller has on the specified resource.
13065
13066 Args:
13067 project: string, Project ID for this request. (required)
13068 region: string, The name of the region for this request. (required)
13069 resource: string, Name or id of the resource for this request. (required)
13070 body: object, The request body.
13071 The object takes the form of:
13072
13073 {
13074 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
13075 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
13076 &quot;A String&quot;,
13077 ],
13078 }
13079
13080 x__xgafv: string, V1 error format.
13081 Allowed values
13082 1 - v1 error format
13083 2 - v2 error format
13084
13085 Returns:
13086 An object of the form:
13087
13088 {
13089 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
13090 # allowed.
13091 &quot;A String&quot;,
13092 ],
13093 }</pre>
13094 </div>
13095
13096 <div class="method">
13097 <code class="details" id="update">update(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
13098 <pre>Updates a managed instance group using the information that you specify
13099 in the request.
13100 This operation is marked as DONE when the group is updated
13101 even if the instances in the group have not yet been updated. You must
13102 separately verify the status of the individual instances with thelistmanagedinstances
13103 method.
13104
13105 If you update your group to specify a new template or instance
13106 configuration, it&#x27;s possible that your intended specification for each VM
13107 in the group is different from the current state of that VM. To learn how
13108 to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
13109 a MIG.
13110
13111 Args:
13112 project: string, Project ID for this request. (required)
13113 region: string, Name of the region scoping this request. (required)
13114 instanceGroupManager: string, The name of the instance group manager. (required)
13115 body: object, The request body.
13116 The object takes the form of:
13117
13118 { # Represents a Managed Instance Group resource.
13119 #
13120 # An instance group is a collection of VM instances that you can manage as a
13121 # single entity. For more information, readInstance groups.
13122 #
13123 # For zonal Managed Instance Group, use the instanceGroupManagers
13124 # resource.
13125 #
13126 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
13127 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
13128 # for the group.
13129 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
13130 #
13131 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
13132 # instances to apply the configuration. To apply the configuration, set the
13133 # group&#x27;s updatePolicy.type field to use proactive updates or
13134 # use the applyUpdatesToInstances method.
13135 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
13136 &quot;a_key&quot;: &quot;A String&quot;,
13137 },
13138 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
13139 # more information, see Project and
13140 # instance metadata.
13141 &quot;a_key&quot;: &quot;A String&quot;,
13142 },
13143 },
13144 },
13145 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
13146 # only one value.
13147 {
13148 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
13149 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
13150 # initialize and run its startup script. During a VM&#x27;s initial delay
13151 # period, the MIG ignores unsuccessful health checks because the VM might
13152 # be in the startup process. This prevents the MIG from prematurely
13153 # recreating a VM. If the health check receives a healthy response during
13154 # the initial delay, it indicates that the startup process is complete and
13155 # the VM is ready. The value of initial delay must be between 0 and 3600
13156 # seconds. The default value is 0.
13157 },
13158 ],
13159 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
13160 # all VMs in a MIG. The maximum character length is 58 and the name must
13161 # comply with RFC1035 format.
13162 #
13163 # When a VM is created in the group, the MIG appends a hyphen and a random
13164 # four-character string to the base instance name. If you want the MIG to
13165 # assign sequential numbers instead of a random string, then end the base
13166 # instance name with a hyphen followed by one or more hash symbols. The hash
13167 # symbols indicate the number of digits. For example, a base instance name of
13168 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
13169 # @pattern
13170 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
13171 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
13172 # text format.
13173 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
13174 # in this managed instance group that are scheduled for each of those
13175 # actions.
13176 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
13177 # that are scheduled to be abandoned. Abandoning an instance removes it
13178 # from the managed instance group without deleting it.
13179 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
13180 # are scheduled to be adopted or are currently being adopted.
13181 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
13182 # are scheduled to be created or are currently being created. If the group
13183 # fails to create any of these instances, it tries again until it creates
13184 # the instance successfully.
13185 #
13186 # If you have disabled creation retries, this field will not be populated;
13187 # instead, the creatingWithoutRetries field will be populated.
13188 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
13189 # will attempt to create. The group attempts to create each instance
13190 # only once. If the group fails to create any of these instances, it
13191 # decreases the group&#x27;s targetSize value accordingly.
13192 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
13193 # are scheduled to be deleted or are currently being deleted.
13194 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
13195 # are running and have no scheduled actions.
13196 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
13197 # are scheduled to be recreated or are currently being being recreated.
13198 # Recreating an instance deletes the existing root persistent disk
13199 # and creates a new disk from the image that is defined in the
13200 # instance template.
13201 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
13202 # are being reconfigured with properties that do not require a restart
13203 # or a recreate action. For example, setting or removing target
13204 # pools for the instance.
13205 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
13206 # are scheduled to be restarted or are currently being restarted.
13207 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
13208 # are scheduled to be restarted or are currently being restarted.
13209 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
13210 # are scheduled to be resumed or are currently being resumed.
13211 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
13212 # are scheduled to be started or are currently being started.
13213 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
13214 # are scheduled to be stopped or are currently being stopped.
13215 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
13216 # are scheduled to be suspended or are currently being suspended.
13217 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
13218 # are being verified. See the managedInstances[].currentAction
13219 # property in the listManagedInstances method documentation.
13220 },
13221 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
13222 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
13223 # zones in a regional managed instance group.
13224 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
13225 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
13226 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
13227 # its instances.
13228 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
13229 # instances, even if an AI zone is available in the specified region. To
13230 # create instances in an AI zone in the selected region, you must explicitly
13231 # specify it in the distribution policy together with the other preferred
13232 # zones.
13233 {
13234 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
13235 # The zone must exist in the region where the managed instance group is
13236 # located.
13237 },
13238 ],
13239 },
13240 &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.
13241 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
13242 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
13243 # fingerprint must be provided in order to update the InstanceGroupManager,
13244 # otherwise the request will fail with error412 conditionNotMet.
13245 #
13246 # To see the latest fingerprint, make a get() request to
13247 # retrieve an InstanceGroupManager.
13248 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
13249 # generates this identifier.
13250 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
13251 # types of machines.
13252 # Instance flexibility configuration on MIG overrides instance
13253 # template configuration.
13254 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
13255 # when creating new VMs.
13256 &quot;a_key&quot;: {
13257 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
13258 # selection.
13259 { # An instance-attached disk resource.
13260 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
13261 # or X86_64.
13262 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
13263 # deleted (but not when the disk is detached from the instance).
13264 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
13265 # partition of the disk for its root filesystem.
13266 &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
13267 # running within the instance. This name can be used to reference the device
13268 # for mounting, resizing, and so on, from within the instance.
13269 #
13270 # If not specified, the server chooses a default device name to apply to this
13271 # disk, in the form persistent-disk-x, where x is a number
13272 # assigned by Google Compute Engine. This field is only applicable for
13273 # persistent disks.
13274 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
13275 # encryption key.
13276 #
13277 # If you are creating a new disk, this field encrypts the new disk using
13278 # an encryption key that you provide. If you are attaching an existing
13279 # disk that is already encrypted, this field decrypts the disk using
13280 # the customer-supplied encryption key.
13281 #
13282 # If you encrypt a disk using a customer-supplied key, you must provide the
13283 # same key again when you attempt to use this resource at a later time. For
13284 # example, you must provide the key when you create a snapshot or an image
13285 # from the disk or when you attach the disk to a virtual machine instance.
13286 #
13287 # If you do not provide an encryption key, then the disk will be encrypted
13288 # using an automatically generated key and you do not need to provide a key
13289 # to use the disk later.
13290 #
13291 # Note:
13292 #
13293 # Instance templates do not storecustomer-supplied
13294 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
13295 #
13296 # You cannot create VMs that have disks with customer-supplied keys using
13297 # the bulk
13298 # insert method.
13299 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
13300 # For example:
13301 #
13302 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13303 # key_region/cryptoKeys/key
13304 #
13305 # The fully-qualifed key name may be returned for resource GET requests. For
13306 # example:
13307 #
13308 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13309 # key_region/cryptoKeys/key
13310 # /cryptoKeyVersions/1
13311 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
13312 # key. If absent, the Compute Engine default service account is used.
13313 # For example:
13314 #
13315 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
13316 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
13317 # encryption key, encoded in RFC
13318 # 4648 base64 to either encrypt or decrypt this resource. You can
13319 # provide either the rawKey or thersaEncryptedKey.
13320 # For example:
13321 #
13322 # &quot;rawKey&quot;:
13323 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
13324 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
13325 # customer-supplied encryption key to either encrypt or decrypt this
13326 # resource. You can provide either the rawKey or thersaEncryptedKey.
13327 # For example:
13328 #
13329 # &quot;rsaEncryptedKey&quot;:
13330 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
13331 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
13332 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
13333 #
13334 # The key must meet the following requirements before you can provide it to
13335 # Compute Engine:
13336 #
13337 # 1. The key is wrapped using a RSA public key certificate provided by
13338 # Google.
13339 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
13340 # encoding.
13341 #
13342 # Gets the RSA public key certificate provided by Google at:
13343 #
13344 #
13345 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
13346 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
13347 # 4648 base64 encoded SHA-256 hash of the customer-supplied
13348 # encryption key that protects this resource.
13349 },
13350 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
13351 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
13352 # currently attached to another instance. If you try to force attach a zonal
13353 # disk to an instance, you will receive an error.
13354 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
13355 # only for bootable images. Read
13356 # Enabling guest operating system features to see a list of available
13357 # options.
13358 { # Guest OS features.
13359 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
13360 # separate values. Set to one or more of the following values:
13361 #
13362 # - VIRTIO_SCSI_MULTIQUEUE
13363 # - WINDOWS
13364 # - MULTI_IP_SUBNET
13365 # - UEFI_COMPATIBLE
13366 # - GVNIC
13367 # - SEV_CAPABLE
13368 # - SUSPEND_RESUME_COMPATIBLE
13369 # - SEV_LIVE_MIGRATABLE_V2
13370 # - SEV_SNP_CAPABLE
13371 # - TDX_CAPABLE
13372 # - IDPF
13373 # - SNP_SVSM_CAPABLE
13374 # - CCA_CAPABLE
13375 #
13376 #
13377 # For more information, see
13378 # Enabling guest operating system features.
13379 },
13380 ],
13381 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
13382 # boot disk. If you have many disks attached to an instance, each
13383 # disk would have a unique index number.
13384 &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
13385 # alongside the new instance. Use initialization parameters to create boot
13386 # disks or local SSDs attached to the new instance.
13387 #
13388 # This property is mutually exclusive with the source property;
13389 # you can only define one or the other, but not both.
13390 # alongside the new instance. Use initialization parameters to create boot
13391 # disks or local SSDs attached to the new instance.
13392 #
13393 # This field is persisted and returned for instanceTemplate and not returned
13394 # in the context of instance.
13395 #
13396 # This property is mutually exclusive with the source property;
13397 # you can only define one or the other, but not both.
13398 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
13399 # arm64 or x86_64.
13400 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
13401 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
13402 # of the instance. If a disk with the same name already exists in the given
13403 # region, the existing disk is attached to the new instance and the
13404 # new disk is not created.
13405 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
13406 # 10 GB. If you specify a sourceImage, which is required for
13407 # boot disks, the default size is the size of the sourceImage.
13408 # If you do not specify a sourceImage, the default disk size
13409 # is 500 GB.
13410 &quot;diskType&quot;: &quot;A String&quot;,
13411 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
13412 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
13413 # only for bootable images. Read
13414 # Enabling guest operating system features to see a list of available
13415 # options.
13416 #
13417 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
13418 { # Guest OS features.
13419 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
13420 # separate values. Set to one or more of the following values:
13421 #
13422 # - VIRTIO_SCSI_MULTIQUEUE
13423 # - WINDOWS
13424 # - MULTI_IP_SUBNET
13425 # - UEFI_COMPATIBLE
13426 # - GVNIC
13427 # - SEV_CAPABLE
13428 # - SUSPEND_RESUME_COMPATIBLE
13429 # - SEV_LIVE_MIGRATABLE_V2
13430 # - SEV_SNP_CAPABLE
13431 # - TDX_CAPABLE
13432 # - IDPF
13433 # - SNP_SVSM_CAPABLE
13434 # - CCA_CAPABLE
13435 #
13436 #
13437 # For more information, see
13438 # Enabling guest operating system features.
13439 },
13440 ],
13441 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
13442 # persistent disks.
13443 &quot;a_key&quot;: &quot;A String&quot;,
13444 },
13445 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
13446 &quot;A String&quot;,
13447 ],
13448 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
13449 # more than one instance.
13450 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
13451 # is to use the existing disk.
13452 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
13453 # of I/O operations per second that the disk can handle. Values must be
13454 # between 10,000 and 120,000. For more details, see theExtreme persistent
13455 # disk documentation.
13456 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
13457 # number of throughput mb per second that the disk can handle. Values must
13458 # greater than or equal to 1.
13459 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
13460 # the URLs of the zones where the disk should be replicated to.
13461 # You must provide exactly two replica zones, and one zone must be the same
13462 # as the instance zone.
13463 &quot;A String&quot;,
13464 ],
13465 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
13466 # have the same definition as resource
13467 # manager tags. Keys and values can be either in numeric format,
13468 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
13469 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
13470 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
13471 # empty.
13472 &quot;a_key&quot;: &quot;A String&quot;,
13473 },
13474 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
13475 # Specified using the full or partial URL. For instance template, specify
13476 # only the resource policy name.
13477 &quot;A String&quot;,
13478 ],
13479 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
13480 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
13481 # is required.
13482 #
13483 # To create a disk with one of the public operating system
13484 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
13485 #
13486 # projects/debian-cloud/global/images/family/debian-9
13487 #
13488 #
13489 # Alternatively, use a specific version of a public operating system image:
13490 #
13491 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
13492 #
13493 #
13494 # To create a disk with a custom image that you created, specify the
13495 # image name in the following format:
13496 #
13497 # global/images/my-custom-image
13498 #
13499 #
13500 # You can also specify a custom image by its image family, which returns
13501 # the latest version of the image in that family. Replace the image name
13502 # with family/family-name:
13503 #
13504 # global/images/family/my-image-family
13505 #
13506 #
13507 # If the source image is deleted later, this field will not be set.
13508 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
13509 # encryption key of the source image. Required if the source image is
13510 # protected by a customer-supplied encryption key.
13511 #
13512 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
13513 # encryption keys, so you cannot create disks for instances in a managed instance group if the
13514 # source images are encrypted with your own keys.
13515 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
13516 # For example:
13517 #
13518 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13519 # key_region/cryptoKeys/key
13520 #
13521 # The fully-qualifed key name may be returned for resource GET requests. For
13522 # example:
13523 #
13524 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13525 # key_region/cryptoKeys/key
13526 # /cryptoKeyVersions/1
13527 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
13528 # key. If absent, the Compute Engine default service account is used.
13529 # For example:
13530 #
13531 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
13532 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
13533 # encryption key, encoded in RFC
13534 # 4648 base64 to either encrypt or decrypt this resource. You can
13535 # provide either the rawKey or thersaEncryptedKey.
13536 # For example:
13537 #
13538 # &quot;rawKey&quot;:
13539 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
13540 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
13541 # customer-supplied encryption key to either encrypt or decrypt this
13542 # resource. You can provide either the rawKey or thersaEncryptedKey.
13543 # For example:
13544 #
13545 # &quot;rsaEncryptedKey&quot;:
13546 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
13547 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
13548 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
13549 #
13550 # The key must meet the following requirements before you can provide it to
13551 # Compute Engine:
13552 #
13553 # 1. The key is wrapped using a RSA public key certificate provided by
13554 # Google.
13555 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
13556 # encoding.
13557 #
13558 # Gets the RSA public key certificate provided by Google at:
13559 #
13560 #
13561 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
13562 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
13563 # 4648 base64 encoded SHA-256 hash of the customer-supplied
13564 # encryption key that protects this resource.
13565 },
13566 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
13567 # instance boot disk, one of initializeParams.sourceSnapshot
13568 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
13569 # is required.
13570 #
13571 # To create a disk with a snapshot that you created, specify the
13572 # snapshot name in the following format:
13573 #
13574 # us-central1-a/instantSnapshots/my-backup
13575 #
13576 #
13577 # If the source instant-snapshot is deleted later, this field will not be
13578 # set.
13579 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
13580 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
13581 # is required.
13582 #
13583 # To create a disk with a snapshot that you created, specify the
13584 # snapshot name in the following format:
13585 #
13586 # global/snapshots/my-backup
13587 #
13588 #
13589 # If the source snapshot is deleted later, this field will not be set.
13590 #
13591 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
13592 # an image instead when you create VMs using
13593 # the bulk
13594 # insert method.
13595 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
13596 # encryption key of the source snapshot.
13597 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
13598 # For example:
13599 #
13600 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13601 # key_region/cryptoKeys/key
13602 #
13603 # The fully-qualifed key name may be returned for resource GET requests. For
13604 # example:
13605 #
13606 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
13607 # key_region/cryptoKeys/key
13608 # /cryptoKeyVersions/1
13609 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
13610 # key. If absent, the Compute Engine default service account is used.
13611 # For example:
13612 #
13613 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
13614 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
13615 # encryption key, encoded in RFC
13616 # 4648 base64 to either encrypt or decrypt this resource. You can
13617 # provide either the rawKey or thersaEncryptedKey.
13618 # For example:
13619 #
13620 # &quot;rawKey&quot;:
13621 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
13622 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
13623 # customer-supplied encryption key to either encrypt or decrypt this
13624 # resource. You can provide either the rawKey or thersaEncryptedKey.
13625 # For example:
13626 #
13627 # &quot;rsaEncryptedKey&quot;:
13628 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
13629 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
13630 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
13631 #
13632 # The key must meet the following requirements before you can provide it to
13633 # Compute Engine:
13634 #
13635 # 1. The key is wrapped using a RSA public key certificate provided by
13636 # Google.
13637 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
13638 # encoding.
13639 #
13640 # Gets the RSA public key certificate provided by Google at:
13641 #
13642 #
13643 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
13644 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
13645 # 4648 base64 encoded SHA-256 hash of the customer-supplied
13646 # encryption key that protects this resource.
13647 },
13648 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
13649 # this as a partial or full URL to the resource. For example, the following
13650 # are valid values:
13651 #
13652 #
13653 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
13654 # - projects/project/zones/zone/storagePools/storagePool
13655 # - zones/zone/storagePools/storagePool
13656 },
13657 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
13658 # either SCSI or NVME. For most machine types, the
13659 # default is SCSI. Local SSDs can use either NVME or SCSI.
13660 # In certain configurations, persistent disks can use NVMe. For more
13661 # information, seeAbout
13662 # persistent disks.
13663 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
13664 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
13665 &quot;A String&quot;,
13666 ],
13667 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
13668 # disk is not allowed to be detached from the instance, or to be used as the
13669 # source of the snapshot creation, and the image creation. The instance with
13670 # at least one locked attached disk is not allow to be used as source of
13671 # machine image creation, instant snapshot creation, and not allowed to be
13672 # deleted with --keep-disk parameter set to true for locked disks.
13673 &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
13674 # in READ_WRITE mode.
13675 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
13676 # field is set to PRESERVED if the LocalSSD data has been saved
13677 # to a persistent location by customer request. (see the
13678 # discard_local_ssd option on Stop/Suspend).
13679 # Read-only in the api.
13680 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
13681 # these are public keys which are safe to store in public
13682 &quot;dbs&quot;: [ # The Key Database (db).
13683 {
13684 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
13685 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
13686 },
13687 ],
13688 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
13689 {
13690 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
13691 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
13692 },
13693 ],
13694 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
13695 {
13696 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
13697 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
13698 },
13699 ],
13700 &quot;pk&quot;: { # The Platform Key (PK).
13701 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
13702 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
13703 },
13704 },
13705 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
13706 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
13707 # is required.
13708 #
13709 # If desired, you can also attach existing non-root persistent disks using
13710 # this property. This field is only applicable for persistent disks.
13711 #
13712 # Note that for InstanceTemplate, specify the disk name for zonal disk,
13713 # and the URL for regional disk.
13714 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
13715 },
13716 ],
13717 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
13718 &quot;A String&quot;,
13719 ],
13720 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
13721 # e.g. &#x27;Intel Ice Lake&#x27;.
13722 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
13723 # preference. MIG will first try to create a VM based on the machine-type
13724 # with lowest rank and fallback to next rank based on availability.
13725 # Machine types and instance selections with the same rank have the same
13726 # preference.
13727 },
13728 },
13729 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
13730 # create instances.
13731 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
13732 # more preemption than the minimum capacity user needs. MIG will create
13733 # only Standard VMs until it reaches standard_capacity_base and only
13734 # then will start using standard_capacity_percent_above_base to mix Spot
13735 # with Standard VMs.
13736 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
13737 # remaining percentage will use Spot VMs. The percentage applies only to
13738 # the capacity above standard_capacity_base.
13739 },
13740 },
13741 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
13742 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
13743 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
13744 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
13745 # applies to the VMs on which your application fails a health check.
13746 # Valid values are
13747 #
13748 # - REPAIR (default): MIG automatically repairs a failed VM
13749 # by recreating it. For more information, see About
13750 # repairing VMs in a MIG.
13751 # - DO_NOTHING: MIG does not repair a failed VM.
13752 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
13753 # configuration when repairing a VM. Valid options are:
13754 #
13755 #
13756 #
13757 # - NO (default): If configuration updates are available, they are not
13758 # forcefully applied during repair. Instead, configuration updates are
13759 # applied according to the group&#x27;s update policy.
13760 #
13761 # - YES: If configuration updates are available, they are applied
13762 # during repair.
13763 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
13764 # unhealthy when the application running on that VM fails a health check.
13765 # Valid values are:
13766 #
13767 # - DEFAULT_ACTION (default): MIG uses the same action
13768 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
13769 # - REPAIR: MIG automatically repairs an unhealthy VM by
13770 # recreating it.
13771 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
13772 # For more information, see
13773 # About repairing VMs in a MIG.
13774 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
13775 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
13776 # Valid values are:
13777 #
13778 # - NO (default): MIG cannot change a VM&#x27;s zone during a
13779 # repair.
13780 # - YES: MIG can select a different zone for the VM during
13781 # a repair.
13782 },
13783 },
13784 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
13785 # instance group. The group uses this template to create all new instances
13786 # in the managed instance group. The templates for existing instances in the
13787 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
13788 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
13789 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
13790 # this managed instance group.
13791 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
13792 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
13793 # long, and comply withRFC1035.
13794 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
13795 # to this Instance Group Manager.
13796 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
13797 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
13798 # The name must be 1-63 characters long, and comply withRFC1035.
13799 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
13800 },
13801 ],
13802 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
13803 # as part of resource payload.
13804 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
13805 # key-value pairs. Keys and values can be either in numeric format,
13806 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
13807 # format such as `{org_id|project_id}/{tag_key_short_name}` and
13808 # `{tag_value_short_name}`. For more information, seeManage tags
13809 # for resources.
13810 &quot;a_key&quot;: &quot;A String&quot;,
13811 },
13812 },
13813 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
13814 # where the managed instance group resides (for regional resources).
13815 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
13816 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
13817 # instance group.
13818 # It can be a full or partial URL. For example, the following are
13819 # all valid URLs to a workload policy:
13820 #
13821 #
13822 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
13823 # - projects/project/regions/region/resourcePolicies/resourcePolicy
13824 # - regions/region/resourcePolicies/resourcePolicy
13825 },
13826 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
13827 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
13828 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
13829 # this URL.
13830 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
13831 # by the managed instance group on instances. The service accounts needs all
13832 # permissions required to create and delete instances.
13833 # By default, the service account
13834 # {projectNumber}@cloudservices.gserviceaccount.com is used.
13835 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
13836 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
13837 # stop a VM after that VM was created. The initial delay gives the
13838 # initialization script the time to prepare your VM for a quick scale out.
13839 # The value of initial delay must be between 0 and 3600 seconds. The
13840 # default value is 0.
13841 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
13842 # group scales out. The default mode is `MANUAL`.
13843 },
13844 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
13845 &quot;preservedState&quot;: { # Configuration of preserved resources.
13846 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
13847 # delete, update, etc. This map is keyed with the device names of
13848 # the disks.
13849 &quot;a_key&quot;: {
13850 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
13851 # update or VM instance recreate operations.
13852 # This flag is used to configure if the disk should be deleted after it
13853 # is no longer used by the group, e.g. when the given instance or
13854 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
13855 },
13856 },
13857 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
13858 # instance delete, update, etc. This map is keyed with the network
13859 # interface name.
13860 &quot;a_key&quot;: {
13861 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
13862 # update or VM instance recreate operations.
13863 # This flag is used to configure if the IP reservation should be deleted
13864 # after it is no longer used by the group, e.g. when the given instance
13865 # or the whole group is deleted.
13866 },
13867 },
13868 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
13869 # instance delete, update, etc. This map is keyed with the network
13870 # interface name.
13871 &quot;a_key&quot;: {
13872 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
13873 # update or VM instance recreate operations.
13874 # This flag is used to configure if the IP reservation should be deleted
13875 # after it is no longer used by the group, e.g. when the given instance
13876 # or the whole group is deleted.
13877 },
13878 },
13879 },
13880 },
13881 &quot;status&quot;: { # Output only. The status of this managed instance group.
13882 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
13883 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
13884 # This value is in RFC3339 text format.
13885 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
13886 # been applied to all managed instances in the group.
13887 },
13888 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
13889 # Currently only one accelerator topology is supported.
13890 {
13891 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
13892 # The value is the same as configured in the WorkloadPolicy.
13893 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
13894 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
13895 # check.
13896 &quot;error&quot;: { # Output only. Encountered errors.
13897 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
13898 # operation.
13899 {
13900 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
13901 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
13902 # details. There is a set of defined message types to use for providing
13903 # details.The syntax depends on the error code. For example,
13904 # QuotaExceededInfo will have details when the error code is
13905 # QUOTA_EXCEEDED.
13906 {
13907 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
13908 #
13909 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
13910 # is not enabled:
13911 #
13912 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
13913 # &quot;domain&quot;: &quot;googleapis.com&quot;
13914 # &quot;metadata&quot;: {
13915 # &quot;resource&quot;: &quot;projects/123&quot;,
13916 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
13917 # }
13918 # }
13919 #
13920 # This response indicates that the pubsub.googleapis.com API is not enabled.
13921 #
13922 # Example of an error that is returned when attempting to create a Spanner
13923 # instance in a region that is out of stock:
13924 #
13925 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
13926 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
13927 # &quot;metadata&quot;: {
13928 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
13929 # }
13930 # }
13931 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
13932 # is typically the registered service name of the tool or product that
13933 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
13934 # generated by some common infrastructure, the error domain must be a
13935 # globally unique value that identifies the infrastructure. For Google API
13936 # infrastructure, the error domain is &quot;googleapis.com&quot;.
13937 &quot;metadatas&quot;: { # Additional structured details about this error.
13938 #
13939 # Keys must match a regular expression of `a-z+` but should
13940 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
13941 # length. When identifying the current value of an exceeded limit, the units
13942 # should be contained in the key, not the value. For example, rather than
13943 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
13944 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
13945 # instances that can be created in a single (batch) request.
13946 &quot;a_key&quot;: &quot;A String&quot;,
13947 },
13948 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
13949 # proximate cause of the error. Error reasons are unique within a particular
13950 # domain of errors. This should be at most 63 characters and match a
13951 # regular expression of `A-Z+[A-Z0-9]`, which represents
13952 # UPPER_SNAKE_CASE.
13953 },
13954 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
13955 #
13956 # For example, if a quota check failed with an error indicating the calling
13957 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
13958 # directly to the right place in the developer console to flip the bit.
13959 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
13960 { # Describes a URL link.
13961 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
13962 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
13963 },
13964 ],
13965 },
13966 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
13967 # which can be attached to an RPC error.
13968 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
13969 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
13970 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
13971 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
13972 },
13973 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
13974 &quot;dimensions&quot;: { # The map holding related quota dimensions.
13975 &quot;a_key&quot;: &quot;A String&quot;,
13976 },
13977 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
13978 # type or metric.
13979 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
13980 # or metric.
13981 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
13982 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
13983 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
13984 },
13985 },
13986 ],
13987 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
13988 # This property is optional.
13989 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
13990 },
13991 ],
13992 },
13993 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
13994 # has // RFC3339 //
13995 # text format.
13996 },
13997 },
13998 ],
13999 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
14000 # that targets this instance group manager.
14001 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
14002 # targetSizePolicy.mode is set to BULK.
14003 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
14004 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
14005 # operation.
14006 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
14007 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14008 # operation.
14009 {
14010 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14011 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14012 # details. There is a set of defined message types to use for providing
14013 # details.The syntax depends on the error code. For example,
14014 # QuotaExceededInfo will have details when the error code is
14015 # QUOTA_EXCEEDED.
14016 {
14017 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14018 #
14019 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14020 # is not enabled:
14021 #
14022 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14023 # &quot;domain&quot;: &quot;googleapis.com&quot;
14024 # &quot;metadata&quot;: {
14025 # &quot;resource&quot;: &quot;projects/123&quot;,
14026 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14027 # }
14028 # }
14029 #
14030 # This response indicates that the pubsub.googleapis.com API is not enabled.
14031 #
14032 # Example of an error that is returned when attempting to create a Spanner
14033 # instance in a region that is out of stock:
14034 #
14035 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14036 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14037 # &quot;metadata&quot;: {
14038 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14039 # }
14040 # }
14041 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14042 # is typically the registered service name of the tool or product that
14043 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14044 # generated by some common infrastructure, the error domain must be a
14045 # globally unique value that identifies the infrastructure. For Google API
14046 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14047 &quot;metadatas&quot;: { # Additional structured details about this error.
14048 #
14049 # Keys must match a regular expression of `a-z+` but should
14050 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14051 # length. When identifying the current value of an exceeded limit, the units
14052 # should be contained in the key, not the value. For example, rather than
14053 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14054 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14055 # instances that can be created in a single (batch) request.
14056 &quot;a_key&quot;: &quot;A String&quot;,
14057 },
14058 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14059 # proximate cause of the error. Error reasons are unique within a particular
14060 # domain of errors. This should be at most 63 characters and match a
14061 # regular expression of `A-Z+[A-Z0-9]`, which represents
14062 # UPPER_SNAKE_CASE.
14063 },
14064 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14065 #
14066 # For example, if a quota check failed with an error indicating the calling
14067 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14068 # directly to the right place in the developer console to flip the bit.
14069 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14070 { # Describes a URL link.
14071 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14072 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14073 },
14074 ],
14075 },
14076 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14077 # which can be attached to an RPC error.
14078 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14079 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14080 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14081 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14082 },
14083 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14084 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14085 &quot;a_key&quot;: &quot;A String&quot;,
14086 },
14087 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14088 # type or metric.
14089 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14090 # or metric.
14091 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14092 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14093 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14094 },
14095 },
14096 ],
14097 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14098 # This property is optional.
14099 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14100 },
14101 ],
14102 },
14103 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
14104 # operation. Timestamp is in RFC3339 text format.
14105 },
14106 },
14107 &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
14108 # in this managed instance group that have the status. Currently only shown
14109 # for TPU MIGs
14110 # instance group that have the status. For more information about how to
14111 # interpret each status check the instance lifecycle documentation.
14112 # Currently only shown for TPU MIGs.
14113 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
14114 # that have DEPROVISIONING status.
14115 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
14116 # have been deleted. Includes only instances that would be shown in the
14117 # listManagedInstances method and not all instances that have been
14118 # deleted in the lifetime of the MIG.
14119 # Does not include FlexStart instances that are waiting for the resources
14120 # availability, they are considered as &#x27;pending&#x27;.
14121 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
14122 # that have PENDING status, that is FlexStart instances that are waiting
14123 # for resources. Instances that do not exist because of the other reasons
14124 # are counted as &#x27;non_existent&#x27;.
14125 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
14126 # that have PENDING_STOP status.
14127 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
14128 # that have PROVISIONING status.
14129 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
14130 # that have REPAIRING status.
14131 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
14132 # that have RUNNING status.
14133 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
14134 # that have STAGING status.
14135 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
14136 # that have STOPPED status.
14137 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
14138 # that have STOPPING status.
14139 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
14140 # that have SUSPENDED status.
14141 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
14142 # that have SUSPENDING status.
14143 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
14144 # that have TERMINATED status.
14145 },
14146 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
14147 # stable state. A stable state means that: none of the instances in the
14148 # managed instance group is currently undergoing any type of change (for
14149 # example, creation, restart, or deletion); no future changes are scheduled
14150 # for instances in the managed instance group; and the managed instance
14151 # group itself is not being modified.
14152 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
14153 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
14154 # has stateful configuration, that is, if you have configured any items
14155 # in a stateful policy or in per-instance configs.
14156 # The group might report that it has no stateful configuration even when
14157 # there is still some preserved state on a managed instance, for example,
14158 # if you have deleted all PICs but not yet applied those deletions.
14159 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
14160 # has stateful configuration, that is, if you have configured any items
14161 # in a stateful policy or in per-instance configs.
14162 # The group might report that it has no stateful configuration even when
14163 # there is still some preserved state on a managed instance, for example,
14164 # if you have deleted all PICs but not yet applied those deletions. This
14165 # field is deprecated in favor of has_stateful_config.
14166 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
14167 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
14168 # (listed in the output of a listPerInstanceConfigs API call) have
14169 # status EFFECTIVE or there are no per-instance-configs.
14170 },
14171 },
14172 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
14173 # target version specified by version field on Instance Group
14174 # Manager.
14175 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
14176 # in this managed instance group, i.e. all instances are in their target
14177 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
14178 },
14179 },
14180 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
14181 # apply to all of the instances in the managed instance group.
14182 &quot;A String&quot;,
14183 ],
14184 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
14185 # You can reduce this number by using the instanceGroupManager
14186 # deleteInstances or abandonInstances methods. Resizing the group also
14187 # changes this number.
14188 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
14189 # size.
14190 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
14191 # individually or all at once.
14192 },
14193 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
14194 # This number changes when you:
14195 #
14196 # - Stop instance using the stopInstances
14197 # method or start instances using the startInstances
14198 # method.
14199 # - Manually change the targetStoppedSize using the update
14200 # method.
14201 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
14202 # This number changes when you:
14203 #
14204 # - Suspend instance using the suspendInstances
14205 # method or resume instances using the resumeInstances
14206 # method.
14207 # - Manually change the targetSuspendedSize using the update
14208 # method.
14209 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
14210 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
14211 &quot;A String&quot;,
14212 ],
14213 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
14214 # instance redistribution policy for regional managed instance groups.
14215 # Valid values are:
14216 #
14217 # - PROACTIVE (default): The group attempts to maintain an
14218 # even distribution of VM instances across zones in the region.
14219 # - NONE: For non-autoscaled groups, proactive
14220 # redistribution is disabled.
14221 &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
14222 # either a fixed number or, if the group has 10 or more instances, a
14223 # percentage. If you set a percentage, the number of instances is rounded
14224 # if necessary. The default value for maxSurge is a fixed
14225 # value equal to the number of zones in which the managed instance group
14226 # operates.
14227 #
14228 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
14229 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
14230 #
14231 #
14232 #
14233 # - If the value is fixed, then the calculated
14234 # value is equal to the fixed value.
14235 # - If the value is a percent, then the
14236 # calculated
14237 # value is percent/100 * targetSize. For example,
14238 # the calculated value of a 80% of a managed instance group
14239 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
14240 # is a remainder, the number is rounded.
14241 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
14242 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
14243 # example, specify 80 for 80%.
14244 },
14245 &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
14246 # process. An instance is considered available if all of the following
14247 # conditions are satisfied:
14248 #
14249 #
14250 #
14251 # - The instance&#x27;s status is
14252 # RUNNING.
14253 # - If there is a health
14254 # check on the instance group, the instance&#x27;s health check status
14255 # must be HEALTHY at least once. If there is no health check
14256 # on the group, then the instance only needs to have a status of
14257 # RUNNING to be considered available.
14258 #
14259 #
14260 # This value can be either a fixed number or, if the group has 10 or more
14261 # instances, a percentage. If you set a percentage, the number of instances
14262 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
14263 # in which the managed instance group operates.
14264 #
14265 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
14266 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
14267 #
14268 #
14269 #
14270 # - If the value is fixed, then the calculated
14271 # value is equal to the fixed value.
14272 # - If the value is a percent, then the
14273 # calculated
14274 # value is percent/100 * targetSize. For example,
14275 # the calculated value of a 80% of a managed instance group
14276 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
14277 # is a remainder, the number is rounded.
14278 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
14279 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
14280 # example, specify 80 for 80%.
14281 },
14282 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
14283 # becomes available. This value must be from range [0, 3600].
14284 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
14285 # disruption as much as possible or to apply a more disruptive action than
14286 # is necessary.
14287 #
14288 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
14289 # Compute Engine performs the necessary action to execute the update.
14290 # - To apply a more disruptive action than is strictly necessary, set the
14291 # minimal action to RESTART or REPLACE. For
14292 # example, Compute Engine does not need to restart a VM to change its
14293 # metadata. But if your application reads instance metadata only when a VM
14294 # is restarted, you can set the minimal action to RESTART in
14295 # order to pick up metadata changes.
14296 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
14297 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
14298 # as much as possible. RESTART to allow actions that can be
14299 # applied without instance replacing or REPLACE to allow all
14300 # possible actions. If the Updater determines that the minimal update
14301 # action needed is more disruptive than most disruptive allowed action you
14302 # specify it will not perform the update at all.
14303 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
14304 # See minimal_action.REPLACE
14305 &quot;type&quot;: &quot;A String&quot;, # The type
14306 # of update process. You can specify either PROACTIVE so
14307 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
14308 # to update.
14309 },
14310 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
14311 # create instances.
14312 #
14313 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
14314 # group. This field overrides the top-level instanceTemplate
14315 # field. Read more about therelationships
14316 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
14317 # remaining instances. For more information, read aboutcanary
14318 # updates.
14319 {
14320 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
14321 # instance group. The group uses this template to create new instances in
14322 # the managed instance group until the `targetSize` for this version is
14323 # reached. The templates for existing instances in the group do not change
14324 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
14325 # existing instances are updated until the `targetSize` for this version is
14326 # reached.
14327 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
14328 # managed instance group.
14329 &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
14330 # from the template will be equal to:
14331 #
14332 #
14333 # - If expressed as a fixed number, the minimum of either
14334 # targetSize.fixed or
14335 # instanceGroupManager.targetSize is used.
14336 # - if expressed as a percent, the targetSize
14337 # would be (targetSize.percent/100 *
14338 # InstanceGroupManager.targetSize) If there is a remainder, the
14339 # number is rounded.
14340 #
14341 # If unset, this version will update any remaining instances not
14342 # updated by another version. ReadStarting
14343 # a canary update for more information.
14344 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
14345 #
14346 #
14347 #
14348 # - If the value is fixed, then the calculated
14349 # value is equal to the fixed value.
14350 # - If the value is a percent, then the
14351 # calculated
14352 # value is percent/100 * targetSize. For example,
14353 # the calculated value of a 80% of a managed instance group
14354 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
14355 # is a remainder, the number is rounded.
14356 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
14357 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
14358 # example, specify 80 for 80%.
14359 },
14360 },
14361 ],
14362 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
14363 # where the managed instance group is located (for zonal resources).
14364 }
14365
14366 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14367 that if you must retry your request, the server will know to ignore the
14368 request if it has already been completed.
14369
14370 For example, consider a situation where you make an initial request and
14371 the request times out. If you make the request again with the same
14372 request ID, the server can check if original operation with the same
14373 request ID was received, and if so, will ignore the second request. This
14374 prevents clients from accidentally creating duplicate commitments.
14375
14376 The request ID must be
14377 a valid UUID with the exception that zero UUID is not supported
14378 (00000000-0000-0000-0000-000000000000).
14379 x__xgafv: string, V1 error format.
14380 Allowed values
14381 1 - v1 error format
14382 2 - v2 error format
14383
14384 Returns:
14385 An object of the form:
14386
14387 { # Represents an Operation resource.
14388 #
14389 # Google Compute Engine has three Operation resources:
14390 #
14391 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
14392 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
14393 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
14394 #
14395 # You can use an operation resource to manage asynchronous API requests.
14396 # For more information, readHandling
14397 # API responses.
14398 #
14399 # Operations can be global, regional or zonal.
14400 #
14401 # - For global operations, use the `globalOperations`
14402 # resource.
14403 # - For regional operations, use the
14404 # `regionOperations` resource.
14405 # - For zonal operations, use
14406 # the `zoneOperations` resource.
14407 #
14408 #
14409 #
14410 # For more information, read
14411 # Global, Regional, and Zonal Resources.
14412 #
14413 # Note that completed Operation resources have a limited
14414 # retention period.
14415 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14416 # Not present otherwise.
14417 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14418 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14419 # set when the operation is created.
14420 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14421 # text format.
14422 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14423 # this field will be populated.
14424 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14425 # operation.
14426 {
14427 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14428 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14429 # details. There is a set of defined message types to use for providing
14430 # details.The syntax depends on the error code. For example,
14431 # QuotaExceededInfo will have details when the error code is
14432 # QUOTA_EXCEEDED.
14433 {
14434 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14435 #
14436 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14437 # is not enabled:
14438 #
14439 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14440 # &quot;domain&quot;: &quot;googleapis.com&quot;
14441 # &quot;metadata&quot;: {
14442 # &quot;resource&quot;: &quot;projects/123&quot;,
14443 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14444 # }
14445 # }
14446 #
14447 # This response indicates that the pubsub.googleapis.com API is not enabled.
14448 #
14449 # Example of an error that is returned when attempting to create a Spanner
14450 # instance in a region that is out of stock:
14451 #
14452 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14453 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14454 # &quot;metadata&quot;: {
14455 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14456 # }
14457 # }
14458 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14459 # is typically the registered service name of the tool or product that
14460 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14461 # generated by some common infrastructure, the error domain must be a
14462 # globally unique value that identifies the infrastructure. For Google API
14463 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14464 &quot;metadatas&quot;: { # Additional structured details about this error.
14465 #
14466 # Keys must match a regular expression of `a-z+` but should
14467 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14468 # length. When identifying the current value of an exceeded limit, the units
14469 # should be contained in the key, not the value. For example, rather than
14470 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14471 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14472 # instances that can be created in a single (batch) request.
14473 &quot;a_key&quot;: &quot;A String&quot;,
14474 },
14475 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14476 # proximate cause of the error. Error reasons are unique within a particular
14477 # domain of errors. This should be at most 63 characters and match a
14478 # regular expression of `A-Z+[A-Z0-9]`, which represents
14479 # UPPER_SNAKE_CASE.
14480 },
14481 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14482 #
14483 # For example, if a quota check failed with an error indicating the calling
14484 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14485 # directly to the right place in the developer console to flip the bit.
14486 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14487 { # Describes a URL link.
14488 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14489 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14490 },
14491 ],
14492 },
14493 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14494 # which can be attached to an RPC error.
14495 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14496 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14497 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14498 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14499 },
14500 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14501 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14502 &quot;a_key&quot;: &quot;A String&quot;,
14503 },
14504 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14505 # type or metric.
14506 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14507 # or metric.
14508 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14509 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14510 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14511 },
14512 },
14513 ],
14514 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14515 # This property is optional.
14516 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14517 },
14518 ],
14519 },
14520 &quot;getVersionOperationMetadata&quot;: {
14521 &quot;inlineSbomInfo&quot;: {
14522 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14523 # appropriate identifiers.
14524 &quot;a_key&quot;: &quot;A String&quot;,
14525 },
14526 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14527 # identifiers.
14528 &quot;a_key&quot;: &quot;A String&quot;,
14529 },
14530 },
14531 },
14532 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14533 # message that was returned, such as `NOT FOUND`.
14534 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14535 # status code that was returned. For example, a `404` means the
14536 # resource was not found.
14537 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14538 # defined by the server.
14539 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14540 # This value is inRFC3339
14541 # text format.
14542 &quot;instancesBulkInsertOperationMetadata&quot;: {
14543 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14544 # Example key: zones/us-central1-a
14545 &quot;a_key&quot;: {
14546 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14547 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14548 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14549 # error.
14550 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14551 # if the flow is rolling forward or rolling back.
14552 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14553 },
14554 },
14555 },
14556 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
14557 # Operation resources.
14558 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
14559 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
14560 # group of operations results from a `bulkInsert` API request.
14561 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
14562 # `update`, or `delete`, and so on.
14563 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
14564 # There is no requirement that this be linear or support any granularity of
14565 # operations. This should not be used to guess when the operation will be
14566 # complete. This number should monotonically increase as the operation
14567 # progresses.
14568 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
14569 # applicable when performing regional operations.
14570 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
14571 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
14572 # this field will contain information on all underlying zonal actions and
14573 # their state.
14574 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
14575 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
14576 # Example key: zones/us-central1-a
14577 &quot;a_key&quot;: {
14578 &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
14579 # populated.
14580 # different programming environments, including REST APIs and RPC APIs. It is
14581 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
14582 # three pieces of data: error code, error message, and error details.
14583 #
14584 # You can find out more about this error model and how to work with it in the
14585 # [API Design Guide](https://cloud.google.com/apis/design/errors).
14586 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
14587 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
14588 # message types for APIs to use.
14589 {
14590 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
14591 },
14592 ],
14593 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
14594 # user-facing error message should be localized and sent in the
14595 # google.rpc.Status.details field, or localized by the client.
14596 },
14597 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
14598 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
14599 },
14600 },
14601 },
14602 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
14603 # This value is inRFC3339
14604 # text format.
14605 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
14606 # following:
14607 # `PENDING`, `RUNNING`, or `DONE`.
14608 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
14609 # operation.
14610 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
14611 # of the target resource.
14612 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
14613 # operations related to creating a snapshot, this points to the disk
14614 # that the snapshot was created from.
14615 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
14616 # `[email protected]` or
14617 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
14618 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
14619 # operation, this field will be populated.
14620 {
14621 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
14622 # Engine returns NO_RESULTS_ON_PAGE if there
14623 # are no results in the response.
14624 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
14625 # value format. For example:
14626 #
14627 # &quot;data&quot;: [
14628 # {
14629 # &quot;key&quot;: &quot;scope&quot;,
14630 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
14631 # }
14632 {
14633 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
14634 # returned. For example, for warnings where there are no results in a list
14635 # request for a particular zone, this key might be scope and
14636 # the key value might be the zone name. Other examples might be a key
14637 # indicating a deprecated resource and a suggested replacement, or a
14638 # warning about invalid network settings (for example, if an instance
14639 # attempts to perform IP forwarding but is not enabled for IP forwarding).
14640 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
14641 },
14642 ],
14643 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
14644 },
14645 ],
14646 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
14647 # applicable when performing per-zone operations.
14648 }</pre>
14649 </div>
14650
14651 <div class="method">
14652 <code class="details" id="updatePerInstanceConfigs">updatePerInstanceConfigs(project, region, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
14653 <pre>Inserts or updates per-instance configurations for the managed instance
14654 group. perInstanceConfig.name serves as a key used to
14655 distinguish whether to perform insert or patch.
14656
14657 Args:
14658 project: string, Project ID for this request. (required)
14659 region: string, Name of the region scoping this request, should conform to RFC1035. (required)
14660 instanceGroupManager: string, The name of the managed instance group.
14661 It should conform to RFC1035. (required)
14662 body: object, The request body.
14663 The object takes the form of:
14664
14665 { # RegionInstanceGroupManagers.updatePerInstanceConfigs
14666 &quot;perInstanceConfigs&quot;: [ # The list of per-instance configurations to insert or patch on this managed
14667 # instance group.
14668 {
14669 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
14670 # optimistic locking. It is ignored when inserting a per-instance
14671 # config. An up-to-date fingerprint must be provided in order to update an
14672 # existing per-instance configuration or the field needs to be unset.
14673 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
14674 # Serves as a merge key during UpdatePerInstanceConfigs
14675 # operations, that is, if a per-instance configuration with the same name
14676 # exists then it will be updated, otherwise a new one will be created for the
14677 # VM instance with the same name. An attempt to create a per-instance
14678 # configuration for a VM instance that either doesn&#x27;t exist or is not part
14679 # of the group will result in an error.
14680 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
14681 # preserved state generated from a stateful policy.
14682 &quot;disks&quot;: { # Preserved disks defined for this instance.
14683 # This map is keyed with the device names of the disks.
14684 &quot;a_key&quot;: {
14685 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
14686 # update, instance recreate operations. This flag is used to configure
14687 # if the disk should be deleted after it is no longer used by the group,
14688 # e.g. when the given instance or the whole MIG is deleted.
14689 # Note: disks attached in READ_ONLY mode cannot be
14690 # auto-deleted.
14691 &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
14692 # disk in READ_WRITE mode.
14693 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
14694 # to the VM instance.
14695 },
14696 },
14697 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
14698 # This map is keyed with the name of the network interface.
14699 &quot;a_key&quot;: {
14700 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
14701 # update or VM instance recreate operations.
14702 # This flag is used to configure if the IP reservation should be deleted
14703 # after it is no longer used by the group, e.g. when the given instance
14704 # or the whole group is deleted.
14705 &quot;ipAddress&quot;: { # Ip address representation
14706 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
14707 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
14708 # network interface.
14709 },
14710 },
14711 },
14712 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
14713 # This map is keyed with the name of the network interface.
14714 &quot;a_key&quot;: {
14715 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
14716 # update or VM instance recreate operations.
14717 # This flag is used to configure if the IP reservation should be deleted
14718 # after it is no longer used by the group, e.g. when the given instance
14719 # or the whole group is deleted.
14720 &quot;ipAddress&quot;: { # Ip address representation
14721 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
14722 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
14723 # network interface.
14724 },
14725 },
14726 },
14727 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
14728 &quot;a_key&quot;: &quot;A String&quot;,
14729 },
14730 },
14731 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
14732 # managed instance.
14733 },
14734 ],
14735 }
14736
14737 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14738 that if you must retry your request, the server will know to ignore the
14739 request if it has already been completed.
14740
14741 For example, consider a situation where you make an initial request and
14742 the request times out. If you make the request again with the same
14743 request ID, the server can check if original operation with the same
14744 request ID was received, and if so, will ignore the second request. This
14745 prevents clients from accidentally creating duplicate commitments.
14746
14747 The request ID must be
14748 a valid UUID with the exception that zero UUID is not supported
14749 (00000000-0000-0000-0000-000000000000).
14750 x__xgafv: string, V1 error format.
14751 Allowed values
14752 1 - v1 error format
14753 2 - v2 error format
14754
14755 Returns:
14756 An object of the form:
14757
14758 { # Represents an Operation resource.
14759 #
14760 # Google Compute Engine has three Operation resources:
14761 #
14762 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
14763 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
14764 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
14765 #
14766 # You can use an operation resource to manage asynchronous API requests.
14767 # For more information, readHandling
14768 # API responses.
14769 #
14770 # Operations can be global, regional or zonal.
14771 #
14772 # - For global operations, use the `globalOperations`
14773 # resource.
14774 # - For regional operations, use the
14775 # `regionOperations` resource.
14776 # - For zonal operations, use
14777 # the `zoneOperations` resource.
14778 #
14779 #
14780 #
14781 # For more information, read
14782 # Global, Regional, and Zonal Resources.
14783 #
14784 # Note that completed Operation resources have a limited
14785 # retention period.
14786 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14787 # Not present otherwise.
14788 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14789 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14790 # set when the operation is created.
14791 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14792 # text format.
14793 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14794 # this field will be populated.
14795 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14796 # operation.
14797 {
14798 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14799 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14800 # details. There is a set of defined message types to use for providing
14801 # details.The syntax depends on the error code. For example,
14802 # QuotaExceededInfo will have details when the error code is
14803 # QUOTA_EXCEEDED.
14804 {
14805 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14806 #
14807 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14808 # is not enabled:
14809 #
14810 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14811 # &quot;domain&quot;: &quot;googleapis.com&quot;
14812 # &quot;metadata&quot;: {
14813 # &quot;resource&quot;: &quot;projects/123&quot;,
14814 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14815 # }
14816 # }
14817 #
14818 # This response indicates that the pubsub.googleapis.com API is not enabled.
14819 #
14820 # Example of an error that is returned when attempting to create a Spanner
14821 # instance in a region that is out of stock:
14822 #
14823 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14824 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14825 # &quot;metadata&quot;: {
14826 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14827 # }
14828 # }
14829 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14830 # is typically the registered service name of the tool or product that
14831 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14832 # generated by some common infrastructure, the error domain must be a
14833 # globally unique value that identifies the infrastructure. For Google API
14834 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14835 &quot;metadatas&quot;: { # Additional structured details about this error.
14836 #
14837 # Keys must match a regular expression of `a-z+` but should
14838 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14839 # length. When identifying the current value of an exceeded limit, the units
14840 # should be contained in the key, not the value. For example, rather than
14841 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14842 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14843 # instances that can be created in a single (batch) request.
14844 &quot;a_key&quot;: &quot;A String&quot;,
14845 },
14846 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14847 # proximate cause of the error. Error reasons are unique within a particular
14848 # domain of errors. This should be at most 63 characters and match a
14849 # regular expression of `A-Z+[A-Z0-9]`, which represents
14850 # UPPER_SNAKE_CASE.
14851 },
14852 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14853 #
14854 # For example, if a quota check failed with an error indicating the calling
14855 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14856 # directly to the right place in the developer console to flip the bit.
14857 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14858 { # Describes a URL link.
14859 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14860 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14861 },
14862 ],
14863 },
14864 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14865 # which can be attached to an RPC error.
14866 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14867 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14868 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14869 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14870 },
14871 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14872 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14873 &quot;a_key&quot;: &quot;A String&quot;,
14874 },
14875 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14876 # type or metric.
14877 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14878 # or metric.
14879 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14880 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14881 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14882 },
14883 },
14884 ],
14885 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14886 # This property is optional.
14887 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14888 },
14889 ],
14890 },
14891 &quot;getVersionOperationMetadata&quot;: {
14892 &quot;inlineSbomInfo&quot;: {
14893 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14894 # appropriate identifiers.
14895 &quot;a_key&quot;: &quot;A String&quot;,
14896 },
14897 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14898 # identifiers.
14899 &quot;a_key&quot;: &quot;A String&quot;,
14900 },
14901 },
14902 },
14903 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14904 # message that was returned, such as `NOT FOUND`.
14905 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14906 # status code that was returned. For example, a `404` means the
14907 # resource was not found.
14908 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14909 # defined by the server.
14910 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14911 # This value is inRFC3339
14912 # text format.
14913 &quot;instancesBulkInsertOperationMetadata&quot;: {
14914 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14915 # Example key: zones/us-central1-a
14916 &quot;a_key&quot;: {
14917 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14918 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14919 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14920 # error.
14921 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14922 # if the flow is rolling forward or rolling back.
14923 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14924 },
14925 },
14926 },
14927 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
14928 # Operation resources.
14929 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
14930 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
14931 # group of operations results from a `bulkInsert` API request.
14932 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
14933 # `update`, or `delete`, and so on.
14934 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
14935 # There is no requirement that this be linear or support any granularity of
14936 # operations. This should not be used to guess when the operation will be
14937 # complete. This number should monotonically increase as the operation
14938 # progresses.
14939 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
14940 # applicable when performing regional operations.
14941 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
14942 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
14943 # this field will contain information on all underlying zonal actions and
14944 # their state.
14945 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
14946 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
14947 # Example key: zones/us-central1-a
14948 &quot;a_key&quot;: {
14949 &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
14950 # populated.
14951 # different programming environments, including REST APIs and RPC APIs. It is
14952 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
14953 # three pieces of data: error code, error message, and error details.
14954 #
14955 # You can find out more about this error model and how to work with it in the
14956 # [API Design Guide](https://cloud.google.com/apis/design/errors).
14957 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
14958 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
14959 # message types for APIs to use.
14960 {
14961 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
14962 },
14963 ],
14964 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
14965 # user-facing error message should be localized and sent in the
14966 # google.rpc.Status.details field, or localized by the client.
14967 },
14968 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
14969 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
14970 },
14971 },
14972 },
14973 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
14974 # This value is inRFC3339
14975 # text format.
14976 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
14977 # following:
14978 # `PENDING`, `RUNNING`, or `DONE`.
14979 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
14980 # operation.
14981 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
14982 # of the target resource.
14983 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
14984 # operations related to creating a snapshot, this points to the disk
14985 # that the snapshot was created from.
14986 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
14987 # `[email protected]` or
14988 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
14989 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
14990 # operation, this field will be populated.
14991 {
14992 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
14993 # Engine returns NO_RESULTS_ON_PAGE if there
14994 # are no results in the response.
14995 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
14996 # value format. For example:
14997 #
14998 # &quot;data&quot;: [
14999 # {
15000 # &quot;key&quot;: &quot;scope&quot;,
15001 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
15002 # }
15003 {
15004 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
15005 # returned. For example, for warnings where there are no results in a list
15006 # request for a particular zone, this key might be scope and
15007 # the key value might be the zone name. Other examples might be a key
15008 # indicating a deprecated resource and a suggested replacement, or a
15009 # warning about invalid network settings (for example, if an instance
15010 # attempts to perform IP forwarding but is not enabled for IP forwarding).
15011 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
15012 },
15013 ],
15014 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
15015 },
15016 ],
15017 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
15018 # applicable when performing per-zone operations.
15019 }</pre>
15020 </div>
15021
15022 </body></html>