Debian Codegraph @

docs/dyn/compute_beta.instanceGroupManagers.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.instanceGroupManagers.html">instanceGroupManagers</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#abandonInstances">abandonInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Flags the specified instances to be removed from the</p>
80 <p class="toc_element">
81 <code><a href="#aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Retrieves the list of managed instance groups and groups them by zone.</p>
83 <p class="toc_element">
84 <code><a href="#aggregatedList_next">aggregatedList_next()</a></code></p>
85 <p class="firstline">Retrieves the next page of results.</p>
86 <p class="toc_element">
87 <code><a href="#applyUpdatesToInstances">applyUpdatesToInstances(project, zone, instanceGroupManager, body=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Applies changes to selected instances on the managed instance group.</p>
89 <p class="toc_element">
90 <code><a href="#close">close()</a></code></p>
91 <p class="firstline">Close httplib2 connections.</p>
92 <p class="toc_element">
93 <code><a href="#configureAcceleratorTopologies">configureAcceleratorTopologies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
94 <p class="firstline">Updates the accelerator topologies configuration.</p>
95 <p class="toc_element">
96 <code><a href="#createInstances">createInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Creates instances with per-instance configurations in this managed instance</p>
98 <p class="toc_element">
99 <code><a href="#delete">delete(project, zone, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Deletes the specified managed instance group and all of the instances</p>
101 <p class="toc_element">
102 <code><a href="#deleteInstances">deleteInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
103 <p class="firstline">Flags the specified instances in the managed instance group for immediate</p>
104 <p class="toc_element">
105 <code><a href="#deletePerInstanceConfigs">deletePerInstanceConfigs(project, zone, instanceGroupManager, body=None, x__xgafv=None)</a></code></p>
106 <p class="firstline">Deletes selected per-instance configurations for the managed instance</p>
107 <p class="toc_element">
108 <code><a href="#get">get(project, zone, instanceGroupManager, x__xgafv=None)</a></code></p>
109 <p class="firstline">Returns all of the details about the specified managed instance group.</p>
110 <p class="toc_element">
111 <code><a href="#getAvailableAcceleratorTopologies">getAvailableAcceleratorTopologies(project, zone, resourceId, x__xgafv=None)</a></code></p>
112 <p class="firstline">Returns information about available accelerator topologies for a given MIG.</p>
113 <p class="toc_element">
114 <code><a href="#insert">insert(project, zone, body=None, requestId=None, x__xgafv=None)</a></code></p>
115 <p class="firstline">Creates a managed instance group using the information that you specify</p>
116 <p class="toc_element">
117 <code><a href="#list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
118 <p class="firstline">Retrieves a list of managed instance groups that are contained within the</p>
119 <p class="toc_element">
120 <code><a href="#listErrors">listErrors(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
121 <p class="firstline">Lists all errors thrown by actions on instances for a given managed</p>
122 <p class="toc_element">
123 <code><a href="#listErrors_next">listErrors_next()</a></code></p>
124 <p class="firstline">Retrieves the next page of results.</p>
125 <p class="toc_element">
126 <code><a href="#listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
127 <p class="firstline">Lists all of the instances in the managed instance group. Each instance</p>
128 <p class="toc_element">
129 <code><a href="#listManagedInstances_next">listManagedInstances_next()</a></code></p>
130 <p class="firstline">Retrieves the next page of results.</p>
131 <p class="toc_element">
132 <code><a href="#listPerInstanceConfigs">listPerInstanceConfigs(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
133 <p class="firstline">Lists all of the per-instance configurations defined for the managed</p>
134 <p class="toc_element">
135 <code><a href="#listPerInstanceConfigs_next">listPerInstanceConfigs_next()</a></code></p>
136 <p class="firstline">Retrieves the next page of results.</p>
137 <p class="toc_element">
138 <code><a href="#list_next">list_next()</a></code></p>
139 <p class="firstline">Retrieves the next page of results.</p>
140 <p class="toc_element">
141 <code><a href="#patch">patch(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
142 <p class="firstline">Updates a managed instance group using the information that you specify</p>
143 <p class="toc_element">
144 <code><a href="#patchPerInstanceConfigs">patchPerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
145 <p class="firstline">Inserts or patches per-instance configurations for the managed instance</p>
146 <p class="toc_element">
147 <code><a href="#recreateInstances">recreateInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
148 <p class="firstline">Flags the specified VM instances in the managed instance group to be</p>
149 <p class="toc_element">
150 <code><a href="#resize">resize(project, zone, instanceGroupManager, size, requestId=None, x__xgafv=None)</a></code></p>
151 <p class="firstline">Resizes the managed instance group. If you increase the size, the group</p>
152 <p class="toc_element">
153 <code><a href="#resizeAdvanced">resizeAdvanced(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
154 <p class="firstline">Resizes the managed instance group with advanced configuration options like</p>
155 <p class="toc_element">
156 <code><a href="#resumeInstances">resumeInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
157 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
158 <p class="toc_element">
159 <code><a href="#setAutoHealingPolicies">setAutoHealingPolicies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
160 <p class="firstline">Motifies the autohealing policy for the instances in this managed</p>
161 <p class="toc_element">
162 <code><a href="#setInstanceTemplate">setInstanceTemplate(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
163 <p class="firstline">Specifies the instance template to use when creating new instances in this</p>
164 <p class="toc_element">
165 <code><a href="#setTargetPools">setTargetPools(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
166 <p class="firstline">Modifies the target pools to which all instances in this managed instance</p>
167 <p class="toc_element">
168 <code><a href="#startInstances">startInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
169 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
170 <p class="toc_element">
171 <code><a href="#stopInstances">stopInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</a></code></p>
172 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
173 <p class="toc_element">
174 <code><a href="#suspendInstances">suspendInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
175 <p class="firstline">Flags the specified instances in the managed instance group to be</p>
176 <p class="toc_element">
177 <code><a href="#testIamPermissions">testIamPermissions(project, zone, resource, body=None, x__xgafv=None)</a></code></p>
178 <p class="firstline">Returns permissions that a caller has on the specified resource.</p>
179 <p class="toc_element">
180 <code><a href="#update">update(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
181 <p class="firstline">Updates a managed instance group using the information that you specify</p>
182 <p class="toc_element">
183 <code><a href="#updatePerInstanceConfigs">updatePerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
184 <p class="firstline">Inserts or updates per-instance configurations for the managed instance</p>
185 <h3>Method Details</h3>
186 <div class="method">
187 <code class="details" id="abandonInstances">abandonInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
188 <pre>Flags the specified instances to be removed from the
189 managed instance group. Abandoning an instance does not delete the
190 instance, but it does remove the instance from any target pools that are
191 applied by the managed instance group. This method reduces thetargetSize of the managed instance group by the
192 number of instances that you abandon. This operation is marked asDONE when the action is scheduled even if the instances have
193 not yet been removed from the group. You must separately verify the
194 status of the abandoning action with thelistmanagedinstances
195 method.
196
197 If the group is part of a backend
198 service that has enabled
199 connection draining, it can take up to 60 seconds after the connection
200 draining duration has elapsed before the VM instance is removed or deleted.
201
202 You can specify a maximum of 1000 instances with this method per request.
203
204 Args:
205 project: string, Project ID for this request. (required)
206 zone: string, The name of thezone where the managed
207 instance group is located. (required)
208 instanceGroupManager: string, The name of the managed instance group. (required)
209 body: object, The request body.
210 The object takes the form of:
211
212 {
213 &quot;instances&quot;: [ # The URLs of one or more instances to abandon. This can be a full URL or
214 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
215 &quot;A String&quot;,
216 ],
217 }
218
219 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
220 that if you must retry your request, the server will know to ignore the
221 request if it has already been completed.
222
223 For example, consider a situation where you make an initial request and
224 the request times out. If you make the request again with the same
225 request ID, the server can check if original operation with the same
226 request ID was received, and if so, will ignore the second request. This
227 prevents clients from accidentally creating duplicate commitments.
228
229 The request ID must be
230 a valid UUID with the exception that zero UUID is not supported
231 (00000000-0000-0000-0000-000000000000).
232 x__xgafv: string, V1 error format.
233 Allowed values
234 1 - v1 error format
235 2 - v2 error format
236
237 Returns:
238 An object of the form:
239
240 { # Represents an Operation resource.
241 #
242 # Google Compute Engine has three Operation resources:
243 #
244 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
245 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
246 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
247 #
248 # You can use an operation resource to manage asynchronous API requests.
249 # For more information, readHandling
250 # API responses.
251 #
252 # Operations can be global, regional or zonal.
253 #
254 # - For global operations, use the `globalOperations`
255 # resource.
256 # - For regional operations, use the
257 # `regionOperations` resource.
258 # - For zonal operations, use
259 # the `zoneOperations` resource.
260 #
261 #
262 #
263 # For more information, read
264 # Global, Regional, and Zonal Resources.
265 #
266 # Note that completed Operation resources have a limited
267 # retention period.
268 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
269 # Not present otherwise.
270 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
271 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
272 # set when the operation is created.
273 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
274 # text format.
275 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
276 # this field will be populated.
277 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
278 # operation.
279 {
280 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
281 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
282 # details. There is a set of defined message types to use for providing
283 # details.The syntax depends on the error code. For example,
284 # QuotaExceededInfo will have details when the error code is
285 # QUOTA_EXCEEDED.
286 {
287 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
288 #
289 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
290 # is not enabled:
291 #
292 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
293 # &quot;domain&quot;: &quot;googleapis.com&quot;
294 # &quot;metadata&quot;: {
295 # &quot;resource&quot;: &quot;projects/123&quot;,
296 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
297 # }
298 # }
299 #
300 # This response indicates that the pubsub.googleapis.com API is not enabled.
301 #
302 # Example of an error that is returned when attempting to create a Spanner
303 # instance in a region that is out of stock:
304 #
305 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
306 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
307 # &quot;metadata&quot;: {
308 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
309 # }
310 # }
311 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
312 # is typically the registered service name of the tool or product that
313 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
314 # generated by some common infrastructure, the error domain must be a
315 # globally unique value that identifies the infrastructure. For Google API
316 # infrastructure, the error domain is &quot;googleapis.com&quot;.
317 &quot;metadatas&quot;: { # Additional structured details about this error.
318 #
319 # Keys must match a regular expression of `a-z+` but should
320 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
321 # length. When identifying the current value of an exceeded limit, the units
322 # should be contained in the key, not the value. For example, rather than
323 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
324 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
325 # instances that can be created in a single (batch) request.
326 &quot;a_key&quot;: &quot;A String&quot;,
327 },
328 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
329 # proximate cause of the error. Error reasons are unique within a particular
330 # domain of errors. This should be at most 63 characters and match a
331 # regular expression of `A-Z+[A-Z0-9]`, which represents
332 # UPPER_SNAKE_CASE.
333 },
334 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
335 #
336 # For example, if a quota check failed with an error indicating the calling
337 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
338 # directly to the right place in the developer console to flip the bit.
339 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
340 { # Describes a URL link.
341 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
342 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
343 },
344 ],
345 },
346 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
347 # which can be attached to an RPC error.
348 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
349 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
350 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
351 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
352 },
353 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
354 &quot;dimensions&quot;: { # The map holding related quota dimensions.
355 &quot;a_key&quot;: &quot;A String&quot;,
356 },
357 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
358 # type or metric.
359 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
360 # or metric.
361 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
362 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
363 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
364 },
365 },
366 ],
367 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
368 # This property is optional.
369 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
370 },
371 ],
372 },
373 &quot;getVersionOperationMetadata&quot;: {
374 &quot;inlineSbomInfo&quot;: {
375 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
376 # appropriate identifiers.
377 &quot;a_key&quot;: &quot;A String&quot;,
378 },
379 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
380 # identifiers.
381 &quot;a_key&quot;: &quot;A String&quot;,
382 },
383 },
384 },
385 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
386 # message that was returned, such as `NOT FOUND`.
387 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
388 # status code that was returned. For example, a `404` means the
389 # resource was not found.
390 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
391 # defined by the server.
392 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
393 # This value is inRFC3339
394 # text format.
395 &quot;instancesBulkInsertOperationMetadata&quot;: {
396 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
397 # Example key: zones/us-central1-a
398 &quot;a_key&quot;: {
399 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
400 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
401 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
402 # error.
403 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
404 # if the flow is rolling forward or rolling back.
405 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
406 },
407 },
408 },
409 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
410 # Operation resources.
411 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
412 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
413 # group of operations results from a `bulkInsert` API request.
414 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
415 # `update`, or `delete`, and so on.
416 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
417 # There is no requirement that this be linear or support any granularity of
418 # operations. This should not be used to guess when the operation will be
419 # complete. This number should monotonically increase as the operation
420 # progresses.
421 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
422 # applicable when performing regional operations.
423 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
424 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
425 # this field will contain information on all underlying zonal actions and
426 # their state.
427 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
428 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
429 # Example key: zones/us-central1-a
430 &quot;a_key&quot;: {
431 &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
432 # populated.
433 # different programming environments, including REST APIs and RPC APIs. It is
434 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
435 # three pieces of data: error code, error message, and error details.
436 #
437 # You can find out more about this error model and how to work with it in the
438 # [API Design Guide](https://cloud.google.com/apis/design/errors).
439 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
440 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
441 # message types for APIs to use.
442 {
443 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
444 },
445 ],
446 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
447 # user-facing error message should be localized and sent in the
448 # google.rpc.Status.details field, or localized by the client.
449 },
450 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
451 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
452 },
453 },
454 },
455 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
456 # This value is inRFC3339
457 # text format.
458 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
459 # following:
460 # `PENDING`, `RUNNING`, or `DONE`.
461 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
462 # operation.
463 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
464 # of the target resource.
465 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
466 # operations related to creating a snapshot, this points to the disk
467 # that the snapshot was created from.
468 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
469 # `[email protected]` or
470 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
471 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
472 # operation, this field will be populated.
473 {
474 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
475 # Engine returns NO_RESULTS_ON_PAGE if there
476 # are no results in the response.
477 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
478 # value format. For example:
479 #
480 # &quot;data&quot;: [
481 # {
482 # &quot;key&quot;: &quot;scope&quot;,
483 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
484 # }
485 {
486 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
487 # returned. For example, for warnings where there are no results in a list
488 # request for a particular zone, this key might be scope and
489 # the key value might be the zone name. Other examples might be a key
490 # indicating a deprecated resource and a suggested replacement, or a
491 # warning about invalid network settings (for example, if an instance
492 # attempts to perform IP forwarding but is not enabled for IP forwarding).
493 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
494 },
495 ],
496 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
497 },
498 ],
499 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
500 # applicable when performing per-zone operations.
501 }</pre>
502 </div>
503
504 <div class="method">
505 <code class="details" id="aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</code>
506 <pre>Retrieves the list of managed instance groups and groups them by zone.
507
508 To prevent failure, Google recommends that you set the
509 `returnPartialSuccess` parameter to `true`.
510
511 Args:
512 project: string, Project ID for this request. (required)
513 filter: string, A filter expression that filters resources listed in the response. Most
514 Compute resources support two types of filter expressions:
515 expressions that support regular expressions and expressions that follow
516 API improvement proposal AIP-160.
517 These two types of filter expressions cannot be mixed in one request.
518
519 If you want to use AIP-160, your expression must specify the field name, an
520 operator, and the value that you want to use for filtering. The value
521 must be a string, a number, or a boolean. The operator
522 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
523
524 For example, if you are filtering Compute Engine instances, you can
525 exclude instances named `example-instance` by specifying
526 `name != example-instance`.
527
528 The `:*` comparison can be used to test whether a key has been defined.
529 For example, to find all objects with `owner` label use:
530 ```
531 labels.owner:*
532 ```
533
534 You can also filter nested fields. For example, you could specify
535 `scheduling.automaticRestart = false` to include instances only
536 if they are not scheduled for automatic restarts. You can use filtering
537 on nested fields to filter based onresource labels.
538
539 To filter on multiple expressions, provide each separate expression within
540 parentheses. For example:
541 ```
542 (scheduling.automaticRestart = true)
543 (cpuPlatform = &quot;Intel Skylake&quot;)
544 ```
545 By default, each expression is an `AND` expression. However, you
546 can include `AND` and `OR` expressions explicitly.
547 For example:
548 ```
549 (cpuPlatform = &quot;Intel Skylake&quot;) OR
550 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
551 (scheduling.automaticRestart = true)
552 ```
553
554 If you want to use a regular expression, use the `eq` (equal) or `ne`
555 (not equal) operator against a single un-parenthesized expression with or
556 without quotes or against multiple parenthesized expressions. Examples:
557
558 `fieldname eq unquoted literal`
559 `fieldname eq &#x27;single quoted literal&#x27;`
560 `fieldname eq &quot;double quoted literal&quot;`
561 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
562
563 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
564 The literal value must match the entire field.
565
566 For example, to filter for instances that do not end with name &quot;instance&quot;,
567 you would use `name ne .*instance`.
568
569 You cannot combine constraints on multiple fields using regular
570 expressions.
571 includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region,
572 global) should be included in the response. For new resource types added
573 after this field, the flag has no effect as new resource types will always
574 include every visible scope for each scope type in response. For resource
575 types which predate this field, if this flag is omitted or false, only
576 scopes of the scope types where the resource type is expected to be found
577 will be included.
578 maxResults: integer, The maximum number of results per page that should be returned.
579 If the number of available results is larger than `maxResults`,
580 Compute Engine returns a `nextPageToken` that can be used to get
581 the next page of results in subsequent list requests. Acceptable values are
582 `0` to `500`, inclusive. (Default: `500`)
583 orderBy: string, Sorts list results by a certain order. By default, results
584 are returned in alphanumerical order based on the resource name.
585
586 You can also sort results in descending order based on the creation
587 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
588 results based on the `creationTimestamp` field in
589 reverse chronological order (newest result first). Use this to sort
590 resources like operations so that the newest operation is returned first.
591
592 Currently, only sorting by `name` or
593 `creationTimestamp desc` is supported.
594 pageToken: string, Specifies a page token to use. Set `pageToken` to the
595 `nextPageToken` returned by a previous list request to get
596 the next page of results.
597 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
598 of failure. The default value is false.
599
600 For example, when partial success behavior is enabled, aggregatedList for a
601 single zone scope either returns all resources in the zone or no resources,
602 with an error code.
603 serviceProjectNumber: string, The Shared VPC service project id or service project number for which
604 aggregated list request is invoked for subnetworks list-usable api.
605 x__xgafv: string, V1 error format.
606 Allowed values
607 1 - v1 error format
608 2 - v2 error format
609
610 Returns:
611 An object of the form:
612
613 {
614 &quot;id&quot;: &quot;A String&quot;, # Output only. Unique identifier for the resource; defined by the server.
615 &quot;items&quot;: { # A list of InstanceGroupManagersScopedList resources.
616 &quot;a_key&quot;: { # Output only. The name of the scope that contains this set of managed instance groups.
617 &quot;instanceGroupManagers&quot;: [ # Output only. The list of managed instance groups that are contained in the specified
618 # project and zone.
619 { # Represents a Managed Instance Group resource.
620 #
621 # An instance group is a collection of VM instances that you can manage as a
622 # single entity. For more information, readInstance groups.
623 #
624 # For zonal Managed Instance Group, use the instanceGroupManagers
625 # resource.
626 #
627 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
628 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
629 # for the group.
630 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
631 #
632 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
633 # instances to apply the configuration. To apply the configuration, set the
634 # group&#x27;s updatePolicy.type field to use proactive updates or
635 # use the applyUpdatesToInstances method.
636 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
637 &quot;a_key&quot;: &quot;A String&quot;,
638 },
639 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
640 # more information, see Project and
641 # instance metadata.
642 &quot;a_key&quot;: &quot;A String&quot;,
643 },
644 },
645 },
646 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
647 # only one value.
648 {
649 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
650 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
651 # initialize and run its startup script. During a VM&#x27;s initial delay
652 # period, the MIG ignores unsuccessful health checks because the VM might
653 # be in the startup process. This prevents the MIG from prematurely
654 # recreating a VM. If the health check receives a healthy response during
655 # the initial delay, it indicates that the startup process is complete and
656 # the VM is ready. The value of initial delay must be between 0 and 3600
657 # seconds. The default value is 0.
658 },
659 ],
660 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
661 # all VMs in a MIG. The maximum character length is 58 and the name must
662 # comply with RFC1035 format.
663 #
664 # When a VM is created in the group, the MIG appends a hyphen and a random
665 # four-character string to the base instance name. If you want the MIG to
666 # assign sequential numbers instead of a random string, then end the base
667 # instance name with a hyphen followed by one or more hash symbols. The hash
668 # symbols indicate the number of digits. For example, a base instance name of
669 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
670 # @pattern
671 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
672 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
673 # text format.
674 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
675 # in this managed instance group that are scheduled for each of those
676 # actions.
677 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
678 # that are scheduled to be abandoned. Abandoning an instance removes it
679 # from the managed instance group without deleting it.
680 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
681 # are scheduled to be adopted or are currently being adopted.
682 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
683 # are scheduled to be created or are currently being created. If the group
684 # fails to create any of these instances, it tries again until it creates
685 # the instance successfully.
686 #
687 # If you have disabled creation retries, this field will not be populated;
688 # instead, the creatingWithoutRetries field will be populated.
689 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
690 # will attempt to create. The group attempts to create each instance
691 # only once. If the group fails to create any of these instances, it
692 # decreases the group&#x27;s targetSize value accordingly.
693 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
694 # are scheduled to be deleted or are currently being deleted.
695 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
696 # are running and have no scheduled actions.
697 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
698 # are scheduled to be recreated or are currently being being recreated.
699 # Recreating an instance deletes the existing root persistent disk
700 # and creates a new disk from the image that is defined in the
701 # instance template.
702 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
703 # are being reconfigured with properties that do not require a restart
704 # or a recreate action. For example, setting or removing target
705 # pools for the instance.
706 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
707 # are scheduled to be restarted or are currently being restarted.
708 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
709 # are scheduled to be restarted or are currently being restarted.
710 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
711 # are scheduled to be resumed or are currently being resumed.
712 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
713 # are scheduled to be started or are currently being started.
714 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
715 # are scheduled to be stopped or are currently being stopped.
716 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
717 # are scheduled to be suspended or are currently being suspended.
718 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
719 # are being verified. See the managedInstances[].currentAction
720 # property in the listManagedInstances method documentation.
721 },
722 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
723 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
724 # zones in a regional managed instance group.
725 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
726 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
727 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
728 # its instances.
729 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
730 # instances, even if an AI zone is available in the specified region. To
731 # create instances in an AI zone in the selected region, you must explicitly
732 # specify it in the distribution policy together with the other preferred
733 # zones.
734 {
735 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
736 # The zone must exist in the region where the managed instance group is
737 # located.
738 },
739 ],
740 },
741 &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.
742 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
743 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
744 # fingerprint must be provided in order to update the InstanceGroupManager,
745 # otherwise the request will fail with error412 conditionNotMet.
746 #
747 # To see the latest fingerprint, make a get() request to
748 # retrieve an InstanceGroupManager.
749 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
750 # generates this identifier.
751 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
752 # types of machines.
753 # Instance flexibility configuration on MIG overrides instance
754 # template configuration.
755 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
756 # when creating new VMs.
757 &quot;a_key&quot;: {
758 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
759 # selection.
760 { # An instance-attached disk resource.
761 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
762 # or X86_64.
763 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
764 # deleted (but not when the disk is detached from the instance).
765 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
766 # partition of the disk for its root filesystem.
767 &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
768 # running within the instance. This name can be used to reference the device
769 # for mounting, resizing, and so on, from within the instance.
770 #
771 # If not specified, the server chooses a default device name to apply to this
772 # disk, in the form persistent-disk-x, where x is a number
773 # assigned by Google Compute Engine. This field is only applicable for
774 # persistent disks.
775 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
776 # encryption key.
777 #
778 # If you are creating a new disk, this field encrypts the new disk using
779 # an encryption key that you provide. If you are attaching an existing
780 # disk that is already encrypted, this field decrypts the disk using
781 # the customer-supplied encryption key.
782 #
783 # If you encrypt a disk using a customer-supplied key, you must provide the
784 # same key again when you attempt to use this resource at a later time. For
785 # example, you must provide the key when you create a snapshot or an image
786 # from the disk or when you attach the disk to a virtual machine instance.
787 #
788 # If you do not provide an encryption key, then the disk will be encrypted
789 # using an automatically generated key and you do not need to provide a key
790 # to use the disk later.
791 #
792 # Note:
793 #
794 # Instance templates do not storecustomer-supplied
795 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
796 #
797 # You cannot create VMs that have disks with customer-supplied keys using
798 # the bulk
799 # insert method.
800 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
801 # For example:
802 #
803 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
804 # key_region/cryptoKeys/key
805 #
806 # The fully-qualifed key name may be returned for resource GET requests. For
807 # example:
808 #
809 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
810 # key_region/cryptoKeys/key
811 # /cryptoKeyVersions/1
812 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
813 # key. If absent, the Compute Engine default service account is used.
814 # For example:
815 #
816 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
817 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
818 # encryption key, encoded in RFC
819 # 4648 base64 to either encrypt or decrypt this resource. You can
820 # provide either the rawKey or thersaEncryptedKey.
821 # For example:
822 #
823 # &quot;rawKey&quot;:
824 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
825 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
826 # customer-supplied encryption key to either encrypt or decrypt this
827 # resource. You can provide either the rawKey or thersaEncryptedKey.
828 # For example:
829 #
830 # &quot;rsaEncryptedKey&quot;:
831 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
832 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
833 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
834 #
835 # The key must meet the following requirements before you can provide it to
836 # Compute Engine:
837 #
838 # 1. The key is wrapped using a RSA public key certificate provided by
839 # Google.
840 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
841 # encoding.
842 #
843 # Gets the RSA public key certificate provided by Google at:
844 #
845 #
846 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
847 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
848 # 4648 base64 encoded SHA-256 hash of the customer-supplied
849 # encryption key that protects this resource.
850 },
851 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
852 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
853 # currently attached to another instance. If you try to force attach a zonal
854 # disk to an instance, you will receive an error.
855 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
856 # only for bootable images. Read
857 # Enabling guest operating system features to see a list of available
858 # options.
859 { # Guest OS features.
860 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
861 # separate values. Set to one or more of the following values:
862 #
863 # - VIRTIO_SCSI_MULTIQUEUE
864 # - WINDOWS
865 # - MULTI_IP_SUBNET
866 # - UEFI_COMPATIBLE
867 # - GVNIC
868 # - SEV_CAPABLE
869 # - SUSPEND_RESUME_COMPATIBLE
870 # - SEV_LIVE_MIGRATABLE_V2
871 # - SEV_SNP_CAPABLE
872 # - TDX_CAPABLE
873 # - IDPF
874 # - SNP_SVSM_CAPABLE
875 # - CCA_CAPABLE
876 #
877 #
878 # For more information, see
879 # Enabling guest operating system features.
880 },
881 ],
882 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
883 # boot disk. If you have many disks attached to an instance, each
884 # disk would have a unique index number.
885 &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
886 # alongside the new instance. Use initialization parameters to create boot
887 # disks or local SSDs attached to the new instance.
888 #
889 # This property is mutually exclusive with the source property;
890 # you can only define one or the other, but not both.
891 # alongside the new instance. Use initialization parameters to create boot
892 # disks or local SSDs attached to the new instance.
893 #
894 # This field is persisted and returned for instanceTemplate and not returned
895 # in the context of instance.
896 #
897 # This property is mutually exclusive with the source property;
898 # you can only define one or the other, but not both.
899 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
900 # arm64 or x86_64.
901 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
902 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
903 # of the instance. If a disk with the same name already exists in the given
904 # region, the existing disk is attached to the new instance and the
905 # new disk is not created.
906 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
907 # 10 GB. If you specify a sourceImage, which is required for
908 # boot disks, the default size is the size of the sourceImage.
909 # If you do not specify a sourceImage, the default disk size
910 # is 500 GB.
911 &quot;diskType&quot;: &quot;A String&quot;,
912 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
913 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
914 # only for bootable images. Read
915 # Enabling guest operating system features to see a list of available
916 # options.
917 #
918 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
919 { # Guest OS features.
920 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
921 # separate values. Set to one or more of the following values:
922 #
923 # - VIRTIO_SCSI_MULTIQUEUE
924 # - WINDOWS
925 # - MULTI_IP_SUBNET
926 # - UEFI_COMPATIBLE
927 # - GVNIC
928 # - SEV_CAPABLE
929 # - SUSPEND_RESUME_COMPATIBLE
930 # - SEV_LIVE_MIGRATABLE_V2
931 # - SEV_SNP_CAPABLE
932 # - TDX_CAPABLE
933 # - IDPF
934 # - SNP_SVSM_CAPABLE
935 # - CCA_CAPABLE
936 #
937 #
938 # For more information, see
939 # Enabling guest operating system features.
940 },
941 ],
942 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
943 # persistent disks.
944 &quot;a_key&quot;: &quot;A String&quot;,
945 },
946 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
947 &quot;A String&quot;,
948 ],
949 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
950 # more than one instance.
951 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
952 # is to use the existing disk.
953 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
954 # of I/O operations per second that the disk can handle. Values must be
955 # between 10,000 and 120,000. For more details, see theExtreme persistent
956 # disk documentation.
957 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
958 # number of throughput mb per second that the disk can handle. Values must
959 # greater than or equal to 1.
960 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
961 # the URLs of the zones where the disk should be replicated to.
962 # You must provide exactly two replica zones, and one zone must be the same
963 # as the instance zone.
964 &quot;A String&quot;,
965 ],
966 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
967 # have the same definition as resource
968 # manager tags. Keys and values can be either in numeric format,
969 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
970 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
971 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
972 # empty.
973 &quot;a_key&quot;: &quot;A String&quot;,
974 },
975 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
976 # Specified using the full or partial URL. For instance template, specify
977 # only the resource policy name.
978 &quot;A String&quot;,
979 ],
980 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
981 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
982 # is required.
983 #
984 # To create a disk with one of the public operating system
985 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
986 #
987 # projects/debian-cloud/global/images/family/debian-9
988 #
989 #
990 # Alternatively, use a specific version of a public operating system image:
991 #
992 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
993 #
994 #
995 # To create a disk with a custom image that you created, specify the
996 # image name in the following format:
997 #
998 # global/images/my-custom-image
999 #
1000 #
1001 # You can also specify a custom image by its image family, which returns
1002 # the latest version of the image in that family. Replace the image name
1003 # with family/family-name:
1004 #
1005 # global/images/family/my-image-family
1006 #
1007 #
1008 # If the source image is deleted later, this field will not be set.
1009 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
1010 # encryption key of the source image. Required if the source image is
1011 # protected by a customer-supplied encryption key.
1012 #
1013 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
1014 # encryption keys, so you cannot create disks for instances in a managed instance group if the
1015 # source images are encrypted with your own keys.
1016 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1017 # For example:
1018 #
1019 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1020 # key_region/cryptoKeys/key
1021 #
1022 # The fully-qualifed key name may be returned for resource GET requests. For
1023 # example:
1024 #
1025 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1026 # key_region/cryptoKeys/key
1027 # /cryptoKeyVersions/1
1028 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1029 # key. If absent, the Compute Engine default service account is used.
1030 # For example:
1031 #
1032 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1033 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1034 # encryption key, encoded in RFC
1035 # 4648 base64 to either encrypt or decrypt this resource. You can
1036 # provide either the rawKey or thersaEncryptedKey.
1037 # For example:
1038 #
1039 # &quot;rawKey&quot;:
1040 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1041 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1042 # customer-supplied encryption key to either encrypt or decrypt this
1043 # resource. You can provide either the rawKey or thersaEncryptedKey.
1044 # For example:
1045 #
1046 # &quot;rsaEncryptedKey&quot;:
1047 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1048 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1049 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1050 #
1051 # The key must meet the following requirements before you can provide it to
1052 # Compute Engine:
1053 #
1054 # 1. The key is wrapped using a RSA public key certificate provided by
1055 # Google.
1056 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1057 # encoding.
1058 #
1059 # Gets the RSA public key certificate provided by Google at:
1060 #
1061 #
1062 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1063 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1064 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1065 # encryption key that protects this resource.
1066 },
1067 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
1068 # instance boot disk, one of initializeParams.sourceSnapshot
1069 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
1070 # is required.
1071 #
1072 # To create a disk with a snapshot that you created, specify the
1073 # snapshot name in the following format:
1074 #
1075 # us-central1-a/instantSnapshots/my-backup
1076 #
1077 #
1078 # If the source instant-snapshot is deleted later, this field will not be
1079 # set.
1080 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
1081 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
1082 # is required.
1083 #
1084 # To create a disk with a snapshot that you created, specify the
1085 # snapshot name in the following format:
1086 #
1087 # global/snapshots/my-backup
1088 #
1089 #
1090 # If the source snapshot is deleted later, this field will not be set.
1091 #
1092 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
1093 # an image instead when you create VMs using
1094 # the bulk
1095 # insert method.
1096 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
1097 # encryption key of the source snapshot.
1098 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
1099 # For example:
1100 #
1101 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1102 # key_region/cryptoKeys/key
1103 #
1104 # The fully-qualifed key name may be returned for resource GET requests. For
1105 # example:
1106 #
1107 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
1108 # key_region/cryptoKeys/key
1109 # /cryptoKeyVersions/1
1110 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
1111 # key. If absent, the Compute Engine default service account is used.
1112 # For example:
1113 #
1114 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
1115 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
1116 # encryption key, encoded in RFC
1117 # 4648 base64 to either encrypt or decrypt this resource. You can
1118 # provide either the rawKey or thersaEncryptedKey.
1119 # For example:
1120 #
1121 # &quot;rawKey&quot;:
1122 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
1123 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
1124 # customer-supplied encryption key to either encrypt or decrypt this
1125 # resource. You can provide either the rawKey or thersaEncryptedKey.
1126 # For example:
1127 #
1128 # &quot;rsaEncryptedKey&quot;:
1129 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
1130 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
1131 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
1132 #
1133 # The key must meet the following requirements before you can provide it to
1134 # Compute Engine:
1135 #
1136 # 1. The key is wrapped using a RSA public key certificate provided by
1137 # Google.
1138 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
1139 # encoding.
1140 #
1141 # Gets the RSA public key certificate provided by Google at:
1142 #
1143 #
1144 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
1145 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
1146 # 4648 base64 encoded SHA-256 hash of the customer-supplied
1147 # encryption key that protects this resource.
1148 },
1149 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
1150 # this as a partial or full URL to the resource. For example, the following
1151 # are valid values:
1152 #
1153 #
1154 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
1155 # - projects/project/zones/zone/storagePools/storagePool
1156 # - zones/zone/storagePools/storagePool
1157 },
1158 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
1159 # either SCSI or NVME. For most machine types, the
1160 # default is SCSI. Local SSDs can use either NVME or SCSI.
1161 # In certain configurations, persistent disks can use NVMe. For more
1162 # information, seeAbout
1163 # persistent disks.
1164 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
1165 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
1166 &quot;A String&quot;,
1167 ],
1168 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
1169 # disk is not allowed to be detached from the instance, or to be used as the
1170 # source of the snapshot creation, and the image creation. The instance with
1171 # at least one locked attached disk is not allow to be used as source of
1172 # machine image creation, instant snapshot creation, and not allowed to be
1173 # deleted with --keep-disk parameter set to true for locked disks.
1174 &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
1175 # in READ_WRITE mode.
1176 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
1177 # field is set to PRESERVED if the LocalSSD data has been saved
1178 # to a persistent location by customer request. (see the
1179 # discard_local_ssd option on Stop/Suspend).
1180 # Read-only in the api.
1181 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
1182 # these are public keys which are safe to store in public
1183 &quot;dbs&quot;: [ # The Key Database (db).
1184 {
1185 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1186 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1187 },
1188 ],
1189 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
1190 {
1191 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1192 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1193 },
1194 ],
1195 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
1196 {
1197 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1198 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1199 },
1200 ],
1201 &quot;pk&quot;: { # The Platform Key (PK).
1202 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
1203 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
1204 },
1205 },
1206 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
1207 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
1208 # is required.
1209 #
1210 # If desired, you can also attach existing non-root persistent disks using
1211 # this property. This field is only applicable for persistent disks.
1212 #
1213 # Note that for InstanceTemplate, specify the disk name for zonal disk,
1214 # and the URL for regional disk.
1215 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
1216 },
1217 ],
1218 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
1219 &quot;A String&quot;,
1220 ],
1221 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
1222 # e.g. &#x27;Intel Ice Lake&#x27;.
1223 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
1224 # preference. MIG will first try to create a VM based on the machine-type
1225 # with lowest rank and fallback to next rank based on availability.
1226 # Machine types and instance selections with the same rank have the same
1227 # preference.
1228 },
1229 },
1230 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
1231 # create instances.
1232 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
1233 # more preemption than the minimum capacity user needs. MIG will create
1234 # only Standard VMs until it reaches standard_capacity_base and only
1235 # then will start using standard_capacity_percent_above_base to mix Spot
1236 # with Standard VMs.
1237 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
1238 # remaining percentage will use Spot VMs. The percentage applies only to
1239 # the capacity above standard_capacity_base.
1240 },
1241 },
1242 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
1243 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
1244 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
1245 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
1246 # applies to the VMs on which your application fails a health check.
1247 # Valid values are
1248 #
1249 # - REPAIR (default): MIG automatically repairs a failed VM
1250 # by recreating it. For more information, see About
1251 # repairing VMs in a MIG.
1252 # - DO_NOTHING: MIG does not repair a failed VM.
1253 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
1254 # configuration when repairing a VM. Valid options are:
1255 #
1256 #
1257 #
1258 # - NO (default): If configuration updates are available, they are not
1259 # forcefully applied during repair. Instead, configuration updates are
1260 # applied according to the group&#x27;s update policy.
1261 #
1262 # - YES: If configuration updates are available, they are applied
1263 # during repair.
1264 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
1265 # unhealthy when the application running on that VM fails a health check.
1266 # Valid values are:
1267 #
1268 # - DEFAULT_ACTION (default): MIG uses the same action
1269 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
1270 # - REPAIR: MIG automatically repairs an unhealthy VM by
1271 # recreating it.
1272 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
1273 # For more information, see
1274 # About repairing VMs in a MIG.
1275 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
1276 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
1277 # Valid values are:
1278 #
1279 # - NO (default): MIG cannot change a VM&#x27;s zone during a
1280 # repair.
1281 # - YES: MIG can select a different zone for the VM during
1282 # a repair.
1283 },
1284 },
1285 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
1286 # instance group. The group uses this template to create all new instances
1287 # in the managed instance group. The templates for existing instances in the
1288 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
1289 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
1290 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
1291 # this managed instance group.
1292 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
1293 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
1294 # long, and comply withRFC1035.
1295 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
1296 # to this Instance Group Manager.
1297 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
1298 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
1299 # The name must be 1-63 characters long, and comply withRFC1035.
1300 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
1301 },
1302 ],
1303 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
1304 # as part of resource payload.
1305 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
1306 # key-value pairs. Keys and values can be either in numeric format,
1307 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
1308 # format such as `{org_id|project_id}/{tag_key_short_name}` and
1309 # `{tag_value_short_name}`. For more information, seeManage tags
1310 # for resources.
1311 &quot;a_key&quot;: &quot;A String&quot;,
1312 },
1313 },
1314 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
1315 # where the managed instance group resides (for regional resources).
1316 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
1317 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
1318 # instance group.
1319 # It can be a full or partial URL. For example, the following are
1320 # all valid URLs to a workload policy:
1321 #
1322 #
1323 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
1324 # - projects/project/regions/region/resourcePolicies/resourcePolicy
1325 # - regions/region/resourcePolicies/resourcePolicy
1326 },
1327 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
1328 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
1329 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
1330 # this URL.
1331 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
1332 # by the managed instance group on instances. The service accounts needs all
1333 # permissions required to create and delete instances.
1334 # By default, the service account
1335 # {projectNumber}@cloudservices.gserviceaccount.com is used.
1336 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
1337 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
1338 # stop a VM after that VM was created. The initial delay gives the
1339 # initialization script the time to prepare your VM for a quick scale out.
1340 # The value of initial delay must be between 0 and 3600 seconds. The
1341 # default value is 0.
1342 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
1343 # group scales out. The default mode is `MANUAL`.
1344 },
1345 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
1346 &quot;preservedState&quot;: { # Configuration of preserved resources.
1347 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
1348 # delete, update, etc. This map is keyed with the device names of
1349 # the disks.
1350 &quot;a_key&quot;: {
1351 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
1352 # update or VM instance recreate operations.
1353 # This flag is used to configure if the disk should be deleted after it
1354 # is no longer used by the group, e.g. when the given instance or
1355 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
1356 },
1357 },
1358 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
1359 # instance delete, update, etc. This map is keyed with the network
1360 # interface name.
1361 &quot;a_key&quot;: {
1362 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1363 # update or VM instance recreate operations.
1364 # This flag is used to configure if the IP reservation should be deleted
1365 # after it is no longer used by the group, e.g. when the given instance
1366 # or the whole group is deleted.
1367 },
1368 },
1369 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
1370 # instance delete, update, etc. This map is keyed with the network
1371 # interface name.
1372 &quot;a_key&quot;: {
1373 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1374 # update or VM instance recreate operations.
1375 # This flag is used to configure if the IP reservation should be deleted
1376 # after it is no longer used by the group, e.g. when the given instance
1377 # or the whole group is deleted.
1378 },
1379 },
1380 },
1381 },
1382 &quot;status&quot;: { # Output only. The status of this managed instance group.
1383 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
1384 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
1385 # This value is in RFC3339 text format.
1386 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
1387 # been applied to all managed instances in the group.
1388 },
1389 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
1390 # Currently only one accelerator topology is supported.
1391 {
1392 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
1393 # The value is the same as configured in the WorkloadPolicy.
1394 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
1395 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
1396 # check.
1397 &quot;error&quot;: { # Output only. Encountered errors.
1398 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1399 # operation.
1400 {
1401 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1402 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1403 # details. There is a set of defined message types to use for providing
1404 # details.The syntax depends on the error code. For example,
1405 # QuotaExceededInfo will have details when the error code is
1406 # QUOTA_EXCEEDED.
1407 {
1408 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1409 #
1410 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1411 # is not enabled:
1412 #
1413 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1414 # &quot;domain&quot;: &quot;googleapis.com&quot;
1415 # &quot;metadata&quot;: {
1416 # &quot;resource&quot;: &quot;projects/123&quot;,
1417 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1418 # }
1419 # }
1420 #
1421 # This response indicates that the pubsub.googleapis.com API is not enabled.
1422 #
1423 # Example of an error that is returned when attempting to create a Spanner
1424 # instance in a region that is out of stock:
1425 #
1426 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1427 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1428 # &quot;metadata&quot;: {
1429 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1430 # }
1431 # }
1432 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1433 # is typically the registered service name of the tool or product that
1434 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1435 # generated by some common infrastructure, the error domain must be a
1436 # globally unique value that identifies the infrastructure. For Google API
1437 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1438 &quot;metadatas&quot;: { # Additional structured details about this error.
1439 #
1440 # Keys must match a regular expression of `a-z+` but should
1441 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1442 # length. When identifying the current value of an exceeded limit, the units
1443 # should be contained in the key, not the value. For example, rather than
1444 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1445 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1446 # instances that can be created in a single (batch) request.
1447 &quot;a_key&quot;: &quot;A String&quot;,
1448 },
1449 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1450 # proximate cause of the error. Error reasons are unique within a particular
1451 # domain of errors. This should be at most 63 characters and match a
1452 # regular expression of `A-Z+[A-Z0-9]`, which represents
1453 # UPPER_SNAKE_CASE.
1454 },
1455 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1456 #
1457 # For example, if a quota check failed with an error indicating the calling
1458 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1459 # directly to the right place in the developer console to flip the bit.
1460 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1461 { # Describes a URL link.
1462 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1463 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1464 },
1465 ],
1466 },
1467 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1468 # which can be attached to an RPC error.
1469 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1470 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1471 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1472 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1473 },
1474 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1475 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1476 &quot;a_key&quot;: &quot;A String&quot;,
1477 },
1478 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1479 # type or metric.
1480 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1481 # or metric.
1482 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1483 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1484 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1485 },
1486 },
1487 ],
1488 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1489 # This property is optional.
1490 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1491 },
1492 ],
1493 },
1494 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
1495 # has // RFC3339 //
1496 # text format.
1497 },
1498 },
1499 ],
1500 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
1501 # that targets this instance group manager.
1502 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
1503 # targetSizePolicy.mode is set to BULK.
1504 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
1505 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
1506 # operation.
1507 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
1508 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1509 # operation.
1510 {
1511 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1512 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1513 # details. There is a set of defined message types to use for providing
1514 # details.The syntax depends on the error code. For example,
1515 # QuotaExceededInfo will have details when the error code is
1516 # QUOTA_EXCEEDED.
1517 {
1518 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1519 #
1520 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1521 # is not enabled:
1522 #
1523 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1524 # &quot;domain&quot;: &quot;googleapis.com&quot;
1525 # &quot;metadata&quot;: {
1526 # &quot;resource&quot;: &quot;projects/123&quot;,
1527 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1528 # }
1529 # }
1530 #
1531 # This response indicates that the pubsub.googleapis.com API is not enabled.
1532 #
1533 # Example of an error that is returned when attempting to create a Spanner
1534 # instance in a region that is out of stock:
1535 #
1536 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1537 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1538 # &quot;metadata&quot;: {
1539 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1540 # }
1541 # }
1542 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1543 # is typically the registered service name of the tool or product that
1544 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1545 # generated by some common infrastructure, the error domain must be a
1546 # globally unique value that identifies the infrastructure. For Google API
1547 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1548 &quot;metadatas&quot;: { # Additional structured details about this error.
1549 #
1550 # Keys must match a regular expression of `a-z+` but should
1551 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1552 # length. When identifying the current value of an exceeded limit, the units
1553 # should be contained in the key, not the value. For example, rather than
1554 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1555 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1556 # instances that can be created in a single (batch) request.
1557 &quot;a_key&quot;: &quot;A String&quot;,
1558 },
1559 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1560 # proximate cause of the error. Error reasons are unique within a particular
1561 # domain of errors. This should be at most 63 characters and match a
1562 # regular expression of `A-Z+[A-Z0-9]`, which represents
1563 # UPPER_SNAKE_CASE.
1564 },
1565 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1566 #
1567 # For example, if a quota check failed with an error indicating the calling
1568 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1569 # directly to the right place in the developer console to flip the bit.
1570 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1571 { # Describes a URL link.
1572 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1573 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1574 },
1575 ],
1576 },
1577 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1578 # which can be attached to an RPC error.
1579 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1580 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1581 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1582 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1583 },
1584 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1585 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1586 &quot;a_key&quot;: &quot;A String&quot;,
1587 },
1588 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1589 # type or metric.
1590 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1591 # or metric.
1592 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1593 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1594 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1595 },
1596 },
1597 ],
1598 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1599 # This property is optional.
1600 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1601 },
1602 ],
1603 },
1604 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
1605 # operation. Timestamp is in RFC3339 text format.
1606 },
1607 },
1608 &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
1609 # in this managed instance group that have the status. Currently only shown
1610 # for TPU MIGs
1611 # instance group that have the status. For more information about how to
1612 # interpret each status check the instance lifecycle documentation.
1613 # Currently only shown for TPU MIGs.
1614 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
1615 # that have DEPROVISIONING status.
1616 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
1617 # have been deleted. Includes only instances that would be shown in the
1618 # listManagedInstances method and not all instances that have been
1619 # deleted in the lifetime of the MIG.
1620 # Does not include FlexStart instances that are waiting for the resources
1621 # availability, they are considered as &#x27;pending&#x27;.
1622 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
1623 # that have PENDING status, that is FlexStart instances that are waiting
1624 # for resources. Instances that do not exist because of the other reasons
1625 # are counted as &#x27;non_existent&#x27;.
1626 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
1627 # that have PENDING_STOP status.
1628 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
1629 # that have PROVISIONING status.
1630 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
1631 # that have REPAIRING status.
1632 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
1633 # that have RUNNING status.
1634 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
1635 # that have STAGING status.
1636 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
1637 # that have STOPPED status.
1638 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
1639 # that have STOPPING status.
1640 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
1641 # that have SUSPENDED status.
1642 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
1643 # that have SUSPENDING status.
1644 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
1645 # that have TERMINATED status.
1646 },
1647 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
1648 # stable state. A stable state means that: none of the instances in the
1649 # managed instance group is currently undergoing any type of change (for
1650 # example, creation, restart, or deletion); no future changes are scheduled
1651 # for instances in the managed instance group; and the managed instance
1652 # group itself is not being modified.
1653 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
1654 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
1655 # has stateful configuration, that is, if you have configured any items
1656 # in a stateful policy or in per-instance configs.
1657 # The group might report that it has no stateful configuration even when
1658 # there is still some preserved state on a managed instance, for example,
1659 # if you have deleted all PICs but not yet applied those deletions.
1660 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
1661 # has stateful configuration, that is, if you have configured any items
1662 # in a stateful policy or in per-instance configs.
1663 # The group might report that it has no stateful configuration even when
1664 # there is still some preserved state on a managed instance, for example,
1665 # if you have deleted all PICs but not yet applied those deletions. This
1666 # field is deprecated in favor of has_stateful_config.
1667 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
1668 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
1669 # (listed in the output of a listPerInstanceConfigs API call) have
1670 # status EFFECTIVE or there are no per-instance-configs.
1671 },
1672 },
1673 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
1674 # target version specified by version field on Instance Group
1675 # Manager.
1676 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
1677 # in this managed instance group, i.e. all instances are in their target
1678 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
1679 },
1680 },
1681 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
1682 # apply to all of the instances in the managed instance group.
1683 &quot;A String&quot;,
1684 ],
1685 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
1686 # You can reduce this number by using the instanceGroupManager
1687 # deleteInstances or abandonInstances methods. Resizing the group also
1688 # changes this number.
1689 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
1690 # size.
1691 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
1692 # individually or all at once.
1693 },
1694 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
1695 # This number changes when you:
1696 #
1697 # - Stop instance using the stopInstances
1698 # method or start instances using the startInstances
1699 # method.
1700 # - Manually change the targetStoppedSize using the update
1701 # method.
1702 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
1703 # This number changes when you:
1704 #
1705 # - Suspend instance using the suspendInstances
1706 # method or resume instances using the resumeInstances
1707 # method.
1708 # - Manually change the targetSuspendedSize using the update
1709 # method.
1710 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
1711 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
1712 &quot;A String&quot;,
1713 ],
1714 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
1715 # instance redistribution policy for regional managed instance groups.
1716 # Valid values are:
1717 #
1718 # - PROACTIVE (default): The group attempts to maintain an
1719 # even distribution of VM instances across zones in the region.
1720 # - NONE: For non-autoscaled groups, proactive
1721 # redistribution is disabled.
1722 &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
1723 # either a fixed number or, if the group has 10 or more instances, a
1724 # percentage. If you set a percentage, the number of instances is rounded
1725 # if necessary. The default value for maxSurge is a fixed
1726 # value equal to the number of zones in which the managed instance group
1727 # operates.
1728 #
1729 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
1730 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
1731 #
1732 #
1733 #
1734 # - If the value is fixed, then the calculated
1735 # value is equal to the fixed value.
1736 # - If the value is a percent, then the
1737 # calculated
1738 # value is percent/100 * targetSize. For example,
1739 # the calculated value of a 80% of a managed instance group
1740 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
1741 # is a remainder, the number is rounded.
1742 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
1743 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
1744 # example, specify 80 for 80%.
1745 },
1746 &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
1747 # process. An instance is considered available if all of the following
1748 # conditions are satisfied:
1749 #
1750 #
1751 #
1752 # - The instance&#x27;s status is
1753 # RUNNING.
1754 # - If there is a health
1755 # check on the instance group, the instance&#x27;s health check status
1756 # must be HEALTHY at least once. If there is no health check
1757 # on the group, then the instance only needs to have a status of
1758 # RUNNING to be considered available.
1759 #
1760 #
1761 # This value can be either a fixed number or, if the group has 10 or more
1762 # instances, a percentage. If you set a percentage, the number of instances
1763 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
1764 # in which the managed instance group operates.
1765 #
1766 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
1767 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
1768 #
1769 #
1770 #
1771 # - If the value is fixed, then the calculated
1772 # value is equal to the fixed value.
1773 # - If the value is a percent, then the
1774 # calculated
1775 # value is percent/100 * targetSize. For example,
1776 # the calculated value of a 80% of a managed instance group
1777 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
1778 # is a remainder, the number is rounded.
1779 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
1780 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
1781 # example, specify 80 for 80%.
1782 },
1783 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
1784 # becomes available. This value must be from range [0, 3600].
1785 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
1786 # disruption as much as possible or to apply a more disruptive action than
1787 # is necessary.
1788 #
1789 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
1790 # Compute Engine performs the necessary action to execute the update.
1791 # - To apply a more disruptive action than is strictly necessary, set the
1792 # minimal action to RESTART or REPLACE. For
1793 # example, Compute Engine does not need to restart a VM to change its
1794 # metadata. But if your application reads instance metadata only when a VM
1795 # is restarted, you can set the minimal action to RESTART in
1796 # order to pick up metadata changes.
1797 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
1798 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
1799 # as much as possible. RESTART to allow actions that can be
1800 # applied without instance replacing or REPLACE to allow all
1801 # possible actions. If the Updater determines that the minimal update
1802 # action needed is more disruptive than most disruptive allowed action you
1803 # specify it will not perform the update at all.
1804 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
1805 # See minimal_action.REPLACE
1806 &quot;type&quot;: &quot;A String&quot;, # The type
1807 # of update process. You can specify either PROACTIVE so
1808 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
1809 # to update.
1810 },
1811 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
1812 # create instances.
1813 #
1814 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
1815 # group. This field overrides the top-level instanceTemplate
1816 # field. Read more about therelationships
1817 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
1818 # remaining instances. For more information, read aboutcanary
1819 # updates.
1820 {
1821 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
1822 # instance group. The group uses this template to create new instances in
1823 # the managed instance group until the `targetSize` for this version is
1824 # reached. The templates for existing instances in the group do not change
1825 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
1826 # existing instances are updated until the `targetSize` for this version is
1827 # reached.
1828 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
1829 # managed instance group.
1830 &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
1831 # from the template will be equal to:
1832 #
1833 #
1834 # - If expressed as a fixed number, the minimum of either
1835 # targetSize.fixed or
1836 # instanceGroupManager.targetSize is used.
1837 # - if expressed as a percent, the targetSize
1838 # would be (targetSize.percent/100 *
1839 # InstanceGroupManager.targetSize) If there is a remainder, the
1840 # number is rounded.
1841 #
1842 # If unset, this version will update any remaining instances not
1843 # updated by another version. ReadStarting
1844 # a canary update for more information.
1845 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
1846 #
1847 #
1848 #
1849 # - If the value is fixed, then the calculated
1850 # value is equal to the fixed value.
1851 # - If the value is a percent, then the
1852 # calculated
1853 # value is percent/100 * targetSize. For example,
1854 # the calculated value of a 80% of a managed instance group
1855 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
1856 # is a remainder, the number is rounded.
1857 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
1858 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
1859 # example, specify 80 for 80%.
1860 },
1861 },
1862 ],
1863 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
1864 # where the managed instance group is located (for zonal resources).
1865 },
1866 ],
1867 &quot;warning&quot;: { # Output only. The warning that replaces the list of managed instance groups when the list
1868 # is empty.
1869 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1870 # Engine returns NO_RESULTS_ON_PAGE if there
1871 # are no results in the response.
1872 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1873 # value format. For example:
1874 #
1875 # &quot;data&quot;: [
1876 # {
1877 # &quot;key&quot;: &quot;scope&quot;,
1878 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1879 # }
1880 {
1881 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1882 # returned. For example, for warnings where there are no results in a list
1883 # request for a particular zone, this key might be scope and
1884 # the key value might be the zone name. Other examples might be a key
1885 # indicating a deprecated resource and a suggested replacement, or a
1886 # warning about invalid network settings (for example, if an instance
1887 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1888 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1889 },
1890 ],
1891 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1892 },
1893 },
1894 },
1895 &quot;kind&quot;: &quot;compute#instanceGroupManagerAggregatedList&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManagerAggregatedList for an aggregated
1896 # list of managed instance groups.
1897 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. This token allows you to get the next page of results for
1898 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
1899 # the query parameter pageToken in the next list request.
1900 # Subsequent list requests will have their own nextPageToken to
1901 # continue paging through the results.
1902 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource.
1903 &quot;unreachables&quot;: [ # Output only. Unreachable resources.
1904 &quot;A String&quot;,
1905 ],
1906 &quot;warning&quot;: { # Output only. Informational warning message.
1907 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1908 # Engine returns NO_RESULTS_ON_PAGE if there
1909 # are no results in the response.
1910 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1911 # value format. For example:
1912 #
1913 # &quot;data&quot;: [
1914 # {
1915 # &quot;key&quot;: &quot;scope&quot;,
1916 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1917 # }
1918 {
1919 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1920 # returned. For example, for warnings where there are no results in a list
1921 # request for a particular zone, this key might be scope and
1922 # the key value might be the zone name. Other examples might be a key
1923 # indicating a deprecated resource and a suggested replacement, or a
1924 # warning about invalid network settings (for example, if an instance
1925 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1926 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1927 },
1928 ],
1929 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1930 },
1931 }</pre>
1932 </div>
1933
1934 <div class="method">
1935 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
1936 <pre>Retrieves the next page of results.
1937
1938 Args:
1939 previous_request: The request for the previous page. (required)
1940 previous_response: The response from the request for the previous page. (required)
1941
1942 Returns:
1943 A request object that you can call &#x27;execute()&#x27; on to request the next
1944 page. Returns None if there are no more items in the collection.
1945 </pre>
1946 </div>
1947
1948 <div class="method">
1949 <code class="details" id="applyUpdatesToInstances">applyUpdatesToInstances(project, zone, instanceGroupManager, body=None, x__xgafv=None)</code>
1950 <pre>Applies changes to selected instances on the managed instance group.
1951 This method can be used to apply new overrides and/or new versions.
1952
1953 Args:
1954 project: string, Project ID for this request. (required)
1955 zone: string, The name of thezone
1956 where the managed instance group is located. Should conform to RFC1035. (required)
1957 instanceGroupManager: string, The name of the managed instance group, should conform to RFC1035. (required)
1958 body: object, The request body.
1959 The object takes the form of:
1960
1961 { # InstanceGroupManagers.applyUpdatesToInstances
1962 &quot;allInstances&quot;: True or False, # Flag to update all instances instead of specified list of “instances”.
1963 # If the flag is set to true then the instances may not be specified
1964 # in the request.
1965 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
1966 &quot;A String&quot;,
1967 ],
1968 &quot;instances&quot;: [ # The list of URLs of one or more instances for which you want to apply
1969 # updates. Each URL can be a full URL or a partial URL, such aszones/[ZONE]/instances/[INSTANCE_NAME].
1970 &quot;A String&quot;,
1971 ],
1972 &quot;minimalAction&quot;: &quot;A String&quot;, # The minimal action that you want to perform on each instance during the
1973 # update:
1974 #
1975 #
1976 # - REPLACE: At minimum, delete the instance and create it
1977 # again.
1978 # - RESTART: Stop the instance and start it
1979 # again.
1980 # - REFRESH: Do not stop the instance and limit
1981 # disruption as much as possible.
1982 # - NONE: Do not
1983 # disrupt the instance at all.
1984 #
1985 #
1986 # By default, the minimum action is NONE. If your update
1987 # requires a more disruptive action than you set with this flag, the
1988 # necessary action is performed to execute the update.
1989 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # The most disruptive action that you want to perform on each instance during
1990 # the update:
1991 #
1992 #
1993 # - REPLACE: Delete the instance and create it again.
1994 # - RESTART: Stop the instance and start it again.
1995 # - REFRESH: Do not stop the instance and limit disruption
1996 # as much as possible.
1997 # - NONE: Do not disrupt the
1998 # instance at all.
1999 #
2000 #
2001 # By default, the most disruptive allowed action is REPLACE. If
2002 # your update requires a more disruptive action than you set with this flag,
2003 # the update request will fail.
2004 }
2005
2006 x__xgafv: string, V1 error format.
2007 Allowed values
2008 1 - v1 error format
2009 2 - v2 error format
2010
2011 Returns:
2012 An object of the form:
2013
2014 { # Represents an Operation resource.
2015 #
2016 # Google Compute Engine has three Operation resources:
2017 #
2018 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
2019 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
2020 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
2021 #
2022 # You can use an operation resource to manage asynchronous API requests.
2023 # For more information, readHandling
2024 # API responses.
2025 #
2026 # Operations can be global, regional or zonal.
2027 #
2028 # - For global operations, use the `globalOperations`
2029 # resource.
2030 # - For regional operations, use the
2031 # `regionOperations` resource.
2032 # - For zonal operations, use
2033 # the `zoneOperations` resource.
2034 #
2035 #
2036 #
2037 # For more information, read
2038 # Global, Regional, and Zonal Resources.
2039 #
2040 # Note that completed Operation resources have a limited
2041 # retention period.
2042 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2043 # Not present otherwise.
2044 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2045 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2046 # set when the operation is created.
2047 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2048 # text format.
2049 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2050 # this field will be populated.
2051 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2052 # operation.
2053 {
2054 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2055 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2056 # details. There is a set of defined message types to use for providing
2057 # details.The syntax depends on the error code. For example,
2058 # QuotaExceededInfo will have details when the error code is
2059 # QUOTA_EXCEEDED.
2060 {
2061 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2062 #
2063 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2064 # is not enabled:
2065 #
2066 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2067 # &quot;domain&quot;: &quot;googleapis.com&quot;
2068 # &quot;metadata&quot;: {
2069 # &quot;resource&quot;: &quot;projects/123&quot;,
2070 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2071 # }
2072 # }
2073 #
2074 # This response indicates that the pubsub.googleapis.com API is not enabled.
2075 #
2076 # Example of an error that is returned when attempting to create a Spanner
2077 # instance in a region that is out of stock:
2078 #
2079 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2080 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2081 # &quot;metadata&quot;: {
2082 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2083 # }
2084 # }
2085 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2086 # is typically the registered service name of the tool or product that
2087 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2088 # generated by some common infrastructure, the error domain must be a
2089 # globally unique value that identifies the infrastructure. For Google API
2090 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2091 &quot;metadatas&quot;: { # Additional structured details about this error.
2092 #
2093 # Keys must match a regular expression of `a-z+` but should
2094 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2095 # length. When identifying the current value of an exceeded limit, the units
2096 # should be contained in the key, not the value. For example, rather than
2097 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2098 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2099 # instances that can be created in a single (batch) request.
2100 &quot;a_key&quot;: &quot;A String&quot;,
2101 },
2102 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2103 # proximate cause of the error. Error reasons are unique within a particular
2104 # domain of errors. This should be at most 63 characters and match a
2105 # regular expression of `A-Z+[A-Z0-9]`, which represents
2106 # UPPER_SNAKE_CASE.
2107 },
2108 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2109 #
2110 # For example, if a quota check failed with an error indicating the calling
2111 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2112 # directly to the right place in the developer console to flip the bit.
2113 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2114 { # Describes a URL link.
2115 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2116 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2117 },
2118 ],
2119 },
2120 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2121 # which can be attached to an RPC error.
2122 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2123 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2124 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2125 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2126 },
2127 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2128 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2129 &quot;a_key&quot;: &quot;A String&quot;,
2130 },
2131 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2132 # type or metric.
2133 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2134 # or metric.
2135 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2136 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2137 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2138 },
2139 },
2140 ],
2141 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2142 # This property is optional.
2143 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2144 },
2145 ],
2146 },
2147 &quot;getVersionOperationMetadata&quot;: {
2148 &quot;inlineSbomInfo&quot;: {
2149 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2150 # appropriate identifiers.
2151 &quot;a_key&quot;: &quot;A String&quot;,
2152 },
2153 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2154 # identifiers.
2155 &quot;a_key&quot;: &quot;A String&quot;,
2156 },
2157 },
2158 },
2159 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2160 # message that was returned, such as `NOT FOUND`.
2161 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2162 # status code that was returned. For example, a `404` means the
2163 # resource was not found.
2164 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2165 # defined by the server.
2166 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2167 # This value is inRFC3339
2168 # text format.
2169 &quot;instancesBulkInsertOperationMetadata&quot;: {
2170 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2171 # Example key: zones/us-central1-a
2172 &quot;a_key&quot;: {
2173 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2174 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2175 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2176 # error.
2177 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2178 # if the flow is rolling forward or rolling back.
2179 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2180 },
2181 },
2182 },
2183 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2184 # Operation resources.
2185 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2186 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2187 # group of operations results from a `bulkInsert` API request.
2188 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2189 # `update`, or `delete`, and so on.
2190 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2191 # There is no requirement that this be linear or support any granularity of
2192 # operations. This should not be used to guess when the operation will be
2193 # complete. This number should monotonically increase as the operation
2194 # progresses.
2195 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2196 # applicable when performing regional operations.
2197 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2198 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2199 # this field will contain information on all underlying zonal actions and
2200 # their state.
2201 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2202 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2203 # Example key: zones/us-central1-a
2204 &quot;a_key&quot;: {
2205 &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
2206 # populated.
2207 # different programming environments, including REST APIs and RPC APIs. It is
2208 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2209 # three pieces of data: error code, error message, and error details.
2210 #
2211 # You can find out more about this error model and how to work with it in the
2212 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2213 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2214 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2215 # message types for APIs to use.
2216 {
2217 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2218 },
2219 ],
2220 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2221 # user-facing error message should be localized and sent in the
2222 # google.rpc.Status.details field, or localized by the client.
2223 },
2224 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2225 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2226 },
2227 },
2228 },
2229 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2230 # This value is inRFC3339
2231 # text format.
2232 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2233 # following:
2234 # `PENDING`, `RUNNING`, or `DONE`.
2235 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2236 # operation.
2237 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2238 # of the target resource.
2239 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2240 # operations related to creating a snapshot, this points to the disk
2241 # that the snapshot was created from.
2242 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2243 # `[email protected]` or
2244 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2245 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2246 # operation, this field will be populated.
2247 {
2248 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2249 # Engine returns NO_RESULTS_ON_PAGE if there
2250 # are no results in the response.
2251 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2252 # value format. For example:
2253 #
2254 # &quot;data&quot;: [
2255 # {
2256 # &quot;key&quot;: &quot;scope&quot;,
2257 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2258 # }
2259 {
2260 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2261 # returned. For example, for warnings where there are no results in a list
2262 # request for a particular zone, this key might be scope and
2263 # the key value might be the zone name. Other examples might be a key
2264 # indicating a deprecated resource and a suggested replacement, or a
2265 # warning about invalid network settings (for example, if an instance
2266 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2267 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2268 },
2269 ],
2270 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2271 },
2272 ],
2273 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2274 # applicable when performing per-zone operations.
2275 }</pre>
2276 </div>
2277
2278 <div class="method">
2279 <code class="details" id="close">close()</code>
2280 <pre>Close httplib2 connections.</pre>
2281 </div>
2282
2283 <div class="method">
2284 <code class="details" id="configureAcceleratorTopologies">configureAcceleratorTopologies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
2285 <pre>Updates the accelerator topologies configuration.
2286
2287 Args:
2288 project: string, Project ID for this request. (required)
2289 zone: string, The name of thezone
2290 where the managed instance group is located.
2291 It should conform to RFC1035. (required)
2292 instanceGroupManager: string, The name of the managed instance group.
2293 It should conform to RFC1035. (required)
2294 body: object, The request body.
2295 The object takes the form of:
2296
2297 { # InstanceGroupManagers.ConfigureAcceleratorTopologies
2298 &quot;acceleratorTopologyActions&quot;: { # Map of accelerator topologies that should have their state changed to
2299 # the specified value. The key is the hashed topology locus id. It can be
2300 # obtained from the GetAvailableAcceleratorTopologies rpc.
2301 &quot;a_key&quot;: &quot;A String&quot;,
2302 },
2303 &quot;acceleratorTopologyConfigurations&quot;: { # Map of accelerator topologies that should have their state changed to
2304 # the specified configuration. The map key is the hashed topology locus id.
2305 # It can be obtained from the GetAvailableAcceleratorTopologies rpc.
2306 &quot;a_key&quot;: { # Configuration for a single accelerator topology.
2307 &quot;action&quot;: &quot;A String&quot;,
2308 &quot;externalId&quot;: &quot;A String&quot;, # Identifier of the accelerator topology assigned externally to
2309 # differentiate who is the owner of the topology. The format needs to
2310 # conform to RFC1035 and be unique. The uniqueness is guaranteed by the
2311 # requestor. If it is provided on activating the sub-slice it will have to
2312 # be provided on deactivating as well. This identifier is cleared on
2313 # successful deform of a sub-slice.
2314 },
2315 },
2316 }
2317
2318 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2319 that if you must retry your request, the server will know to ignore the
2320 request if it has already been completed.
2321
2322 For example, consider a situation where you make an initial request and
2323 the request times out. If you make the request again with the same
2324 request ID, the server can check if original operation with the same
2325 request ID was received, and if so, will ignore the second request.
2326
2327 The request ID must be
2328 a valid UUID with the exception that zero UUID is not supported
2329 (00000000-0000-0000-0000-000000000000).
2330 x__xgafv: string, V1 error format.
2331 Allowed values
2332 1 - v1 error format
2333 2 - v2 error format
2334
2335 Returns:
2336 An object of the form:
2337
2338 { # Represents an Operation resource.
2339 #
2340 # Google Compute Engine has three Operation resources:
2341 #
2342 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
2343 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
2344 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
2345 #
2346 # You can use an operation resource to manage asynchronous API requests.
2347 # For more information, readHandling
2348 # API responses.
2349 #
2350 # Operations can be global, regional or zonal.
2351 #
2352 # - For global operations, use the `globalOperations`
2353 # resource.
2354 # - For regional operations, use the
2355 # `regionOperations` resource.
2356 # - For zonal operations, use
2357 # the `zoneOperations` resource.
2358 #
2359 #
2360 #
2361 # For more information, read
2362 # Global, Regional, and Zonal Resources.
2363 #
2364 # Note that completed Operation resources have a limited
2365 # retention period.
2366 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2367 # Not present otherwise.
2368 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2369 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2370 # set when the operation is created.
2371 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2372 # text format.
2373 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2374 # this field will be populated.
2375 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2376 # operation.
2377 {
2378 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2379 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2380 # details. There is a set of defined message types to use for providing
2381 # details.The syntax depends on the error code. For example,
2382 # QuotaExceededInfo will have details when the error code is
2383 # QUOTA_EXCEEDED.
2384 {
2385 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2386 #
2387 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2388 # is not enabled:
2389 #
2390 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2391 # &quot;domain&quot;: &quot;googleapis.com&quot;
2392 # &quot;metadata&quot;: {
2393 # &quot;resource&quot;: &quot;projects/123&quot;,
2394 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2395 # }
2396 # }
2397 #
2398 # This response indicates that the pubsub.googleapis.com API is not enabled.
2399 #
2400 # Example of an error that is returned when attempting to create a Spanner
2401 # instance in a region that is out of stock:
2402 #
2403 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2404 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2405 # &quot;metadata&quot;: {
2406 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2407 # }
2408 # }
2409 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2410 # is typically the registered service name of the tool or product that
2411 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2412 # generated by some common infrastructure, the error domain must be a
2413 # globally unique value that identifies the infrastructure. For Google API
2414 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2415 &quot;metadatas&quot;: { # Additional structured details about this error.
2416 #
2417 # Keys must match a regular expression of `a-z+` but should
2418 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2419 # length. When identifying the current value of an exceeded limit, the units
2420 # should be contained in the key, not the value. For example, rather than
2421 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2422 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2423 # instances that can be created in a single (batch) request.
2424 &quot;a_key&quot;: &quot;A String&quot;,
2425 },
2426 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2427 # proximate cause of the error. Error reasons are unique within a particular
2428 # domain of errors. This should be at most 63 characters and match a
2429 # regular expression of `A-Z+[A-Z0-9]`, which represents
2430 # UPPER_SNAKE_CASE.
2431 },
2432 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2433 #
2434 # For example, if a quota check failed with an error indicating the calling
2435 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2436 # directly to the right place in the developer console to flip the bit.
2437 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2438 { # Describes a URL link.
2439 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2440 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2441 },
2442 ],
2443 },
2444 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2445 # which can be attached to an RPC error.
2446 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2447 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2448 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2449 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2450 },
2451 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2452 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2453 &quot;a_key&quot;: &quot;A String&quot;,
2454 },
2455 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2456 # type or metric.
2457 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2458 # or metric.
2459 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2460 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2461 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2462 },
2463 },
2464 ],
2465 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2466 # This property is optional.
2467 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2468 },
2469 ],
2470 },
2471 &quot;getVersionOperationMetadata&quot;: {
2472 &quot;inlineSbomInfo&quot;: {
2473 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2474 # appropriate identifiers.
2475 &quot;a_key&quot;: &quot;A String&quot;,
2476 },
2477 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2478 # identifiers.
2479 &quot;a_key&quot;: &quot;A String&quot;,
2480 },
2481 },
2482 },
2483 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2484 # message that was returned, such as `NOT FOUND`.
2485 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2486 # status code that was returned. For example, a `404` means the
2487 # resource was not found.
2488 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2489 # defined by the server.
2490 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2491 # This value is inRFC3339
2492 # text format.
2493 &quot;instancesBulkInsertOperationMetadata&quot;: {
2494 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2495 # Example key: zones/us-central1-a
2496 &quot;a_key&quot;: {
2497 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2498 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2499 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2500 # error.
2501 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2502 # if the flow is rolling forward or rolling back.
2503 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2504 },
2505 },
2506 },
2507 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2508 # Operation resources.
2509 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2510 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2511 # group of operations results from a `bulkInsert` API request.
2512 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2513 # `update`, or `delete`, and so on.
2514 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2515 # There is no requirement that this be linear or support any granularity of
2516 # operations. This should not be used to guess when the operation will be
2517 # complete. This number should monotonically increase as the operation
2518 # progresses.
2519 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2520 # applicable when performing regional operations.
2521 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2522 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2523 # this field will contain information on all underlying zonal actions and
2524 # their state.
2525 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2526 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2527 # Example key: zones/us-central1-a
2528 &quot;a_key&quot;: {
2529 &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
2530 # populated.
2531 # different programming environments, including REST APIs and RPC APIs. It is
2532 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2533 # three pieces of data: error code, error message, and error details.
2534 #
2535 # You can find out more about this error model and how to work with it in the
2536 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2537 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2538 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2539 # message types for APIs to use.
2540 {
2541 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2542 },
2543 ],
2544 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2545 # user-facing error message should be localized and sent in the
2546 # google.rpc.Status.details field, or localized by the client.
2547 },
2548 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2549 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2550 },
2551 },
2552 },
2553 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2554 # This value is inRFC3339
2555 # text format.
2556 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2557 # following:
2558 # `PENDING`, `RUNNING`, or `DONE`.
2559 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2560 # operation.
2561 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2562 # of the target resource.
2563 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2564 # operations related to creating a snapshot, this points to the disk
2565 # that the snapshot was created from.
2566 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2567 # `[email protected]` or
2568 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2569 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2570 # operation, this field will be populated.
2571 {
2572 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2573 # Engine returns NO_RESULTS_ON_PAGE if there
2574 # are no results in the response.
2575 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2576 # value format. For example:
2577 #
2578 # &quot;data&quot;: [
2579 # {
2580 # &quot;key&quot;: &quot;scope&quot;,
2581 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2582 # }
2583 {
2584 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2585 # returned. For example, for warnings where there are no results in a list
2586 # request for a particular zone, this key might be scope and
2587 # the key value might be the zone name. Other examples might be a key
2588 # indicating a deprecated resource and a suggested replacement, or a
2589 # warning about invalid network settings (for example, if an instance
2590 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2591 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2592 },
2593 ],
2594 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2595 },
2596 ],
2597 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2598 # applicable when performing per-zone operations.
2599 }</pre>
2600 </div>
2601
2602 <div class="method">
2603 <code class="details" id="createInstances">createInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
2604 <pre>Creates instances with per-instance configurations in this managed instance
2605 group. Instances are created using the current instance template. Thecreate instances operation is marked DONE if thecreateInstances request is successful. The underlying actions
2606 take additional time. You must separately verify the status of thecreating or actions with the listmanagedinstances
2607 method.
2608
2609 Args:
2610 project: string, Project ID for this request. (required)
2611 zone: string, The name of thezone
2612 where the managed instance group is located.
2613 It should conform to RFC1035. (required)
2614 instanceGroupManager: string, The name of the managed instance group.
2615 It should conform to RFC1035. (required)
2616 body: object, The request body.
2617 The object takes the form of:
2618
2619 { # InstanceGroupManagers.createInstances
2620 &quot;instances&quot;: [ # [Required] List of specifications of per-instance configs.
2621 {
2622 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
2623 # optimistic locking. It is ignored when inserting a per-instance
2624 # config. An up-to-date fingerprint must be provided in order to update an
2625 # existing per-instance configuration or the field needs to be unset.
2626 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
2627 # Serves as a merge key during UpdatePerInstanceConfigs
2628 # operations, that is, if a per-instance configuration with the same name
2629 # exists then it will be updated, otherwise a new one will be created for the
2630 # VM instance with the same name. An attempt to create a per-instance
2631 # configuration for a VM instance that either doesn&#x27;t exist or is not part
2632 # of the group will result in an error.
2633 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
2634 # preserved state generated from a stateful policy.
2635 &quot;disks&quot;: { # Preserved disks defined for this instance.
2636 # This map is keyed with the device names of the disks.
2637 &quot;a_key&quot;: {
2638 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
2639 # update, instance recreate operations. This flag is used to configure
2640 # if the disk should be deleted after it is no longer used by the group,
2641 # e.g. when the given instance or the whole MIG is deleted.
2642 # Note: disks attached in READ_ONLY mode cannot be
2643 # auto-deleted.
2644 &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
2645 # disk in READ_WRITE mode.
2646 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
2647 # to the VM instance.
2648 },
2649 },
2650 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
2651 # This map is keyed with the name of the network interface.
2652 &quot;a_key&quot;: {
2653 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
2654 # update or VM instance recreate operations.
2655 # This flag is used to configure if the IP reservation should be deleted
2656 # after it is no longer used by the group, e.g. when the given instance
2657 # or the whole group is deleted.
2658 &quot;ipAddress&quot;: { # Ip address representation
2659 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
2660 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
2661 # network interface.
2662 },
2663 },
2664 },
2665 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
2666 # This map is keyed with the name of the network interface.
2667 &quot;a_key&quot;: {
2668 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
2669 # update or VM instance recreate operations.
2670 # This flag is used to configure if the IP reservation should be deleted
2671 # after it is no longer used by the group, e.g. when the given instance
2672 # or the whole group is deleted.
2673 &quot;ipAddress&quot;: { # Ip address representation
2674 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
2675 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
2676 # network interface.
2677 },
2678 },
2679 },
2680 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
2681 &quot;a_key&quot;: &quot;A String&quot;,
2682 },
2683 },
2684 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
2685 # managed instance.
2686 },
2687 ],
2688 }
2689
2690 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2691 that if you must retry your request, the server will know to ignore the
2692 request if it has already been completed.
2693
2694 For example, consider a situation where you make an initial request and
2695 the request times out. If you make the request again with the same
2696 request ID, the server can check if original operation with the same
2697 request ID was received, and if so, will ignore the second request.
2698
2699 The request ID must be
2700 a valid UUID with the exception that zero UUID is not supported
2701 (00000000-0000-0000-0000-000000000000).
2702 x__xgafv: string, V1 error format.
2703 Allowed values
2704 1 - v1 error format
2705 2 - v2 error format
2706
2707 Returns:
2708 An object of the form:
2709
2710 { # Represents an Operation resource.
2711 #
2712 # Google Compute Engine has three Operation resources:
2713 #
2714 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
2715 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
2716 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
2717 #
2718 # You can use an operation resource to manage asynchronous API requests.
2719 # For more information, readHandling
2720 # API responses.
2721 #
2722 # Operations can be global, regional or zonal.
2723 #
2724 # - For global operations, use the `globalOperations`
2725 # resource.
2726 # - For regional operations, use the
2727 # `regionOperations` resource.
2728 # - For zonal operations, use
2729 # the `zoneOperations` resource.
2730 #
2731 #
2732 #
2733 # For more information, read
2734 # Global, Regional, and Zonal Resources.
2735 #
2736 # Note that completed Operation resources have a limited
2737 # retention period.
2738 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2739 # Not present otherwise.
2740 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2741 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2742 # set when the operation is created.
2743 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2744 # text format.
2745 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2746 # this field will be populated.
2747 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2748 # operation.
2749 {
2750 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2751 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2752 # details. There is a set of defined message types to use for providing
2753 # details.The syntax depends on the error code. For example,
2754 # QuotaExceededInfo will have details when the error code is
2755 # QUOTA_EXCEEDED.
2756 {
2757 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2758 #
2759 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2760 # is not enabled:
2761 #
2762 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2763 # &quot;domain&quot;: &quot;googleapis.com&quot;
2764 # &quot;metadata&quot;: {
2765 # &quot;resource&quot;: &quot;projects/123&quot;,
2766 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2767 # }
2768 # }
2769 #
2770 # This response indicates that the pubsub.googleapis.com API is not enabled.
2771 #
2772 # Example of an error that is returned when attempting to create a Spanner
2773 # instance in a region that is out of stock:
2774 #
2775 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2776 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2777 # &quot;metadata&quot;: {
2778 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2779 # }
2780 # }
2781 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2782 # is typically the registered service name of the tool or product that
2783 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2784 # generated by some common infrastructure, the error domain must be a
2785 # globally unique value that identifies the infrastructure. For Google API
2786 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2787 &quot;metadatas&quot;: { # Additional structured details about this error.
2788 #
2789 # Keys must match a regular expression of `a-z+` but should
2790 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2791 # length. When identifying the current value of an exceeded limit, the units
2792 # should be contained in the key, not the value. For example, rather than
2793 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2794 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2795 # instances that can be created in a single (batch) request.
2796 &quot;a_key&quot;: &quot;A String&quot;,
2797 },
2798 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2799 # proximate cause of the error. Error reasons are unique within a particular
2800 # domain of errors. This should be at most 63 characters and match a
2801 # regular expression of `A-Z+[A-Z0-9]`, which represents
2802 # UPPER_SNAKE_CASE.
2803 },
2804 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2805 #
2806 # For example, if a quota check failed with an error indicating the calling
2807 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2808 # directly to the right place in the developer console to flip the bit.
2809 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2810 { # Describes a URL link.
2811 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2812 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2813 },
2814 ],
2815 },
2816 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2817 # which can be attached to an RPC error.
2818 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2819 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2820 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2821 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2822 },
2823 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2824 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2825 &quot;a_key&quot;: &quot;A String&quot;,
2826 },
2827 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2828 # type or metric.
2829 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2830 # or metric.
2831 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2832 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2833 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2834 },
2835 },
2836 ],
2837 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2838 # This property is optional.
2839 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2840 },
2841 ],
2842 },
2843 &quot;getVersionOperationMetadata&quot;: {
2844 &quot;inlineSbomInfo&quot;: {
2845 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2846 # appropriate identifiers.
2847 &quot;a_key&quot;: &quot;A String&quot;,
2848 },
2849 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2850 # identifiers.
2851 &quot;a_key&quot;: &quot;A String&quot;,
2852 },
2853 },
2854 },
2855 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2856 # message that was returned, such as `NOT FOUND`.
2857 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2858 # status code that was returned. For example, a `404` means the
2859 # resource was not found.
2860 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2861 # defined by the server.
2862 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2863 # This value is inRFC3339
2864 # text format.
2865 &quot;instancesBulkInsertOperationMetadata&quot;: {
2866 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2867 # Example key: zones/us-central1-a
2868 &quot;a_key&quot;: {
2869 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2870 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2871 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2872 # error.
2873 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2874 # if the flow is rolling forward or rolling back.
2875 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2876 },
2877 },
2878 },
2879 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2880 # Operation resources.
2881 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2882 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2883 # group of operations results from a `bulkInsert` API request.
2884 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2885 # `update`, or `delete`, and so on.
2886 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2887 # There is no requirement that this be linear or support any granularity of
2888 # operations. This should not be used to guess when the operation will be
2889 # complete. This number should monotonically increase as the operation
2890 # progresses.
2891 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2892 # applicable when performing regional operations.
2893 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2894 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2895 # this field will contain information on all underlying zonal actions and
2896 # their state.
2897 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2898 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2899 # Example key: zones/us-central1-a
2900 &quot;a_key&quot;: {
2901 &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
2902 # populated.
2903 # different programming environments, including REST APIs and RPC APIs. It is
2904 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2905 # three pieces of data: error code, error message, and error details.
2906 #
2907 # You can find out more about this error model and how to work with it in the
2908 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2909 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2910 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2911 # message types for APIs to use.
2912 {
2913 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2914 },
2915 ],
2916 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2917 # user-facing error message should be localized and sent in the
2918 # google.rpc.Status.details field, or localized by the client.
2919 },
2920 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2921 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2922 },
2923 },
2924 },
2925 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2926 # This value is inRFC3339
2927 # text format.
2928 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2929 # following:
2930 # `PENDING`, `RUNNING`, or `DONE`.
2931 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2932 # operation.
2933 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2934 # of the target resource.
2935 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2936 # operations related to creating a snapshot, this points to the disk
2937 # that the snapshot was created from.
2938 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2939 # `[email protected]` or
2940 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2941 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2942 # operation, this field will be populated.
2943 {
2944 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2945 # Engine returns NO_RESULTS_ON_PAGE if there
2946 # are no results in the response.
2947 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2948 # value format. For example:
2949 #
2950 # &quot;data&quot;: [
2951 # {
2952 # &quot;key&quot;: &quot;scope&quot;,
2953 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2954 # }
2955 {
2956 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2957 # returned. For example, for warnings where there are no results in a list
2958 # request for a particular zone, this key might be scope and
2959 # the key value might be the zone name. Other examples might be a key
2960 # indicating a deprecated resource and a suggested replacement, or a
2961 # warning about invalid network settings (for example, if an instance
2962 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2963 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2964 },
2965 ],
2966 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2967 },
2968 ],
2969 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2970 # applicable when performing per-zone operations.
2971 }</pre>
2972 </div>
2973
2974 <div class="method">
2975 <code class="details" id="delete">delete(project, zone, instanceGroupManager, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
2976 <pre>Deletes the specified managed instance group and all of the instances
2977 in that group. Note that the instance group must not belong to a
2978 backend service. Read
2979 Deleting an instance group for more information.
2980
2981 Args:
2982 project: string, Project ID for this request. (required)
2983 zone: string, The name of thezone where the managed
2984 instance group is located. (required)
2985 instanceGroupManager: string, The name of the managed instance group to delete. (required)
2986 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it&#x27;s
2987 configured for the instances.
2988 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2989 that if you must retry your request, the server will know to ignore the
2990 request if it has already been completed.
2991
2992 For example, consider a situation where you make an initial request and
2993 the request times out. If you make the request again with the same
2994 request ID, the server can check if original operation with the same
2995 request ID was received, and if so, will ignore the second request. This
2996 prevents clients from accidentally creating duplicate commitments.
2997
2998 The request ID must be
2999 a valid UUID with the exception that zero UUID is not supported
3000 (00000000-0000-0000-0000-000000000000).
3001 x__xgafv: string, V1 error format.
3002 Allowed values
3003 1 - v1 error format
3004 2 - v2 error format
3005
3006 Returns:
3007 An object of the form:
3008
3009 { # Represents an Operation resource.
3010 #
3011 # Google Compute Engine has three Operation resources:
3012 #
3013 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
3014 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
3015 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
3016 #
3017 # You can use an operation resource to manage asynchronous API requests.
3018 # For more information, readHandling
3019 # API responses.
3020 #
3021 # Operations can be global, regional or zonal.
3022 #
3023 # - For global operations, use the `globalOperations`
3024 # resource.
3025 # - For regional operations, use the
3026 # `regionOperations` resource.
3027 # - For zonal operations, use
3028 # the `zoneOperations` resource.
3029 #
3030 #
3031 #
3032 # For more information, read
3033 # Global, Regional, and Zonal Resources.
3034 #
3035 # Note that completed Operation resources have a limited
3036 # retention period.
3037 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3038 # Not present otherwise.
3039 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3040 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3041 # set when the operation is created.
3042 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3043 # text format.
3044 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3045 # this field will be populated.
3046 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3047 # operation.
3048 {
3049 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3050 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3051 # details. There is a set of defined message types to use for providing
3052 # details.The syntax depends on the error code. For example,
3053 # QuotaExceededInfo will have details when the error code is
3054 # QUOTA_EXCEEDED.
3055 {
3056 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3057 #
3058 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3059 # is not enabled:
3060 #
3061 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3062 # &quot;domain&quot;: &quot;googleapis.com&quot;
3063 # &quot;metadata&quot;: {
3064 # &quot;resource&quot;: &quot;projects/123&quot;,
3065 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3066 # }
3067 # }
3068 #
3069 # This response indicates that the pubsub.googleapis.com API is not enabled.
3070 #
3071 # Example of an error that is returned when attempting to create a Spanner
3072 # instance in a region that is out of stock:
3073 #
3074 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3075 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3076 # &quot;metadata&quot;: {
3077 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3078 # }
3079 # }
3080 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3081 # is typically the registered service name of the tool or product that
3082 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3083 # generated by some common infrastructure, the error domain must be a
3084 # globally unique value that identifies the infrastructure. For Google API
3085 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3086 &quot;metadatas&quot;: { # Additional structured details about this error.
3087 #
3088 # Keys must match a regular expression of `a-z+` but should
3089 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3090 # length. When identifying the current value of an exceeded limit, the units
3091 # should be contained in the key, not the value. For example, rather than
3092 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3093 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3094 # instances that can be created in a single (batch) request.
3095 &quot;a_key&quot;: &quot;A String&quot;,
3096 },
3097 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3098 # proximate cause of the error. Error reasons are unique within a particular
3099 # domain of errors. This should be at most 63 characters and match a
3100 # regular expression of `A-Z+[A-Z0-9]`, which represents
3101 # UPPER_SNAKE_CASE.
3102 },
3103 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3104 #
3105 # For example, if a quota check failed with an error indicating the calling
3106 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3107 # directly to the right place in the developer console to flip the bit.
3108 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3109 { # Describes a URL link.
3110 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3111 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3112 },
3113 ],
3114 },
3115 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3116 # which can be attached to an RPC error.
3117 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3118 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3119 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3120 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3121 },
3122 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3123 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3124 &quot;a_key&quot;: &quot;A String&quot;,
3125 },
3126 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3127 # type or metric.
3128 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3129 # or metric.
3130 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3131 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3132 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3133 },
3134 },
3135 ],
3136 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3137 # This property is optional.
3138 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3139 },
3140 ],
3141 },
3142 &quot;getVersionOperationMetadata&quot;: {
3143 &quot;inlineSbomInfo&quot;: {
3144 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3145 # appropriate identifiers.
3146 &quot;a_key&quot;: &quot;A String&quot;,
3147 },
3148 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3149 # identifiers.
3150 &quot;a_key&quot;: &quot;A String&quot;,
3151 },
3152 },
3153 },
3154 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3155 # message that was returned, such as `NOT FOUND`.
3156 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3157 # status code that was returned. For example, a `404` means the
3158 # resource was not found.
3159 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3160 # defined by the server.
3161 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3162 # This value is inRFC3339
3163 # text format.
3164 &quot;instancesBulkInsertOperationMetadata&quot;: {
3165 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3166 # Example key: zones/us-central1-a
3167 &quot;a_key&quot;: {
3168 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3169 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3170 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3171 # error.
3172 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3173 # if the flow is rolling forward or rolling back.
3174 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3175 },
3176 },
3177 },
3178 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3179 # Operation resources.
3180 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3181 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3182 # group of operations results from a `bulkInsert` API request.
3183 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3184 # `update`, or `delete`, and so on.
3185 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3186 # There is no requirement that this be linear or support any granularity of
3187 # operations. This should not be used to guess when the operation will be
3188 # complete. This number should monotonically increase as the operation
3189 # progresses.
3190 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3191 # applicable when performing regional operations.
3192 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3193 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3194 # this field will contain information on all underlying zonal actions and
3195 # their state.
3196 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3197 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3198 # Example key: zones/us-central1-a
3199 &quot;a_key&quot;: {
3200 &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
3201 # populated.
3202 # different programming environments, including REST APIs and RPC APIs. It is
3203 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3204 # three pieces of data: error code, error message, and error details.
3205 #
3206 # You can find out more about this error model and how to work with it in the
3207 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3208 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3209 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3210 # message types for APIs to use.
3211 {
3212 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3213 },
3214 ],
3215 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3216 # user-facing error message should be localized and sent in the
3217 # google.rpc.Status.details field, or localized by the client.
3218 },
3219 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3220 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3221 },
3222 },
3223 },
3224 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3225 # This value is inRFC3339
3226 # text format.
3227 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3228 # following:
3229 # `PENDING`, `RUNNING`, or `DONE`.
3230 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3231 # operation.
3232 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3233 # of the target resource.
3234 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3235 # operations related to creating a snapshot, this points to the disk
3236 # that the snapshot was created from.
3237 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3238 # `[email protected]` or
3239 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3240 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3241 # operation, this field will be populated.
3242 {
3243 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3244 # Engine returns NO_RESULTS_ON_PAGE if there
3245 # are no results in the response.
3246 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3247 # value format. For example:
3248 #
3249 # &quot;data&quot;: [
3250 # {
3251 # &quot;key&quot;: &quot;scope&quot;,
3252 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3253 # }
3254 {
3255 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3256 # returned. For example, for warnings where there are no results in a list
3257 # request for a particular zone, this key might be scope and
3258 # the key value might be the zone name. Other examples might be a key
3259 # indicating a deprecated resource and a suggested replacement, or a
3260 # warning about invalid network settings (for example, if an instance
3261 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3262 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3263 },
3264 ],
3265 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3266 },
3267 ],
3268 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3269 # applicable when performing per-zone operations.
3270 }</pre>
3271 </div>
3272
3273 <div class="method">
3274 <code class="details" id="deleteInstances">deleteInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
3275 <pre>Flags the specified instances in the managed instance group for immediate
3276 deletion. The instances are also removed from any target
3277 pools of which they were a member. This method reduces thetargetSize of the managed instance group by the number of
3278 instances that you delete. This operation is marked as DONE
3279 when the action is scheduled even if the instances are still being deleted.
3280 You must separately verify the status of the deleting action
3281 with thelistmanagedinstances
3282 method.
3283
3284 If the group is part of a backend
3285 service that has enabled
3286 connection draining, it can take up to 60 seconds after the connection
3287 draining duration has elapsed before the VM instance is removed or deleted.
3288
3289 You can specify a maximum of 1000 instances with this method per request.
3290
3291 Args:
3292 project: string, Project ID for this request. (required)
3293 zone: string, The name of thezone where the managed
3294 instance group is located. (required)
3295 instanceGroupManager: string, The name of the managed instance group. (required)
3296 body: object, The request body.
3297 The object takes the form of:
3298
3299 {
3300 &quot;instances&quot;: [ # The URLs of one or more instances to delete. This can be a full URL or
3301 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
3302 # Queued instances do not have URL and can be deleted only by name.
3303 # One cannot specify both URLs and names in a single request.
3304 &quot;A String&quot;,
3305 ],
3306 &quot;skipInstancesOnValidationError&quot;: True or False, # Specifies whether the request should proceed despite the inclusion of
3307 # instances that are not members of the group or that are already in the
3308 # process of being deleted or abandoned. If this field is set to `false` and
3309 # such an instance is specified in the request, the operation fails. The
3310 # operation always fails if the request contains a malformed instance URL or
3311 # a reference to an instance that exists in a zone or region other than the
3312 # group&#x27;s zone or region.
3313 }
3314
3315 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance deletion even if it&#x27;s
3316 configured for the instances.
3317 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3318 that if you must retry your request, the server will know to ignore the
3319 request if it has already been completed.
3320
3321 For example, consider a situation where you make an initial request and
3322 the request times out. If you make the request again with the same
3323 request ID, the server can check if original operation with the same
3324 request ID was received, and if so, will ignore the second request. This
3325 prevents clients from accidentally creating duplicate commitments.
3326
3327 The request ID must be
3328 a valid UUID with the exception that zero UUID is not supported
3329 (00000000-0000-0000-0000-000000000000).
3330 x__xgafv: string, V1 error format.
3331 Allowed values
3332 1 - v1 error format
3333 2 - v2 error format
3334
3335 Returns:
3336 An object of the form:
3337
3338 { # Represents an Operation resource.
3339 #
3340 # Google Compute Engine has three Operation resources:
3341 #
3342 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
3343 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
3344 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
3345 #
3346 # You can use an operation resource to manage asynchronous API requests.
3347 # For more information, readHandling
3348 # API responses.
3349 #
3350 # Operations can be global, regional or zonal.
3351 #
3352 # - For global operations, use the `globalOperations`
3353 # resource.
3354 # - For regional operations, use the
3355 # `regionOperations` resource.
3356 # - For zonal operations, use
3357 # the `zoneOperations` resource.
3358 #
3359 #
3360 #
3361 # For more information, read
3362 # Global, Regional, and Zonal Resources.
3363 #
3364 # Note that completed Operation resources have a limited
3365 # retention period.
3366 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3367 # Not present otherwise.
3368 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3369 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3370 # set when the operation is created.
3371 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3372 # text format.
3373 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3374 # this field will be populated.
3375 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3376 # operation.
3377 {
3378 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3379 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3380 # details. There is a set of defined message types to use for providing
3381 # details.The syntax depends on the error code. For example,
3382 # QuotaExceededInfo will have details when the error code is
3383 # QUOTA_EXCEEDED.
3384 {
3385 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3386 #
3387 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3388 # is not enabled:
3389 #
3390 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3391 # &quot;domain&quot;: &quot;googleapis.com&quot;
3392 # &quot;metadata&quot;: {
3393 # &quot;resource&quot;: &quot;projects/123&quot;,
3394 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3395 # }
3396 # }
3397 #
3398 # This response indicates that the pubsub.googleapis.com API is not enabled.
3399 #
3400 # Example of an error that is returned when attempting to create a Spanner
3401 # instance in a region that is out of stock:
3402 #
3403 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3404 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3405 # &quot;metadata&quot;: {
3406 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3407 # }
3408 # }
3409 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3410 # is typically the registered service name of the tool or product that
3411 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3412 # generated by some common infrastructure, the error domain must be a
3413 # globally unique value that identifies the infrastructure. For Google API
3414 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3415 &quot;metadatas&quot;: { # Additional structured details about this error.
3416 #
3417 # Keys must match a regular expression of `a-z+` but should
3418 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3419 # length. When identifying the current value of an exceeded limit, the units
3420 # should be contained in the key, not the value. For example, rather than
3421 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3422 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3423 # instances that can be created in a single (batch) request.
3424 &quot;a_key&quot;: &quot;A String&quot;,
3425 },
3426 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3427 # proximate cause of the error. Error reasons are unique within a particular
3428 # domain of errors. This should be at most 63 characters and match a
3429 # regular expression of `A-Z+[A-Z0-9]`, which represents
3430 # UPPER_SNAKE_CASE.
3431 },
3432 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3433 #
3434 # For example, if a quota check failed with an error indicating the calling
3435 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3436 # directly to the right place in the developer console to flip the bit.
3437 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3438 { # Describes a URL link.
3439 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3440 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3441 },
3442 ],
3443 },
3444 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3445 # which can be attached to an RPC error.
3446 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3447 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3448 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3449 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3450 },
3451 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3452 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3453 &quot;a_key&quot;: &quot;A String&quot;,
3454 },
3455 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3456 # type or metric.
3457 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3458 # or metric.
3459 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3460 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3461 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3462 },
3463 },
3464 ],
3465 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3466 # This property is optional.
3467 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3468 },
3469 ],
3470 },
3471 &quot;getVersionOperationMetadata&quot;: {
3472 &quot;inlineSbomInfo&quot;: {
3473 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3474 # appropriate identifiers.
3475 &quot;a_key&quot;: &quot;A String&quot;,
3476 },
3477 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3478 # identifiers.
3479 &quot;a_key&quot;: &quot;A String&quot;,
3480 },
3481 },
3482 },
3483 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3484 # message that was returned, such as `NOT FOUND`.
3485 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3486 # status code that was returned. For example, a `404` means the
3487 # resource was not found.
3488 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3489 # defined by the server.
3490 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3491 # This value is inRFC3339
3492 # text format.
3493 &quot;instancesBulkInsertOperationMetadata&quot;: {
3494 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3495 # Example key: zones/us-central1-a
3496 &quot;a_key&quot;: {
3497 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3498 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3499 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3500 # error.
3501 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3502 # if the flow is rolling forward or rolling back.
3503 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3504 },
3505 },
3506 },
3507 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3508 # Operation resources.
3509 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3510 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3511 # group of operations results from a `bulkInsert` API request.
3512 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3513 # `update`, or `delete`, and so on.
3514 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3515 # There is no requirement that this be linear or support any granularity of
3516 # operations. This should not be used to guess when the operation will be
3517 # complete. This number should monotonically increase as the operation
3518 # progresses.
3519 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3520 # applicable when performing regional operations.
3521 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3522 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3523 # this field will contain information on all underlying zonal actions and
3524 # their state.
3525 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3526 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3527 # Example key: zones/us-central1-a
3528 &quot;a_key&quot;: {
3529 &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
3530 # populated.
3531 # different programming environments, including REST APIs and RPC APIs. It is
3532 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3533 # three pieces of data: error code, error message, and error details.
3534 #
3535 # You can find out more about this error model and how to work with it in the
3536 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3537 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3538 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3539 # message types for APIs to use.
3540 {
3541 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3542 },
3543 ],
3544 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3545 # user-facing error message should be localized and sent in the
3546 # google.rpc.Status.details field, or localized by the client.
3547 },
3548 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3549 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3550 },
3551 },
3552 },
3553 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3554 # This value is inRFC3339
3555 # text format.
3556 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3557 # following:
3558 # `PENDING`, `RUNNING`, or `DONE`.
3559 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3560 # operation.
3561 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3562 # of the target resource.
3563 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3564 # operations related to creating a snapshot, this points to the disk
3565 # that the snapshot was created from.
3566 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3567 # `[email protected]` or
3568 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3569 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3570 # operation, this field will be populated.
3571 {
3572 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3573 # Engine returns NO_RESULTS_ON_PAGE if there
3574 # are no results in the response.
3575 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3576 # value format. For example:
3577 #
3578 # &quot;data&quot;: [
3579 # {
3580 # &quot;key&quot;: &quot;scope&quot;,
3581 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3582 # }
3583 {
3584 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3585 # returned. For example, for warnings where there are no results in a list
3586 # request for a particular zone, this key might be scope and
3587 # the key value might be the zone name. Other examples might be a key
3588 # indicating a deprecated resource and a suggested replacement, or a
3589 # warning about invalid network settings (for example, if an instance
3590 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3591 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3592 },
3593 ],
3594 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3595 },
3596 ],
3597 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3598 # applicable when performing per-zone operations.
3599 }</pre>
3600 </div>
3601
3602 <div class="method">
3603 <code class="details" id="deletePerInstanceConfigs">deletePerInstanceConfigs(project, zone, instanceGroupManager, body=None, x__xgafv=None)</code>
3604 <pre>Deletes selected per-instance configurations for the managed instance
3605 group.
3606
3607 Args:
3608 project: string, Project ID for this request. (required)
3609 zone: string, The name of thezone
3610 where the managed instance
3611 group is located.
3612 It should conform to RFC1035. (required)
3613 instanceGroupManager: string, The name of the managed instance group.
3614 It should conform to RFC1035. (required)
3615 body: object, The request body.
3616 The object takes the form of:
3617
3618 { # InstanceGroupManagers.deletePerInstanceConfigs
3619 &quot;names&quot;: [ # The list of instance names for which we want to delete per-instance configs
3620 # on this managed instance group.
3621 &quot;A String&quot;,
3622 ],
3623 }
3624
3625 x__xgafv: string, V1 error format.
3626 Allowed values
3627 1 - v1 error format
3628 2 - v2 error format
3629
3630 Returns:
3631 An object of the form:
3632
3633 { # Represents an Operation resource.
3634 #
3635 # Google Compute Engine has three Operation resources:
3636 #
3637 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
3638 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
3639 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
3640 #
3641 # You can use an operation resource to manage asynchronous API requests.
3642 # For more information, readHandling
3643 # API responses.
3644 #
3645 # Operations can be global, regional or zonal.
3646 #
3647 # - For global operations, use the `globalOperations`
3648 # resource.
3649 # - For regional operations, use the
3650 # `regionOperations` resource.
3651 # - For zonal operations, use
3652 # the `zoneOperations` resource.
3653 #
3654 #
3655 #
3656 # For more information, read
3657 # Global, Regional, and Zonal Resources.
3658 #
3659 # Note that completed Operation resources have a limited
3660 # retention period.
3661 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3662 # Not present otherwise.
3663 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3664 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3665 # set when the operation is created.
3666 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3667 # text format.
3668 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3669 # this field will be populated.
3670 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3671 # operation.
3672 {
3673 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3674 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3675 # details. There is a set of defined message types to use for providing
3676 # details.The syntax depends on the error code. For example,
3677 # QuotaExceededInfo will have details when the error code is
3678 # QUOTA_EXCEEDED.
3679 {
3680 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3681 #
3682 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3683 # is not enabled:
3684 #
3685 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3686 # &quot;domain&quot;: &quot;googleapis.com&quot;
3687 # &quot;metadata&quot;: {
3688 # &quot;resource&quot;: &quot;projects/123&quot;,
3689 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3690 # }
3691 # }
3692 #
3693 # This response indicates that the pubsub.googleapis.com API is not enabled.
3694 #
3695 # Example of an error that is returned when attempting to create a Spanner
3696 # instance in a region that is out of stock:
3697 #
3698 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3699 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3700 # &quot;metadata&quot;: {
3701 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3702 # }
3703 # }
3704 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3705 # is typically the registered service name of the tool or product that
3706 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3707 # generated by some common infrastructure, the error domain must be a
3708 # globally unique value that identifies the infrastructure. For Google API
3709 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3710 &quot;metadatas&quot;: { # Additional structured details about this error.
3711 #
3712 # Keys must match a regular expression of `a-z+` but should
3713 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3714 # length. When identifying the current value of an exceeded limit, the units
3715 # should be contained in the key, not the value. For example, rather than
3716 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3717 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3718 # instances that can be created in a single (batch) request.
3719 &quot;a_key&quot;: &quot;A String&quot;,
3720 },
3721 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3722 # proximate cause of the error. Error reasons are unique within a particular
3723 # domain of errors. This should be at most 63 characters and match a
3724 # regular expression of `A-Z+[A-Z0-9]`, which represents
3725 # UPPER_SNAKE_CASE.
3726 },
3727 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3728 #
3729 # For example, if a quota check failed with an error indicating the calling
3730 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3731 # directly to the right place in the developer console to flip the bit.
3732 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3733 { # Describes a URL link.
3734 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3735 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3736 },
3737 ],
3738 },
3739 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3740 # which can be attached to an RPC error.
3741 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3742 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3743 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3744 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3745 },
3746 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3747 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3748 &quot;a_key&quot;: &quot;A String&quot;,
3749 },
3750 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3751 # type or metric.
3752 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3753 # or metric.
3754 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3755 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3756 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3757 },
3758 },
3759 ],
3760 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3761 # This property is optional.
3762 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3763 },
3764 ],
3765 },
3766 &quot;getVersionOperationMetadata&quot;: {
3767 &quot;inlineSbomInfo&quot;: {
3768 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3769 # appropriate identifiers.
3770 &quot;a_key&quot;: &quot;A String&quot;,
3771 },
3772 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3773 # identifiers.
3774 &quot;a_key&quot;: &quot;A String&quot;,
3775 },
3776 },
3777 },
3778 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3779 # message that was returned, such as `NOT FOUND`.
3780 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3781 # status code that was returned. For example, a `404` means the
3782 # resource was not found.
3783 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3784 # defined by the server.
3785 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3786 # This value is inRFC3339
3787 # text format.
3788 &quot;instancesBulkInsertOperationMetadata&quot;: {
3789 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3790 # Example key: zones/us-central1-a
3791 &quot;a_key&quot;: {
3792 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3793 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3794 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3795 # error.
3796 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3797 # if the flow is rolling forward or rolling back.
3798 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3799 },
3800 },
3801 },
3802 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3803 # Operation resources.
3804 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3805 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3806 # group of operations results from a `bulkInsert` API request.
3807 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3808 # `update`, or `delete`, and so on.
3809 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3810 # There is no requirement that this be linear or support any granularity of
3811 # operations. This should not be used to guess when the operation will be
3812 # complete. This number should monotonically increase as the operation
3813 # progresses.
3814 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3815 # applicable when performing regional operations.
3816 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3817 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3818 # this field will contain information on all underlying zonal actions and
3819 # their state.
3820 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3821 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3822 # Example key: zones/us-central1-a
3823 &quot;a_key&quot;: {
3824 &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
3825 # populated.
3826 # different programming environments, including REST APIs and RPC APIs. It is
3827 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3828 # three pieces of data: error code, error message, and error details.
3829 #
3830 # You can find out more about this error model and how to work with it in the
3831 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3832 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3833 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3834 # message types for APIs to use.
3835 {
3836 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3837 },
3838 ],
3839 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3840 # user-facing error message should be localized and sent in the
3841 # google.rpc.Status.details field, or localized by the client.
3842 },
3843 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3844 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3845 },
3846 },
3847 },
3848 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3849 # This value is inRFC3339
3850 # text format.
3851 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3852 # following:
3853 # `PENDING`, `RUNNING`, or `DONE`.
3854 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3855 # operation.
3856 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3857 # of the target resource.
3858 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3859 # operations related to creating a snapshot, this points to the disk
3860 # that the snapshot was created from.
3861 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3862 # `[email protected]` or
3863 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3864 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3865 # operation, this field will be populated.
3866 {
3867 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3868 # Engine returns NO_RESULTS_ON_PAGE if there
3869 # are no results in the response.
3870 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3871 # value format. For example:
3872 #
3873 # &quot;data&quot;: [
3874 # {
3875 # &quot;key&quot;: &quot;scope&quot;,
3876 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3877 # }
3878 {
3879 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3880 # returned. For example, for warnings where there are no results in a list
3881 # request for a particular zone, this key might be scope and
3882 # the key value might be the zone name. Other examples might be a key
3883 # indicating a deprecated resource and a suggested replacement, or a
3884 # warning about invalid network settings (for example, if an instance
3885 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3886 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3887 },
3888 ],
3889 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3890 },
3891 ],
3892 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3893 # applicable when performing per-zone operations.
3894 }</pre>
3895 </div>
3896
3897 <div class="method">
3898 <code class="details" id="get">get(project, zone, instanceGroupManager, x__xgafv=None)</code>
3899 <pre>Returns all of the details about the specified managed instance group.
3900
3901 Args:
3902 project: string, Project ID for this request. (required)
3903 zone: string, The name of thezone where the managed
3904 instance group is located. (required)
3905 instanceGroupManager: string, The name of the managed instance group. (required)
3906 x__xgafv: string, V1 error format.
3907 Allowed values
3908 1 - v1 error format
3909 2 - v2 error format
3910
3911 Returns:
3912 An object of the form:
3913
3914 { # Represents a Managed Instance Group resource.
3915 #
3916 # An instance group is a collection of VM instances that you can manage as a
3917 # single entity. For more information, readInstance groups.
3918 #
3919 # For zonal Managed Instance Group, use the instanceGroupManagers
3920 # resource.
3921 #
3922 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
3923 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
3924 # for the group.
3925 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
3926 #
3927 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
3928 # instances to apply the configuration. To apply the configuration, set the
3929 # group&#x27;s updatePolicy.type field to use proactive updates or
3930 # use the applyUpdatesToInstances method.
3931 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
3932 &quot;a_key&quot;: &quot;A String&quot;,
3933 },
3934 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
3935 # more information, see Project and
3936 # instance metadata.
3937 &quot;a_key&quot;: &quot;A String&quot;,
3938 },
3939 },
3940 },
3941 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
3942 # only one value.
3943 {
3944 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
3945 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
3946 # initialize and run its startup script. During a VM&#x27;s initial delay
3947 # period, the MIG ignores unsuccessful health checks because the VM might
3948 # be in the startup process. This prevents the MIG from prematurely
3949 # recreating a VM. If the health check receives a healthy response during
3950 # the initial delay, it indicates that the startup process is complete and
3951 # the VM is ready. The value of initial delay must be between 0 and 3600
3952 # seconds. The default value is 0.
3953 },
3954 ],
3955 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
3956 # all VMs in a MIG. The maximum character length is 58 and the name must
3957 # comply with RFC1035 format.
3958 #
3959 # When a VM is created in the group, the MIG appends a hyphen and a random
3960 # four-character string to the base instance name. If you want the MIG to
3961 # assign sequential numbers instead of a random string, then end the base
3962 # instance name with a hyphen followed by one or more hash symbols. The hash
3963 # symbols indicate the number of digits. For example, a base instance name of
3964 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
3965 # @pattern
3966 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
3967 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
3968 # text format.
3969 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
3970 # in this managed instance group that are scheduled for each of those
3971 # actions.
3972 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
3973 # that are scheduled to be abandoned. Abandoning an instance removes it
3974 # from the managed instance group without deleting it.
3975 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
3976 # are scheduled to be adopted or are currently being adopted.
3977 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
3978 # are scheduled to be created or are currently being created. If the group
3979 # fails to create any of these instances, it tries again until it creates
3980 # the instance successfully.
3981 #
3982 # If you have disabled creation retries, this field will not be populated;
3983 # instead, the creatingWithoutRetries field will be populated.
3984 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
3985 # will attempt to create. The group attempts to create each instance
3986 # only once. If the group fails to create any of these instances, it
3987 # decreases the group&#x27;s targetSize value accordingly.
3988 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
3989 # are scheduled to be deleted or are currently being deleted.
3990 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
3991 # are running and have no scheduled actions.
3992 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
3993 # are scheduled to be recreated or are currently being being recreated.
3994 # Recreating an instance deletes the existing root persistent disk
3995 # and creates a new disk from the image that is defined in the
3996 # instance template.
3997 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
3998 # are being reconfigured with properties that do not require a restart
3999 # or a recreate action. For example, setting or removing target
4000 # pools for the instance.
4001 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
4002 # are scheduled to be restarted or are currently being restarted.
4003 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
4004 # are scheduled to be restarted or are currently being restarted.
4005 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
4006 # are scheduled to be resumed or are currently being resumed.
4007 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
4008 # are scheduled to be started or are currently being started.
4009 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
4010 # are scheduled to be stopped or are currently being stopped.
4011 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
4012 # are scheduled to be suspended or are currently being suspended.
4013 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
4014 # are being verified. See the managedInstances[].currentAction
4015 # property in the listManagedInstances method documentation.
4016 },
4017 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
4018 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
4019 # zones in a regional managed instance group.
4020 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
4021 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
4022 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
4023 # its instances.
4024 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
4025 # instances, even if an AI zone is available in the specified region. To
4026 # create instances in an AI zone in the selected region, you must explicitly
4027 # specify it in the distribution policy together with the other preferred
4028 # zones.
4029 {
4030 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
4031 # The zone must exist in the region where the managed instance group is
4032 # located.
4033 },
4034 ],
4035 },
4036 &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.
4037 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
4038 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
4039 # fingerprint must be provided in order to update the InstanceGroupManager,
4040 # otherwise the request will fail with error412 conditionNotMet.
4041 #
4042 # To see the latest fingerprint, make a get() request to
4043 # retrieve an InstanceGroupManager.
4044 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
4045 # generates this identifier.
4046 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
4047 # types of machines.
4048 # Instance flexibility configuration on MIG overrides instance
4049 # template configuration.
4050 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
4051 # when creating new VMs.
4052 &quot;a_key&quot;: {
4053 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
4054 # selection.
4055 { # An instance-attached disk resource.
4056 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
4057 # or X86_64.
4058 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
4059 # deleted (but not when the disk is detached from the instance).
4060 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
4061 # partition of the disk for its root filesystem.
4062 &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
4063 # running within the instance. This name can be used to reference the device
4064 # for mounting, resizing, and so on, from within the instance.
4065 #
4066 # If not specified, the server chooses a default device name to apply to this
4067 # disk, in the form persistent-disk-x, where x is a number
4068 # assigned by Google Compute Engine. This field is only applicable for
4069 # persistent disks.
4070 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
4071 # encryption key.
4072 #
4073 # If you are creating a new disk, this field encrypts the new disk using
4074 # an encryption key that you provide. If you are attaching an existing
4075 # disk that is already encrypted, this field decrypts the disk using
4076 # the customer-supplied encryption key.
4077 #
4078 # If you encrypt a disk using a customer-supplied key, you must provide the
4079 # same key again when you attempt to use this resource at a later time. For
4080 # example, you must provide the key when you create a snapshot or an image
4081 # from the disk or when you attach the disk to a virtual machine instance.
4082 #
4083 # If you do not provide an encryption key, then the disk will be encrypted
4084 # using an automatically generated key and you do not need to provide a key
4085 # to use the disk later.
4086 #
4087 # Note:
4088 #
4089 # Instance templates do not storecustomer-supplied
4090 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
4091 #
4092 # You cannot create VMs that have disks with customer-supplied keys using
4093 # the bulk
4094 # insert method.
4095 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4096 # For example:
4097 #
4098 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4099 # key_region/cryptoKeys/key
4100 #
4101 # The fully-qualifed key name may be returned for resource GET requests. For
4102 # example:
4103 #
4104 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4105 # key_region/cryptoKeys/key
4106 # /cryptoKeyVersions/1
4107 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4108 # key. If absent, the Compute Engine default service account is used.
4109 # For example:
4110 #
4111 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4112 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4113 # encryption key, encoded in RFC
4114 # 4648 base64 to either encrypt or decrypt this resource. You can
4115 # provide either the rawKey or thersaEncryptedKey.
4116 # For example:
4117 #
4118 # &quot;rawKey&quot;:
4119 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4120 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4121 # customer-supplied encryption key to either encrypt or decrypt this
4122 # resource. You can provide either the rawKey or thersaEncryptedKey.
4123 # For example:
4124 #
4125 # &quot;rsaEncryptedKey&quot;:
4126 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4127 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4128 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4129 #
4130 # The key must meet the following requirements before you can provide it to
4131 # Compute Engine:
4132 #
4133 # 1. The key is wrapped using a RSA public key certificate provided by
4134 # Google.
4135 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4136 # encoding.
4137 #
4138 # Gets the RSA public key certificate provided by Google at:
4139 #
4140 #
4141 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4142 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4143 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4144 # encryption key that protects this resource.
4145 },
4146 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
4147 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
4148 # currently attached to another instance. If you try to force attach a zonal
4149 # disk to an instance, you will receive an error.
4150 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4151 # only for bootable images. Read
4152 # Enabling guest operating system features to see a list of available
4153 # options.
4154 { # Guest OS features.
4155 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4156 # separate values. Set to one or more of the following values:
4157 #
4158 # - VIRTIO_SCSI_MULTIQUEUE
4159 # - WINDOWS
4160 # - MULTI_IP_SUBNET
4161 # - UEFI_COMPATIBLE
4162 # - GVNIC
4163 # - SEV_CAPABLE
4164 # - SUSPEND_RESUME_COMPATIBLE
4165 # - SEV_LIVE_MIGRATABLE_V2
4166 # - SEV_SNP_CAPABLE
4167 # - TDX_CAPABLE
4168 # - IDPF
4169 # - SNP_SVSM_CAPABLE
4170 # - CCA_CAPABLE
4171 #
4172 #
4173 # For more information, see
4174 # Enabling guest operating system features.
4175 },
4176 ],
4177 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
4178 # boot disk. If you have many disks attached to an instance, each
4179 # disk would have a unique index number.
4180 &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
4181 # alongside the new instance. Use initialization parameters to create boot
4182 # disks or local SSDs attached to the new instance.
4183 #
4184 # This property is mutually exclusive with the source property;
4185 # you can only define one or the other, but not both.
4186 # alongside the new instance. Use initialization parameters to create boot
4187 # disks or local SSDs attached to the new instance.
4188 #
4189 # This field is persisted and returned for instanceTemplate and not returned
4190 # in the context of instance.
4191 #
4192 # This property is mutually exclusive with the source property;
4193 # you can only define one or the other, but not both.
4194 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
4195 # arm64 or x86_64.
4196 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
4197 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
4198 # of the instance. If a disk with the same name already exists in the given
4199 # region, the existing disk is attached to the new instance and the
4200 # new disk is not created.
4201 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
4202 # 10 GB. If you specify a sourceImage, which is required for
4203 # boot disks, the default size is the size of the sourceImage.
4204 # If you do not specify a sourceImage, the default disk size
4205 # is 500 GB.
4206 &quot;diskType&quot;: &quot;A String&quot;,
4207 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
4208 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
4209 # only for bootable images. Read
4210 # Enabling guest operating system features to see a list of available
4211 # options.
4212 #
4213 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
4214 { # Guest OS features.
4215 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
4216 # separate values. Set to one or more of the following values:
4217 #
4218 # - VIRTIO_SCSI_MULTIQUEUE
4219 # - WINDOWS
4220 # - MULTI_IP_SUBNET
4221 # - UEFI_COMPATIBLE
4222 # - GVNIC
4223 # - SEV_CAPABLE
4224 # - SUSPEND_RESUME_COMPATIBLE
4225 # - SEV_LIVE_MIGRATABLE_V2
4226 # - SEV_SNP_CAPABLE
4227 # - TDX_CAPABLE
4228 # - IDPF
4229 # - SNP_SVSM_CAPABLE
4230 # - CCA_CAPABLE
4231 #
4232 #
4233 # For more information, see
4234 # Enabling guest operating system features.
4235 },
4236 ],
4237 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
4238 # persistent disks.
4239 &quot;a_key&quot;: &quot;A String&quot;,
4240 },
4241 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
4242 &quot;A String&quot;,
4243 ],
4244 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
4245 # more than one instance.
4246 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
4247 # is to use the existing disk.
4248 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
4249 # of I/O operations per second that the disk can handle. Values must be
4250 # between 10,000 and 120,000. For more details, see theExtreme persistent
4251 # disk documentation.
4252 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
4253 # number of throughput mb per second that the disk can handle. Values must
4254 # greater than or equal to 1.
4255 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
4256 # the URLs of the zones where the disk should be replicated to.
4257 # You must provide exactly two replica zones, and one zone must be the same
4258 # as the instance zone.
4259 &quot;A String&quot;,
4260 ],
4261 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
4262 # have the same definition as resource
4263 # manager tags. Keys and values can be either in numeric format,
4264 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
4265 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
4266 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
4267 # empty.
4268 &quot;a_key&quot;: &quot;A String&quot;,
4269 },
4270 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
4271 # Specified using the full or partial URL. For instance template, specify
4272 # only the resource policy name.
4273 &quot;A String&quot;,
4274 ],
4275 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
4276 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4277 # is required.
4278 #
4279 # To create a disk with one of the public operating system
4280 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
4281 #
4282 # projects/debian-cloud/global/images/family/debian-9
4283 #
4284 #
4285 # Alternatively, use a specific version of a public operating system image:
4286 #
4287 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
4288 #
4289 #
4290 # To create a disk with a custom image that you created, specify the
4291 # image name in the following format:
4292 #
4293 # global/images/my-custom-image
4294 #
4295 #
4296 # You can also specify a custom image by its image family, which returns
4297 # the latest version of the image in that family. Replace the image name
4298 # with family/family-name:
4299 #
4300 # global/images/family/my-image-family
4301 #
4302 #
4303 # If the source image is deleted later, this field will not be set.
4304 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
4305 # encryption key of the source image. Required if the source image is
4306 # protected by a customer-supplied encryption key.
4307 #
4308 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
4309 # encryption keys, so you cannot create disks for instances in a managed instance group if the
4310 # source images are encrypted with your own keys.
4311 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4312 # For example:
4313 #
4314 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4315 # key_region/cryptoKeys/key
4316 #
4317 # The fully-qualifed key name may be returned for resource GET requests. For
4318 # example:
4319 #
4320 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4321 # key_region/cryptoKeys/key
4322 # /cryptoKeyVersions/1
4323 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4324 # key. If absent, the Compute Engine default service account is used.
4325 # For example:
4326 #
4327 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4328 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4329 # encryption key, encoded in RFC
4330 # 4648 base64 to either encrypt or decrypt this resource. You can
4331 # provide either the rawKey or thersaEncryptedKey.
4332 # For example:
4333 #
4334 # &quot;rawKey&quot;:
4335 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4336 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4337 # customer-supplied encryption key to either encrypt or decrypt this
4338 # resource. You can provide either the rawKey or thersaEncryptedKey.
4339 # For example:
4340 #
4341 # &quot;rsaEncryptedKey&quot;:
4342 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4343 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4344 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4345 #
4346 # The key must meet the following requirements before you can provide it to
4347 # Compute Engine:
4348 #
4349 # 1. The key is wrapped using a RSA public key certificate provided by
4350 # Google.
4351 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4352 # encoding.
4353 #
4354 # Gets the RSA public key certificate provided by Google at:
4355 #
4356 #
4357 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4358 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4359 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4360 # encryption key that protects this resource.
4361 },
4362 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
4363 # instance boot disk, one of initializeParams.sourceSnapshot
4364 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
4365 # is required.
4366 #
4367 # To create a disk with a snapshot that you created, specify the
4368 # snapshot name in the following format:
4369 #
4370 # us-central1-a/instantSnapshots/my-backup
4371 #
4372 #
4373 # If the source instant-snapshot is deleted later, this field will not be
4374 # set.
4375 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
4376 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
4377 # is required.
4378 #
4379 # To create a disk with a snapshot that you created, specify the
4380 # snapshot name in the following format:
4381 #
4382 # global/snapshots/my-backup
4383 #
4384 #
4385 # If the source snapshot is deleted later, this field will not be set.
4386 #
4387 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
4388 # an image instead when you create VMs using
4389 # the bulk
4390 # insert method.
4391 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
4392 # encryption key of the source snapshot.
4393 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
4394 # For example:
4395 #
4396 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4397 # key_region/cryptoKeys/key
4398 #
4399 # The fully-qualifed key name may be returned for resource GET requests. For
4400 # example:
4401 #
4402 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
4403 # key_region/cryptoKeys/key
4404 # /cryptoKeyVersions/1
4405 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
4406 # key. If absent, the Compute Engine default service account is used.
4407 # For example:
4408 #
4409 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
4410 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
4411 # encryption key, encoded in RFC
4412 # 4648 base64 to either encrypt or decrypt this resource. You can
4413 # provide either the rawKey or thersaEncryptedKey.
4414 # For example:
4415 #
4416 # &quot;rawKey&quot;:
4417 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
4418 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
4419 # customer-supplied encryption key to either encrypt or decrypt this
4420 # resource. You can provide either the rawKey or thersaEncryptedKey.
4421 # For example:
4422 #
4423 # &quot;rsaEncryptedKey&quot;:
4424 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
4425 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
4426 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
4427 #
4428 # The key must meet the following requirements before you can provide it to
4429 # Compute Engine:
4430 #
4431 # 1. The key is wrapped using a RSA public key certificate provided by
4432 # Google.
4433 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
4434 # encoding.
4435 #
4436 # Gets the RSA public key certificate provided by Google at:
4437 #
4438 #
4439 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
4440 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
4441 # 4648 base64 encoded SHA-256 hash of the customer-supplied
4442 # encryption key that protects this resource.
4443 },
4444 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
4445 # this as a partial or full URL to the resource. For example, the following
4446 # are valid values:
4447 #
4448 #
4449 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
4450 # - projects/project/zones/zone/storagePools/storagePool
4451 # - zones/zone/storagePools/storagePool
4452 },
4453 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
4454 # either SCSI or NVME. For most machine types, the
4455 # default is SCSI. Local SSDs can use either NVME or SCSI.
4456 # In certain configurations, persistent disks can use NVMe. For more
4457 # information, seeAbout
4458 # persistent disks.
4459 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
4460 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
4461 &quot;A String&quot;,
4462 ],
4463 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
4464 # disk is not allowed to be detached from the instance, or to be used as the
4465 # source of the snapshot creation, and the image creation. The instance with
4466 # at least one locked attached disk is not allow to be used as source of
4467 # machine image creation, instant snapshot creation, and not allowed to be
4468 # deleted with --keep-disk parameter set to true for locked disks.
4469 &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
4470 # in READ_WRITE mode.
4471 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
4472 # field is set to PRESERVED if the LocalSSD data has been saved
4473 # to a persistent location by customer request. (see the
4474 # discard_local_ssd option on Stop/Suspend).
4475 # Read-only in the api.
4476 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
4477 # these are public keys which are safe to store in public
4478 &quot;dbs&quot;: [ # The Key Database (db).
4479 {
4480 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4481 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4482 },
4483 ],
4484 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
4485 {
4486 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4487 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4488 },
4489 ],
4490 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
4491 {
4492 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4493 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4494 },
4495 ],
4496 &quot;pk&quot;: { # The Platform Key (PK).
4497 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
4498 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
4499 },
4500 },
4501 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
4502 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
4503 # is required.
4504 #
4505 # If desired, you can also attach existing non-root persistent disks using
4506 # this property. This field is only applicable for persistent disks.
4507 #
4508 # Note that for InstanceTemplate, specify the disk name for zonal disk,
4509 # and the URL for regional disk.
4510 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
4511 },
4512 ],
4513 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
4514 &quot;A String&quot;,
4515 ],
4516 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
4517 # e.g. &#x27;Intel Ice Lake&#x27;.
4518 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
4519 # preference. MIG will first try to create a VM based on the machine-type
4520 # with lowest rank and fallback to next rank based on availability.
4521 # Machine types and instance selections with the same rank have the same
4522 # preference.
4523 },
4524 },
4525 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
4526 # create instances.
4527 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
4528 # more preemption than the minimum capacity user needs. MIG will create
4529 # only Standard VMs until it reaches standard_capacity_base and only
4530 # then will start using standard_capacity_percent_above_base to mix Spot
4531 # with Standard VMs.
4532 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
4533 # remaining percentage will use Spot VMs. The percentage applies only to
4534 # the capacity above standard_capacity_base.
4535 },
4536 },
4537 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
4538 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
4539 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
4540 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
4541 # applies to the VMs on which your application fails a health check.
4542 # Valid values are
4543 #
4544 # - REPAIR (default): MIG automatically repairs a failed VM
4545 # by recreating it. For more information, see About
4546 # repairing VMs in a MIG.
4547 # - DO_NOTHING: MIG does not repair a failed VM.
4548 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
4549 # configuration when repairing a VM. Valid options are:
4550 #
4551 #
4552 #
4553 # - NO (default): If configuration updates are available, they are not
4554 # forcefully applied during repair. Instead, configuration updates are
4555 # applied according to the group&#x27;s update policy.
4556 #
4557 # - YES: If configuration updates are available, they are applied
4558 # during repair.
4559 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
4560 # unhealthy when the application running on that VM fails a health check.
4561 # Valid values are:
4562 #
4563 # - DEFAULT_ACTION (default): MIG uses the same action
4564 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
4565 # - REPAIR: MIG automatically repairs an unhealthy VM by
4566 # recreating it.
4567 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
4568 # For more information, see
4569 # About repairing VMs in a MIG.
4570 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
4571 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
4572 # Valid values are:
4573 #
4574 # - NO (default): MIG cannot change a VM&#x27;s zone during a
4575 # repair.
4576 # - YES: MIG can select a different zone for the VM during
4577 # a repair.
4578 },
4579 },
4580 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
4581 # instance group. The group uses this template to create all new instances
4582 # in the managed instance group. The templates for existing instances in the
4583 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
4584 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
4585 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
4586 # this managed instance group.
4587 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
4588 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
4589 # long, and comply withRFC1035.
4590 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
4591 # to this Instance Group Manager.
4592 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
4593 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
4594 # The name must be 1-63 characters long, and comply withRFC1035.
4595 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
4596 },
4597 ],
4598 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
4599 # as part of resource payload.
4600 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
4601 # key-value pairs. Keys and values can be either in numeric format,
4602 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
4603 # format such as `{org_id|project_id}/{tag_key_short_name}` and
4604 # `{tag_value_short_name}`. For more information, seeManage tags
4605 # for resources.
4606 &quot;a_key&quot;: &quot;A String&quot;,
4607 },
4608 },
4609 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
4610 # where the managed instance group resides (for regional resources).
4611 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
4612 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
4613 # instance group.
4614 # It can be a full or partial URL. For example, the following are
4615 # all valid URLs to a workload policy:
4616 #
4617 #
4618 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
4619 # - projects/project/regions/region/resourcePolicies/resourcePolicy
4620 # - regions/region/resourcePolicies/resourcePolicy
4621 },
4622 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
4623 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
4624 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
4625 # this URL.
4626 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
4627 # by the managed instance group on instances. The service accounts needs all
4628 # permissions required to create and delete instances.
4629 # By default, the service account
4630 # {projectNumber}@cloudservices.gserviceaccount.com is used.
4631 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
4632 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
4633 # stop a VM after that VM was created. The initial delay gives the
4634 # initialization script the time to prepare your VM for a quick scale out.
4635 # The value of initial delay must be between 0 and 3600 seconds. The
4636 # default value is 0.
4637 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
4638 # group scales out. The default mode is `MANUAL`.
4639 },
4640 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
4641 &quot;preservedState&quot;: { # Configuration of preserved resources.
4642 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
4643 # delete, update, etc. This map is keyed with the device names of
4644 # the disks.
4645 &quot;a_key&quot;: {
4646 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
4647 # update or VM instance recreate operations.
4648 # This flag is used to configure if the disk should be deleted after it
4649 # is no longer used by the group, e.g. when the given instance or
4650 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
4651 },
4652 },
4653 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
4654 # instance delete, update, etc. This map is keyed with the network
4655 # interface name.
4656 &quot;a_key&quot;: {
4657 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
4658 # update or VM instance recreate operations.
4659 # This flag is used to configure if the IP reservation should be deleted
4660 # after it is no longer used by the group, e.g. when the given instance
4661 # or the whole group is deleted.
4662 },
4663 },
4664 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
4665 # instance delete, update, etc. This map is keyed with the network
4666 # interface name.
4667 &quot;a_key&quot;: {
4668 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
4669 # update or VM instance recreate operations.
4670 # This flag is used to configure if the IP reservation should be deleted
4671 # after it is no longer used by the group, e.g. when the given instance
4672 # or the whole group is deleted.
4673 },
4674 },
4675 },
4676 },
4677 &quot;status&quot;: { # Output only. The status of this managed instance group.
4678 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
4679 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
4680 # This value is in RFC3339 text format.
4681 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
4682 # been applied to all managed instances in the group.
4683 },
4684 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
4685 # Currently only one accelerator topology is supported.
4686 {
4687 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
4688 # The value is the same as configured in the WorkloadPolicy.
4689 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
4690 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
4691 # check.
4692 &quot;error&quot;: { # Output only. Encountered errors.
4693 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4694 # operation.
4695 {
4696 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4697 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4698 # details. There is a set of defined message types to use for providing
4699 # details.The syntax depends on the error code. For example,
4700 # QuotaExceededInfo will have details when the error code is
4701 # QUOTA_EXCEEDED.
4702 {
4703 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4704 #
4705 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4706 # is not enabled:
4707 #
4708 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4709 # &quot;domain&quot;: &quot;googleapis.com&quot;
4710 # &quot;metadata&quot;: {
4711 # &quot;resource&quot;: &quot;projects/123&quot;,
4712 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4713 # }
4714 # }
4715 #
4716 # This response indicates that the pubsub.googleapis.com API is not enabled.
4717 #
4718 # Example of an error that is returned when attempting to create a Spanner
4719 # instance in a region that is out of stock:
4720 #
4721 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4722 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4723 # &quot;metadata&quot;: {
4724 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4725 # }
4726 # }
4727 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4728 # is typically the registered service name of the tool or product that
4729 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4730 # generated by some common infrastructure, the error domain must be a
4731 # globally unique value that identifies the infrastructure. For Google API
4732 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4733 &quot;metadatas&quot;: { # Additional structured details about this error.
4734 #
4735 # Keys must match a regular expression of `a-z+` but should
4736 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4737 # length. When identifying the current value of an exceeded limit, the units
4738 # should be contained in the key, not the value. For example, rather than
4739 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4740 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4741 # instances that can be created in a single (batch) request.
4742 &quot;a_key&quot;: &quot;A String&quot;,
4743 },
4744 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4745 # proximate cause of the error. Error reasons are unique within a particular
4746 # domain of errors. This should be at most 63 characters and match a
4747 # regular expression of `A-Z+[A-Z0-9]`, which represents
4748 # UPPER_SNAKE_CASE.
4749 },
4750 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4751 #
4752 # For example, if a quota check failed with an error indicating the calling
4753 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4754 # directly to the right place in the developer console to flip the bit.
4755 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4756 { # Describes a URL link.
4757 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4758 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4759 },
4760 ],
4761 },
4762 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4763 # which can be attached to an RPC error.
4764 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4765 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4766 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4767 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4768 },
4769 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4770 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4771 &quot;a_key&quot;: &quot;A String&quot;,
4772 },
4773 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4774 # type or metric.
4775 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4776 # or metric.
4777 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4778 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4779 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4780 },
4781 },
4782 ],
4783 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4784 # This property is optional.
4785 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4786 },
4787 ],
4788 },
4789 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
4790 # has // RFC3339 //
4791 # text format.
4792 },
4793 },
4794 ],
4795 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
4796 # that targets this instance group manager.
4797 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
4798 # targetSizePolicy.mode is set to BULK.
4799 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
4800 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
4801 # operation.
4802 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
4803 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4804 # operation.
4805 {
4806 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4807 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4808 # details. There is a set of defined message types to use for providing
4809 # details.The syntax depends on the error code. For example,
4810 # QuotaExceededInfo will have details when the error code is
4811 # QUOTA_EXCEEDED.
4812 {
4813 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4814 #
4815 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4816 # is not enabled:
4817 #
4818 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4819 # &quot;domain&quot;: &quot;googleapis.com&quot;
4820 # &quot;metadata&quot;: {
4821 # &quot;resource&quot;: &quot;projects/123&quot;,
4822 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4823 # }
4824 # }
4825 #
4826 # This response indicates that the pubsub.googleapis.com API is not enabled.
4827 #
4828 # Example of an error that is returned when attempting to create a Spanner
4829 # instance in a region that is out of stock:
4830 #
4831 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4832 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4833 # &quot;metadata&quot;: {
4834 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4835 # }
4836 # }
4837 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4838 # is typically the registered service name of the tool or product that
4839 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4840 # generated by some common infrastructure, the error domain must be a
4841 # globally unique value that identifies the infrastructure. For Google API
4842 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4843 &quot;metadatas&quot;: { # Additional structured details about this error.
4844 #
4845 # Keys must match a regular expression of `a-z+` but should
4846 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4847 # length. When identifying the current value of an exceeded limit, the units
4848 # should be contained in the key, not the value. For example, rather than
4849 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4850 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4851 # instances that can be created in a single (batch) request.
4852 &quot;a_key&quot;: &quot;A String&quot;,
4853 },
4854 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4855 # proximate cause of the error. Error reasons are unique within a particular
4856 # domain of errors. This should be at most 63 characters and match a
4857 # regular expression of `A-Z+[A-Z0-9]`, which represents
4858 # UPPER_SNAKE_CASE.
4859 },
4860 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4861 #
4862 # For example, if a quota check failed with an error indicating the calling
4863 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4864 # directly to the right place in the developer console to flip the bit.
4865 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4866 { # Describes a URL link.
4867 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4868 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4869 },
4870 ],
4871 },
4872 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4873 # which can be attached to an RPC error.
4874 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4875 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4876 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4877 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4878 },
4879 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4880 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4881 &quot;a_key&quot;: &quot;A String&quot;,
4882 },
4883 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4884 # type or metric.
4885 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4886 # or metric.
4887 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4888 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4889 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4890 },
4891 },
4892 ],
4893 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4894 # This property is optional.
4895 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4896 },
4897 ],
4898 },
4899 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
4900 # operation. Timestamp is in RFC3339 text format.
4901 },
4902 },
4903 &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
4904 # in this managed instance group that have the status. Currently only shown
4905 # for TPU MIGs
4906 # instance group that have the status. For more information about how to
4907 # interpret each status check the instance lifecycle documentation.
4908 # Currently only shown for TPU MIGs.
4909 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
4910 # that have DEPROVISIONING status.
4911 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
4912 # have been deleted. Includes only instances that would be shown in the
4913 # listManagedInstances method and not all instances that have been
4914 # deleted in the lifetime of the MIG.
4915 # Does not include FlexStart instances that are waiting for the resources
4916 # availability, they are considered as &#x27;pending&#x27;.
4917 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
4918 # that have PENDING status, that is FlexStart instances that are waiting
4919 # for resources. Instances that do not exist because of the other reasons
4920 # are counted as &#x27;non_existent&#x27;.
4921 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
4922 # that have PENDING_STOP status.
4923 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
4924 # that have PROVISIONING status.
4925 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
4926 # that have REPAIRING status.
4927 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
4928 # that have RUNNING status.
4929 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
4930 # that have STAGING status.
4931 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
4932 # that have STOPPED status.
4933 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
4934 # that have STOPPING status.
4935 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
4936 # that have SUSPENDED status.
4937 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
4938 # that have SUSPENDING status.
4939 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
4940 # that have TERMINATED status.
4941 },
4942 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
4943 # stable state. A stable state means that: none of the instances in the
4944 # managed instance group is currently undergoing any type of change (for
4945 # example, creation, restart, or deletion); no future changes are scheduled
4946 # for instances in the managed instance group; and the managed instance
4947 # group itself is not being modified.
4948 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
4949 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
4950 # has stateful configuration, that is, if you have configured any items
4951 # in a stateful policy or in per-instance configs.
4952 # The group might report that it has no stateful configuration even when
4953 # there is still some preserved state on a managed instance, for example,
4954 # if you have deleted all PICs but not yet applied those deletions.
4955 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
4956 # has stateful configuration, that is, if you have configured any items
4957 # in a stateful policy or in per-instance configs.
4958 # The group might report that it has no stateful configuration even when
4959 # there is still some preserved state on a managed instance, for example,
4960 # if you have deleted all PICs but not yet applied those deletions. This
4961 # field is deprecated in favor of has_stateful_config.
4962 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
4963 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
4964 # (listed in the output of a listPerInstanceConfigs API call) have
4965 # status EFFECTIVE or there are no per-instance-configs.
4966 },
4967 },
4968 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
4969 # target version specified by version field on Instance Group
4970 # Manager.
4971 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
4972 # in this managed instance group, i.e. all instances are in their target
4973 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
4974 },
4975 },
4976 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
4977 # apply to all of the instances in the managed instance group.
4978 &quot;A String&quot;,
4979 ],
4980 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
4981 # You can reduce this number by using the instanceGroupManager
4982 # deleteInstances or abandonInstances methods. Resizing the group also
4983 # changes this number.
4984 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
4985 # size.
4986 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
4987 # individually or all at once.
4988 },
4989 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
4990 # This number changes when you:
4991 #
4992 # - Stop instance using the stopInstances
4993 # method or start instances using the startInstances
4994 # method.
4995 # - Manually change the targetStoppedSize using the update
4996 # method.
4997 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
4998 # This number changes when you:
4999 #
5000 # - Suspend instance using the suspendInstances
5001 # method or resume instances using the resumeInstances
5002 # method.
5003 # - Manually change the targetSuspendedSize using the update
5004 # method.
5005 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
5006 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
5007 &quot;A String&quot;,
5008 ],
5009 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
5010 # instance redistribution policy for regional managed instance groups.
5011 # Valid values are:
5012 #
5013 # - PROACTIVE (default): The group attempts to maintain an
5014 # even distribution of VM instances across zones in the region.
5015 # - NONE: For non-autoscaled groups, proactive
5016 # redistribution is disabled.
5017 &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
5018 # either a fixed number or, if the group has 10 or more instances, a
5019 # percentage. If you set a percentage, the number of instances is rounded
5020 # if necessary. The default value for maxSurge is a fixed
5021 # value equal to the number of zones in which the managed instance group
5022 # operates.
5023 #
5024 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
5025 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
5026 #
5027 #
5028 #
5029 # - If the value is fixed, then the calculated
5030 # value is equal to the fixed value.
5031 # - If the value is a percent, then the
5032 # calculated
5033 # value is percent/100 * targetSize. For example,
5034 # the calculated value of a 80% of a managed instance group
5035 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
5036 # is a remainder, the number is rounded.
5037 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
5038 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
5039 # example, specify 80 for 80%.
5040 },
5041 &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
5042 # process. An instance is considered available if all of the following
5043 # conditions are satisfied:
5044 #
5045 #
5046 #
5047 # - The instance&#x27;s status is
5048 # RUNNING.
5049 # - If there is a health
5050 # check on the instance group, the instance&#x27;s health check status
5051 # must be HEALTHY at least once. If there is no health check
5052 # on the group, then the instance only needs to have a status of
5053 # RUNNING to be considered available.
5054 #
5055 #
5056 # This value can be either a fixed number or, if the group has 10 or more
5057 # instances, a percentage. If you set a percentage, the number of instances
5058 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
5059 # in which the managed instance group operates.
5060 #
5061 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
5062 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
5063 #
5064 #
5065 #
5066 # - If the value is fixed, then the calculated
5067 # value is equal to the fixed value.
5068 # - If the value is a percent, then the
5069 # calculated
5070 # value is percent/100 * targetSize. For example,
5071 # the calculated value of a 80% of a managed instance group
5072 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
5073 # is a remainder, the number is rounded.
5074 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
5075 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
5076 # example, specify 80 for 80%.
5077 },
5078 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
5079 # becomes available. This value must be from range [0, 3600].
5080 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
5081 # disruption as much as possible or to apply a more disruptive action than
5082 # is necessary.
5083 #
5084 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
5085 # Compute Engine performs the necessary action to execute the update.
5086 # - To apply a more disruptive action than is strictly necessary, set the
5087 # minimal action to RESTART or REPLACE. For
5088 # example, Compute Engine does not need to restart a VM to change its
5089 # metadata. But if your application reads instance metadata only when a VM
5090 # is restarted, you can set the minimal action to RESTART in
5091 # order to pick up metadata changes.
5092 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
5093 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
5094 # as much as possible. RESTART to allow actions that can be
5095 # applied without instance replacing or REPLACE to allow all
5096 # possible actions. If the Updater determines that the minimal update
5097 # action needed is more disruptive than most disruptive allowed action you
5098 # specify it will not perform the update at all.
5099 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
5100 # See minimal_action.REPLACE
5101 &quot;type&quot;: &quot;A String&quot;, # The type
5102 # of update process. You can specify either PROACTIVE so
5103 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
5104 # to update.
5105 },
5106 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
5107 # create instances.
5108 #
5109 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
5110 # group. This field overrides the top-level instanceTemplate
5111 # field. Read more about therelationships
5112 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
5113 # remaining instances. For more information, read aboutcanary
5114 # updates.
5115 {
5116 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
5117 # instance group. The group uses this template to create new instances in
5118 # the managed instance group until the `targetSize` for this version is
5119 # reached. The templates for existing instances in the group do not change
5120 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
5121 # existing instances are updated until the `targetSize` for this version is
5122 # reached.
5123 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
5124 # managed instance group.
5125 &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
5126 # from the template will be equal to:
5127 #
5128 #
5129 # - If expressed as a fixed number, the minimum of either
5130 # targetSize.fixed or
5131 # instanceGroupManager.targetSize is used.
5132 # - if expressed as a percent, the targetSize
5133 # would be (targetSize.percent/100 *
5134 # InstanceGroupManager.targetSize) If there is a remainder, the
5135 # number is rounded.
5136 #
5137 # If unset, this version will update any remaining instances not
5138 # updated by another version. ReadStarting
5139 # a canary update for more information.
5140 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
5141 #
5142 #
5143 #
5144 # - If the value is fixed, then the calculated
5145 # value is equal to the fixed value.
5146 # - If the value is a percent, then the
5147 # calculated
5148 # value is percent/100 * targetSize. For example,
5149 # the calculated value of a 80% of a managed instance group
5150 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
5151 # is a remainder, the number is rounded.
5152 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
5153 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
5154 # example, specify 80 for 80%.
5155 },
5156 },
5157 ],
5158 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
5159 # where the managed instance group is located (for zonal resources).
5160 }</pre>
5161 </div>
5162
5163 <div class="method">
5164 <code class="details" id="getAvailableAcceleratorTopologies">getAvailableAcceleratorTopologies(project, zone, resourceId, x__xgafv=None)</code>
5165 <pre>Returns information about available accelerator topologies for a given MIG.
5166
5167 Args:
5168 project: string, Required. Project ID for this request. (required)
5169 zone: string, Required. The name of thezone where the managed
5170 instance group is located.
5171 Name should conform to RFC1035. (required)
5172 resourceId: string, Required. The name of the managed instance group.
5173 It should conform to RFC1035. (required)
5174 x__xgafv: string, V1 error format.
5175 Allowed values
5176 1 - v1 error format
5177 2 - v2 error format
5178
5179 Returns:
5180 An object of the form:
5181
5182 {
5183 &quot;acceleratorTopologiesInfo&quot;: { # The accelerator topology information returned per id of the topology
5184 # location.
5185 &quot;a_key&quot;: {
5186 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
5187 &quot;acceleratorTopologyHealth&quot;: &quot;A String&quot;,
5188 &quot;acceleratorTopologyState&quot;: { # Specifies the topology state
5189 &quot;currentState&quot;: &quot;A String&quot;,
5190 &quot;error&quot;: { # Reason why the topology state change failed
5191 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
5192 # operation.
5193 {
5194 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
5195 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
5196 # details. There is a set of defined message types to use for providing
5197 # details.The syntax depends on the error code. For example,
5198 # QuotaExceededInfo will have details when the error code is
5199 # QUOTA_EXCEEDED.
5200 {
5201 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
5202 #
5203 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
5204 # is not enabled:
5205 #
5206 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
5207 # &quot;domain&quot;: &quot;googleapis.com&quot;
5208 # &quot;metadata&quot;: {
5209 # &quot;resource&quot;: &quot;projects/123&quot;,
5210 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
5211 # }
5212 # }
5213 #
5214 # This response indicates that the pubsub.googleapis.com API is not enabled.
5215 #
5216 # Example of an error that is returned when attempting to create a Spanner
5217 # instance in a region that is out of stock:
5218 #
5219 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
5220 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
5221 # &quot;metadata&quot;: {
5222 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
5223 # }
5224 # }
5225 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
5226 # is typically the registered service name of the tool or product that
5227 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
5228 # generated by some common infrastructure, the error domain must be a
5229 # globally unique value that identifies the infrastructure. For Google API
5230 # infrastructure, the error domain is &quot;googleapis.com&quot;.
5231 &quot;metadatas&quot;: { # Additional structured details about this error.
5232 #
5233 # Keys must match a regular expression of `a-z+` but should
5234 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
5235 # length. When identifying the current value of an exceeded limit, the units
5236 # should be contained in the key, not the value. For example, rather than
5237 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
5238 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
5239 # instances that can be created in a single (batch) request.
5240 &quot;a_key&quot;: &quot;A String&quot;,
5241 },
5242 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
5243 # proximate cause of the error. Error reasons are unique within a particular
5244 # domain of errors. This should be at most 63 characters and match a
5245 # regular expression of `A-Z+[A-Z0-9]`, which represents
5246 # UPPER_SNAKE_CASE.
5247 },
5248 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
5249 #
5250 # For example, if a quota check failed with an error indicating the calling
5251 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
5252 # directly to the right place in the developer console to flip the bit.
5253 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
5254 { # Describes a URL link.
5255 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
5256 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
5257 },
5258 ],
5259 },
5260 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
5261 # which can be attached to an RPC error.
5262 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
5263 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
5264 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
5265 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
5266 },
5267 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
5268 &quot;dimensions&quot;: { # The map holding related quota dimensions.
5269 &quot;a_key&quot;: &quot;A String&quot;,
5270 },
5271 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
5272 # type or metric.
5273 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
5274 # or metric.
5275 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
5276 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
5277 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
5278 },
5279 },
5280 ],
5281 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
5282 # This property is optional.
5283 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
5284 },
5285 ],
5286 },
5287 &quot;errorTimestamp&quot;: &quot;A String&quot;, # Timestamp when the last error happened
5288 &quot;externalId&quot;: &quot;A String&quot;, # Identifier of the accelerator topology assigned externally to
5289 # differentiate who is the owner of the topology. This is set in
5290 # ConfigureAcceleratorTopologies. If it is provided on activating the
5291 # sub-slice it will have to be provided on deactivating as well.
5292 # This identifier is cleared on successful deform of a sub-slice.
5293 },
5294 &quot;instancesHealth&quot;: &quot;A String&quot;,
5295 &quot;parent&quot;: &quot;A String&quot;, # Identified by the topology Id in the accelerator_topology_info map. Empty
5296 # for the top-level topology
5297 },
5298 },
5299 &quot;multiMig&quot;: &quot;A String&quot;, # URL to MMIG this MIG belongs to.
5300 }</pre>
5301 </div>
5302
5303 <div class="method">
5304 <code class="details" id="insert">insert(project, zone, body=None, requestId=None, x__xgafv=None)</code>
5305 <pre>Creates a managed instance group using the information that you specify
5306 in the request. After the group is created, instances in the group are
5307 created using the specified instance template.
5308 This operation is marked as DONE when the group is created
5309 even if the instances in the group have not yet been created. You
5310 must separately verify the status of the individual instances with thelistmanagedinstances
5311 method.
5312
5313 A managed instance group can have up to 1000 VM instances per group. Please
5314 contact Cloud Support if you need an increase in
5315 this limit.
5316
5317 Args:
5318 project: string, Project ID for this request. (required)
5319 zone: string, The name of the zone
5320 where you want to create the managed instance group. (required)
5321 body: object, The request body.
5322 The object takes the form of:
5323
5324 { # Represents a Managed Instance Group resource.
5325 #
5326 # An instance group is a collection of VM instances that you can manage as a
5327 # single entity. For more information, readInstance groups.
5328 #
5329 # For zonal Managed Instance Group, use the instanceGroupManagers
5330 # resource.
5331 #
5332 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
5333 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
5334 # for the group.
5335 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
5336 #
5337 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
5338 # instances to apply the configuration. To apply the configuration, set the
5339 # group&#x27;s updatePolicy.type field to use proactive updates or
5340 # use the applyUpdatesToInstances method.
5341 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
5342 &quot;a_key&quot;: &quot;A String&quot;,
5343 },
5344 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
5345 # more information, see Project and
5346 # instance metadata.
5347 &quot;a_key&quot;: &quot;A String&quot;,
5348 },
5349 },
5350 },
5351 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
5352 # only one value.
5353 {
5354 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
5355 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
5356 # initialize and run its startup script. During a VM&#x27;s initial delay
5357 # period, the MIG ignores unsuccessful health checks because the VM might
5358 # be in the startup process. This prevents the MIG from prematurely
5359 # recreating a VM. If the health check receives a healthy response during
5360 # the initial delay, it indicates that the startup process is complete and
5361 # the VM is ready. The value of initial delay must be between 0 and 3600
5362 # seconds. The default value is 0.
5363 },
5364 ],
5365 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
5366 # all VMs in a MIG. The maximum character length is 58 and the name must
5367 # comply with RFC1035 format.
5368 #
5369 # When a VM is created in the group, the MIG appends a hyphen and a random
5370 # four-character string to the base instance name. If you want the MIG to
5371 # assign sequential numbers instead of a random string, then end the base
5372 # instance name with a hyphen followed by one or more hash symbols. The hash
5373 # symbols indicate the number of digits. For example, a base instance name of
5374 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
5375 # @pattern
5376 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
5377 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
5378 # text format.
5379 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
5380 # in this managed instance group that are scheduled for each of those
5381 # actions.
5382 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
5383 # that are scheduled to be abandoned. Abandoning an instance removes it
5384 # from the managed instance group without deleting it.
5385 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
5386 # are scheduled to be adopted or are currently being adopted.
5387 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
5388 # are scheduled to be created or are currently being created. If the group
5389 # fails to create any of these instances, it tries again until it creates
5390 # the instance successfully.
5391 #
5392 # If you have disabled creation retries, this field will not be populated;
5393 # instead, the creatingWithoutRetries field will be populated.
5394 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
5395 # will attempt to create. The group attempts to create each instance
5396 # only once. If the group fails to create any of these instances, it
5397 # decreases the group&#x27;s targetSize value accordingly.
5398 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
5399 # are scheduled to be deleted or are currently being deleted.
5400 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
5401 # are running and have no scheduled actions.
5402 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
5403 # are scheduled to be recreated or are currently being being recreated.
5404 # Recreating an instance deletes the existing root persistent disk
5405 # and creates a new disk from the image that is defined in the
5406 # instance template.
5407 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
5408 # are being reconfigured with properties that do not require a restart
5409 # or a recreate action. For example, setting or removing target
5410 # pools for the instance.
5411 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
5412 # are scheduled to be restarted or are currently being restarted.
5413 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
5414 # are scheduled to be restarted or are currently being restarted.
5415 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
5416 # are scheduled to be resumed or are currently being resumed.
5417 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
5418 # are scheduled to be started or are currently being started.
5419 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
5420 # are scheduled to be stopped or are currently being stopped.
5421 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
5422 # are scheduled to be suspended or are currently being suspended.
5423 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
5424 # are being verified. See the managedInstances[].currentAction
5425 # property in the listManagedInstances method documentation.
5426 },
5427 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
5428 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
5429 # zones in a regional managed instance group.
5430 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
5431 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
5432 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
5433 # its instances.
5434 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
5435 # instances, even if an AI zone is available in the specified region. To
5436 # create instances in an AI zone in the selected region, you must explicitly
5437 # specify it in the distribution policy together with the other preferred
5438 # zones.
5439 {
5440 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
5441 # The zone must exist in the region where the managed instance group is
5442 # located.
5443 },
5444 ],
5445 },
5446 &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.
5447 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
5448 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
5449 # fingerprint must be provided in order to update the InstanceGroupManager,
5450 # otherwise the request will fail with error412 conditionNotMet.
5451 #
5452 # To see the latest fingerprint, make a get() request to
5453 # retrieve an InstanceGroupManager.
5454 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
5455 # generates this identifier.
5456 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
5457 # types of machines.
5458 # Instance flexibility configuration on MIG overrides instance
5459 # template configuration.
5460 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
5461 # when creating new VMs.
5462 &quot;a_key&quot;: {
5463 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
5464 # selection.
5465 { # An instance-attached disk resource.
5466 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
5467 # or X86_64.
5468 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
5469 # deleted (but not when the disk is detached from the instance).
5470 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
5471 # partition of the disk for its root filesystem.
5472 &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
5473 # running within the instance. This name can be used to reference the device
5474 # for mounting, resizing, and so on, from within the instance.
5475 #
5476 # If not specified, the server chooses a default device name to apply to this
5477 # disk, in the form persistent-disk-x, where x is a number
5478 # assigned by Google Compute Engine. This field is only applicable for
5479 # persistent disks.
5480 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
5481 # encryption key.
5482 #
5483 # If you are creating a new disk, this field encrypts the new disk using
5484 # an encryption key that you provide. If you are attaching an existing
5485 # disk that is already encrypted, this field decrypts the disk using
5486 # the customer-supplied encryption key.
5487 #
5488 # If you encrypt a disk using a customer-supplied key, you must provide the
5489 # same key again when you attempt to use this resource at a later time. For
5490 # example, you must provide the key when you create a snapshot or an image
5491 # from the disk or when you attach the disk to a virtual machine instance.
5492 #
5493 # If you do not provide an encryption key, then the disk will be encrypted
5494 # using an automatically generated key and you do not need to provide a key
5495 # to use the disk later.
5496 #
5497 # Note:
5498 #
5499 # Instance templates do not storecustomer-supplied
5500 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
5501 #
5502 # You cannot create VMs that have disks with customer-supplied keys using
5503 # the bulk
5504 # insert method.
5505 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5506 # For example:
5507 #
5508 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5509 # key_region/cryptoKeys/key
5510 #
5511 # The fully-qualifed key name may be returned for resource GET requests. For
5512 # example:
5513 #
5514 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5515 # key_region/cryptoKeys/key
5516 # /cryptoKeyVersions/1
5517 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5518 # key. If absent, the Compute Engine default service account is used.
5519 # For example:
5520 #
5521 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5522 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5523 # encryption key, encoded in RFC
5524 # 4648 base64 to either encrypt or decrypt this resource. You can
5525 # provide either the rawKey or thersaEncryptedKey.
5526 # For example:
5527 #
5528 # &quot;rawKey&quot;:
5529 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5530 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5531 # customer-supplied encryption key to either encrypt or decrypt this
5532 # resource. You can provide either the rawKey or thersaEncryptedKey.
5533 # For example:
5534 #
5535 # &quot;rsaEncryptedKey&quot;:
5536 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5537 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5538 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5539 #
5540 # The key must meet the following requirements before you can provide it to
5541 # Compute Engine:
5542 #
5543 # 1. The key is wrapped using a RSA public key certificate provided by
5544 # Google.
5545 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5546 # encoding.
5547 #
5548 # Gets the RSA public key certificate provided by Google at:
5549 #
5550 #
5551 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5552 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5553 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5554 # encryption key that protects this resource.
5555 },
5556 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
5557 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
5558 # currently attached to another instance. If you try to force attach a zonal
5559 # disk to an instance, you will receive an error.
5560 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5561 # only for bootable images. Read
5562 # Enabling guest operating system features to see a list of available
5563 # options.
5564 { # Guest OS features.
5565 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5566 # separate values. Set to one or more of the following values:
5567 #
5568 # - VIRTIO_SCSI_MULTIQUEUE
5569 # - WINDOWS
5570 # - MULTI_IP_SUBNET
5571 # - UEFI_COMPATIBLE
5572 # - GVNIC
5573 # - SEV_CAPABLE
5574 # - SUSPEND_RESUME_COMPATIBLE
5575 # - SEV_LIVE_MIGRATABLE_V2
5576 # - SEV_SNP_CAPABLE
5577 # - TDX_CAPABLE
5578 # - IDPF
5579 # - SNP_SVSM_CAPABLE
5580 # - CCA_CAPABLE
5581 #
5582 #
5583 # For more information, see
5584 # Enabling guest operating system features.
5585 },
5586 ],
5587 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
5588 # boot disk. If you have many disks attached to an instance, each
5589 # disk would have a unique index number.
5590 &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
5591 # alongside the new instance. Use initialization parameters to create boot
5592 # disks or local SSDs attached to the new instance.
5593 #
5594 # This property is mutually exclusive with the source property;
5595 # you can only define one or the other, but not both.
5596 # alongside the new instance. Use initialization parameters to create boot
5597 # disks or local SSDs attached to the new instance.
5598 #
5599 # This field is persisted and returned for instanceTemplate and not returned
5600 # in the context of instance.
5601 #
5602 # This property is mutually exclusive with the source property;
5603 # you can only define one or the other, but not both.
5604 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
5605 # arm64 or x86_64.
5606 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
5607 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
5608 # of the instance. If a disk with the same name already exists in the given
5609 # region, the existing disk is attached to the new instance and the
5610 # new disk is not created.
5611 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
5612 # 10 GB. If you specify a sourceImage, which is required for
5613 # boot disks, the default size is the size of the sourceImage.
5614 # If you do not specify a sourceImage, the default disk size
5615 # is 500 GB.
5616 &quot;diskType&quot;: &quot;A String&quot;,
5617 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
5618 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
5619 # only for bootable images. Read
5620 # Enabling guest operating system features to see a list of available
5621 # options.
5622 #
5623 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
5624 { # Guest OS features.
5625 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
5626 # separate values. Set to one or more of the following values:
5627 #
5628 # - VIRTIO_SCSI_MULTIQUEUE
5629 # - WINDOWS
5630 # - MULTI_IP_SUBNET
5631 # - UEFI_COMPATIBLE
5632 # - GVNIC
5633 # - SEV_CAPABLE
5634 # - SUSPEND_RESUME_COMPATIBLE
5635 # - SEV_LIVE_MIGRATABLE_V2
5636 # - SEV_SNP_CAPABLE
5637 # - TDX_CAPABLE
5638 # - IDPF
5639 # - SNP_SVSM_CAPABLE
5640 # - CCA_CAPABLE
5641 #
5642 #
5643 # For more information, see
5644 # Enabling guest operating system features.
5645 },
5646 ],
5647 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
5648 # persistent disks.
5649 &quot;a_key&quot;: &quot;A String&quot;,
5650 },
5651 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
5652 &quot;A String&quot;,
5653 ],
5654 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
5655 # more than one instance.
5656 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
5657 # is to use the existing disk.
5658 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
5659 # of I/O operations per second that the disk can handle. Values must be
5660 # between 10,000 and 120,000. For more details, see theExtreme persistent
5661 # disk documentation.
5662 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
5663 # number of throughput mb per second that the disk can handle. Values must
5664 # greater than or equal to 1.
5665 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
5666 # the URLs of the zones where the disk should be replicated to.
5667 # You must provide exactly two replica zones, and one zone must be the same
5668 # as the instance zone.
5669 &quot;A String&quot;,
5670 ],
5671 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
5672 # have the same definition as resource
5673 # manager tags. Keys and values can be either in numeric format,
5674 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
5675 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
5676 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
5677 # empty.
5678 &quot;a_key&quot;: &quot;A String&quot;,
5679 },
5680 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
5681 # Specified using the full or partial URL. For instance template, specify
5682 # only the resource policy name.
5683 &quot;A String&quot;,
5684 ],
5685 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
5686 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5687 # is required.
5688 #
5689 # To create a disk with one of the public operating system
5690 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
5691 #
5692 # projects/debian-cloud/global/images/family/debian-9
5693 #
5694 #
5695 # Alternatively, use a specific version of a public operating system image:
5696 #
5697 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
5698 #
5699 #
5700 # To create a disk with a custom image that you created, specify the
5701 # image name in the following format:
5702 #
5703 # global/images/my-custom-image
5704 #
5705 #
5706 # You can also specify a custom image by its image family, which returns
5707 # the latest version of the image in that family. Replace the image name
5708 # with family/family-name:
5709 #
5710 # global/images/family/my-image-family
5711 #
5712 #
5713 # If the source image is deleted later, this field will not be set.
5714 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
5715 # encryption key of the source image. Required if the source image is
5716 # protected by a customer-supplied encryption key.
5717 #
5718 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
5719 # encryption keys, so you cannot create disks for instances in a managed instance group if the
5720 # source images are encrypted with your own keys.
5721 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5722 # For example:
5723 #
5724 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5725 # key_region/cryptoKeys/key
5726 #
5727 # The fully-qualifed key name may be returned for resource GET requests. For
5728 # example:
5729 #
5730 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5731 # key_region/cryptoKeys/key
5732 # /cryptoKeyVersions/1
5733 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5734 # key. If absent, the Compute Engine default service account is used.
5735 # For example:
5736 #
5737 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5738 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5739 # encryption key, encoded in RFC
5740 # 4648 base64 to either encrypt or decrypt this resource. You can
5741 # provide either the rawKey or thersaEncryptedKey.
5742 # For example:
5743 #
5744 # &quot;rawKey&quot;:
5745 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5746 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5747 # customer-supplied encryption key to either encrypt or decrypt this
5748 # resource. You can provide either the rawKey or thersaEncryptedKey.
5749 # For example:
5750 #
5751 # &quot;rsaEncryptedKey&quot;:
5752 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5753 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5754 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5755 #
5756 # The key must meet the following requirements before you can provide it to
5757 # Compute Engine:
5758 #
5759 # 1. The key is wrapped using a RSA public key certificate provided by
5760 # Google.
5761 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5762 # encoding.
5763 #
5764 # Gets the RSA public key certificate provided by Google at:
5765 #
5766 #
5767 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5768 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5769 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5770 # encryption key that protects this resource.
5771 },
5772 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
5773 # instance boot disk, one of initializeParams.sourceSnapshot
5774 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
5775 # is required.
5776 #
5777 # To create a disk with a snapshot that you created, specify the
5778 # snapshot name in the following format:
5779 #
5780 # us-central1-a/instantSnapshots/my-backup
5781 #
5782 #
5783 # If the source instant-snapshot is deleted later, this field will not be
5784 # set.
5785 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
5786 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
5787 # is required.
5788 #
5789 # To create a disk with a snapshot that you created, specify the
5790 # snapshot name in the following format:
5791 #
5792 # global/snapshots/my-backup
5793 #
5794 #
5795 # If the source snapshot is deleted later, this field will not be set.
5796 #
5797 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
5798 # an image instead when you create VMs using
5799 # the bulk
5800 # insert method.
5801 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
5802 # encryption key of the source snapshot.
5803 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
5804 # For example:
5805 #
5806 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5807 # key_region/cryptoKeys/key
5808 #
5809 # The fully-qualifed key name may be returned for resource GET requests. For
5810 # example:
5811 #
5812 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
5813 # key_region/cryptoKeys/key
5814 # /cryptoKeyVersions/1
5815 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
5816 # key. If absent, the Compute Engine default service account is used.
5817 # For example:
5818 #
5819 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
5820 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
5821 # encryption key, encoded in RFC
5822 # 4648 base64 to either encrypt or decrypt this resource. You can
5823 # provide either the rawKey or thersaEncryptedKey.
5824 # For example:
5825 #
5826 # &quot;rawKey&quot;:
5827 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
5828 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
5829 # customer-supplied encryption key to either encrypt or decrypt this
5830 # resource. You can provide either the rawKey or thersaEncryptedKey.
5831 # For example:
5832 #
5833 # &quot;rsaEncryptedKey&quot;:
5834 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
5835 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
5836 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
5837 #
5838 # The key must meet the following requirements before you can provide it to
5839 # Compute Engine:
5840 #
5841 # 1. The key is wrapped using a RSA public key certificate provided by
5842 # Google.
5843 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
5844 # encoding.
5845 #
5846 # Gets the RSA public key certificate provided by Google at:
5847 #
5848 #
5849 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
5850 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
5851 # 4648 base64 encoded SHA-256 hash of the customer-supplied
5852 # encryption key that protects this resource.
5853 },
5854 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
5855 # this as a partial or full URL to the resource. For example, the following
5856 # are valid values:
5857 #
5858 #
5859 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
5860 # - projects/project/zones/zone/storagePools/storagePool
5861 # - zones/zone/storagePools/storagePool
5862 },
5863 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
5864 # either SCSI or NVME. For most machine types, the
5865 # default is SCSI. Local SSDs can use either NVME or SCSI.
5866 # In certain configurations, persistent disks can use NVMe. For more
5867 # information, seeAbout
5868 # persistent disks.
5869 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
5870 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
5871 &quot;A String&quot;,
5872 ],
5873 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
5874 # disk is not allowed to be detached from the instance, or to be used as the
5875 # source of the snapshot creation, and the image creation. The instance with
5876 # at least one locked attached disk is not allow to be used as source of
5877 # machine image creation, instant snapshot creation, and not allowed to be
5878 # deleted with --keep-disk parameter set to true for locked disks.
5879 &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
5880 # in READ_WRITE mode.
5881 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
5882 # field is set to PRESERVED if the LocalSSD data has been saved
5883 # to a persistent location by customer request. (see the
5884 # discard_local_ssd option on Stop/Suspend).
5885 # Read-only in the api.
5886 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
5887 # these are public keys which are safe to store in public
5888 &quot;dbs&quot;: [ # The Key Database (db).
5889 {
5890 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5891 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5892 },
5893 ],
5894 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
5895 {
5896 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5897 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5898 },
5899 ],
5900 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
5901 {
5902 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5903 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5904 },
5905 ],
5906 &quot;pk&quot;: { # The Platform Key (PK).
5907 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
5908 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
5909 },
5910 },
5911 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
5912 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
5913 # is required.
5914 #
5915 # If desired, you can also attach existing non-root persistent disks using
5916 # this property. This field is only applicable for persistent disks.
5917 #
5918 # Note that for InstanceTemplate, specify the disk name for zonal disk,
5919 # and the URL for regional disk.
5920 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
5921 },
5922 ],
5923 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
5924 &quot;A String&quot;,
5925 ],
5926 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
5927 # e.g. &#x27;Intel Ice Lake&#x27;.
5928 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
5929 # preference. MIG will first try to create a VM based on the machine-type
5930 # with lowest rank and fallback to next rank based on availability.
5931 # Machine types and instance selections with the same rank have the same
5932 # preference.
5933 },
5934 },
5935 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
5936 # create instances.
5937 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
5938 # more preemption than the minimum capacity user needs. MIG will create
5939 # only Standard VMs until it reaches standard_capacity_base and only
5940 # then will start using standard_capacity_percent_above_base to mix Spot
5941 # with Standard VMs.
5942 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
5943 # remaining percentage will use Spot VMs. The percentage applies only to
5944 # the capacity above standard_capacity_base.
5945 },
5946 },
5947 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
5948 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
5949 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
5950 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
5951 # applies to the VMs on which your application fails a health check.
5952 # Valid values are
5953 #
5954 # - REPAIR (default): MIG automatically repairs a failed VM
5955 # by recreating it. For more information, see About
5956 # repairing VMs in a MIG.
5957 # - DO_NOTHING: MIG does not repair a failed VM.
5958 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
5959 # configuration when repairing a VM. Valid options are:
5960 #
5961 #
5962 #
5963 # - NO (default): If configuration updates are available, they are not
5964 # forcefully applied during repair. Instead, configuration updates are
5965 # applied according to the group&#x27;s update policy.
5966 #
5967 # - YES: If configuration updates are available, they are applied
5968 # during repair.
5969 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
5970 # unhealthy when the application running on that VM fails a health check.
5971 # Valid values are:
5972 #
5973 # - DEFAULT_ACTION (default): MIG uses the same action
5974 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
5975 # - REPAIR: MIG automatically repairs an unhealthy VM by
5976 # recreating it.
5977 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
5978 # For more information, see
5979 # About repairing VMs in a MIG.
5980 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
5981 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
5982 # Valid values are:
5983 #
5984 # - NO (default): MIG cannot change a VM&#x27;s zone during a
5985 # repair.
5986 # - YES: MIG can select a different zone for the VM during
5987 # a repair.
5988 },
5989 },
5990 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
5991 # instance group. The group uses this template to create all new instances
5992 # in the managed instance group. The templates for existing instances in the
5993 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
5994 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
5995 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
5996 # this managed instance group.
5997 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
5998 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
5999 # long, and comply withRFC1035.
6000 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
6001 # to this Instance Group Manager.
6002 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
6003 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
6004 # The name must be 1-63 characters long, and comply withRFC1035.
6005 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
6006 },
6007 ],
6008 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
6009 # as part of resource payload.
6010 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
6011 # key-value pairs. Keys and values can be either in numeric format,
6012 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
6013 # format such as `{org_id|project_id}/{tag_key_short_name}` and
6014 # `{tag_value_short_name}`. For more information, seeManage tags
6015 # for resources.
6016 &quot;a_key&quot;: &quot;A String&quot;,
6017 },
6018 },
6019 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
6020 # where the managed instance group resides (for regional resources).
6021 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
6022 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
6023 # instance group.
6024 # It can be a full or partial URL. For example, the following are
6025 # all valid URLs to a workload policy:
6026 #
6027 #
6028 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
6029 # - projects/project/regions/region/resourcePolicies/resourcePolicy
6030 # - regions/region/resourcePolicies/resourcePolicy
6031 },
6032 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
6033 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
6034 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
6035 # this URL.
6036 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
6037 # by the managed instance group on instances. The service accounts needs all
6038 # permissions required to create and delete instances.
6039 # By default, the service account
6040 # {projectNumber}@cloudservices.gserviceaccount.com is used.
6041 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
6042 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
6043 # stop a VM after that VM was created. The initial delay gives the
6044 # initialization script the time to prepare your VM for a quick scale out.
6045 # The value of initial delay must be between 0 and 3600 seconds. The
6046 # default value is 0.
6047 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
6048 # group scales out. The default mode is `MANUAL`.
6049 },
6050 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
6051 &quot;preservedState&quot;: { # Configuration of preserved resources.
6052 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
6053 # delete, update, etc. This map is keyed with the device names of
6054 # the disks.
6055 &quot;a_key&quot;: {
6056 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
6057 # update or VM instance recreate operations.
6058 # This flag is used to configure if the disk should be deleted after it
6059 # is no longer used by the group, e.g. when the given instance or
6060 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
6061 },
6062 },
6063 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
6064 # instance delete, update, etc. This map is keyed with the network
6065 # interface name.
6066 &quot;a_key&quot;: {
6067 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
6068 # update or VM instance recreate operations.
6069 # This flag is used to configure if the IP reservation should be deleted
6070 # after it is no longer used by the group, e.g. when the given instance
6071 # or the whole group is deleted.
6072 },
6073 },
6074 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
6075 # instance delete, update, etc. This map is keyed with the network
6076 # interface name.
6077 &quot;a_key&quot;: {
6078 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
6079 # update or VM instance recreate operations.
6080 # This flag is used to configure if the IP reservation should be deleted
6081 # after it is no longer used by the group, e.g. when the given instance
6082 # or the whole group is deleted.
6083 },
6084 },
6085 },
6086 },
6087 &quot;status&quot;: { # Output only. The status of this managed instance group.
6088 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
6089 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
6090 # This value is in RFC3339 text format.
6091 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
6092 # been applied to all managed instances in the group.
6093 },
6094 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
6095 # Currently only one accelerator topology is supported.
6096 {
6097 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
6098 # The value is the same as configured in the WorkloadPolicy.
6099 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
6100 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
6101 # check.
6102 &quot;error&quot;: { # Output only. Encountered errors.
6103 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6104 # operation.
6105 {
6106 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6107 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6108 # details. There is a set of defined message types to use for providing
6109 # details.The syntax depends on the error code. For example,
6110 # QuotaExceededInfo will have details when the error code is
6111 # QUOTA_EXCEEDED.
6112 {
6113 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6114 #
6115 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6116 # is not enabled:
6117 #
6118 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6119 # &quot;domain&quot;: &quot;googleapis.com&quot;
6120 # &quot;metadata&quot;: {
6121 # &quot;resource&quot;: &quot;projects/123&quot;,
6122 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6123 # }
6124 # }
6125 #
6126 # This response indicates that the pubsub.googleapis.com API is not enabled.
6127 #
6128 # Example of an error that is returned when attempting to create a Spanner
6129 # instance in a region that is out of stock:
6130 #
6131 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6132 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6133 # &quot;metadata&quot;: {
6134 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6135 # }
6136 # }
6137 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6138 # is typically the registered service name of the tool or product that
6139 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6140 # generated by some common infrastructure, the error domain must be a
6141 # globally unique value that identifies the infrastructure. For Google API
6142 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6143 &quot;metadatas&quot;: { # Additional structured details about this error.
6144 #
6145 # Keys must match a regular expression of `a-z+` but should
6146 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6147 # length. When identifying the current value of an exceeded limit, the units
6148 # should be contained in the key, not the value. For example, rather than
6149 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6150 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6151 # instances that can be created in a single (batch) request.
6152 &quot;a_key&quot;: &quot;A String&quot;,
6153 },
6154 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6155 # proximate cause of the error. Error reasons are unique within a particular
6156 # domain of errors. This should be at most 63 characters and match a
6157 # regular expression of `A-Z+[A-Z0-9]`, which represents
6158 # UPPER_SNAKE_CASE.
6159 },
6160 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6161 #
6162 # For example, if a quota check failed with an error indicating the calling
6163 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6164 # directly to the right place in the developer console to flip the bit.
6165 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6166 { # Describes a URL link.
6167 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6168 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6169 },
6170 ],
6171 },
6172 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6173 # which can be attached to an RPC error.
6174 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6175 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6176 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6177 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6178 },
6179 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6180 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6181 &quot;a_key&quot;: &quot;A String&quot;,
6182 },
6183 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6184 # type or metric.
6185 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6186 # or metric.
6187 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6188 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6189 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6190 },
6191 },
6192 ],
6193 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6194 # This property is optional.
6195 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6196 },
6197 ],
6198 },
6199 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
6200 # has // RFC3339 //
6201 # text format.
6202 },
6203 },
6204 ],
6205 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
6206 # that targets this instance group manager.
6207 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
6208 # targetSizePolicy.mode is set to BULK.
6209 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
6210 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
6211 # operation.
6212 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
6213 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6214 # operation.
6215 {
6216 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6217 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6218 # details. There is a set of defined message types to use for providing
6219 # details.The syntax depends on the error code. For example,
6220 # QuotaExceededInfo will have details when the error code is
6221 # QUOTA_EXCEEDED.
6222 {
6223 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6224 #
6225 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6226 # is not enabled:
6227 #
6228 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6229 # &quot;domain&quot;: &quot;googleapis.com&quot;
6230 # &quot;metadata&quot;: {
6231 # &quot;resource&quot;: &quot;projects/123&quot;,
6232 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6233 # }
6234 # }
6235 #
6236 # This response indicates that the pubsub.googleapis.com API is not enabled.
6237 #
6238 # Example of an error that is returned when attempting to create a Spanner
6239 # instance in a region that is out of stock:
6240 #
6241 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6242 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6243 # &quot;metadata&quot;: {
6244 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6245 # }
6246 # }
6247 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6248 # is typically the registered service name of the tool or product that
6249 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6250 # generated by some common infrastructure, the error domain must be a
6251 # globally unique value that identifies the infrastructure. For Google API
6252 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6253 &quot;metadatas&quot;: { # Additional structured details about this error.
6254 #
6255 # Keys must match a regular expression of `a-z+` but should
6256 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6257 # length. When identifying the current value of an exceeded limit, the units
6258 # should be contained in the key, not the value. For example, rather than
6259 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6260 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6261 # instances that can be created in a single (batch) request.
6262 &quot;a_key&quot;: &quot;A String&quot;,
6263 },
6264 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6265 # proximate cause of the error. Error reasons are unique within a particular
6266 # domain of errors. This should be at most 63 characters and match a
6267 # regular expression of `A-Z+[A-Z0-9]`, which represents
6268 # UPPER_SNAKE_CASE.
6269 },
6270 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6271 #
6272 # For example, if a quota check failed with an error indicating the calling
6273 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6274 # directly to the right place in the developer console to flip the bit.
6275 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6276 { # Describes a URL link.
6277 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6278 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6279 },
6280 ],
6281 },
6282 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6283 # which can be attached to an RPC error.
6284 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6285 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6286 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6287 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6288 },
6289 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6290 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6291 &quot;a_key&quot;: &quot;A String&quot;,
6292 },
6293 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6294 # type or metric.
6295 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6296 # or metric.
6297 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6298 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6299 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6300 },
6301 },
6302 ],
6303 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6304 # This property is optional.
6305 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6306 },
6307 ],
6308 },
6309 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
6310 # operation. Timestamp is in RFC3339 text format.
6311 },
6312 },
6313 &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
6314 # in this managed instance group that have the status. Currently only shown
6315 # for TPU MIGs
6316 # instance group that have the status. For more information about how to
6317 # interpret each status check the instance lifecycle documentation.
6318 # Currently only shown for TPU MIGs.
6319 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
6320 # that have DEPROVISIONING status.
6321 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
6322 # have been deleted. Includes only instances that would be shown in the
6323 # listManagedInstances method and not all instances that have been
6324 # deleted in the lifetime of the MIG.
6325 # Does not include FlexStart instances that are waiting for the resources
6326 # availability, they are considered as &#x27;pending&#x27;.
6327 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
6328 # that have PENDING status, that is FlexStart instances that are waiting
6329 # for resources. Instances that do not exist because of the other reasons
6330 # are counted as &#x27;non_existent&#x27;.
6331 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
6332 # that have PENDING_STOP status.
6333 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
6334 # that have PROVISIONING status.
6335 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
6336 # that have REPAIRING status.
6337 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
6338 # that have RUNNING status.
6339 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
6340 # that have STAGING status.
6341 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
6342 # that have STOPPED status.
6343 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
6344 # that have STOPPING status.
6345 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
6346 # that have SUSPENDED status.
6347 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
6348 # that have SUSPENDING status.
6349 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
6350 # that have TERMINATED status.
6351 },
6352 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
6353 # stable state. A stable state means that: none of the instances in the
6354 # managed instance group is currently undergoing any type of change (for
6355 # example, creation, restart, or deletion); no future changes are scheduled
6356 # for instances in the managed instance group; and the managed instance
6357 # group itself is not being modified.
6358 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
6359 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
6360 # has stateful configuration, that is, if you have configured any items
6361 # in a stateful policy or in per-instance configs.
6362 # The group might report that it has no stateful configuration even when
6363 # there is still some preserved state on a managed instance, for example,
6364 # if you have deleted all PICs but not yet applied those deletions.
6365 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
6366 # has stateful configuration, that is, if you have configured any items
6367 # in a stateful policy or in per-instance configs.
6368 # The group might report that it has no stateful configuration even when
6369 # there is still some preserved state on a managed instance, for example,
6370 # if you have deleted all PICs but not yet applied those deletions. This
6371 # field is deprecated in favor of has_stateful_config.
6372 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
6373 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
6374 # (listed in the output of a listPerInstanceConfigs API call) have
6375 # status EFFECTIVE or there are no per-instance-configs.
6376 },
6377 },
6378 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
6379 # target version specified by version field on Instance Group
6380 # Manager.
6381 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
6382 # in this managed instance group, i.e. all instances are in their target
6383 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
6384 },
6385 },
6386 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
6387 # apply to all of the instances in the managed instance group.
6388 &quot;A String&quot;,
6389 ],
6390 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
6391 # You can reduce this number by using the instanceGroupManager
6392 # deleteInstances or abandonInstances methods. Resizing the group also
6393 # changes this number.
6394 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
6395 # size.
6396 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
6397 # individually or all at once.
6398 },
6399 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
6400 # This number changes when you:
6401 #
6402 # - Stop instance using the stopInstances
6403 # method or start instances using the startInstances
6404 # method.
6405 # - Manually change the targetStoppedSize using the update
6406 # method.
6407 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
6408 # This number changes when you:
6409 #
6410 # - Suspend instance using the suspendInstances
6411 # method or resume instances using the resumeInstances
6412 # method.
6413 # - Manually change the targetSuspendedSize using the update
6414 # method.
6415 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
6416 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
6417 &quot;A String&quot;,
6418 ],
6419 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
6420 # instance redistribution policy for regional managed instance groups.
6421 # Valid values are:
6422 #
6423 # - PROACTIVE (default): The group attempts to maintain an
6424 # even distribution of VM instances across zones in the region.
6425 # - NONE: For non-autoscaled groups, proactive
6426 # redistribution is disabled.
6427 &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
6428 # either a fixed number or, if the group has 10 or more instances, a
6429 # percentage. If you set a percentage, the number of instances is rounded
6430 # if necessary. The default value for maxSurge is a fixed
6431 # value equal to the number of zones in which the managed instance group
6432 # operates.
6433 #
6434 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
6435 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6436 #
6437 #
6438 #
6439 # - If the value is fixed, then the calculated
6440 # value is equal to the fixed value.
6441 # - If the value is a percent, then the
6442 # calculated
6443 # value is percent/100 * targetSize. For example,
6444 # the calculated value of a 80% of a managed instance group
6445 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6446 # is a remainder, the number is rounded.
6447 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6448 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6449 # example, specify 80 for 80%.
6450 },
6451 &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
6452 # process. An instance is considered available if all of the following
6453 # conditions are satisfied:
6454 #
6455 #
6456 #
6457 # - The instance&#x27;s status is
6458 # RUNNING.
6459 # - If there is a health
6460 # check on the instance group, the instance&#x27;s health check status
6461 # must be HEALTHY at least once. If there is no health check
6462 # on the group, then the instance only needs to have a status of
6463 # RUNNING to be considered available.
6464 #
6465 #
6466 # This value can be either a fixed number or, if the group has 10 or more
6467 # instances, a percentage. If you set a percentage, the number of instances
6468 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
6469 # in which the managed instance group operates.
6470 #
6471 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
6472 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6473 #
6474 #
6475 #
6476 # - If the value is fixed, then the calculated
6477 # value is equal to the fixed value.
6478 # - If the value is a percent, then the
6479 # calculated
6480 # value is percent/100 * targetSize. For example,
6481 # the calculated value of a 80% of a managed instance group
6482 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6483 # is a remainder, the number is rounded.
6484 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6485 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6486 # example, specify 80 for 80%.
6487 },
6488 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
6489 # becomes available. This value must be from range [0, 3600].
6490 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
6491 # disruption as much as possible or to apply a more disruptive action than
6492 # is necessary.
6493 #
6494 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
6495 # Compute Engine performs the necessary action to execute the update.
6496 # - To apply a more disruptive action than is strictly necessary, set the
6497 # minimal action to RESTART or REPLACE. For
6498 # example, Compute Engine does not need to restart a VM to change its
6499 # metadata. But if your application reads instance metadata only when a VM
6500 # is restarted, you can set the minimal action to RESTART in
6501 # order to pick up metadata changes.
6502 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
6503 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
6504 # as much as possible. RESTART to allow actions that can be
6505 # applied without instance replacing or REPLACE to allow all
6506 # possible actions. If the Updater determines that the minimal update
6507 # action needed is more disruptive than most disruptive allowed action you
6508 # specify it will not perform the update at all.
6509 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
6510 # See minimal_action.REPLACE
6511 &quot;type&quot;: &quot;A String&quot;, # The type
6512 # of update process. You can specify either PROACTIVE so
6513 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
6514 # to update.
6515 },
6516 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
6517 # create instances.
6518 #
6519 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
6520 # group. This field overrides the top-level instanceTemplate
6521 # field. Read more about therelationships
6522 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
6523 # remaining instances. For more information, read aboutcanary
6524 # updates.
6525 {
6526 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
6527 # instance group. The group uses this template to create new instances in
6528 # the managed instance group until the `targetSize` for this version is
6529 # reached. The templates for existing instances in the group do not change
6530 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
6531 # existing instances are updated until the `targetSize` for this version is
6532 # reached.
6533 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
6534 # managed instance group.
6535 &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
6536 # from the template will be equal to:
6537 #
6538 #
6539 # - If expressed as a fixed number, the minimum of either
6540 # targetSize.fixed or
6541 # instanceGroupManager.targetSize is used.
6542 # - if expressed as a percent, the targetSize
6543 # would be (targetSize.percent/100 *
6544 # InstanceGroupManager.targetSize) If there is a remainder, the
6545 # number is rounded.
6546 #
6547 # If unset, this version will update any remaining instances not
6548 # updated by another version. ReadStarting
6549 # a canary update for more information.
6550 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
6551 #
6552 #
6553 #
6554 # - If the value is fixed, then the calculated
6555 # value is equal to the fixed value.
6556 # - If the value is a percent, then the
6557 # calculated
6558 # value is percent/100 * targetSize. For example,
6559 # the calculated value of a 80% of a managed instance group
6560 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
6561 # is a remainder, the number is rounded.
6562 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
6563 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
6564 # example, specify 80 for 80%.
6565 },
6566 },
6567 ],
6568 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
6569 # where the managed instance group is located (for zonal resources).
6570 }
6571
6572 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
6573 that if you must retry your request, the server will know to ignore the
6574 request if it has already been completed.
6575
6576 For example, consider a situation where you make an initial request and
6577 the request times out. If you make the request again with the same
6578 request ID, the server can check if original operation with the same
6579 request ID was received, and if so, will ignore the second request. This
6580 prevents clients from accidentally creating duplicate commitments.
6581
6582 The request ID must be
6583 a valid UUID with the exception that zero UUID is not supported
6584 (00000000-0000-0000-0000-000000000000).
6585 x__xgafv: string, V1 error format.
6586 Allowed values
6587 1 - v1 error format
6588 2 - v2 error format
6589
6590 Returns:
6591 An object of the form:
6592
6593 { # Represents an Operation resource.
6594 #
6595 # Google Compute Engine has three Operation resources:
6596 #
6597 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
6598 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
6599 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
6600 #
6601 # You can use an operation resource to manage asynchronous API requests.
6602 # For more information, readHandling
6603 # API responses.
6604 #
6605 # Operations can be global, regional or zonal.
6606 #
6607 # - For global operations, use the `globalOperations`
6608 # resource.
6609 # - For regional operations, use the
6610 # `regionOperations` resource.
6611 # - For zonal operations, use
6612 # the `zoneOperations` resource.
6613 #
6614 #
6615 #
6616 # For more information, read
6617 # Global, Regional, and Zonal Resources.
6618 #
6619 # Note that completed Operation resources have a limited
6620 # retention period.
6621 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
6622 # Not present otherwise.
6623 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
6624 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
6625 # set when the operation is created.
6626 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
6627 # text format.
6628 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
6629 # this field will be populated.
6630 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
6631 # operation.
6632 {
6633 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
6634 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
6635 # details. There is a set of defined message types to use for providing
6636 # details.The syntax depends on the error code. For example,
6637 # QuotaExceededInfo will have details when the error code is
6638 # QUOTA_EXCEEDED.
6639 {
6640 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
6641 #
6642 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
6643 # is not enabled:
6644 #
6645 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
6646 # &quot;domain&quot;: &quot;googleapis.com&quot;
6647 # &quot;metadata&quot;: {
6648 # &quot;resource&quot;: &quot;projects/123&quot;,
6649 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
6650 # }
6651 # }
6652 #
6653 # This response indicates that the pubsub.googleapis.com API is not enabled.
6654 #
6655 # Example of an error that is returned when attempting to create a Spanner
6656 # instance in a region that is out of stock:
6657 #
6658 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
6659 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
6660 # &quot;metadata&quot;: {
6661 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
6662 # }
6663 # }
6664 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
6665 # is typically the registered service name of the tool or product that
6666 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
6667 # generated by some common infrastructure, the error domain must be a
6668 # globally unique value that identifies the infrastructure. For Google API
6669 # infrastructure, the error domain is &quot;googleapis.com&quot;.
6670 &quot;metadatas&quot;: { # Additional structured details about this error.
6671 #
6672 # Keys must match a regular expression of `a-z+` but should
6673 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
6674 # length. When identifying the current value of an exceeded limit, the units
6675 # should be contained in the key, not the value. For example, rather than
6676 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
6677 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
6678 # instances that can be created in a single (batch) request.
6679 &quot;a_key&quot;: &quot;A String&quot;,
6680 },
6681 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
6682 # proximate cause of the error. Error reasons are unique within a particular
6683 # domain of errors. This should be at most 63 characters and match a
6684 # regular expression of `A-Z+[A-Z0-9]`, which represents
6685 # UPPER_SNAKE_CASE.
6686 },
6687 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
6688 #
6689 # For example, if a quota check failed with an error indicating the calling
6690 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
6691 # directly to the right place in the developer console to flip the bit.
6692 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
6693 { # Describes a URL link.
6694 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
6695 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
6696 },
6697 ],
6698 },
6699 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
6700 # which can be attached to an RPC error.
6701 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
6702 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
6703 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
6704 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
6705 },
6706 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
6707 &quot;dimensions&quot;: { # The map holding related quota dimensions.
6708 &quot;a_key&quot;: &quot;A String&quot;,
6709 },
6710 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
6711 # type or metric.
6712 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
6713 # or metric.
6714 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
6715 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
6716 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
6717 },
6718 },
6719 ],
6720 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
6721 # This property is optional.
6722 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
6723 },
6724 ],
6725 },
6726 &quot;getVersionOperationMetadata&quot;: {
6727 &quot;inlineSbomInfo&quot;: {
6728 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
6729 # appropriate identifiers.
6730 &quot;a_key&quot;: &quot;A String&quot;,
6731 },
6732 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
6733 # identifiers.
6734 &quot;a_key&quot;: &quot;A String&quot;,
6735 },
6736 },
6737 },
6738 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
6739 # message that was returned, such as `NOT FOUND`.
6740 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
6741 # status code that was returned. For example, a `404` means the
6742 # resource was not found.
6743 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
6744 # defined by the server.
6745 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
6746 # This value is inRFC3339
6747 # text format.
6748 &quot;instancesBulkInsertOperationMetadata&quot;: {
6749 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
6750 # Example key: zones/us-central1-a
6751 &quot;a_key&quot;: {
6752 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
6753 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
6754 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
6755 # error.
6756 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
6757 # if the flow is rolling forward or rolling back.
6758 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
6759 },
6760 },
6761 },
6762 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
6763 # Operation resources.
6764 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
6765 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
6766 # group of operations results from a `bulkInsert` API request.
6767 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
6768 # `update`, or `delete`, and so on.
6769 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
6770 # There is no requirement that this be linear or support any granularity of
6771 # operations. This should not be used to guess when the operation will be
6772 # complete. This number should monotonically increase as the operation
6773 # progresses.
6774 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
6775 # applicable when performing regional operations.
6776 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
6777 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
6778 # this field will contain information on all underlying zonal actions and
6779 # their state.
6780 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
6781 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
6782 # Example key: zones/us-central1-a
6783 &quot;a_key&quot;: {
6784 &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
6785 # populated.
6786 # different programming environments, including REST APIs and RPC APIs. It is
6787 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
6788 # three pieces of data: error code, error message, and error details.
6789 #
6790 # You can find out more about this error model and how to work with it in the
6791 # [API Design Guide](https://cloud.google.com/apis/design/errors).
6792 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
6793 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
6794 # message types for APIs to use.
6795 {
6796 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
6797 },
6798 ],
6799 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
6800 # user-facing error message should be localized and sent in the
6801 # google.rpc.Status.details field, or localized by the client.
6802 },
6803 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
6804 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
6805 },
6806 },
6807 },
6808 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
6809 # This value is inRFC3339
6810 # text format.
6811 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
6812 # following:
6813 # `PENDING`, `RUNNING`, or `DONE`.
6814 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
6815 # operation.
6816 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
6817 # of the target resource.
6818 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
6819 # operations related to creating a snapshot, this points to the disk
6820 # that the snapshot was created from.
6821 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
6822 # `[email protected]` or
6823 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
6824 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
6825 # operation, this field will be populated.
6826 {
6827 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
6828 # Engine returns NO_RESULTS_ON_PAGE if there
6829 # are no results in the response.
6830 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
6831 # value format. For example:
6832 #
6833 # &quot;data&quot;: [
6834 # {
6835 # &quot;key&quot;: &quot;scope&quot;,
6836 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
6837 # }
6838 {
6839 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
6840 # returned. For example, for warnings where there are no results in a list
6841 # request for a particular zone, this key might be scope and
6842 # the key value might be the zone name. Other examples might be a key
6843 # indicating a deprecated resource and a suggested replacement, or a
6844 # warning about invalid network settings (for example, if an instance
6845 # attempts to perform IP forwarding but is not enabled for IP forwarding).
6846 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
6847 },
6848 ],
6849 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
6850 },
6851 ],
6852 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
6853 # applicable when performing per-zone operations.
6854 }</pre>
6855 </div>
6856
6857 <div class="method">
6858 <code class="details" id="list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
6859 <pre>Retrieves a list of managed instance groups that are contained within the
6860 specified project and zone.
6861
6862 Args:
6863 project: string, Project ID for this request. (required)
6864 zone: string, The name of thezone where the managed
6865 instance group is located. (required)
6866 filter: string, A filter expression that filters resources listed in the response. Most
6867 Compute resources support two types of filter expressions:
6868 expressions that support regular expressions and expressions that follow
6869 API improvement proposal AIP-160.
6870 These two types of filter expressions cannot be mixed in one request.
6871
6872 If you want to use AIP-160, your expression must specify the field name, an
6873 operator, and the value that you want to use for filtering. The value
6874 must be a string, a number, or a boolean. The operator
6875 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
6876
6877 For example, if you are filtering Compute Engine instances, you can
6878 exclude instances named `example-instance` by specifying
6879 `name != example-instance`.
6880
6881 The `:*` comparison can be used to test whether a key has been defined.
6882 For example, to find all objects with `owner` label use:
6883 ```
6884 labels.owner:*
6885 ```
6886
6887 You can also filter nested fields. For example, you could specify
6888 `scheduling.automaticRestart = false` to include instances only
6889 if they are not scheduled for automatic restarts. You can use filtering
6890 on nested fields to filter based onresource labels.
6891
6892 To filter on multiple expressions, provide each separate expression within
6893 parentheses. For example:
6894 ```
6895 (scheduling.automaticRestart = true)
6896 (cpuPlatform = &quot;Intel Skylake&quot;)
6897 ```
6898 By default, each expression is an `AND` expression. However, you
6899 can include `AND` and `OR` expressions explicitly.
6900 For example:
6901 ```
6902 (cpuPlatform = &quot;Intel Skylake&quot;) OR
6903 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
6904 (scheduling.automaticRestart = true)
6905 ```
6906
6907 If you want to use a regular expression, use the `eq` (equal) or `ne`
6908 (not equal) operator against a single un-parenthesized expression with or
6909 without quotes or against multiple parenthesized expressions. Examples:
6910
6911 `fieldname eq unquoted literal`
6912 `fieldname eq &#x27;single quoted literal&#x27;`
6913 `fieldname eq &quot;double quoted literal&quot;`
6914 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
6915
6916 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
6917 The literal value must match the entire field.
6918
6919 For example, to filter for instances that do not end with name &quot;instance&quot;,
6920 you would use `name ne .*instance`.
6921
6922 You cannot combine constraints on multiple fields using regular
6923 expressions.
6924 maxResults: integer, The maximum number of results per page that should be returned.
6925 If the number of available results is larger than `maxResults`,
6926 Compute Engine returns a `nextPageToken` that can be used to get
6927 the next page of results in subsequent list requests. Acceptable values are
6928 `0` to `500`, inclusive. (Default: `500`)
6929 orderBy: string, Sorts list results by a certain order. By default, results
6930 are returned in alphanumerical order based on the resource name.
6931
6932 You can also sort results in descending order based on the creation
6933 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
6934 results based on the `creationTimestamp` field in
6935 reverse chronological order (newest result first). Use this to sort
6936 resources like operations so that the newest operation is returned first.
6937
6938 Currently, only sorting by `name` or
6939 `creationTimestamp desc` is supported.
6940 pageToken: string, Specifies a page token to use. Set `pageToken` to the
6941 `nextPageToken` returned by a previous list request to get
6942 the next page of results.
6943 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
6944 of failure. The default value is false.
6945
6946 For example, when partial success behavior is enabled, aggregatedList for a
6947 single zone scope either returns all resources in the zone or no resources,
6948 with an error code.
6949 x__xgafv: string, V1 error format.
6950 Allowed values
6951 1 - v1 error format
6952 2 - v2 error format
6953
6954 Returns:
6955 An object of the form:
6956
6957 { # [Output Only] A list of managed instance groups.
6958 &quot;id&quot;: &quot;A String&quot;, # Output only. Unique identifier for the resource; defined by the server.
6959 &quot;items&quot;: [ # A list of InstanceGroupManager resources.
6960 { # Represents a Managed Instance Group resource.
6961 #
6962 # An instance group is a collection of VM instances that you can manage as a
6963 # single entity. For more information, readInstance groups.
6964 #
6965 # For zonal Managed Instance Group, use the instanceGroupManagers
6966 # resource.
6967 #
6968 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
6969 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
6970 # for the group.
6971 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
6972 #
6973 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
6974 # instances to apply the configuration. To apply the configuration, set the
6975 # group&#x27;s updatePolicy.type field to use proactive updates or
6976 # use the applyUpdatesToInstances method.
6977 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
6978 &quot;a_key&quot;: &quot;A String&quot;,
6979 },
6980 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
6981 # more information, see Project and
6982 # instance metadata.
6983 &quot;a_key&quot;: &quot;A String&quot;,
6984 },
6985 },
6986 },
6987 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
6988 # only one value.
6989 {
6990 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
6991 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
6992 # initialize and run its startup script. During a VM&#x27;s initial delay
6993 # period, the MIG ignores unsuccessful health checks because the VM might
6994 # be in the startup process. This prevents the MIG from prematurely
6995 # recreating a VM. If the health check receives a healthy response during
6996 # the initial delay, it indicates that the startup process is complete and
6997 # the VM is ready. The value of initial delay must be between 0 and 3600
6998 # seconds. The default value is 0.
6999 },
7000 ],
7001 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
7002 # all VMs in a MIG. The maximum character length is 58 and the name must
7003 # comply with RFC1035 format.
7004 #
7005 # When a VM is created in the group, the MIG appends a hyphen and a random
7006 # four-character string to the base instance name. If you want the MIG to
7007 # assign sequential numbers instead of a random string, then end the base
7008 # instance name with a hyphen followed by one or more hash symbols. The hash
7009 # symbols indicate the number of digits. For example, a base instance name of
7010 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
7011 # @pattern
7012 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
7013 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
7014 # text format.
7015 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
7016 # in this managed instance group that are scheduled for each of those
7017 # actions.
7018 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
7019 # that are scheduled to be abandoned. Abandoning an instance removes it
7020 # from the managed instance group without deleting it.
7021 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
7022 # are scheduled to be adopted or are currently being adopted.
7023 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
7024 # are scheduled to be created or are currently being created. If the group
7025 # fails to create any of these instances, it tries again until it creates
7026 # the instance successfully.
7027 #
7028 # If you have disabled creation retries, this field will not be populated;
7029 # instead, the creatingWithoutRetries field will be populated.
7030 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
7031 # will attempt to create. The group attempts to create each instance
7032 # only once. If the group fails to create any of these instances, it
7033 # decreases the group&#x27;s targetSize value accordingly.
7034 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
7035 # are scheduled to be deleted or are currently being deleted.
7036 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
7037 # are running and have no scheduled actions.
7038 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
7039 # are scheduled to be recreated or are currently being being recreated.
7040 # Recreating an instance deletes the existing root persistent disk
7041 # and creates a new disk from the image that is defined in the
7042 # instance template.
7043 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
7044 # are being reconfigured with properties that do not require a restart
7045 # or a recreate action. For example, setting or removing target
7046 # pools for the instance.
7047 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
7048 # are scheduled to be restarted or are currently being restarted.
7049 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
7050 # are scheduled to be restarted or are currently being restarted.
7051 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
7052 # are scheduled to be resumed or are currently being resumed.
7053 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
7054 # are scheduled to be started or are currently being started.
7055 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
7056 # are scheduled to be stopped or are currently being stopped.
7057 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
7058 # are scheduled to be suspended or are currently being suspended.
7059 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
7060 # are being verified. See the managedInstances[].currentAction
7061 # property in the listManagedInstances method documentation.
7062 },
7063 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
7064 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
7065 # zones in a regional managed instance group.
7066 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
7067 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
7068 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
7069 # its instances.
7070 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
7071 # instances, even if an AI zone is available in the specified region. To
7072 # create instances in an AI zone in the selected region, you must explicitly
7073 # specify it in the distribution policy together with the other preferred
7074 # zones.
7075 {
7076 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
7077 # The zone must exist in the region where the managed instance group is
7078 # located.
7079 },
7080 ],
7081 },
7082 &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.
7083 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
7084 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
7085 # fingerprint must be provided in order to update the InstanceGroupManager,
7086 # otherwise the request will fail with error412 conditionNotMet.
7087 #
7088 # To see the latest fingerprint, make a get() request to
7089 # retrieve an InstanceGroupManager.
7090 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
7091 # generates this identifier.
7092 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
7093 # types of machines.
7094 # Instance flexibility configuration on MIG overrides instance
7095 # template configuration.
7096 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
7097 # when creating new VMs.
7098 &quot;a_key&quot;: {
7099 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
7100 # selection.
7101 { # An instance-attached disk resource.
7102 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
7103 # or X86_64.
7104 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
7105 # deleted (but not when the disk is detached from the instance).
7106 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
7107 # partition of the disk for its root filesystem.
7108 &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
7109 # running within the instance. This name can be used to reference the device
7110 # for mounting, resizing, and so on, from within the instance.
7111 #
7112 # If not specified, the server chooses a default device name to apply to this
7113 # disk, in the form persistent-disk-x, where x is a number
7114 # assigned by Google Compute Engine. This field is only applicable for
7115 # persistent disks.
7116 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
7117 # encryption key.
7118 #
7119 # If you are creating a new disk, this field encrypts the new disk using
7120 # an encryption key that you provide. If you are attaching an existing
7121 # disk that is already encrypted, this field decrypts the disk using
7122 # the customer-supplied encryption key.
7123 #
7124 # If you encrypt a disk using a customer-supplied key, you must provide the
7125 # same key again when you attempt to use this resource at a later time. For
7126 # example, you must provide the key when you create a snapshot or an image
7127 # from the disk or when you attach the disk to a virtual machine instance.
7128 #
7129 # If you do not provide an encryption key, then the disk will be encrypted
7130 # using an automatically generated key and you do not need to provide a key
7131 # to use the disk later.
7132 #
7133 # Note:
7134 #
7135 # Instance templates do not storecustomer-supplied
7136 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
7137 #
7138 # You cannot create VMs that have disks with customer-supplied keys using
7139 # the bulk
7140 # insert method.
7141 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7142 # For example:
7143 #
7144 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7145 # key_region/cryptoKeys/key
7146 #
7147 # The fully-qualifed key name may be returned for resource GET requests. For
7148 # example:
7149 #
7150 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7151 # key_region/cryptoKeys/key
7152 # /cryptoKeyVersions/1
7153 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7154 # key. If absent, the Compute Engine default service account is used.
7155 # For example:
7156 #
7157 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7158 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7159 # encryption key, encoded in RFC
7160 # 4648 base64 to either encrypt or decrypt this resource. You can
7161 # provide either the rawKey or thersaEncryptedKey.
7162 # For example:
7163 #
7164 # &quot;rawKey&quot;:
7165 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7166 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7167 # customer-supplied encryption key to either encrypt or decrypt this
7168 # resource. You can provide either the rawKey or thersaEncryptedKey.
7169 # For example:
7170 #
7171 # &quot;rsaEncryptedKey&quot;:
7172 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7173 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7174 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7175 #
7176 # The key must meet the following requirements before you can provide it to
7177 # Compute Engine:
7178 #
7179 # 1. The key is wrapped using a RSA public key certificate provided by
7180 # Google.
7181 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7182 # encoding.
7183 #
7184 # Gets the RSA public key certificate provided by Google at:
7185 #
7186 #
7187 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7188 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7189 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7190 # encryption key that protects this resource.
7191 },
7192 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
7193 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
7194 # currently attached to another instance. If you try to force attach a zonal
7195 # disk to an instance, you will receive an error.
7196 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7197 # only for bootable images. Read
7198 # Enabling guest operating system features to see a list of available
7199 # options.
7200 { # Guest OS features.
7201 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7202 # separate values. Set to one or more of the following values:
7203 #
7204 # - VIRTIO_SCSI_MULTIQUEUE
7205 # - WINDOWS
7206 # - MULTI_IP_SUBNET
7207 # - UEFI_COMPATIBLE
7208 # - GVNIC
7209 # - SEV_CAPABLE
7210 # - SUSPEND_RESUME_COMPATIBLE
7211 # - SEV_LIVE_MIGRATABLE_V2
7212 # - SEV_SNP_CAPABLE
7213 # - TDX_CAPABLE
7214 # - IDPF
7215 # - SNP_SVSM_CAPABLE
7216 # - CCA_CAPABLE
7217 #
7218 #
7219 # For more information, see
7220 # Enabling guest operating system features.
7221 },
7222 ],
7223 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
7224 # boot disk. If you have many disks attached to an instance, each
7225 # disk would have a unique index number.
7226 &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
7227 # alongside the new instance. Use initialization parameters to create boot
7228 # disks or local SSDs attached to the new instance.
7229 #
7230 # This property is mutually exclusive with the source property;
7231 # you can only define one or the other, but not both.
7232 # alongside the new instance. Use initialization parameters to create boot
7233 # disks or local SSDs attached to the new instance.
7234 #
7235 # This field is persisted and returned for instanceTemplate and not returned
7236 # in the context of instance.
7237 #
7238 # This property is mutually exclusive with the source property;
7239 # you can only define one or the other, but not both.
7240 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
7241 # arm64 or x86_64.
7242 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
7243 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
7244 # of the instance. If a disk with the same name already exists in the given
7245 # region, the existing disk is attached to the new instance and the
7246 # new disk is not created.
7247 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
7248 # 10 GB. If you specify a sourceImage, which is required for
7249 # boot disks, the default size is the size of the sourceImage.
7250 # If you do not specify a sourceImage, the default disk size
7251 # is 500 GB.
7252 &quot;diskType&quot;: &quot;A String&quot;,
7253 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
7254 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
7255 # only for bootable images. Read
7256 # Enabling guest operating system features to see a list of available
7257 # options.
7258 #
7259 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
7260 { # Guest OS features.
7261 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
7262 # separate values. Set to one or more of the following values:
7263 #
7264 # - VIRTIO_SCSI_MULTIQUEUE
7265 # - WINDOWS
7266 # - MULTI_IP_SUBNET
7267 # - UEFI_COMPATIBLE
7268 # - GVNIC
7269 # - SEV_CAPABLE
7270 # - SUSPEND_RESUME_COMPATIBLE
7271 # - SEV_LIVE_MIGRATABLE_V2
7272 # - SEV_SNP_CAPABLE
7273 # - TDX_CAPABLE
7274 # - IDPF
7275 # - SNP_SVSM_CAPABLE
7276 # - CCA_CAPABLE
7277 #
7278 #
7279 # For more information, see
7280 # Enabling guest operating system features.
7281 },
7282 ],
7283 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
7284 # persistent disks.
7285 &quot;a_key&quot;: &quot;A String&quot;,
7286 },
7287 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
7288 &quot;A String&quot;,
7289 ],
7290 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
7291 # more than one instance.
7292 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
7293 # is to use the existing disk.
7294 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
7295 # of I/O operations per second that the disk can handle. Values must be
7296 # between 10,000 and 120,000. For more details, see theExtreme persistent
7297 # disk documentation.
7298 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
7299 # number of throughput mb per second that the disk can handle. Values must
7300 # greater than or equal to 1.
7301 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
7302 # the URLs of the zones where the disk should be replicated to.
7303 # You must provide exactly two replica zones, and one zone must be the same
7304 # as the instance zone.
7305 &quot;A String&quot;,
7306 ],
7307 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
7308 # have the same definition as resource
7309 # manager tags. Keys and values can be either in numeric format,
7310 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
7311 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
7312 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
7313 # empty.
7314 &quot;a_key&quot;: &quot;A String&quot;,
7315 },
7316 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
7317 # Specified using the full or partial URL. For instance template, specify
7318 # only the resource policy name.
7319 &quot;A String&quot;,
7320 ],
7321 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
7322 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7323 # is required.
7324 #
7325 # To create a disk with one of the public operating system
7326 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
7327 #
7328 # projects/debian-cloud/global/images/family/debian-9
7329 #
7330 #
7331 # Alternatively, use a specific version of a public operating system image:
7332 #
7333 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
7334 #
7335 #
7336 # To create a disk with a custom image that you created, specify the
7337 # image name in the following format:
7338 #
7339 # global/images/my-custom-image
7340 #
7341 #
7342 # You can also specify a custom image by its image family, which returns
7343 # the latest version of the image in that family. Replace the image name
7344 # with family/family-name:
7345 #
7346 # global/images/family/my-image-family
7347 #
7348 #
7349 # If the source image is deleted later, this field will not be set.
7350 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
7351 # encryption key of the source image. Required if the source image is
7352 # protected by a customer-supplied encryption key.
7353 #
7354 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
7355 # encryption keys, so you cannot create disks for instances in a managed instance group if the
7356 # source images are encrypted with your own keys.
7357 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7358 # For example:
7359 #
7360 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7361 # key_region/cryptoKeys/key
7362 #
7363 # The fully-qualifed key name may be returned for resource GET requests. For
7364 # example:
7365 #
7366 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7367 # key_region/cryptoKeys/key
7368 # /cryptoKeyVersions/1
7369 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7370 # key. If absent, the Compute Engine default service account is used.
7371 # For example:
7372 #
7373 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7374 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7375 # encryption key, encoded in RFC
7376 # 4648 base64 to either encrypt or decrypt this resource. You can
7377 # provide either the rawKey or thersaEncryptedKey.
7378 # For example:
7379 #
7380 # &quot;rawKey&quot;:
7381 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7382 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7383 # customer-supplied encryption key to either encrypt or decrypt this
7384 # resource. You can provide either the rawKey or thersaEncryptedKey.
7385 # For example:
7386 #
7387 # &quot;rsaEncryptedKey&quot;:
7388 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7389 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7390 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7391 #
7392 # The key must meet the following requirements before you can provide it to
7393 # Compute Engine:
7394 #
7395 # 1. The key is wrapped using a RSA public key certificate provided by
7396 # Google.
7397 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7398 # encoding.
7399 #
7400 # Gets the RSA public key certificate provided by Google at:
7401 #
7402 #
7403 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7404 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7405 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7406 # encryption key that protects this resource.
7407 },
7408 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
7409 # instance boot disk, one of initializeParams.sourceSnapshot
7410 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
7411 # is required.
7412 #
7413 # To create a disk with a snapshot that you created, specify the
7414 # snapshot name in the following format:
7415 #
7416 # us-central1-a/instantSnapshots/my-backup
7417 #
7418 #
7419 # If the source instant-snapshot is deleted later, this field will not be
7420 # set.
7421 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
7422 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
7423 # is required.
7424 #
7425 # To create a disk with a snapshot that you created, specify the
7426 # snapshot name in the following format:
7427 #
7428 # global/snapshots/my-backup
7429 #
7430 #
7431 # If the source snapshot is deleted later, this field will not be set.
7432 #
7433 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
7434 # an image instead when you create VMs using
7435 # the bulk
7436 # insert method.
7437 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
7438 # encryption key of the source snapshot.
7439 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
7440 # For example:
7441 #
7442 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7443 # key_region/cryptoKeys/key
7444 #
7445 # The fully-qualifed key name may be returned for resource GET requests. For
7446 # example:
7447 #
7448 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
7449 # key_region/cryptoKeys/key
7450 # /cryptoKeyVersions/1
7451 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
7452 # key. If absent, the Compute Engine default service account is used.
7453 # For example:
7454 #
7455 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
7456 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
7457 # encryption key, encoded in RFC
7458 # 4648 base64 to either encrypt or decrypt this resource. You can
7459 # provide either the rawKey or thersaEncryptedKey.
7460 # For example:
7461 #
7462 # &quot;rawKey&quot;:
7463 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
7464 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
7465 # customer-supplied encryption key to either encrypt or decrypt this
7466 # resource. You can provide either the rawKey or thersaEncryptedKey.
7467 # For example:
7468 #
7469 # &quot;rsaEncryptedKey&quot;:
7470 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
7471 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
7472 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
7473 #
7474 # The key must meet the following requirements before you can provide it to
7475 # Compute Engine:
7476 #
7477 # 1. The key is wrapped using a RSA public key certificate provided by
7478 # Google.
7479 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
7480 # encoding.
7481 #
7482 # Gets the RSA public key certificate provided by Google at:
7483 #
7484 #
7485 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
7486 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
7487 # 4648 base64 encoded SHA-256 hash of the customer-supplied
7488 # encryption key that protects this resource.
7489 },
7490 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
7491 # this as a partial or full URL to the resource. For example, the following
7492 # are valid values:
7493 #
7494 #
7495 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
7496 # - projects/project/zones/zone/storagePools/storagePool
7497 # - zones/zone/storagePools/storagePool
7498 },
7499 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
7500 # either SCSI or NVME. For most machine types, the
7501 # default is SCSI. Local SSDs can use either NVME or SCSI.
7502 # In certain configurations, persistent disks can use NVMe. For more
7503 # information, seeAbout
7504 # persistent disks.
7505 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
7506 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
7507 &quot;A String&quot;,
7508 ],
7509 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
7510 # disk is not allowed to be detached from the instance, or to be used as the
7511 # source of the snapshot creation, and the image creation. The instance with
7512 # at least one locked attached disk is not allow to be used as source of
7513 # machine image creation, instant snapshot creation, and not allowed to be
7514 # deleted with --keep-disk parameter set to true for locked disks.
7515 &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
7516 # in READ_WRITE mode.
7517 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
7518 # field is set to PRESERVED if the LocalSSD data has been saved
7519 # to a persistent location by customer request. (see the
7520 # discard_local_ssd option on Stop/Suspend).
7521 # Read-only in the api.
7522 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
7523 # these are public keys which are safe to store in public
7524 &quot;dbs&quot;: [ # The Key Database (db).
7525 {
7526 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7527 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7528 },
7529 ],
7530 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
7531 {
7532 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7533 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7534 },
7535 ],
7536 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
7537 {
7538 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7539 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7540 },
7541 ],
7542 &quot;pk&quot;: { # The Platform Key (PK).
7543 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
7544 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
7545 },
7546 },
7547 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
7548 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
7549 # is required.
7550 #
7551 # If desired, you can also attach existing non-root persistent disks using
7552 # this property. This field is only applicable for persistent disks.
7553 #
7554 # Note that for InstanceTemplate, specify the disk name for zonal disk,
7555 # and the URL for regional disk.
7556 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
7557 },
7558 ],
7559 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
7560 &quot;A String&quot;,
7561 ],
7562 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
7563 # e.g. &#x27;Intel Ice Lake&#x27;.
7564 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
7565 # preference. MIG will first try to create a VM based on the machine-type
7566 # with lowest rank and fallback to next rank based on availability.
7567 # Machine types and instance selections with the same rank have the same
7568 # preference.
7569 },
7570 },
7571 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
7572 # create instances.
7573 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
7574 # more preemption than the minimum capacity user needs. MIG will create
7575 # only Standard VMs until it reaches standard_capacity_base and only
7576 # then will start using standard_capacity_percent_above_base to mix Spot
7577 # with Standard VMs.
7578 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
7579 # remaining percentage will use Spot VMs. The percentage applies only to
7580 # the capacity above standard_capacity_base.
7581 },
7582 },
7583 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
7584 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
7585 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
7586 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
7587 # applies to the VMs on which your application fails a health check.
7588 # Valid values are
7589 #
7590 # - REPAIR (default): MIG automatically repairs a failed VM
7591 # by recreating it. For more information, see About
7592 # repairing VMs in a MIG.
7593 # - DO_NOTHING: MIG does not repair a failed VM.
7594 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
7595 # configuration when repairing a VM. Valid options are:
7596 #
7597 #
7598 #
7599 # - NO (default): If configuration updates are available, they are not
7600 # forcefully applied during repair. Instead, configuration updates are
7601 # applied according to the group&#x27;s update policy.
7602 #
7603 # - YES: If configuration updates are available, they are applied
7604 # during repair.
7605 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
7606 # unhealthy when the application running on that VM fails a health check.
7607 # Valid values are:
7608 #
7609 # - DEFAULT_ACTION (default): MIG uses the same action
7610 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
7611 # - REPAIR: MIG automatically repairs an unhealthy VM by
7612 # recreating it.
7613 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
7614 # For more information, see
7615 # About repairing VMs in a MIG.
7616 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
7617 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
7618 # Valid values are:
7619 #
7620 # - NO (default): MIG cannot change a VM&#x27;s zone during a
7621 # repair.
7622 # - YES: MIG can select a different zone for the VM during
7623 # a repair.
7624 },
7625 },
7626 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
7627 # instance group. The group uses this template to create all new instances
7628 # in the managed instance group. The templates for existing instances in the
7629 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
7630 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
7631 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
7632 # this managed instance group.
7633 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
7634 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
7635 # long, and comply withRFC1035.
7636 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
7637 # to this Instance Group Manager.
7638 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
7639 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
7640 # The name must be 1-63 characters long, and comply withRFC1035.
7641 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
7642 },
7643 ],
7644 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
7645 # as part of resource payload.
7646 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
7647 # key-value pairs. Keys and values can be either in numeric format,
7648 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
7649 # format such as `{org_id|project_id}/{tag_key_short_name}` and
7650 # `{tag_value_short_name}`. For more information, seeManage tags
7651 # for resources.
7652 &quot;a_key&quot;: &quot;A String&quot;,
7653 },
7654 },
7655 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
7656 # where the managed instance group resides (for regional resources).
7657 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
7658 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
7659 # instance group.
7660 # It can be a full or partial URL. For example, the following are
7661 # all valid URLs to a workload policy:
7662 #
7663 #
7664 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
7665 # - projects/project/regions/region/resourcePolicies/resourcePolicy
7666 # - regions/region/resourcePolicies/resourcePolicy
7667 },
7668 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
7669 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
7670 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
7671 # this URL.
7672 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
7673 # by the managed instance group on instances. The service accounts needs all
7674 # permissions required to create and delete instances.
7675 # By default, the service account
7676 # {projectNumber}@cloudservices.gserviceaccount.com is used.
7677 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
7678 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
7679 # stop a VM after that VM was created. The initial delay gives the
7680 # initialization script the time to prepare your VM for a quick scale out.
7681 # The value of initial delay must be between 0 and 3600 seconds. The
7682 # default value is 0.
7683 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
7684 # group scales out. The default mode is `MANUAL`.
7685 },
7686 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
7687 &quot;preservedState&quot;: { # Configuration of preserved resources.
7688 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
7689 # delete, update, etc. This map is keyed with the device names of
7690 # the disks.
7691 &quot;a_key&quot;: {
7692 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
7693 # update or VM instance recreate operations.
7694 # This flag is used to configure if the disk should be deleted after it
7695 # is no longer used by the group, e.g. when the given instance or
7696 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
7697 },
7698 },
7699 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
7700 # instance delete, update, etc. This map is keyed with the network
7701 # interface name.
7702 &quot;a_key&quot;: {
7703 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7704 # update or VM instance recreate operations.
7705 # This flag is used to configure if the IP reservation should be deleted
7706 # after it is no longer used by the group, e.g. when the given instance
7707 # or the whole group is deleted.
7708 },
7709 },
7710 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
7711 # instance delete, update, etc. This map is keyed with the network
7712 # interface name.
7713 &quot;a_key&quot;: {
7714 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
7715 # update or VM instance recreate operations.
7716 # This flag is used to configure if the IP reservation should be deleted
7717 # after it is no longer used by the group, e.g. when the given instance
7718 # or the whole group is deleted.
7719 },
7720 },
7721 },
7722 },
7723 &quot;status&quot;: { # Output only. The status of this managed instance group.
7724 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
7725 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
7726 # This value is in RFC3339 text format.
7727 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
7728 # been applied to all managed instances in the group.
7729 },
7730 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
7731 # Currently only one accelerator topology is supported.
7732 {
7733 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
7734 # The value is the same as configured in the WorkloadPolicy.
7735 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
7736 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
7737 # check.
7738 &quot;error&quot;: { # Output only. Encountered errors.
7739 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7740 # operation.
7741 {
7742 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7743 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7744 # details. There is a set of defined message types to use for providing
7745 # details.The syntax depends on the error code. For example,
7746 # QuotaExceededInfo will have details when the error code is
7747 # QUOTA_EXCEEDED.
7748 {
7749 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7750 #
7751 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7752 # is not enabled:
7753 #
7754 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7755 # &quot;domain&quot;: &quot;googleapis.com&quot;
7756 # &quot;metadata&quot;: {
7757 # &quot;resource&quot;: &quot;projects/123&quot;,
7758 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7759 # }
7760 # }
7761 #
7762 # This response indicates that the pubsub.googleapis.com API is not enabled.
7763 #
7764 # Example of an error that is returned when attempting to create a Spanner
7765 # instance in a region that is out of stock:
7766 #
7767 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7768 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7769 # &quot;metadata&quot;: {
7770 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7771 # }
7772 # }
7773 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7774 # is typically the registered service name of the tool or product that
7775 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7776 # generated by some common infrastructure, the error domain must be a
7777 # globally unique value that identifies the infrastructure. For Google API
7778 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7779 &quot;metadatas&quot;: { # Additional structured details about this error.
7780 #
7781 # Keys must match a regular expression of `a-z+` but should
7782 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7783 # length. When identifying the current value of an exceeded limit, the units
7784 # should be contained in the key, not the value. For example, rather than
7785 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7786 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7787 # instances that can be created in a single (batch) request.
7788 &quot;a_key&quot;: &quot;A String&quot;,
7789 },
7790 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7791 # proximate cause of the error. Error reasons are unique within a particular
7792 # domain of errors. This should be at most 63 characters and match a
7793 # regular expression of `A-Z+[A-Z0-9]`, which represents
7794 # UPPER_SNAKE_CASE.
7795 },
7796 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7797 #
7798 # For example, if a quota check failed with an error indicating the calling
7799 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7800 # directly to the right place in the developer console to flip the bit.
7801 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7802 { # Describes a URL link.
7803 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7804 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7805 },
7806 ],
7807 },
7808 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7809 # which can be attached to an RPC error.
7810 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7811 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7812 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7813 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7814 },
7815 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7816 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7817 &quot;a_key&quot;: &quot;A String&quot;,
7818 },
7819 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7820 # type or metric.
7821 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7822 # or metric.
7823 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7824 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7825 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7826 },
7827 },
7828 ],
7829 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7830 # This property is optional.
7831 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7832 },
7833 ],
7834 },
7835 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
7836 # has // RFC3339 //
7837 # text format.
7838 },
7839 },
7840 ],
7841 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
7842 # that targets this instance group manager.
7843 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
7844 # targetSizePolicy.mode is set to BULK.
7845 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
7846 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
7847 # operation.
7848 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
7849 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
7850 # operation.
7851 {
7852 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
7853 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
7854 # details. There is a set of defined message types to use for providing
7855 # details.The syntax depends on the error code. For example,
7856 # QuotaExceededInfo will have details when the error code is
7857 # QUOTA_EXCEEDED.
7858 {
7859 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
7860 #
7861 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
7862 # is not enabled:
7863 #
7864 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
7865 # &quot;domain&quot;: &quot;googleapis.com&quot;
7866 # &quot;metadata&quot;: {
7867 # &quot;resource&quot;: &quot;projects/123&quot;,
7868 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
7869 # }
7870 # }
7871 #
7872 # This response indicates that the pubsub.googleapis.com API is not enabled.
7873 #
7874 # Example of an error that is returned when attempting to create a Spanner
7875 # instance in a region that is out of stock:
7876 #
7877 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
7878 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
7879 # &quot;metadata&quot;: {
7880 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
7881 # }
7882 # }
7883 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
7884 # is typically the registered service name of the tool or product that
7885 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
7886 # generated by some common infrastructure, the error domain must be a
7887 # globally unique value that identifies the infrastructure. For Google API
7888 # infrastructure, the error domain is &quot;googleapis.com&quot;.
7889 &quot;metadatas&quot;: { # Additional structured details about this error.
7890 #
7891 # Keys must match a regular expression of `a-z+` but should
7892 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
7893 # length. When identifying the current value of an exceeded limit, the units
7894 # should be contained in the key, not the value. For example, rather than
7895 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
7896 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
7897 # instances that can be created in a single (batch) request.
7898 &quot;a_key&quot;: &quot;A String&quot;,
7899 },
7900 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
7901 # proximate cause of the error. Error reasons are unique within a particular
7902 # domain of errors. This should be at most 63 characters and match a
7903 # regular expression of `A-Z+[A-Z0-9]`, which represents
7904 # UPPER_SNAKE_CASE.
7905 },
7906 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
7907 #
7908 # For example, if a quota check failed with an error indicating the calling
7909 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
7910 # directly to the right place in the developer console to flip the bit.
7911 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
7912 { # Describes a URL link.
7913 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
7914 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
7915 },
7916 ],
7917 },
7918 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
7919 # which can be attached to an RPC error.
7920 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
7921 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
7922 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
7923 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
7924 },
7925 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
7926 &quot;dimensions&quot;: { # The map holding related quota dimensions.
7927 &quot;a_key&quot;: &quot;A String&quot;,
7928 },
7929 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
7930 # type or metric.
7931 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
7932 # or metric.
7933 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
7934 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
7935 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
7936 },
7937 },
7938 ],
7939 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
7940 # This property is optional.
7941 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
7942 },
7943 ],
7944 },
7945 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
7946 # operation. Timestamp is in RFC3339 text format.
7947 },
7948 },
7949 &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
7950 # in this managed instance group that have the status. Currently only shown
7951 # for TPU MIGs
7952 # instance group that have the status. For more information about how to
7953 # interpret each status check the instance lifecycle documentation.
7954 # Currently only shown for TPU MIGs.
7955 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
7956 # that have DEPROVISIONING status.
7957 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
7958 # have been deleted. Includes only instances that would be shown in the
7959 # listManagedInstances method and not all instances that have been
7960 # deleted in the lifetime of the MIG.
7961 # Does not include FlexStart instances that are waiting for the resources
7962 # availability, they are considered as &#x27;pending&#x27;.
7963 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
7964 # that have PENDING status, that is FlexStart instances that are waiting
7965 # for resources. Instances that do not exist because of the other reasons
7966 # are counted as &#x27;non_existent&#x27;.
7967 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
7968 # that have PENDING_STOP status.
7969 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
7970 # that have PROVISIONING status.
7971 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
7972 # that have REPAIRING status.
7973 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
7974 # that have RUNNING status.
7975 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
7976 # that have STAGING status.
7977 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
7978 # that have STOPPED status.
7979 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
7980 # that have STOPPING status.
7981 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
7982 # that have SUSPENDED status.
7983 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
7984 # that have SUSPENDING status.
7985 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
7986 # that have TERMINATED status.
7987 },
7988 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
7989 # stable state. A stable state means that: none of the instances in the
7990 # managed instance group is currently undergoing any type of change (for
7991 # example, creation, restart, or deletion); no future changes are scheduled
7992 # for instances in the managed instance group; and the managed instance
7993 # group itself is not being modified.
7994 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
7995 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
7996 # has stateful configuration, that is, if you have configured any items
7997 # in a stateful policy or in per-instance configs.
7998 # The group might report that it has no stateful configuration even when
7999 # there is still some preserved state on a managed instance, for example,
8000 # if you have deleted all PICs but not yet applied those deletions.
8001 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
8002 # has stateful configuration, that is, if you have configured any items
8003 # in a stateful policy or in per-instance configs.
8004 # The group might report that it has no stateful configuration even when
8005 # there is still some preserved state on a managed instance, for example,
8006 # if you have deleted all PICs but not yet applied those deletions. This
8007 # field is deprecated in favor of has_stateful_config.
8008 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
8009 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
8010 # (listed in the output of a listPerInstanceConfigs API call) have
8011 # status EFFECTIVE or there are no per-instance-configs.
8012 },
8013 },
8014 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
8015 # target version specified by version field on Instance Group
8016 # Manager.
8017 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
8018 # in this managed instance group, i.e. all instances are in their target
8019 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
8020 },
8021 },
8022 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
8023 # apply to all of the instances in the managed instance group.
8024 &quot;A String&quot;,
8025 ],
8026 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
8027 # You can reduce this number by using the instanceGroupManager
8028 # deleteInstances or abandonInstances methods. Resizing the group also
8029 # changes this number.
8030 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
8031 # size.
8032 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
8033 # individually or all at once.
8034 },
8035 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
8036 # This number changes when you:
8037 #
8038 # - Stop instance using the stopInstances
8039 # method or start instances using the startInstances
8040 # method.
8041 # - Manually change the targetStoppedSize using the update
8042 # method.
8043 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
8044 # This number changes when you:
8045 #
8046 # - Suspend instance using the suspendInstances
8047 # method or resume instances using the resumeInstances
8048 # method.
8049 # - Manually change the targetSuspendedSize using the update
8050 # method.
8051 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
8052 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
8053 &quot;A String&quot;,
8054 ],
8055 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
8056 # instance redistribution policy for regional managed instance groups.
8057 # Valid values are:
8058 #
8059 # - PROACTIVE (default): The group attempts to maintain an
8060 # even distribution of VM instances across zones in the region.
8061 # - NONE: For non-autoscaled groups, proactive
8062 # redistribution is disabled.
8063 &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
8064 # either a fixed number or, if the group has 10 or more instances, a
8065 # percentage. If you set a percentage, the number of instances is rounded
8066 # if necessary. The default value for maxSurge is a fixed
8067 # value equal to the number of zones in which the managed instance group
8068 # operates.
8069 #
8070 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
8071 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8072 #
8073 #
8074 #
8075 # - If the value is fixed, then the calculated
8076 # value is equal to the fixed value.
8077 # - If the value is a percent, then the
8078 # calculated
8079 # value is percent/100 * targetSize. For example,
8080 # the calculated value of a 80% of a managed instance group
8081 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8082 # is a remainder, the number is rounded.
8083 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8084 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8085 # example, specify 80 for 80%.
8086 },
8087 &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
8088 # process. An instance is considered available if all of the following
8089 # conditions are satisfied:
8090 #
8091 #
8092 #
8093 # - The instance&#x27;s status is
8094 # RUNNING.
8095 # - If there is a health
8096 # check on the instance group, the instance&#x27;s health check status
8097 # must be HEALTHY at least once. If there is no health check
8098 # on the group, then the instance only needs to have a status of
8099 # RUNNING to be considered available.
8100 #
8101 #
8102 # This value can be either a fixed number or, if the group has 10 or more
8103 # instances, a percentage. If you set a percentage, the number of instances
8104 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
8105 # in which the managed instance group operates.
8106 #
8107 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
8108 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8109 #
8110 #
8111 #
8112 # - If the value is fixed, then the calculated
8113 # value is equal to the fixed value.
8114 # - If the value is a percent, then the
8115 # calculated
8116 # value is percent/100 * targetSize. For example,
8117 # the calculated value of a 80% of a managed instance group
8118 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8119 # is a remainder, the number is rounded.
8120 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8121 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8122 # example, specify 80 for 80%.
8123 },
8124 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
8125 # becomes available. This value must be from range [0, 3600].
8126 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
8127 # disruption as much as possible or to apply a more disruptive action than
8128 # is necessary.
8129 #
8130 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
8131 # Compute Engine performs the necessary action to execute the update.
8132 # - To apply a more disruptive action than is strictly necessary, set the
8133 # minimal action to RESTART or REPLACE. For
8134 # example, Compute Engine does not need to restart a VM to change its
8135 # metadata. But if your application reads instance metadata only when a VM
8136 # is restarted, you can set the minimal action to RESTART in
8137 # order to pick up metadata changes.
8138 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
8139 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
8140 # as much as possible. RESTART to allow actions that can be
8141 # applied without instance replacing or REPLACE to allow all
8142 # possible actions. If the Updater determines that the minimal update
8143 # action needed is more disruptive than most disruptive allowed action you
8144 # specify it will not perform the update at all.
8145 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
8146 # See minimal_action.REPLACE
8147 &quot;type&quot;: &quot;A String&quot;, # The type
8148 # of update process. You can specify either PROACTIVE so
8149 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
8150 # to update.
8151 },
8152 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
8153 # create instances.
8154 #
8155 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
8156 # group. This field overrides the top-level instanceTemplate
8157 # field. Read more about therelationships
8158 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
8159 # remaining instances. For more information, read aboutcanary
8160 # updates.
8161 {
8162 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
8163 # instance group. The group uses this template to create new instances in
8164 # the managed instance group until the `targetSize` for this version is
8165 # reached. The templates for existing instances in the group do not change
8166 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
8167 # existing instances are updated until the `targetSize` for this version is
8168 # reached.
8169 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
8170 # managed instance group.
8171 &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
8172 # from the template will be equal to:
8173 #
8174 #
8175 # - If expressed as a fixed number, the minimum of either
8176 # targetSize.fixed or
8177 # instanceGroupManager.targetSize is used.
8178 # - if expressed as a percent, the targetSize
8179 # would be (targetSize.percent/100 *
8180 # InstanceGroupManager.targetSize) If there is a remainder, the
8181 # number is rounded.
8182 #
8183 # If unset, this version will update any remaining instances not
8184 # updated by another version. ReadStarting
8185 # a canary update for more information.
8186 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
8187 #
8188 #
8189 #
8190 # - If the value is fixed, then the calculated
8191 # value is equal to the fixed value.
8192 # - If the value is a percent, then the
8193 # calculated
8194 # value is percent/100 * targetSize. For example,
8195 # the calculated value of a 80% of a managed instance group
8196 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
8197 # is a remainder, the number is rounded.
8198 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
8199 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
8200 # example, specify 80 for 80%.
8201 },
8202 },
8203 ],
8204 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
8205 # where the managed instance group is located (for zonal resources).
8206 },
8207 ],
8208 &quot;kind&quot;: &quot;compute#instanceGroupManagerList&quot;, # Output only. The resource type, which is always compute#instanceGroupManagerList for a
8209 # list of managed instance groups.
8210 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. This token allows you to get the next page of results for
8211 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
8212 # the query parameter pageToken in the next list request.
8213 # Subsequent list requests will have their own nextPageToken to
8214 # continue paging through the results.
8215 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource.
8216 &quot;warning&quot;: { # Output only. Informational warning message.
8217 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
8218 # Engine returns NO_RESULTS_ON_PAGE if there
8219 # are no results in the response.
8220 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
8221 # value format. For example:
8222 #
8223 # &quot;data&quot;: [
8224 # {
8225 # &quot;key&quot;: &quot;scope&quot;,
8226 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
8227 # }
8228 {
8229 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
8230 # returned. For example, for warnings where there are no results in a list
8231 # request for a particular zone, this key might be scope and
8232 # the key value might be the zone name. Other examples might be a key
8233 # indicating a deprecated resource and a suggested replacement, or a
8234 # warning about invalid network settings (for example, if an instance
8235 # attempts to perform IP forwarding but is not enabled for IP forwarding).
8236 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
8237 },
8238 ],
8239 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
8240 },
8241 }</pre>
8242 </div>
8243
8244 <div class="method">
8245 <code class="details" id="listErrors">listErrors(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
8246 <pre>Lists all errors thrown by actions on instances for a given managed
8247 instance group. The filter and orderBy query
8248 parameters are not supported.
8249
8250 Args:
8251 project: string, Project ID for this request. (required)
8252 zone: string, The name of thezone where the managed
8253 instance group is located.
8254 It should conform to RFC1035. (required)
8255 instanceGroupManager: string, The name of the managed instance group.
8256 It must be a string that meets the requirements in RFC1035, or an
8257 unsigned long integer: must match regexp pattern:
8258 (?:[a-z](?:[-a-z0-9]{0,61}[a-z0-9])?)|1-9{0,19}. (required)
8259 filter: string, A filter expression that filters resources listed in the response. Most
8260 Compute resources support two types of filter expressions:
8261 expressions that support regular expressions and expressions that follow
8262 API improvement proposal AIP-160.
8263 These two types of filter expressions cannot be mixed in one request.
8264
8265 If you want to use AIP-160, your expression must specify the field name, an
8266 operator, and the value that you want to use for filtering. The value
8267 must be a string, a number, or a boolean. The operator
8268 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
8269
8270 For example, if you are filtering Compute Engine instances, you can
8271 exclude instances named `example-instance` by specifying
8272 `name != example-instance`.
8273
8274 The `:*` comparison can be used to test whether a key has been defined.
8275 For example, to find all objects with `owner` label use:
8276 ```
8277 labels.owner:*
8278 ```
8279
8280 You can also filter nested fields. For example, you could specify
8281 `scheduling.automaticRestart = false` to include instances only
8282 if they are not scheduled for automatic restarts. You can use filtering
8283 on nested fields to filter based onresource labels.
8284
8285 To filter on multiple expressions, provide each separate expression within
8286 parentheses. For example:
8287 ```
8288 (scheduling.automaticRestart = true)
8289 (cpuPlatform = &quot;Intel Skylake&quot;)
8290 ```
8291 By default, each expression is an `AND` expression. However, you
8292 can include `AND` and `OR` expressions explicitly.
8293 For example:
8294 ```
8295 (cpuPlatform = &quot;Intel Skylake&quot;) OR
8296 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
8297 (scheduling.automaticRestart = true)
8298 ```
8299
8300 If you want to use a regular expression, use the `eq` (equal) or `ne`
8301 (not equal) operator against a single un-parenthesized expression with or
8302 without quotes or against multiple parenthesized expressions. Examples:
8303
8304 `fieldname eq unquoted literal`
8305 `fieldname eq &#x27;single quoted literal&#x27;`
8306 `fieldname eq &quot;double quoted literal&quot;`
8307 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
8308
8309 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
8310 The literal value must match the entire field.
8311
8312 For example, to filter for instances that do not end with name &quot;instance&quot;,
8313 you would use `name ne .*instance`.
8314
8315 You cannot combine constraints on multiple fields using regular
8316 expressions.
8317 maxResults: integer, The maximum number of results per page that should be returned.
8318 If the number of available results is larger than `maxResults`,
8319 Compute Engine returns a `nextPageToken` that can be used to get
8320 the next page of results in subsequent list requests. Acceptable values are
8321 `0` to `500`, inclusive. (Default: `500`)
8322 orderBy: string, Sorts list results by a certain order. By default, results
8323 are returned in alphanumerical order based on the resource name.
8324
8325 You can also sort results in descending order based on the creation
8326 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
8327 results based on the `creationTimestamp` field in
8328 reverse chronological order (newest result first). Use this to sort
8329 resources like operations so that the newest operation is returned first.
8330
8331 Currently, only sorting by `name` or
8332 `creationTimestamp desc` is supported.
8333 pageToken: string, Specifies a page token to use. Set `pageToken` to the
8334 `nextPageToken` returned by a previous list request to get
8335 the next page of results.
8336 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
8337 of failure. The default value is false.
8338
8339 For example, when partial success behavior is enabled, aggregatedList for a
8340 single zone scope either returns all resources in the zone or no resources,
8341 with an error code.
8342 x__xgafv: string, V1 error format.
8343 Allowed values
8344 1 - v1 error format
8345 2 - v2 error format
8346
8347 Returns:
8348 An object of the form:
8349
8350 {
8351 &quot;items&quot;: [ # Output only. [Output Only] The list of errors of the managed instance group.
8352 {
8353 &quot;error&quot;: { # Output only. Contents of the error.
8354 &quot;code&quot;: &quot;A String&quot;, # Output only. Error code.
8355 &quot;message&quot;: &quot;A String&quot;, # Output only. Error message.
8356 },
8357 &quot;instanceActionDetails&quot;: { # Output only. Details of the instance action that triggered this error.
8358 # May be null, if the error was not caused by an action on an instance.
8359 # This field is optional.
8360 &quot;action&quot;: &quot;A String&quot;, # Output only. Action that managed instance group was executing on the instance when the
8361 # error occurred. Possible values:
8362 &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
8363 # yet been created.
8364 &quot;version&quot;: { # Output only. Version this instance was created from, or was being
8365 # created from, but the creation failed. Corresponds to one of the versions
8366 # that were set on the Instance Group Manager resource at the time this
8367 # instance was being created.
8368 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
8369 # when current_action is one of { DELETING, ABANDONING }.
8370 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] Name of the version.
8371 },
8372 },
8373 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. The time that this error occurred. This value is in RFC3339 text format.
8374 },
8375 ],
8376 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
8377 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
8378 # the query parameter pageToken in the next list request.
8379 # Subsequent list requests will have their own nextPageToken to
8380 # continue paging through the results.
8381 }</pre>
8382 </div>
8383
8384 <div class="method">
8385 <code class="details" id="listErrors_next">listErrors_next()</code>
8386 <pre>Retrieves the next page of results.
8387
8388 Args:
8389 previous_request: The request for the previous page. (required)
8390 previous_response: The response from the request for the previous page. (required)
8391
8392 Returns:
8393 A request object that you can call &#x27;execute()&#x27; on to request the next
8394 page. Returns None if there are no more items in the collection.
8395 </pre>
8396 </div>
8397
8398 <div class="method">
8399 <code class="details" id="listManagedInstances">listManagedInstances(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
8400 <pre>Lists all of the instances in the managed instance group. Each instance
8401 in the list has a currentAction, which indicates the action
8402 that the managed instance group is performing on the instance. For example,
8403 if the group is still creating an instance, the currentAction
8404 is CREATING. If a previous action failed, the
8405 list displays the errors for that failed action. The orderBy
8406 query parameter is not supported. The `pageToken` query parameter is
8407 supported only if the group&#x27;s `listManagedInstancesResults` field is set
8408 to `PAGINATED`.
8409
8410 Args:
8411 project: string, Project ID for this request. (required)
8412 zone: string, The name of thezone where the managed
8413 instance group is located. (required)
8414 instanceGroupManager: string, The name of the managed instance group. (required)
8415 filter: string, A filter expression that filters resources listed in the response. Most
8416 Compute resources support two types of filter expressions:
8417 expressions that support regular expressions and expressions that follow
8418 API improvement proposal AIP-160.
8419 These two types of filter expressions cannot be mixed in one request.
8420
8421 If you want to use AIP-160, your expression must specify the field name, an
8422 operator, and the value that you want to use for filtering. The value
8423 must be a string, a number, or a boolean. The operator
8424 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
8425
8426 For example, if you are filtering Compute Engine instances, you can
8427 exclude instances named `example-instance` by specifying
8428 `name != example-instance`.
8429
8430 The `:*` comparison can be used to test whether a key has been defined.
8431 For example, to find all objects with `owner` label use:
8432 ```
8433 labels.owner:*
8434 ```
8435
8436 You can also filter nested fields. For example, you could specify
8437 `scheduling.automaticRestart = false` to include instances only
8438 if they are not scheduled for automatic restarts. You can use filtering
8439 on nested fields to filter based onresource labels.
8440
8441 To filter on multiple expressions, provide each separate expression within
8442 parentheses. For example:
8443 ```
8444 (scheduling.automaticRestart = true)
8445 (cpuPlatform = &quot;Intel Skylake&quot;)
8446 ```
8447 By default, each expression is an `AND` expression. However, you
8448 can include `AND` and `OR` expressions explicitly.
8449 For example:
8450 ```
8451 (cpuPlatform = &quot;Intel Skylake&quot;) OR
8452 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
8453 (scheduling.automaticRestart = true)
8454 ```
8455
8456 If you want to use a regular expression, use the `eq` (equal) or `ne`
8457 (not equal) operator against a single un-parenthesized expression with or
8458 without quotes or against multiple parenthesized expressions. Examples:
8459
8460 `fieldname eq unquoted literal`
8461 `fieldname eq &#x27;single quoted literal&#x27;`
8462 `fieldname eq &quot;double quoted literal&quot;`
8463 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
8464
8465 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
8466 The literal value must match the entire field.
8467
8468 For example, to filter for instances that do not end with name &quot;instance&quot;,
8469 you would use `name ne .*instance`.
8470
8471 You cannot combine constraints on multiple fields using regular
8472 expressions.
8473 maxResults: integer, The maximum number of results per page that should be returned.
8474 If the number of available results is larger than `maxResults`,
8475 Compute Engine returns a `nextPageToken` that can be used to get
8476 the next page of results in subsequent list requests. Acceptable values are
8477 `0` to `500`, inclusive. (Default: `500`)
8478 orderBy: string, Sorts list results by a certain order. By default, results
8479 are returned in alphanumerical order based on the resource name.
8480
8481 You can also sort results in descending order based on the creation
8482 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
8483 results based on the `creationTimestamp` field in
8484 reverse chronological order (newest result first). Use this to sort
8485 resources like operations so that the newest operation is returned first.
8486
8487 Currently, only sorting by `name` or
8488 `creationTimestamp desc` is supported.
8489 pageToken: string, Specifies a page token to use. Set `pageToken` to the
8490 `nextPageToken` returned by a previous list request to get
8491 the next page of results.
8492 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
8493 of failure. The default value is false.
8494
8495 For example, when partial success behavior is enabled, aggregatedList for a
8496 single zone scope either returns all resources in the zone or no resources,
8497 with an error code.
8498 x__xgafv: string, V1 error format.
8499 Allowed values
8500 1 - v1 error format
8501 2 - v2 error format
8502
8503 Returns:
8504 An object of the form:
8505
8506 {
8507 &quot;managedInstances&quot;: [ # Output only. [Output Only] The list of instances in the managed instance group.
8508 { # A Managed Instance resource.
8509 &quot;allInstancesConfig&quot;: { # Output only. [Output Only] Current all-instances configuration revision applied to this
8510 # instance.
8511 &quot;revision&quot;: &quot;A String&quot;, # Output only. [Output Only] Current all-instances configuration revision.
8512 # This value is in RFC3339 text format.
8513 },
8514 &quot;currentAction&quot;: &quot;A String&quot;, # Output only. [Output Only] The current action that the managed instance group has
8515 # scheduled for the instance. Possible values:
8516 #
8517 # - NONE The instance is running, and the managed
8518 # instance group does not have any scheduled actions for this instance.
8519 # - CREATING The managed instance group is creating this
8520 # instance. If the group fails to create this instance, it will try again
8521 # until it is successful.
8522 # - CREATING_WITHOUT_RETRIES The managed instance group
8523 # is attempting to create this instance only once. If the group fails
8524 # to create this instance, it does not try again and the group&#x27;stargetSize value is decreased instead.
8525 # - RECREATING The managed instance group is recreating
8526 # this instance.
8527 # - DELETING The managed instance group is permanently
8528 # deleting this instance.
8529 # - ABANDONING The managed instance group is abandoning
8530 # this instance. The instance will be removed from the instance group
8531 # and from any target pools that are associated with this group.
8532 # - RESTARTING The managed instance group is restarting
8533 # the instance.
8534 # - REFRESHING The managed instance group is applying
8535 # configuration changes to the instance without stopping it. For example,
8536 # the group can update the target pool list for an instance without
8537 # stopping that instance.
8538 # - VERIFYING The managed instance group has created the
8539 # instance and it is in the process of being verified.
8540 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output only] The unique identifier for this resource. This field is empty
8541 # when instance does not exist.
8542 &quot;instance&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of the instance. The URL can exist even if the
8543 # instance has not yet been created.
8544 &quot;instanceHealth&quot;: [ # Output only. [Output Only] Health state of the instance per health-check.
8545 {
8546 &quot;detailedHealthState&quot;: &quot;A String&quot;, # Output only. [Output Only] The current detailed instance health state.
8547 &quot;healthCheck&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL for the health check that verifies whether the
8548 # instance is healthy.
8549 },
8550 ],
8551 &quot;instanceStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] The status of the instance. This field is empty when
8552 # the instance does not exist.
8553 &quot;lastAttempt&quot;: { # Output only. [Output Only] Information about the last attempt to create or delete
8554 # the instance.
8555 &quot;errors&quot;: { # Output only. [Output Only] Encountered errors during the last attempt to create or
8556 # delete the instance.
8557 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
8558 # operation.
8559 {
8560 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
8561 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
8562 # details. There is a set of defined message types to use for providing
8563 # details.The syntax depends on the error code. For example,
8564 # QuotaExceededInfo will have details when the error code is
8565 # QUOTA_EXCEEDED.
8566 {
8567 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
8568 #
8569 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
8570 # is not enabled:
8571 #
8572 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
8573 # &quot;domain&quot;: &quot;googleapis.com&quot;
8574 # &quot;metadata&quot;: {
8575 # &quot;resource&quot;: &quot;projects/123&quot;,
8576 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
8577 # }
8578 # }
8579 #
8580 # This response indicates that the pubsub.googleapis.com API is not enabled.
8581 #
8582 # Example of an error that is returned when attempting to create a Spanner
8583 # instance in a region that is out of stock:
8584 #
8585 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
8586 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
8587 # &quot;metadata&quot;: {
8588 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
8589 # }
8590 # }
8591 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
8592 # is typically the registered service name of the tool or product that
8593 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
8594 # generated by some common infrastructure, the error domain must be a
8595 # globally unique value that identifies the infrastructure. For Google API
8596 # infrastructure, the error domain is &quot;googleapis.com&quot;.
8597 &quot;metadatas&quot;: { # Additional structured details about this error.
8598 #
8599 # Keys must match a regular expression of `a-z+` but should
8600 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
8601 # length. When identifying the current value of an exceeded limit, the units
8602 # should be contained in the key, not the value. For example, rather than
8603 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
8604 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
8605 # instances that can be created in a single (batch) request.
8606 &quot;a_key&quot;: &quot;A String&quot;,
8607 },
8608 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
8609 # proximate cause of the error. Error reasons are unique within a particular
8610 # domain of errors. This should be at most 63 characters and match a
8611 # regular expression of `A-Z+[A-Z0-9]`, which represents
8612 # UPPER_SNAKE_CASE.
8613 },
8614 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
8615 #
8616 # For example, if a quota check failed with an error indicating the calling
8617 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
8618 # directly to the right place in the developer console to flip the bit.
8619 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
8620 { # Describes a URL link.
8621 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
8622 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
8623 },
8624 ],
8625 },
8626 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
8627 # which can be attached to an RPC error.
8628 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
8629 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
8630 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
8631 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
8632 },
8633 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
8634 &quot;dimensions&quot;: { # The map holding related quota dimensions.
8635 &quot;a_key&quot;: &quot;A String&quot;,
8636 },
8637 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
8638 # type or metric.
8639 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
8640 # or metric.
8641 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
8642 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
8643 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
8644 },
8645 },
8646 ],
8647 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
8648 # This property is optional.
8649 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
8650 },
8651 ],
8652 },
8653 },
8654 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] The name of the instance. The name always exists even if the
8655 # instance has not yet been created.
8656 &quot;preservedStateFromConfig&quot;: { # Preserved state for a given instance. # Output only. [Output Only] Preserved state applied from per-instance config
8657 # for this instance.
8658 &quot;disks&quot;: { # Preserved disks defined for this instance.
8659 # This map is keyed with the device names of the disks.
8660 &quot;a_key&quot;: {
8661 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
8662 # update, instance recreate operations. This flag is used to configure
8663 # if the disk should be deleted after it is no longer used by the group,
8664 # e.g. when the given instance or the whole MIG is deleted.
8665 # Note: disks attached in READ_ONLY mode cannot be
8666 # auto-deleted.
8667 &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
8668 # disk in READ_WRITE mode.
8669 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
8670 # to the VM instance.
8671 },
8672 },
8673 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
8674 # This map is keyed with the name of the network interface.
8675 &quot;a_key&quot;: {
8676 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
8677 # update or VM instance recreate operations.
8678 # This flag is used to configure if the IP reservation should be deleted
8679 # after it is no longer used by the group, e.g. when the given instance
8680 # or the whole group is deleted.
8681 &quot;ipAddress&quot;: { # Ip address representation
8682 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
8683 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
8684 # network interface.
8685 },
8686 },
8687 },
8688 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
8689 # This map is keyed with the name of the network interface.
8690 &quot;a_key&quot;: {
8691 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
8692 # update or VM instance recreate operations.
8693 # This flag is used to configure if the IP reservation should be deleted
8694 # after it is no longer used by the group, e.g. when the given instance
8695 # or the whole group is deleted.
8696 &quot;ipAddress&quot;: { # Ip address representation
8697 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
8698 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
8699 # network interface.
8700 },
8701 },
8702 },
8703 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
8704 &quot;a_key&quot;: &quot;A String&quot;,
8705 },
8706 },
8707 &quot;preservedStateFromPolicy&quot;: { # Preserved state for a given instance. # Output only. [Output Only] Preserved state generated based on stateful policy
8708 # for this instance.
8709 &quot;disks&quot;: { # Preserved disks defined for this instance.
8710 # This map is keyed with the device names of the disks.
8711 &quot;a_key&quot;: {
8712 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
8713 # update, instance recreate operations. This flag is used to configure
8714 # if the disk should be deleted after it is no longer used by the group,
8715 # e.g. when the given instance or the whole MIG is deleted.
8716 # Note: disks attached in READ_ONLY mode cannot be
8717 # auto-deleted.
8718 &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
8719 # disk in READ_WRITE mode.
8720 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
8721 # to the VM instance.
8722 },
8723 },
8724 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
8725 # This map is keyed with the name of the network interface.
8726 &quot;a_key&quot;: {
8727 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
8728 # update or VM instance recreate operations.
8729 # This flag is used to configure if the IP reservation should be deleted
8730 # after it is no longer used by the group, e.g. when the given instance
8731 # or the whole group is deleted.
8732 &quot;ipAddress&quot;: { # Ip address representation
8733 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
8734 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
8735 # network interface.
8736 },
8737 },
8738 },
8739 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
8740 # This map is keyed with the name of the network interface.
8741 &quot;a_key&quot;: {
8742 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
8743 # update or VM instance recreate operations.
8744 # This flag is used to configure if the IP reservation should be deleted
8745 # after it is no longer used by the group, e.g. when the given instance
8746 # or the whole group is deleted.
8747 &quot;ipAddress&quot;: { # Ip address representation
8748 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
8749 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
8750 # network interface.
8751 },
8752 },
8753 },
8754 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
8755 &quot;a_key&quot;: &quot;A String&quot;,
8756 },
8757 },
8758 &quot;propertiesFromFlexibilityPolicy&quot;: { # Output only. [Output Only] Instance properties selected for this instance resulting from
8759 # InstanceFlexibilityPolicy.
8760 &quot;disks&quot;: [ # List of disks to be attached to the instance.
8761 { # An instance-attached disk resource.
8762 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
8763 # or X86_64.
8764 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
8765 # deleted (but not when the disk is detached from the instance).
8766 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
8767 # partition of the disk for its root filesystem.
8768 &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
8769 # running within the instance. This name can be used to reference the device
8770 # for mounting, resizing, and so on, from within the instance.
8771 #
8772 # If not specified, the server chooses a default device name to apply to this
8773 # disk, in the form persistent-disk-x, where x is a number
8774 # assigned by Google Compute Engine. This field is only applicable for
8775 # persistent disks.
8776 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
8777 # encryption key.
8778 #
8779 # If you are creating a new disk, this field encrypts the new disk using
8780 # an encryption key that you provide. If you are attaching an existing
8781 # disk that is already encrypted, this field decrypts the disk using
8782 # the customer-supplied encryption key.
8783 #
8784 # If you encrypt a disk using a customer-supplied key, you must provide the
8785 # same key again when you attempt to use this resource at a later time. For
8786 # example, you must provide the key when you create a snapshot or an image
8787 # from the disk or when you attach the disk to a virtual machine instance.
8788 #
8789 # If you do not provide an encryption key, then the disk will be encrypted
8790 # using an automatically generated key and you do not need to provide a key
8791 # to use the disk later.
8792 #
8793 # Note:
8794 #
8795 # Instance templates do not storecustomer-supplied
8796 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
8797 #
8798 # You cannot create VMs that have disks with customer-supplied keys using
8799 # the bulk
8800 # insert method.
8801 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
8802 # For example:
8803 #
8804 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8805 # key_region/cryptoKeys/key
8806 #
8807 # The fully-qualifed key name may be returned for resource GET requests. For
8808 # example:
8809 #
8810 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
8811 # key_region/cryptoKeys/key
8812 # /cryptoKeyVersions/1
8813 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
8814 # key. If absent, the Compute Engine default service account is used.
8815 # For example:
8816 #
8817 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
8818 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
8819 # encryption key, encoded in RFC
8820 # 4648 base64 to either encrypt or decrypt this resource. You can
8821 # provide either the rawKey or thersaEncryptedKey.
8822 # For example:
8823 #
8824 # &quot;rawKey&quot;:
8825 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
8826 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
8827 # customer-supplied encryption key to either encrypt or decrypt this
8828 # resource. You can provide either the rawKey or thersaEncryptedKey.
8829 # For example:
8830 #
8831 # &quot;rsaEncryptedKey&quot;:
8832 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
8833 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
8834 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
8835 #
8836 # The key must meet the following requirements before you can provide it to
8837 # Compute Engine:
8838 #
8839 # 1. The key is wrapped using a RSA public key certificate provided by
8840 # Google.
8841 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
8842 # encoding.
8843 #
8844 # Gets the RSA public key certificate provided by Google at:
8845 #
8846 #
8847 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
8848 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
8849 # 4648 base64 encoded SHA-256 hash of the customer-supplied
8850 # encryption key that protects this resource.
8851 },
8852 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
8853 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
8854 # currently attached to another instance. If you try to force attach a zonal
8855 # disk to an instance, you will receive an error.
8856 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
8857 # only for bootable images. Read
8858 # Enabling guest operating system features to see a list of available
8859 # options.
8860 { # Guest OS features.
8861 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
8862 # separate values. Set to one or more of the following values:
8863 #
8864 # - VIRTIO_SCSI_MULTIQUEUE
8865 # - WINDOWS
8866 # - MULTI_IP_SUBNET
8867 # - UEFI_COMPATIBLE
8868 # - GVNIC
8869 # - SEV_CAPABLE
8870 # - SUSPEND_RESUME_COMPATIBLE
8871 # - SEV_LIVE_MIGRATABLE_V2
8872 # - SEV_SNP_CAPABLE
8873 # - TDX_CAPABLE
8874 # - IDPF
8875 # - SNP_SVSM_CAPABLE
8876 # - CCA_CAPABLE
8877 #
8878 #
8879 # For more information, see
8880 # Enabling guest operating system features.
8881 },
8882 ],
8883 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
8884 # boot disk. If you have many disks attached to an instance, each
8885 # disk would have a unique index number.
8886 &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
8887 # alongside the new instance. Use initialization parameters to create boot
8888 # disks or local SSDs attached to the new instance.
8889 #
8890 # This property is mutually exclusive with the source property;
8891 # you can only define one or the other, but not both.
8892 # alongside the new instance. Use initialization parameters to create boot
8893 # disks or local SSDs attached to the new instance.
8894 #
8895 # This field is persisted and returned for instanceTemplate and not returned
8896 # in the context of instance.
8897 #
8898 # This property is mutually exclusive with the source property;
8899 # you can only define one or the other, but not both.
8900 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
8901 # arm64 or x86_64.
8902 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
8903 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
8904 # of the instance. If a disk with the same name already exists in the given
8905 # region, the existing disk is attached to the new instance and the
8906 # new disk is not created.
8907 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
8908 # 10 GB. If you specify a sourceImage, which is required for
8909 # boot disks, the default size is the size of the sourceImage.
8910 # If you do not specify a sourceImage, the default disk size
8911 # is 500 GB.
8912 &quot;diskType&quot;: &quot;A String&quot;,
8913 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
8914 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
8915 # only for bootable images. Read
8916 # Enabling guest operating system features to see a list of available
8917 # options.
8918 #
8919 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
8920 { # Guest OS features.
8921 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
8922 # separate values. Set to one or more of the following values:
8923 #
8924 # - VIRTIO_SCSI_MULTIQUEUE
8925 # - WINDOWS
8926 # - MULTI_IP_SUBNET
8927 # - UEFI_COMPATIBLE
8928 # - GVNIC
8929 # - SEV_CAPABLE
8930 # - SUSPEND_RESUME_COMPATIBLE
8931 # - SEV_LIVE_MIGRATABLE_V2
8932 # - SEV_SNP_CAPABLE
8933 # - TDX_CAPABLE
8934 # - IDPF
8935 # - SNP_SVSM_CAPABLE
8936 # - CCA_CAPABLE
8937 #
8938 #
8939 # For more information, see
8940 # Enabling guest operating system features.
8941 },
8942 ],
8943 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
8944 # persistent disks.
8945 &quot;a_key&quot;: &quot;A String&quot;,
8946 },
8947 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
8948 &quot;A String&quot;,
8949 ],
8950 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
8951 # more than one instance.
8952 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
8953 # is to use the existing disk.
8954 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
8955 # of I/O operations per second that the disk can handle. Values must be
8956 # between 10,000 and 120,000. For more details, see theExtreme persistent
8957 # disk documentation.
8958 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
8959 # number of throughput mb per second that the disk can handle. Values must
8960 # greater than or equal to 1.
8961 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
8962 # the URLs of the zones where the disk should be replicated to.
8963 # You must provide exactly two replica zones, and one zone must be the same
8964 # as the instance zone.
8965 &quot;A String&quot;,
8966 ],
8967 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
8968 # have the same definition as resource
8969 # manager tags. Keys and values can be either in numeric format,
8970 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
8971 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
8972 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
8973 # empty.
8974 &quot;a_key&quot;: &quot;A String&quot;,
8975 },
8976 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
8977 # Specified using the full or partial URL. For instance template, specify
8978 # only the resource policy name.
8979 &quot;A String&quot;,
8980 ],
8981 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
8982 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
8983 # is required.
8984 #
8985 # To create a disk with one of the public operating system
8986 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
8987 #
8988 # projects/debian-cloud/global/images/family/debian-9
8989 #
8990 #
8991 # Alternatively, use a specific version of a public operating system image:
8992 #
8993 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
8994 #
8995 #
8996 # To create a disk with a custom image that you created, specify the
8997 # image name in the following format:
8998 #
8999 # global/images/my-custom-image
9000 #
9001 #
9002 # You can also specify a custom image by its image family, which returns
9003 # the latest version of the image in that family. Replace the image name
9004 # with family/family-name:
9005 #
9006 # global/images/family/my-image-family
9007 #
9008 #
9009 # If the source image is deleted later, this field will not be set.
9010 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
9011 # encryption key of the source image. Required if the source image is
9012 # protected by a customer-supplied encryption key.
9013 #
9014 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
9015 # encryption keys, so you cannot create disks for instances in a managed instance group if the
9016 # source images are encrypted with your own keys.
9017 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9018 # For example:
9019 #
9020 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9021 # key_region/cryptoKeys/key
9022 #
9023 # The fully-qualifed key name may be returned for resource GET requests. For
9024 # example:
9025 #
9026 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9027 # key_region/cryptoKeys/key
9028 # /cryptoKeyVersions/1
9029 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9030 # key. If absent, the Compute Engine default service account is used.
9031 # For example:
9032 #
9033 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9034 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9035 # encryption key, encoded in RFC
9036 # 4648 base64 to either encrypt or decrypt this resource. You can
9037 # provide either the rawKey or thersaEncryptedKey.
9038 # For example:
9039 #
9040 # &quot;rawKey&quot;:
9041 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9042 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9043 # customer-supplied encryption key to either encrypt or decrypt this
9044 # resource. You can provide either the rawKey or thersaEncryptedKey.
9045 # For example:
9046 #
9047 # &quot;rsaEncryptedKey&quot;:
9048 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9049 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9050 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9051 #
9052 # The key must meet the following requirements before you can provide it to
9053 # Compute Engine:
9054 #
9055 # 1. The key is wrapped using a RSA public key certificate provided by
9056 # Google.
9057 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9058 # encoding.
9059 #
9060 # Gets the RSA public key certificate provided by Google at:
9061 #
9062 #
9063 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9064 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9065 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9066 # encryption key that protects this resource.
9067 },
9068 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
9069 # instance boot disk, one of initializeParams.sourceSnapshot
9070 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
9071 # is required.
9072 #
9073 # To create a disk with a snapshot that you created, specify the
9074 # snapshot name in the following format:
9075 #
9076 # us-central1-a/instantSnapshots/my-backup
9077 #
9078 #
9079 # If the source instant-snapshot is deleted later, this field will not be
9080 # set.
9081 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
9082 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
9083 # is required.
9084 #
9085 # To create a disk with a snapshot that you created, specify the
9086 # snapshot name in the following format:
9087 #
9088 # global/snapshots/my-backup
9089 #
9090 #
9091 # If the source snapshot is deleted later, this field will not be set.
9092 #
9093 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
9094 # an image instead when you create VMs using
9095 # the bulk
9096 # insert method.
9097 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
9098 # encryption key of the source snapshot.
9099 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9100 # For example:
9101 #
9102 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9103 # key_region/cryptoKeys/key
9104 #
9105 # The fully-qualifed key name may be returned for resource GET requests. For
9106 # example:
9107 #
9108 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9109 # key_region/cryptoKeys/key
9110 # /cryptoKeyVersions/1
9111 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9112 # key. If absent, the Compute Engine default service account is used.
9113 # For example:
9114 #
9115 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9116 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9117 # encryption key, encoded in RFC
9118 # 4648 base64 to either encrypt or decrypt this resource. You can
9119 # provide either the rawKey or thersaEncryptedKey.
9120 # For example:
9121 #
9122 # &quot;rawKey&quot;:
9123 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9124 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9125 # customer-supplied encryption key to either encrypt or decrypt this
9126 # resource. You can provide either the rawKey or thersaEncryptedKey.
9127 # For example:
9128 #
9129 # &quot;rsaEncryptedKey&quot;:
9130 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9131 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9132 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9133 #
9134 # The key must meet the following requirements before you can provide it to
9135 # Compute Engine:
9136 #
9137 # 1. The key is wrapped using a RSA public key certificate provided by
9138 # Google.
9139 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9140 # encoding.
9141 #
9142 # Gets the RSA public key certificate provided by Google at:
9143 #
9144 #
9145 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9146 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9147 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9148 # encryption key that protects this resource.
9149 },
9150 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
9151 # this as a partial or full URL to the resource. For example, the following
9152 # are valid values:
9153 #
9154 #
9155 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
9156 # - projects/project/zones/zone/storagePools/storagePool
9157 # - zones/zone/storagePools/storagePool
9158 },
9159 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
9160 # either SCSI or NVME. For most machine types, the
9161 # default is SCSI. Local SSDs can use either NVME or SCSI.
9162 # In certain configurations, persistent disks can use NVMe. For more
9163 # information, seeAbout
9164 # persistent disks.
9165 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
9166 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
9167 &quot;A String&quot;,
9168 ],
9169 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
9170 # disk is not allowed to be detached from the instance, or to be used as the
9171 # source of the snapshot creation, and the image creation. The instance with
9172 # at least one locked attached disk is not allow to be used as source of
9173 # machine image creation, instant snapshot creation, and not allowed to be
9174 # deleted with --keep-disk parameter set to true for locked disks.
9175 &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
9176 # in READ_WRITE mode.
9177 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
9178 # field is set to PRESERVED if the LocalSSD data has been saved
9179 # to a persistent location by customer request. (see the
9180 # discard_local_ssd option on Stop/Suspend).
9181 # Read-only in the api.
9182 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
9183 # these are public keys which are safe to store in public
9184 &quot;dbs&quot;: [ # The Key Database (db).
9185 {
9186 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9187 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9188 },
9189 ],
9190 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
9191 {
9192 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9193 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9194 },
9195 ],
9196 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
9197 {
9198 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9199 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9200 },
9201 ],
9202 &quot;pk&quot;: { # The Platform Key (PK).
9203 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
9204 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
9205 },
9206 },
9207 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
9208 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
9209 # is required.
9210 #
9211 # If desired, you can also attach existing non-root persistent disks using
9212 # this property. This field is only applicable for persistent disks.
9213 #
9214 # Note that for InstanceTemplate, specify the disk name for zonal disk,
9215 # and the URL for regional disk.
9216 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
9217 },
9218 ],
9219 &quot;machineType&quot;: &quot;A String&quot;, # Output only. The machine type to be used for this instance.
9220 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance.
9221 # e.g. &#x27;Intel Ice Lake&#x27;.
9222 &quot;provisioningModel&quot;: &quot;A String&quot;, # Output only. The provisioning model to be used for this instance.
9223 },
9224 &quot;scheduling&quot;: { # Output only. [Output Only] Information about the termination timestamp of the instance,
9225 # if applicable.
9226 &quot;gracefulShutdownTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The timestamp at which the underlying instance will be
9227 # triggered for graceful shutdown if it is configured. This is in RFC3339 text format.
9228 &quot;terminationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] The timestamp at which the managed instance will be
9229 # terminated. This is in RFC3339 text format.
9230 },
9231 &quot;shutdownDetails&quot;: { # Output only. [Output Only] Specifies the graceful shutdown details if the instance is in
9232 # `PENDING_STOP` state or there is a programmed stop scheduled.
9233 &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
9234 # the instance is in `PENDING_STOP` state.
9235 # as a count of seconds and fractions of seconds at nanosecond
9236 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
9237 # or &quot;month&quot;. Range is approximately 10,000 years.
9238 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
9239 # Durations less than one second are represented with a 0
9240 # `seconds` field and a positive `nanos` field. Must be from 0
9241 # to 999,999,999 inclusive.
9242 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
9243 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
9244 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
9245 },
9246 &quot;requestTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Past timestamp indicating the beginning of `PENDING_STOP`
9247 # state of instance in RFC3339 text format.
9248 },
9249 &quot;targetStatus&quot;: &quot;A String&quot;, # Output only. [Output Only] The eventual status of the instance. The instance group
9250 # manager will not be identified as stable till each managed instance reaches
9251 # its targetStatus.
9252 &quot;version&quot;: { # Output only. [Output Only] Intended version of this instance.
9253 &quot;instanceTemplate&quot;: &quot;A String&quot;, # Output only. [Output Only] The intended template of the instance. This field is empty
9254 # when current_action is one of { DELETING, ABANDONING }.
9255 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] Name of the version.
9256 },
9257 },
9258 ],
9259 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
9260 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
9261 # the query parameter pageToken in the next list request.
9262 # Subsequent list requests will have their own nextPageToken to
9263 # continue paging through the results.
9264 }</pre>
9265 </div>
9266
9267 <div class="method">
9268 <code class="details" id="listManagedInstances_next">listManagedInstances_next()</code>
9269 <pre>Retrieves the next page of results.
9270
9271 Args:
9272 previous_request: The request for the previous page. (required)
9273 previous_response: The response from the request for the previous page. (required)
9274
9275 Returns:
9276 A request object that you can call &#x27;execute()&#x27; on to request the next
9277 page. Returns None if there are no more items in the collection.
9278 </pre>
9279 </div>
9280
9281 <div class="method">
9282 <code class="details" id="listPerInstanceConfigs">listPerInstanceConfigs(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
9283 <pre>Lists all of the per-instance configurations defined for the managed
9284 instance group. The orderBy query parameter is not supported.
9285
9286 Args:
9287 project: string, Project ID for this request. (required)
9288 zone: string, The name of thezone
9289 where the managed instance group is located.
9290 It should conform to RFC1035. (required)
9291 instanceGroupManager: string, The name of the managed instance group. It should conform to RFC1035. (required)
9292 filter: string, A filter expression that filters resources listed in the response. Most
9293 Compute resources support two types of filter expressions:
9294 expressions that support regular expressions and expressions that follow
9295 API improvement proposal AIP-160.
9296 These two types of filter expressions cannot be mixed in one request.
9297
9298 If you want to use AIP-160, your expression must specify the field name, an
9299 operator, and the value that you want to use for filtering. The value
9300 must be a string, a number, or a boolean. The operator
9301 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
9302
9303 For example, if you are filtering Compute Engine instances, you can
9304 exclude instances named `example-instance` by specifying
9305 `name != example-instance`.
9306
9307 The `:*` comparison can be used to test whether a key has been defined.
9308 For example, to find all objects with `owner` label use:
9309 ```
9310 labels.owner:*
9311 ```
9312
9313 You can also filter nested fields. For example, you could specify
9314 `scheduling.automaticRestart = false` to include instances only
9315 if they are not scheduled for automatic restarts. You can use filtering
9316 on nested fields to filter based onresource labels.
9317
9318 To filter on multiple expressions, provide each separate expression within
9319 parentheses. For example:
9320 ```
9321 (scheduling.automaticRestart = true)
9322 (cpuPlatform = &quot;Intel Skylake&quot;)
9323 ```
9324 By default, each expression is an `AND` expression. However, you
9325 can include `AND` and `OR` expressions explicitly.
9326 For example:
9327 ```
9328 (cpuPlatform = &quot;Intel Skylake&quot;) OR
9329 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
9330 (scheduling.automaticRestart = true)
9331 ```
9332
9333 If you want to use a regular expression, use the `eq` (equal) or `ne`
9334 (not equal) operator against a single un-parenthesized expression with or
9335 without quotes or against multiple parenthesized expressions. Examples:
9336
9337 `fieldname eq unquoted literal`
9338 `fieldname eq &#x27;single quoted literal&#x27;`
9339 `fieldname eq &quot;double quoted literal&quot;`
9340 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
9341
9342 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
9343 The literal value must match the entire field.
9344
9345 For example, to filter for instances that do not end with name &quot;instance&quot;,
9346 you would use `name ne .*instance`.
9347
9348 You cannot combine constraints on multiple fields using regular
9349 expressions.
9350 maxResults: integer, The maximum number of results per page that should be returned.
9351 If the number of available results is larger than `maxResults`,
9352 Compute Engine returns a `nextPageToken` that can be used to get
9353 the next page of results in subsequent list requests. Acceptable values are
9354 `0` to `500`, inclusive. (Default: `500`)
9355 orderBy: string, Sorts list results by a certain order. By default, results
9356 are returned in alphanumerical order based on the resource name.
9357
9358 You can also sort results in descending order based on the creation
9359 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
9360 results based on the `creationTimestamp` field in
9361 reverse chronological order (newest result first). Use this to sort
9362 resources like operations so that the newest operation is returned first.
9363
9364 Currently, only sorting by `name` or
9365 `creationTimestamp desc` is supported.
9366 pageToken: string, Specifies a page token to use. Set `pageToken` to the
9367 `nextPageToken` returned by a previous list request to get
9368 the next page of results.
9369 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
9370 of failure. The default value is false.
9371
9372 For example, when partial success behavior is enabled, aggregatedList for a
9373 single zone scope either returns all resources in the zone or no resources,
9374 with an error code.
9375 x__xgafv: string, V1 error format.
9376 Allowed values
9377 1 - v1 error format
9378 2 - v2 error format
9379
9380 Returns:
9381 An object of the form:
9382
9383 {
9384 &quot;items&quot;: [ # Output only. [Output Only] The list of PerInstanceConfig.
9385 {
9386 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
9387 # optimistic locking. It is ignored when inserting a per-instance
9388 # config. An up-to-date fingerprint must be provided in order to update an
9389 # existing per-instance configuration or the field needs to be unset.
9390 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
9391 # Serves as a merge key during UpdatePerInstanceConfigs
9392 # operations, that is, if a per-instance configuration with the same name
9393 # exists then it will be updated, otherwise a new one will be created for the
9394 # VM instance with the same name. An attempt to create a per-instance
9395 # configuration for a VM instance that either doesn&#x27;t exist or is not part
9396 # of the group will result in an error.
9397 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
9398 # preserved state generated from a stateful policy.
9399 &quot;disks&quot;: { # Preserved disks defined for this instance.
9400 # This map is keyed with the device names of the disks.
9401 &quot;a_key&quot;: {
9402 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
9403 # update, instance recreate operations. This flag is used to configure
9404 # if the disk should be deleted after it is no longer used by the group,
9405 # e.g. when the given instance or the whole MIG is deleted.
9406 # Note: disks attached in READ_ONLY mode cannot be
9407 # auto-deleted.
9408 &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
9409 # disk in READ_WRITE mode.
9410 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
9411 # to the VM instance.
9412 },
9413 },
9414 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
9415 # This map is keyed with the name of the network interface.
9416 &quot;a_key&quot;: {
9417 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9418 # update or VM instance recreate operations.
9419 # This flag is used to configure if the IP reservation should be deleted
9420 # after it is no longer used by the group, e.g. when the given instance
9421 # or the whole group is deleted.
9422 &quot;ipAddress&quot;: { # Ip address representation
9423 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
9424 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
9425 # network interface.
9426 },
9427 },
9428 },
9429 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
9430 # This map is keyed with the name of the network interface.
9431 &quot;a_key&quot;: {
9432 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
9433 # update or VM instance recreate operations.
9434 # This flag is used to configure if the IP reservation should be deleted
9435 # after it is no longer used by the group, e.g. when the given instance
9436 # or the whole group is deleted.
9437 &quot;ipAddress&quot;: { # Ip address representation
9438 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
9439 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
9440 # network interface.
9441 },
9442 },
9443 },
9444 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
9445 &quot;a_key&quot;: &quot;A String&quot;,
9446 },
9447 },
9448 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
9449 # managed instance.
9450 },
9451 ],
9452 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. [Output Only] This token allows you to get the next page of results for
9453 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
9454 # the query parameter pageToken in the next list request.
9455 # Subsequent list requests will have their own nextPageToken to
9456 # continue paging through the results.
9457 &quot;warning&quot;: { # Output only. [Output Only] Informational warning message.
9458 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
9459 # Engine returns NO_RESULTS_ON_PAGE if there
9460 # are no results in the response.
9461 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
9462 # value format. For example:
9463 #
9464 # &quot;data&quot;: [
9465 # {
9466 # &quot;key&quot;: &quot;scope&quot;,
9467 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
9468 # }
9469 {
9470 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
9471 # returned. For example, for warnings where there are no results in a list
9472 # request for a particular zone, this key might be scope and
9473 # the key value might be the zone name. Other examples might be a key
9474 # indicating a deprecated resource and a suggested replacement, or a
9475 # warning about invalid network settings (for example, if an instance
9476 # attempts to perform IP forwarding but is not enabled for IP forwarding).
9477 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
9478 },
9479 ],
9480 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
9481 },
9482 }</pre>
9483 </div>
9484
9485 <div class="method">
9486 <code class="details" id="listPerInstanceConfigs_next">listPerInstanceConfigs_next()</code>
9487 <pre>Retrieves the next page of results.
9488
9489 Args:
9490 previous_request: The request for the previous page. (required)
9491 previous_response: The response from the request for the previous page. (required)
9492
9493 Returns:
9494 A request object that you can call &#x27;execute()&#x27; on to request the next
9495 page. Returns None if there are no more items in the collection.
9496 </pre>
9497 </div>
9498
9499 <div class="method">
9500 <code class="details" id="list_next">list_next()</code>
9501 <pre>Retrieves the next page of results.
9502
9503 Args:
9504 previous_request: The request for the previous page. (required)
9505 previous_response: The response from the request for the previous page. (required)
9506
9507 Returns:
9508 A request object that you can call &#x27;execute()&#x27; on to request the next
9509 page. Returns None if there are no more items in the collection.
9510 </pre>
9511 </div>
9512
9513 <div class="method">
9514 <code class="details" id="patch">patch(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
9515 <pre>Updates a managed instance group using the information that you specify
9516 in the request.
9517 This operation is marked as DONE when the group is patched
9518 even if the instances in the group are still in the process of being
9519 patched. You must separately verify the status of the individual instances
9520 with thelistManagedInstances
9521 method. This method supportsPATCH
9522 semantics and uses theJSON merge
9523 patch format and processing rules.
9524
9525 If you update your group to specify a new template or instance
9526 configuration, it&#x27;s possible that your intended specification for each VM
9527 in the group is different from the current state of that VM. To learn how
9528 to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
9529 a MIG.
9530
9531 Args:
9532 project: string, Project ID for this request. (required)
9533 zone: string, The name of the zone where
9534 you want to create the managed instance group. (required)
9535 instanceGroupManager: string, The name of the instance group manager. (required)
9536 body: object, The request body.
9537 The object takes the form of:
9538
9539 { # Represents a Managed Instance Group resource.
9540 #
9541 # An instance group is a collection of VM instances that you can manage as a
9542 # single entity. For more information, readInstance groups.
9543 #
9544 # For zonal Managed Instance Group, use the instanceGroupManagers
9545 # resource.
9546 #
9547 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
9548 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
9549 # for the group.
9550 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
9551 #
9552 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
9553 # instances to apply the configuration. To apply the configuration, set the
9554 # group&#x27;s updatePolicy.type field to use proactive updates or
9555 # use the applyUpdatesToInstances method.
9556 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
9557 &quot;a_key&quot;: &quot;A String&quot;,
9558 },
9559 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
9560 # more information, see Project and
9561 # instance metadata.
9562 &quot;a_key&quot;: &quot;A String&quot;,
9563 },
9564 },
9565 },
9566 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
9567 # only one value.
9568 {
9569 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
9570 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
9571 # initialize and run its startup script. During a VM&#x27;s initial delay
9572 # period, the MIG ignores unsuccessful health checks because the VM might
9573 # be in the startup process. This prevents the MIG from prematurely
9574 # recreating a VM. If the health check receives a healthy response during
9575 # the initial delay, it indicates that the startup process is complete and
9576 # the VM is ready. The value of initial delay must be between 0 and 3600
9577 # seconds. The default value is 0.
9578 },
9579 ],
9580 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
9581 # all VMs in a MIG. The maximum character length is 58 and the name must
9582 # comply with RFC1035 format.
9583 #
9584 # When a VM is created in the group, the MIG appends a hyphen and a random
9585 # four-character string to the base instance name. If you want the MIG to
9586 # assign sequential numbers instead of a random string, then end the base
9587 # instance name with a hyphen followed by one or more hash symbols. The hash
9588 # symbols indicate the number of digits. For example, a base instance name of
9589 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
9590 # @pattern
9591 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
9592 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
9593 # text format.
9594 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
9595 # in this managed instance group that are scheduled for each of those
9596 # actions.
9597 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
9598 # that are scheduled to be abandoned. Abandoning an instance removes it
9599 # from the managed instance group without deleting it.
9600 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
9601 # are scheduled to be adopted or are currently being adopted.
9602 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
9603 # are scheduled to be created or are currently being created. If the group
9604 # fails to create any of these instances, it tries again until it creates
9605 # the instance successfully.
9606 #
9607 # If you have disabled creation retries, this field will not be populated;
9608 # instead, the creatingWithoutRetries field will be populated.
9609 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
9610 # will attempt to create. The group attempts to create each instance
9611 # only once. If the group fails to create any of these instances, it
9612 # decreases the group&#x27;s targetSize value accordingly.
9613 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
9614 # are scheduled to be deleted or are currently being deleted.
9615 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
9616 # are running and have no scheduled actions.
9617 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
9618 # are scheduled to be recreated or are currently being being recreated.
9619 # Recreating an instance deletes the existing root persistent disk
9620 # and creates a new disk from the image that is defined in the
9621 # instance template.
9622 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
9623 # are being reconfigured with properties that do not require a restart
9624 # or a recreate action. For example, setting or removing target
9625 # pools for the instance.
9626 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
9627 # are scheduled to be restarted or are currently being restarted.
9628 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
9629 # are scheduled to be restarted or are currently being restarted.
9630 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
9631 # are scheduled to be resumed or are currently being resumed.
9632 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
9633 # are scheduled to be started or are currently being started.
9634 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
9635 # are scheduled to be stopped or are currently being stopped.
9636 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
9637 # are scheduled to be suspended or are currently being suspended.
9638 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
9639 # are being verified. See the managedInstances[].currentAction
9640 # property in the listManagedInstances method documentation.
9641 },
9642 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
9643 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
9644 # zones in a regional managed instance group.
9645 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
9646 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
9647 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
9648 # its instances.
9649 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
9650 # instances, even if an AI zone is available in the specified region. To
9651 # create instances in an AI zone in the selected region, you must explicitly
9652 # specify it in the distribution policy together with the other preferred
9653 # zones.
9654 {
9655 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
9656 # The zone must exist in the region where the managed instance group is
9657 # located.
9658 },
9659 ],
9660 },
9661 &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.
9662 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
9663 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
9664 # fingerprint must be provided in order to update the InstanceGroupManager,
9665 # otherwise the request will fail with error412 conditionNotMet.
9666 #
9667 # To see the latest fingerprint, make a get() request to
9668 # retrieve an InstanceGroupManager.
9669 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
9670 # generates this identifier.
9671 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
9672 # types of machines.
9673 # Instance flexibility configuration on MIG overrides instance
9674 # template configuration.
9675 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
9676 # when creating new VMs.
9677 &quot;a_key&quot;: {
9678 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
9679 # selection.
9680 { # An instance-attached disk resource.
9681 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
9682 # or X86_64.
9683 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
9684 # deleted (but not when the disk is detached from the instance).
9685 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
9686 # partition of the disk for its root filesystem.
9687 &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
9688 # running within the instance. This name can be used to reference the device
9689 # for mounting, resizing, and so on, from within the instance.
9690 #
9691 # If not specified, the server chooses a default device name to apply to this
9692 # disk, in the form persistent-disk-x, where x is a number
9693 # assigned by Google Compute Engine. This field is only applicable for
9694 # persistent disks.
9695 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
9696 # encryption key.
9697 #
9698 # If you are creating a new disk, this field encrypts the new disk using
9699 # an encryption key that you provide. If you are attaching an existing
9700 # disk that is already encrypted, this field decrypts the disk using
9701 # the customer-supplied encryption key.
9702 #
9703 # If you encrypt a disk using a customer-supplied key, you must provide the
9704 # same key again when you attempt to use this resource at a later time. For
9705 # example, you must provide the key when you create a snapshot or an image
9706 # from the disk or when you attach the disk to a virtual machine instance.
9707 #
9708 # If you do not provide an encryption key, then the disk will be encrypted
9709 # using an automatically generated key and you do not need to provide a key
9710 # to use the disk later.
9711 #
9712 # Note:
9713 #
9714 # Instance templates do not storecustomer-supplied
9715 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
9716 #
9717 # You cannot create VMs that have disks with customer-supplied keys using
9718 # the bulk
9719 # insert method.
9720 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9721 # For example:
9722 #
9723 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9724 # key_region/cryptoKeys/key
9725 #
9726 # The fully-qualifed key name may be returned for resource GET requests. For
9727 # example:
9728 #
9729 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9730 # key_region/cryptoKeys/key
9731 # /cryptoKeyVersions/1
9732 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9733 # key. If absent, the Compute Engine default service account is used.
9734 # For example:
9735 #
9736 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9737 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9738 # encryption key, encoded in RFC
9739 # 4648 base64 to either encrypt or decrypt this resource. You can
9740 # provide either the rawKey or thersaEncryptedKey.
9741 # For example:
9742 #
9743 # &quot;rawKey&quot;:
9744 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9745 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9746 # customer-supplied encryption key to either encrypt or decrypt this
9747 # resource. You can provide either the rawKey or thersaEncryptedKey.
9748 # For example:
9749 #
9750 # &quot;rsaEncryptedKey&quot;:
9751 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9752 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9753 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9754 #
9755 # The key must meet the following requirements before you can provide it to
9756 # Compute Engine:
9757 #
9758 # 1. The key is wrapped using a RSA public key certificate provided by
9759 # Google.
9760 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9761 # encoding.
9762 #
9763 # Gets the RSA public key certificate provided by Google at:
9764 #
9765 #
9766 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9767 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9768 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9769 # encryption key that protects this resource.
9770 },
9771 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
9772 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
9773 # currently attached to another instance. If you try to force attach a zonal
9774 # disk to an instance, you will receive an error.
9775 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
9776 # only for bootable images. Read
9777 # Enabling guest operating system features to see a list of available
9778 # options.
9779 { # Guest OS features.
9780 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
9781 # separate values. Set to one or more of the following values:
9782 #
9783 # - VIRTIO_SCSI_MULTIQUEUE
9784 # - WINDOWS
9785 # - MULTI_IP_SUBNET
9786 # - UEFI_COMPATIBLE
9787 # - GVNIC
9788 # - SEV_CAPABLE
9789 # - SUSPEND_RESUME_COMPATIBLE
9790 # - SEV_LIVE_MIGRATABLE_V2
9791 # - SEV_SNP_CAPABLE
9792 # - TDX_CAPABLE
9793 # - IDPF
9794 # - SNP_SVSM_CAPABLE
9795 # - CCA_CAPABLE
9796 #
9797 #
9798 # For more information, see
9799 # Enabling guest operating system features.
9800 },
9801 ],
9802 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
9803 # boot disk. If you have many disks attached to an instance, each
9804 # disk would have a unique index number.
9805 &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
9806 # alongside the new instance. Use initialization parameters to create boot
9807 # disks or local SSDs attached to the new instance.
9808 #
9809 # This property is mutually exclusive with the source property;
9810 # you can only define one or the other, but not both.
9811 # alongside the new instance. Use initialization parameters to create boot
9812 # disks or local SSDs attached to the new instance.
9813 #
9814 # This field is persisted and returned for instanceTemplate and not returned
9815 # in the context of instance.
9816 #
9817 # This property is mutually exclusive with the source property;
9818 # you can only define one or the other, but not both.
9819 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
9820 # arm64 or x86_64.
9821 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
9822 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
9823 # of the instance. If a disk with the same name already exists in the given
9824 # region, the existing disk is attached to the new instance and the
9825 # new disk is not created.
9826 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
9827 # 10 GB. If you specify a sourceImage, which is required for
9828 # boot disks, the default size is the size of the sourceImage.
9829 # If you do not specify a sourceImage, the default disk size
9830 # is 500 GB.
9831 &quot;diskType&quot;: &quot;A String&quot;,
9832 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
9833 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
9834 # only for bootable images. Read
9835 # Enabling guest operating system features to see a list of available
9836 # options.
9837 #
9838 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
9839 { # Guest OS features.
9840 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
9841 # separate values. Set to one or more of the following values:
9842 #
9843 # - VIRTIO_SCSI_MULTIQUEUE
9844 # - WINDOWS
9845 # - MULTI_IP_SUBNET
9846 # - UEFI_COMPATIBLE
9847 # - GVNIC
9848 # - SEV_CAPABLE
9849 # - SUSPEND_RESUME_COMPATIBLE
9850 # - SEV_LIVE_MIGRATABLE_V2
9851 # - SEV_SNP_CAPABLE
9852 # - TDX_CAPABLE
9853 # - IDPF
9854 # - SNP_SVSM_CAPABLE
9855 # - CCA_CAPABLE
9856 #
9857 #
9858 # For more information, see
9859 # Enabling guest operating system features.
9860 },
9861 ],
9862 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
9863 # persistent disks.
9864 &quot;a_key&quot;: &quot;A String&quot;,
9865 },
9866 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
9867 &quot;A String&quot;,
9868 ],
9869 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
9870 # more than one instance.
9871 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
9872 # is to use the existing disk.
9873 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
9874 # of I/O operations per second that the disk can handle. Values must be
9875 # between 10,000 and 120,000. For more details, see theExtreme persistent
9876 # disk documentation.
9877 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
9878 # number of throughput mb per second that the disk can handle. Values must
9879 # greater than or equal to 1.
9880 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
9881 # the URLs of the zones where the disk should be replicated to.
9882 # You must provide exactly two replica zones, and one zone must be the same
9883 # as the instance zone.
9884 &quot;A String&quot;,
9885 ],
9886 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
9887 # have the same definition as resource
9888 # manager tags. Keys and values can be either in numeric format,
9889 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
9890 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
9891 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
9892 # empty.
9893 &quot;a_key&quot;: &quot;A String&quot;,
9894 },
9895 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
9896 # Specified using the full or partial URL. For instance template, specify
9897 # only the resource policy name.
9898 &quot;A String&quot;,
9899 ],
9900 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
9901 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
9902 # is required.
9903 #
9904 # To create a disk with one of the public operating system
9905 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
9906 #
9907 # projects/debian-cloud/global/images/family/debian-9
9908 #
9909 #
9910 # Alternatively, use a specific version of a public operating system image:
9911 #
9912 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
9913 #
9914 #
9915 # To create a disk with a custom image that you created, specify the
9916 # image name in the following format:
9917 #
9918 # global/images/my-custom-image
9919 #
9920 #
9921 # You can also specify a custom image by its image family, which returns
9922 # the latest version of the image in that family. Replace the image name
9923 # with family/family-name:
9924 #
9925 # global/images/family/my-image-family
9926 #
9927 #
9928 # If the source image is deleted later, this field will not be set.
9929 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
9930 # encryption key of the source image. Required if the source image is
9931 # protected by a customer-supplied encryption key.
9932 #
9933 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
9934 # encryption keys, so you cannot create disks for instances in a managed instance group if the
9935 # source images are encrypted with your own keys.
9936 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
9937 # For example:
9938 #
9939 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9940 # key_region/cryptoKeys/key
9941 #
9942 # The fully-qualifed key name may be returned for resource GET requests. For
9943 # example:
9944 #
9945 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
9946 # key_region/cryptoKeys/key
9947 # /cryptoKeyVersions/1
9948 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
9949 # key. If absent, the Compute Engine default service account is used.
9950 # For example:
9951 #
9952 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
9953 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
9954 # encryption key, encoded in RFC
9955 # 4648 base64 to either encrypt or decrypt this resource. You can
9956 # provide either the rawKey or thersaEncryptedKey.
9957 # For example:
9958 #
9959 # &quot;rawKey&quot;:
9960 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
9961 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
9962 # customer-supplied encryption key to either encrypt or decrypt this
9963 # resource. You can provide either the rawKey or thersaEncryptedKey.
9964 # For example:
9965 #
9966 # &quot;rsaEncryptedKey&quot;:
9967 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
9968 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
9969 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
9970 #
9971 # The key must meet the following requirements before you can provide it to
9972 # Compute Engine:
9973 #
9974 # 1. The key is wrapped using a RSA public key certificate provided by
9975 # Google.
9976 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
9977 # encoding.
9978 #
9979 # Gets the RSA public key certificate provided by Google at:
9980 #
9981 #
9982 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
9983 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
9984 # 4648 base64 encoded SHA-256 hash of the customer-supplied
9985 # encryption key that protects this resource.
9986 },
9987 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
9988 # instance boot disk, one of initializeParams.sourceSnapshot
9989 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
9990 # is required.
9991 #
9992 # To create a disk with a snapshot that you created, specify the
9993 # snapshot name in the following format:
9994 #
9995 # us-central1-a/instantSnapshots/my-backup
9996 #
9997 #
9998 # If the source instant-snapshot is deleted later, this field will not be
9999 # set.
10000 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
10001 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
10002 # is required.
10003 #
10004 # To create a disk with a snapshot that you created, specify the
10005 # snapshot name in the following format:
10006 #
10007 # global/snapshots/my-backup
10008 #
10009 #
10010 # If the source snapshot is deleted later, this field will not be set.
10011 #
10012 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
10013 # an image instead when you create VMs using
10014 # the bulk
10015 # insert method.
10016 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
10017 # encryption key of the source snapshot.
10018 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
10019 # For example:
10020 #
10021 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10022 # key_region/cryptoKeys/key
10023 #
10024 # The fully-qualifed key name may be returned for resource GET requests. For
10025 # example:
10026 #
10027 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
10028 # key_region/cryptoKeys/key
10029 # /cryptoKeyVersions/1
10030 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
10031 # key. If absent, the Compute Engine default service account is used.
10032 # For example:
10033 #
10034 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
10035 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
10036 # encryption key, encoded in RFC
10037 # 4648 base64 to either encrypt or decrypt this resource. You can
10038 # provide either the rawKey or thersaEncryptedKey.
10039 # For example:
10040 #
10041 # &quot;rawKey&quot;:
10042 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
10043 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
10044 # customer-supplied encryption key to either encrypt or decrypt this
10045 # resource. You can provide either the rawKey or thersaEncryptedKey.
10046 # For example:
10047 #
10048 # &quot;rsaEncryptedKey&quot;:
10049 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
10050 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
10051 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
10052 #
10053 # The key must meet the following requirements before you can provide it to
10054 # Compute Engine:
10055 #
10056 # 1. The key is wrapped using a RSA public key certificate provided by
10057 # Google.
10058 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
10059 # encoding.
10060 #
10061 # Gets the RSA public key certificate provided by Google at:
10062 #
10063 #
10064 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
10065 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
10066 # 4648 base64 encoded SHA-256 hash of the customer-supplied
10067 # encryption key that protects this resource.
10068 },
10069 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
10070 # this as a partial or full URL to the resource. For example, the following
10071 # are valid values:
10072 #
10073 #
10074 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
10075 # - projects/project/zones/zone/storagePools/storagePool
10076 # - zones/zone/storagePools/storagePool
10077 },
10078 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
10079 # either SCSI or NVME. For most machine types, the
10080 # default is SCSI. Local SSDs can use either NVME or SCSI.
10081 # In certain configurations, persistent disks can use NVMe. For more
10082 # information, seeAbout
10083 # persistent disks.
10084 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
10085 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
10086 &quot;A String&quot;,
10087 ],
10088 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
10089 # disk is not allowed to be detached from the instance, or to be used as the
10090 # source of the snapshot creation, and the image creation. The instance with
10091 # at least one locked attached disk is not allow to be used as source of
10092 # machine image creation, instant snapshot creation, and not allowed to be
10093 # deleted with --keep-disk parameter set to true for locked disks.
10094 &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
10095 # in READ_WRITE mode.
10096 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
10097 # field is set to PRESERVED if the LocalSSD data has been saved
10098 # to a persistent location by customer request. (see the
10099 # discard_local_ssd option on Stop/Suspend).
10100 # Read-only in the api.
10101 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
10102 # these are public keys which are safe to store in public
10103 &quot;dbs&quot;: [ # The Key Database (db).
10104 {
10105 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
10106 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
10107 },
10108 ],
10109 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
10110 {
10111 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
10112 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
10113 },
10114 ],
10115 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
10116 {
10117 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
10118 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
10119 },
10120 ],
10121 &quot;pk&quot;: { # The Platform Key (PK).
10122 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
10123 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
10124 },
10125 },
10126 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
10127 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
10128 # is required.
10129 #
10130 # If desired, you can also attach existing non-root persistent disks using
10131 # this property. This field is only applicable for persistent disks.
10132 #
10133 # Note that for InstanceTemplate, specify the disk name for zonal disk,
10134 # and the URL for regional disk.
10135 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
10136 },
10137 ],
10138 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
10139 &quot;A String&quot;,
10140 ],
10141 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
10142 # e.g. &#x27;Intel Ice Lake&#x27;.
10143 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
10144 # preference. MIG will first try to create a VM based on the machine-type
10145 # with lowest rank and fallback to next rank based on availability.
10146 # Machine types and instance selections with the same rank have the same
10147 # preference.
10148 },
10149 },
10150 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
10151 # create instances.
10152 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
10153 # more preemption than the minimum capacity user needs. MIG will create
10154 # only Standard VMs until it reaches standard_capacity_base and only
10155 # then will start using standard_capacity_percent_above_base to mix Spot
10156 # with Standard VMs.
10157 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
10158 # remaining percentage will use Spot VMs. The percentage applies only to
10159 # the capacity above standard_capacity_base.
10160 },
10161 },
10162 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
10163 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
10164 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
10165 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
10166 # applies to the VMs on which your application fails a health check.
10167 # Valid values are
10168 #
10169 # - REPAIR (default): MIG automatically repairs a failed VM
10170 # by recreating it. For more information, see About
10171 # repairing VMs in a MIG.
10172 # - DO_NOTHING: MIG does not repair a failed VM.
10173 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
10174 # configuration when repairing a VM. Valid options are:
10175 #
10176 #
10177 #
10178 # - NO (default): If configuration updates are available, they are not
10179 # forcefully applied during repair. Instead, configuration updates are
10180 # applied according to the group&#x27;s update policy.
10181 #
10182 # - YES: If configuration updates are available, they are applied
10183 # during repair.
10184 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
10185 # unhealthy when the application running on that VM fails a health check.
10186 # Valid values are:
10187 #
10188 # - DEFAULT_ACTION (default): MIG uses the same action
10189 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
10190 # - REPAIR: MIG automatically repairs an unhealthy VM by
10191 # recreating it.
10192 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
10193 # For more information, see
10194 # About repairing VMs in a MIG.
10195 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
10196 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
10197 # Valid values are:
10198 #
10199 # - NO (default): MIG cannot change a VM&#x27;s zone during a
10200 # repair.
10201 # - YES: MIG can select a different zone for the VM during
10202 # a repair.
10203 },
10204 },
10205 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
10206 # instance group. The group uses this template to create all new instances
10207 # in the managed instance group. The templates for existing instances in the
10208 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
10209 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
10210 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
10211 # this managed instance group.
10212 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
10213 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
10214 # long, and comply withRFC1035.
10215 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
10216 # to this Instance Group Manager.
10217 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
10218 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
10219 # The name must be 1-63 characters long, and comply withRFC1035.
10220 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
10221 },
10222 ],
10223 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
10224 # as part of resource payload.
10225 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
10226 # key-value pairs. Keys and values can be either in numeric format,
10227 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
10228 # format such as `{org_id|project_id}/{tag_key_short_name}` and
10229 # `{tag_value_short_name}`. For more information, seeManage tags
10230 # for resources.
10231 &quot;a_key&quot;: &quot;A String&quot;,
10232 },
10233 },
10234 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
10235 # where the managed instance group resides (for regional resources).
10236 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
10237 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
10238 # instance group.
10239 # It can be a full or partial URL. For example, the following are
10240 # all valid URLs to a workload policy:
10241 #
10242 #
10243 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
10244 # - projects/project/regions/region/resourcePolicies/resourcePolicy
10245 # - regions/region/resourcePolicies/resourcePolicy
10246 },
10247 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
10248 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
10249 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
10250 # this URL.
10251 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
10252 # by the managed instance group on instances. The service accounts needs all
10253 # permissions required to create and delete instances.
10254 # By default, the service account
10255 # {projectNumber}@cloudservices.gserviceaccount.com is used.
10256 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
10257 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
10258 # stop a VM after that VM was created. The initial delay gives the
10259 # initialization script the time to prepare your VM for a quick scale out.
10260 # The value of initial delay must be between 0 and 3600 seconds. The
10261 # default value is 0.
10262 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
10263 # group scales out. The default mode is `MANUAL`.
10264 },
10265 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
10266 &quot;preservedState&quot;: { # Configuration of preserved resources.
10267 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
10268 # delete, update, etc. This map is keyed with the device names of
10269 # the disks.
10270 &quot;a_key&quot;: {
10271 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
10272 # update or VM instance recreate operations.
10273 # This flag is used to configure if the disk should be deleted after it
10274 # is no longer used by the group, e.g. when the given instance or
10275 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
10276 },
10277 },
10278 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
10279 # instance delete, update, etc. This map is keyed with the network
10280 # interface name.
10281 &quot;a_key&quot;: {
10282 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
10283 # update or VM instance recreate operations.
10284 # This flag is used to configure if the IP reservation should be deleted
10285 # after it is no longer used by the group, e.g. when the given instance
10286 # or the whole group is deleted.
10287 },
10288 },
10289 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
10290 # instance delete, update, etc. This map is keyed with the network
10291 # interface name.
10292 &quot;a_key&quot;: {
10293 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
10294 # update or VM instance recreate operations.
10295 # This flag is used to configure if the IP reservation should be deleted
10296 # after it is no longer used by the group, e.g. when the given instance
10297 # or the whole group is deleted.
10298 },
10299 },
10300 },
10301 },
10302 &quot;status&quot;: { # Output only. The status of this managed instance group.
10303 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
10304 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
10305 # This value is in RFC3339 text format.
10306 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
10307 # been applied to all managed instances in the group.
10308 },
10309 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
10310 # Currently only one accelerator topology is supported.
10311 {
10312 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
10313 # The value is the same as configured in the WorkloadPolicy.
10314 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
10315 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
10316 # check.
10317 &quot;error&quot;: { # Output only. Encountered errors.
10318 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
10319 # operation.
10320 {
10321 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
10322 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
10323 # details. There is a set of defined message types to use for providing
10324 # details.The syntax depends on the error code. For example,
10325 # QuotaExceededInfo will have details when the error code is
10326 # QUOTA_EXCEEDED.
10327 {
10328 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
10329 #
10330 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
10331 # is not enabled:
10332 #
10333 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
10334 # &quot;domain&quot;: &quot;googleapis.com&quot;
10335 # &quot;metadata&quot;: {
10336 # &quot;resource&quot;: &quot;projects/123&quot;,
10337 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
10338 # }
10339 # }
10340 #
10341 # This response indicates that the pubsub.googleapis.com API is not enabled.
10342 #
10343 # Example of an error that is returned when attempting to create a Spanner
10344 # instance in a region that is out of stock:
10345 #
10346 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
10347 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
10348 # &quot;metadata&quot;: {
10349 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
10350 # }
10351 # }
10352 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
10353 # is typically the registered service name of the tool or product that
10354 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
10355 # generated by some common infrastructure, the error domain must be a
10356 # globally unique value that identifies the infrastructure. For Google API
10357 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10358 &quot;metadatas&quot;: { # Additional structured details about this error.
10359 #
10360 # Keys must match a regular expression of `a-z+` but should
10361 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10362 # length. When identifying the current value of an exceeded limit, the units
10363 # should be contained in the key, not the value. For example, rather than
10364 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10365 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10366 # instances that can be created in a single (batch) request.
10367 &quot;a_key&quot;: &quot;A String&quot;,
10368 },
10369 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10370 # proximate cause of the error. Error reasons are unique within a particular
10371 # domain of errors. This should be at most 63 characters and match a
10372 # regular expression of `A-Z+[A-Z0-9]`, which represents
10373 # UPPER_SNAKE_CASE.
10374 },
10375 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10376 #
10377 # For example, if a quota check failed with an error indicating the calling
10378 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10379 # directly to the right place in the developer console to flip the bit.
10380 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10381 { # Describes a URL link.
10382 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10383 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
10384 },
10385 ],
10386 },
10387 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
10388 # which can be attached to an RPC error.
10389 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
10390 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
10391 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
10392 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
10393 },
10394 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
10395 &quot;dimensions&quot;: { # The map holding related quota dimensions.
10396 &quot;a_key&quot;: &quot;A String&quot;,
10397 },
10398 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
10399 # type or metric.
10400 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
10401 # or metric.
10402 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
10403 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
10404 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
10405 },
10406 },
10407 ],
10408 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
10409 # This property is optional.
10410 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
10411 },
10412 ],
10413 },
10414 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
10415 # has // RFC3339 //
10416 # text format.
10417 },
10418 },
10419 ],
10420 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
10421 # that targets this instance group manager.
10422 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
10423 # targetSizePolicy.mode is set to BULK.
10424 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
10425 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
10426 # operation.
10427 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
10428 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
10429 # operation.
10430 {
10431 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
10432 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
10433 # details. There is a set of defined message types to use for providing
10434 # details.The syntax depends on the error code. For example,
10435 # QuotaExceededInfo will have details when the error code is
10436 # QUOTA_EXCEEDED.
10437 {
10438 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
10439 #
10440 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
10441 # is not enabled:
10442 #
10443 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
10444 # &quot;domain&quot;: &quot;googleapis.com&quot;
10445 # &quot;metadata&quot;: {
10446 # &quot;resource&quot;: &quot;projects/123&quot;,
10447 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
10448 # }
10449 # }
10450 #
10451 # This response indicates that the pubsub.googleapis.com API is not enabled.
10452 #
10453 # Example of an error that is returned when attempting to create a Spanner
10454 # instance in a region that is out of stock:
10455 #
10456 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
10457 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
10458 # &quot;metadata&quot;: {
10459 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
10460 # }
10461 # }
10462 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
10463 # is typically the registered service name of the tool or product that
10464 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
10465 # generated by some common infrastructure, the error domain must be a
10466 # globally unique value that identifies the infrastructure. For Google API
10467 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10468 &quot;metadatas&quot;: { # Additional structured details about this error.
10469 #
10470 # Keys must match a regular expression of `a-z+` but should
10471 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10472 # length. When identifying the current value of an exceeded limit, the units
10473 # should be contained in the key, not the value. For example, rather than
10474 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10475 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10476 # instances that can be created in a single (batch) request.
10477 &quot;a_key&quot;: &quot;A String&quot;,
10478 },
10479 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10480 # proximate cause of the error. Error reasons are unique within a particular
10481 # domain of errors. This should be at most 63 characters and match a
10482 # regular expression of `A-Z+[A-Z0-9]`, which represents
10483 # UPPER_SNAKE_CASE.
10484 },
10485 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10486 #
10487 # For example, if a quota check failed with an error indicating the calling
10488 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10489 # directly to the right place in the developer console to flip the bit.
10490 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10491 { # Describes a URL link.
10492 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10493 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
10494 },
10495 ],
10496 },
10497 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
10498 # which can be attached to an RPC error.
10499 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
10500 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
10501 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
10502 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
10503 },
10504 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
10505 &quot;dimensions&quot;: { # The map holding related quota dimensions.
10506 &quot;a_key&quot;: &quot;A String&quot;,
10507 },
10508 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
10509 # type or metric.
10510 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
10511 # or metric.
10512 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
10513 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
10514 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
10515 },
10516 },
10517 ],
10518 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
10519 # This property is optional.
10520 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
10521 },
10522 ],
10523 },
10524 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
10525 # operation. Timestamp is in RFC3339 text format.
10526 },
10527 },
10528 &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
10529 # in this managed instance group that have the status. Currently only shown
10530 # for TPU MIGs
10531 # instance group that have the status. For more information about how to
10532 # interpret each status check the instance lifecycle documentation.
10533 # Currently only shown for TPU MIGs.
10534 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
10535 # that have DEPROVISIONING status.
10536 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
10537 # have been deleted. Includes only instances that would be shown in the
10538 # listManagedInstances method and not all instances that have been
10539 # deleted in the lifetime of the MIG.
10540 # Does not include FlexStart instances that are waiting for the resources
10541 # availability, they are considered as &#x27;pending&#x27;.
10542 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
10543 # that have PENDING status, that is FlexStart instances that are waiting
10544 # for resources. Instances that do not exist because of the other reasons
10545 # are counted as &#x27;non_existent&#x27;.
10546 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
10547 # that have PENDING_STOP status.
10548 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
10549 # that have PROVISIONING status.
10550 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
10551 # that have REPAIRING status.
10552 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
10553 # that have RUNNING status.
10554 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
10555 # that have STAGING status.
10556 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
10557 # that have STOPPED status.
10558 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
10559 # that have STOPPING status.
10560 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
10561 # that have SUSPENDED status.
10562 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
10563 # that have SUSPENDING status.
10564 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
10565 # that have TERMINATED status.
10566 },
10567 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
10568 # stable state. A stable state means that: none of the instances in the
10569 # managed instance group is currently undergoing any type of change (for
10570 # example, creation, restart, or deletion); no future changes are scheduled
10571 # for instances in the managed instance group; and the managed instance
10572 # group itself is not being modified.
10573 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
10574 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
10575 # has stateful configuration, that is, if you have configured any items
10576 # in a stateful policy or in per-instance configs.
10577 # The group might report that it has no stateful configuration even when
10578 # there is still some preserved state on a managed instance, for example,
10579 # if you have deleted all PICs but not yet applied those deletions.
10580 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
10581 # has stateful configuration, that is, if you have configured any items
10582 # in a stateful policy or in per-instance configs.
10583 # The group might report that it has no stateful configuration even when
10584 # there is still some preserved state on a managed instance, for example,
10585 # if you have deleted all PICs but not yet applied those deletions. This
10586 # field is deprecated in favor of has_stateful_config.
10587 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
10588 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
10589 # (listed in the output of a listPerInstanceConfigs API call) have
10590 # status EFFECTIVE or there are no per-instance-configs.
10591 },
10592 },
10593 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
10594 # target version specified by version field on Instance Group
10595 # Manager.
10596 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
10597 # in this managed instance group, i.e. all instances are in their target
10598 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
10599 },
10600 },
10601 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
10602 # apply to all of the instances in the managed instance group.
10603 &quot;A String&quot;,
10604 ],
10605 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
10606 # You can reduce this number by using the instanceGroupManager
10607 # deleteInstances or abandonInstances methods. Resizing the group also
10608 # changes this number.
10609 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
10610 # size.
10611 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
10612 # individually or all at once.
10613 },
10614 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
10615 # This number changes when you:
10616 #
10617 # - Stop instance using the stopInstances
10618 # method or start instances using the startInstances
10619 # method.
10620 # - Manually change the targetStoppedSize using the update
10621 # method.
10622 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
10623 # This number changes when you:
10624 #
10625 # - Suspend instance using the suspendInstances
10626 # method or resume instances using the resumeInstances
10627 # method.
10628 # - Manually change the targetSuspendedSize using the update
10629 # method.
10630 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
10631 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
10632 &quot;A String&quot;,
10633 ],
10634 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
10635 # instance redistribution policy for regional managed instance groups.
10636 # Valid values are:
10637 #
10638 # - PROACTIVE (default): The group attempts to maintain an
10639 # even distribution of VM instances across zones in the region.
10640 # - NONE: For non-autoscaled groups, proactive
10641 # redistribution is disabled.
10642 &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
10643 # either a fixed number or, if the group has 10 or more instances, a
10644 # percentage. If you set a percentage, the number of instances is rounded
10645 # if necessary. The default value for maxSurge is a fixed
10646 # value equal to the number of zones in which the managed instance group
10647 # operates.
10648 #
10649 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
10650 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
10651 #
10652 #
10653 #
10654 # - If the value is fixed, then the calculated
10655 # value is equal to the fixed value.
10656 # - If the value is a percent, then the
10657 # calculated
10658 # value is percent/100 * targetSize. For example,
10659 # the calculated value of a 80% of a managed instance group
10660 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
10661 # is a remainder, the number is rounded.
10662 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
10663 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
10664 # example, specify 80 for 80%.
10665 },
10666 &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
10667 # process. An instance is considered available if all of the following
10668 # conditions are satisfied:
10669 #
10670 #
10671 #
10672 # - The instance&#x27;s status is
10673 # RUNNING.
10674 # - If there is a health
10675 # check on the instance group, the instance&#x27;s health check status
10676 # must be HEALTHY at least once. If there is no health check
10677 # on the group, then the instance only needs to have a status of
10678 # RUNNING to be considered available.
10679 #
10680 #
10681 # This value can be either a fixed number or, if the group has 10 or more
10682 # instances, a percentage. If you set a percentage, the number of instances
10683 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
10684 # in which the managed instance group operates.
10685 #
10686 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
10687 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
10688 #
10689 #
10690 #
10691 # - If the value is fixed, then the calculated
10692 # value is equal to the fixed value.
10693 # - If the value is a percent, then the
10694 # calculated
10695 # value is percent/100 * targetSize. For example,
10696 # the calculated value of a 80% of a managed instance group
10697 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
10698 # is a remainder, the number is rounded.
10699 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
10700 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
10701 # example, specify 80 for 80%.
10702 },
10703 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
10704 # becomes available. This value must be from range [0, 3600].
10705 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
10706 # disruption as much as possible or to apply a more disruptive action than
10707 # is necessary.
10708 #
10709 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
10710 # Compute Engine performs the necessary action to execute the update.
10711 # - To apply a more disruptive action than is strictly necessary, set the
10712 # minimal action to RESTART or REPLACE. For
10713 # example, Compute Engine does not need to restart a VM to change its
10714 # metadata. But if your application reads instance metadata only when a VM
10715 # is restarted, you can set the minimal action to RESTART in
10716 # order to pick up metadata changes.
10717 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
10718 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
10719 # as much as possible. RESTART to allow actions that can be
10720 # applied without instance replacing or REPLACE to allow all
10721 # possible actions. If the Updater determines that the minimal update
10722 # action needed is more disruptive than most disruptive allowed action you
10723 # specify it will not perform the update at all.
10724 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
10725 # See minimal_action.REPLACE
10726 &quot;type&quot;: &quot;A String&quot;, # The type
10727 # of update process. You can specify either PROACTIVE so
10728 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
10729 # to update.
10730 },
10731 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
10732 # create instances.
10733 #
10734 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
10735 # group. This field overrides the top-level instanceTemplate
10736 # field. Read more about therelationships
10737 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
10738 # remaining instances. For more information, read aboutcanary
10739 # updates.
10740 {
10741 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
10742 # instance group. The group uses this template to create new instances in
10743 # the managed instance group until the `targetSize` for this version is
10744 # reached. The templates for existing instances in the group do not change
10745 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
10746 # existing instances are updated until the `targetSize` for this version is
10747 # reached.
10748 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
10749 # managed instance group.
10750 &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
10751 # from the template will be equal to:
10752 #
10753 #
10754 # - If expressed as a fixed number, the minimum of either
10755 # targetSize.fixed or
10756 # instanceGroupManager.targetSize is used.
10757 # - if expressed as a percent, the targetSize
10758 # would be (targetSize.percent/100 *
10759 # InstanceGroupManager.targetSize) If there is a remainder, the
10760 # number is rounded.
10761 #
10762 # If unset, this version will update any remaining instances not
10763 # updated by another version. ReadStarting
10764 # a canary update for more information.
10765 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
10766 #
10767 #
10768 #
10769 # - If the value is fixed, then the calculated
10770 # value is equal to the fixed value.
10771 # - If the value is a percent, then the
10772 # calculated
10773 # value is percent/100 * targetSize. For example,
10774 # the calculated value of a 80% of a managed instance group
10775 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
10776 # is a remainder, the number is rounded.
10777 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
10778 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
10779 # example, specify 80 for 80%.
10780 },
10781 },
10782 ],
10783 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
10784 # where the managed instance group is located (for zonal resources).
10785 }
10786
10787 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
10788 that if you must retry your request, the server will know to ignore the
10789 request if it has already been completed.
10790
10791 For example, consider a situation where you make an initial request and
10792 the request times out. If you make the request again with the same
10793 request ID, the server can check if original operation with the same
10794 request ID was received, and if so, will ignore the second request. This
10795 prevents clients from accidentally creating duplicate commitments.
10796
10797 The request ID must be
10798 a valid UUID with the exception that zero UUID is not supported
10799 (00000000-0000-0000-0000-000000000000).
10800 x__xgafv: string, V1 error format.
10801 Allowed values
10802 1 - v1 error format
10803 2 - v2 error format
10804
10805 Returns:
10806 An object of the form:
10807
10808 { # Represents an Operation resource.
10809 #
10810 # Google Compute Engine has three Operation resources:
10811 #
10812 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
10813 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
10814 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
10815 #
10816 # You can use an operation resource to manage asynchronous API requests.
10817 # For more information, readHandling
10818 # API responses.
10819 #
10820 # Operations can be global, regional or zonal.
10821 #
10822 # - For global operations, use the `globalOperations`
10823 # resource.
10824 # - For regional operations, use the
10825 # `regionOperations` resource.
10826 # - For zonal operations, use
10827 # the `zoneOperations` resource.
10828 #
10829 #
10830 #
10831 # For more information, read
10832 # Global, Regional, and Zonal Resources.
10833 #
10834 # Note that completed Operation resources have a limited
10835 # retention period.
10836 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
10837 # Not present otherwise.
10838 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
10839 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
10840 # set when the operation is created.
10841 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
10842 # text format.
10843 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
10844 # this field will be populated.
10845 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
10846 # operation.
10847 {
10848 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
10849 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
10850 # details. There is a set of defined message types to use for providing
10851 # details.The syntax depends on the error code. For example,
10852 # QuotaExceededInfo will have details when the error code is
10853 # QUOTA_EXCEEDED.
10854 {
10855 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
10856 #
10857 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
10858 # is not enabled:
10859 #
10860 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
10861 # &quot;domain&quot;: &quot;googleapis.com&quot;
10862 # &quot;metadata&quot;: {
10863 # &quot;resource&quot;: &quot;projects/123&quot;,
10864 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
10865 # }
10866 # }
10867 #
10868 # This response indicates that the pubsub.googleapis.com API is not enabled.
10869 #
10870 # Example of an error that is returned when attempting to create a Spanner
10871 # instance in a region that is out of stock:
10872 #
10873 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
10874 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
10875 # &quot;metadata&quot;: {
10876 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
10877 # }
10878 # }
10879 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
10880 # is typically the registered service name of the tool or product that
10881 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
10882 # generated by some common infrastructure, the error domain must be a
10883 # globally unique value that identifies the infrastructure. For Google API
10884 # infrastructure, the error domain is &quot;googleapis.com&quot;.
10885 &quot;metadatas&quot;: { # Additional structured details about this error.
10886 #
10887 # Keys must match a regular expression of `a-z+` but should
10888 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
10889 # length. When identifying the current value of an exceeded limit, the units
10890 # should be contained in the key, not the value. For example, rather than
10891 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
10892 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
10893 # instances that can be created in a single (batch) request.
10894 &quot;a_key&quot;: &quot;A String&quot;,
10895 },
10896 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
10897 # proximate cause of the error. Error reasons are unique within a particular
10898 # domain of errors. This should be at most 63 characters and match a
10899 # regular expression of `A-Z+[A-Z0-9]`, which represents
10900 # UPPER_SNAKE_CASE.
10901 },
10902 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
10903 #
10904 # For example, if a quota check failed with an error indicating the calling
10905 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
10906 # directly to the right place in the developer console to flip the bit.
10907 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
10908 { # Describes a URL link.
10909 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
10910 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
10911 },
10912 ],
10913 },
10914 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
10915 # which can be attached to an RPC error.
10916 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
10917 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
10918 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
10919 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
10920 },
10921 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
10922 &quot;dimensions&quot;: { # The map holding related quota dimensions.
10923 &quot;a_key&quot;: &quot;A String&quot;,
10924 },
10925 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
10926 # type or metric.
10927 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
10928 # or metric.
10929 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
10930 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
10931 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
10932 },
10933 },
10934 ],
10935 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
10936 # This property is optional.
10937 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
10938 },
10939 ],
10940 },
10941 &quot;getVersionOperationMetadata&quot;: {
10942 &quot;inlineSbomInfo&quot;: {
10943 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
10944 # appropriate identifiers.
10945 &quot;a_key&quot;: &quot;A String&quot;,
10946 },
10947 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
10948 # identifiers.
10949 &quot;a_key&quot;: &quot;A String&quot;,
10950 },
10951 },
10952 },
10953 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
10954 # message that was returned, such as `NOT FOUND`.
10955 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
10956 # status code that was returned. For example, a `404` means the
10957 # resource was not found.
10958 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
10959 # defined by the server.
10960 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
10961 # This value is inRFC3339
10962 # text format.
10963 &quot;instancesBulkInsertOperationMetadata&quot;: {
10964 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
10965 # Example key: zones/us-central1-a
10966 &quot;a_key&quot;: {
10967 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
10968 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
10969 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
10970 # error.
10971 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
10972 # if the flow is rolling forward or rolling back.
10973 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
10974 },
10975 },
10976 },
10977 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
10978 # Operation resources.
10979 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
10980 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
10981 # group of operations results from a `bulkInsert` API request.
10982 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
10983 # `update`, or `delete`, and so on.
10984 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
10985 # There is no requirement that this be linear or support any granularity of
10986 # operations. This should not be used to guess when the operation will be
10987 # complete. This number should monotonically increase as the operation
10988 # progresses.
10989 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
10990 # applicable when performing regional operations.
10991 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
10992 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
10993 # this field will contain information on all underlying zonal actions and
10994 # their state.
10995 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
10996 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
10997 # Example key: zones/us-central1-a
10998 &quot;a_key&quot;: {
10999 &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
11000 # populated.
11001 # different programming environments, including REST APIs and RPC APIs. It is
11002 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
11003 # three pieces of data: error code, error message, and error details.
11004 #
11005 # You can find out more about this error model and how to work with it in the
11006 # [API Design Guide](https://cloud.google.com/apis/design/errors).
11007 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
11008 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
11009 # message types for APIs to use.
11010 {
11011 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
11012 },
11013 ],
11014 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
11015 # user-facing error message should be localized and sent in the
11016 # google.rpc.Status.details field, or localized by the client.
11017 },
11018 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
11019 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
11020 },
11021 },
11022 },
11023 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
11024 # This value is inRFC3339
11025 # text format.
11026 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
11027 # following:
11028 # `PENDING`, `RUNNING`, or `DONE`.
11029 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
11030 # operation.
11031 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
11032 # of the target resource.
11033 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
11034 # operations related to creating a snapshot, this points to the disk
11035 # that the snapshot was created from.
11036 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
11037 # `[email protected]` or
11038 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
11039 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
11040 # operation, this field will be populated.
11041 {
11042 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
11043 # Engine returns NO_RESULTS_ON_PAGE if there
11044 # are no results in the response.
11045 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
11046 # value format. For example:
11047 #
11048 # &quot;data&quot;: [
11049 # {
11050 # &quot;key&quot;: &quot;scope&quot;,
11051 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
11052 # }
11053 {
11054 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
11055 # returned. For example, for warnings where there are no results in a list
11056 # request for a particular zone, this key might be scope and
11057 # the key value might be the zone name. Other examples might be a key
11058 # indicating a deprecated resource and a suggested replacement, or a
11059 # warning about invalid network settings (for example, if an instance
11060 # attempts to perform IP forwarding but is not enabled for IP forwarding).
11061 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
11062 },
11063 ],
11064 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
11065 },
11066 ],
11067 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
11068 # applicable when performing per-zone operations.
11069 }</pre>
11070 </div>
11071
11072 <div class="method">
11073 <code class="details" id="patchPerInstanceConfigs">patchPerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
11074 <pre>Inserts or patches per-instance configurations for the managed instance
11075 group. perInstanceConfig.name serves as a key used to
11076 distinguish whether to perform insert or patch.
11077
11078 Args:
11079 project: string, Project ID for this request. (required)
11080 zone: string, The name of thezone
11081 where the managed instance group is located.
11082 It should conform to RFC1035. (required)
11083 instanceGroupManager: string, The name of the managed instance group.
11084 It should conform to RFC1035. (required)
11085 body: object, The request body.
11086 The object takes the form of:
11087
11088 { # InstanceGroupManagers.patchPerInstanceConfigs
11089 &quot;perInstanceConfigs&quot;: [ # The list of per-instance configurations to insert or patch on this managed
11090 # instance group.
11091 {
11092 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
11093 # optimistic locking. It is ignored when inserting a per-instance
11094 # config. An up-to-date fingerprint must be provided in order to update an
11095 # existing per-instance configuration or the field needs to be unset.
11096 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
11097 # Serves as a merge key during UpdatePerInstanceConfigs
11098 # operations, that is, if a per-instance configuration with the same name
11099 # exists then it will be updated, otherwise a new one will be created for the
11100 # VM instance with the same name. An attempt to create a per-instance
11101 # configuration for a VM instance that either doesn&#x27;t exist or is not part
11102 # of the group will result in an error.
11103 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
11104 # preserved state generated from a stateful policy.
11105 &quot;disks&quot;: { # Preserved disks defined for this instance.
11106 # This map is keyed with the device names of the disks.
11107 &quot;a_key&quot;: {
11108 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
11109 # update, instance recreate operations. This flag is used to configure
11110 # if the disk should be deleted after it is no longer used by the group,
11111 # e.g. when the given instance or the whole MIG is deleted.
11112 # Note: disks attached in READ_ONLY mode cannot be
11113 # auto-deleted.
11114 &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
11115 # disk in READ_WRITE mode.
11116 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
11117 # to the VM instance.
11118 },
11119 },
11120 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
11121 # This map is keyed with the name of the network interface.
11122 &quot;a_key&quot;: {
11123 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
11124 # update or VM instance recreate operations.
11125 # This flag is used to configure if the IP reservation should be deleted
11126 # after it is no longer used by the group, e.g. when the given instance
11127 # or the whole group is deleted.
11128 &quot;ipAddress&quot;: { # Ip address representation
11129 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
11130 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
11131 # network interface.
11132 },
11133 },
11134 },
11135 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
11136 # This map is keyed with the name of the network interface.
11137 &quot;a_key&quot;: {
11138 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
11139 # update or VM instance recreate operations.
11140 # This flag is used to configure if the IP reservation should be deleted
11141 # after it is no longer used by the group, e.g. when the given instance
11142 # or the whole group is deleted.
11143 &quot;ipAddress&quot;: { # Ip address representation
11144 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
11145 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
11146 # network interface.
11147 },
11148 },
11149 },
11150 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
11151 &quot;a_key&quot;: &quot;A String&quot;,
11152 },
11153 },
11154 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
11155 # managed instance.
11156 },
11157 ],
11158 }
11159
11160 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11161 that if you must retry your request, the server will know to ignore the
11162 request if it has already been completed.
11163
11164 For example, consider a situation where you make an initial request and
11165 the request times out. If you make the request again with the same
11166 request ID, the server can check if original operation with the same
11167 request ID was received, and if so, will ignore the second request. This
11168 prevents clients from accidentally creating duplicate commitments.
11169
11170 The request ID must be
11171 a valid UUID with the exception that zero UUID is not supported
11172 (00000000-0000-0000-0000-000000000000).
11173 x__xgafv: string, V1 error format.
11174 Allowed values
11175 1 - v1 error format
11176 2 - v2 error format
11177
11178 Returns:
11179 An object of the form:
11180
11181 { # Represents an Operation resource.
11182 #
11183 # Google Compute Engine has three Operation resources:
11184 #
11185 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
11186 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
11187 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
11188 #
11189 # You can use an operation resource to manage asynchronous API requests.
11190 # For more information, readHandling
11191 # API responses.
11192 #
11193 # Operations can be global, regional or zonal.
11194 #
11195 # - For global operations, use the `globalOperations`
11196 # resource.
11197 # - For regional operations, use the
11198 # `regionOperations` resource.
11199 # - For zonal operations, use
11200 # the `zoneOperations` resource.
11201 #
11202 #
11203 #
11204 # For more information, read
11205 # Global, Regional, and Zonal Resources.
11206 #
11207 # Note that completed Operation resources have a limited
11208 # retention period.
11209 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11210 # Not present otherwise.
11211 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11212 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11213 # set when the operation is created.
11214 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11215 # text format.
11216 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11217 # this field will be populated.
11218 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11219 # operation.
11220 {
11221 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11222 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11223 # details. There is a set of defined message types to use for providing
11224 # details.The syntax depends on the error code. For example,
11225 # QuotaExceededInfo will have details when the error code is
11226 # QUOTA_EXCEEDED.
11227 {
11228 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11229 #
11230 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11231 # is not enabled:
11232 #
11233 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11234 # &quot;domain&quot;: &quot;googleapis.com&quot;
11235 # &quot;metadata&quot;: {
11236 # &quot;resource&quot;: &quot;projects/123&quot;,
11237 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11238 # }
11239 # }
11240 #
11241 # This response indicates that the pubsub.googleapis.com API is not enabled.
11242 #
11243 # Example of an error that is returned when attempting to create a Spanner
11244 # instance in a region that is out of stock:
11245 #
11246 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11247 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11248 # &quot;metadata&quot;: {
11249 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11250 # }
11251 # }
11252 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11253 # is typically the registered service name of the tool or product that
11254 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11255 # generated by some common infrastructure, the error domain must be a
11256 # globally unique value that identifies the infrastructure. For Google API
11257 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11258 &quot;metadatas&quot;: { # Additional structured details about this error.
11259 #
11260 # Keys must match a regular expression of `a-z+` but should
11261 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11262 # length. When identifying the current value of an exceeded limit, the units
11263 # should be contained in the key, not the value. For example, rather than
11264 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11265 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11266 # instances that can be created in a single (batch) request.
11267 &quot;a_key&quot;: &quot;A String&quot;,
11268 },
11269 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11270 # proximate cause of the error. Error reasons are unique within a particular
11271 # domain of errors. This should be at most 63 characters and match a
11272 # regular expression of `A-Z+[A-Z0-9]`, which represents
11273 # UPPER_SNAKE_CASE.
11274 },
11275 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11276 #
11277 # For example, if a quota check failed with an error indicating the calling
11278 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11279 # directly to the right place in the developer console to flip the bit.
11280 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11281 { # Describes a URL link.
11282 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11283 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11284 },
11285 ],
11286 },
11287 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11288 # which can be attached to an RPC error.
11289 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11290 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11291 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11292 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11293 },
11294 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11295 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11296 &quot;a_key&quot;: &quot;A String&quot;,
11297 },
11298 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11299 # type or metric.
11300 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11301 # or metric.
11302 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11303 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11304 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11305 },
11306 },
11307 ],
11308 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11309 # This property is optional.
11310 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11311 },
11312 ],
11313 },
11314 &quot;getVersionOperationMetadata&quot;: {
11315 &quot;inlineSbomInfo&quot;: {
11316 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11317 # appropriate identifiers.
11318 &quot;a_key&quot;: &quot;A String&quot;,
11319 },
11320 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11321 # identifiers.
11322 &quot;a_key&quot;: &quot;A String&quot;,
11323 },
11324 },
11325 },
11326 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11327 # message that was returned, such as `NOT FOUND`.
11328 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11329 # status code that was returned. For example, a `404` means the
11330 # resource was not found.
11331 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11332 # defined by the server.
11333 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11334 # This value is inRFC3339
11335 # text format.
11336 &quot;instancesBulkInsertOperationMetadata&quot;: {
11337 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11338 # Example key: zones/us-central1-a
11339 &quot;a_key&quot;: {
11340 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11341 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11342 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11343 # error.
11344 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11345 # if the flow is rolling forward or rolling back.
11346 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11347 },
11348 },
11349 },
11350 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11351 # Operation resources.
11352 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11353 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11354 # group of operations results from a `bulkInsert` API request.
11355 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11356 # `update`, or `delete`, and so on.
11357 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11358 # There is no requirement that this be linear or support any granularity of
11359 # operations. This should not be used to guess when the operation will be
11360 # complete. This number should monotonically increase as the operation
11361 # progresses.
11362 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
11363 # applicable when performing regional operations.
11364 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11365 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
11366 # this field will contain information on all underlying zonal actions and
11367 # their state.
11368 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
11369 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
11370 # Example key: zones/us-central1-a
11371 &quot;a_key&quot;: {
11372 &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
11373 # populated.
11374 # different programming environments, including REST APIs and RPC APIs. It is
11375 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
11376 # three pieces of data: error code, error message, and error details.
11377 #
11378 # You can find out more about this error model and how to work with it in the
11379 # [API Design Guide](https://cloud.google.com/apis/design/errors).
11380 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
11381 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
11382 # message types for APIs to use.
11383 {
11384 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
11385 },
11386 ],
11387 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
11388 # user-facing error message should be localized and sent in the
11389 # google.rpc.Status.details field, or localized by the client.
11390 },
11391 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
11392 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
11393 },
11394 },
11395 },
11396 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
11397 # This value is inRFC3339
11398 # text format.
11399 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
11400 # following:
11401 # `PENDING`, `RUNNING`, or `DONE`.
11402 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
11403 # operation.
11404 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
11405 # of the target resource.
11406 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
11407 # operations related to creating a snapshot, this points to the disk
11408 # that the snapshot was created from.
11409 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
11410 # `[email protected]` or
11411 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
11412 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
11413 # operation, this field will be populated.
11414 {
11415 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
11416 # Engine returns NO_RESULTS_ON_PAGE if there
11417 # are no results in the response.
11418 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
11419 # value format. For example:
11420 #
11421 # &quot;data&quot;: [
11422 # {
11423 # &quot;key&quot;: &quot;scope&quot;,
11424 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
11425 # }
11426 {
11427 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
11428 # returned. For example, for warnings where there are no results in a list
11429 # request for a particular zone, this key might be scope and
11430 # the key value might be the zone name. Other examples might be a key
11431 # indicating a deprecated resource and a suggested replacement, or a
11432 # warning about invalid network settings (for example, if an instance
11433 # attempts to perform IP forwarding but is not enabled for IP forwarding).
11434 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
11435 },
11436 ],
11437 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
11438 },
11439 ],
11440 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
11441 # applicable when performing per-zone operations.
11442 }</pre>
11443 </div>
11444
11445 <div class="method">
11446 <code class="details" id="recreateInstances">recreateInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
11447 <pre>Flags the specified VM instances in the managed instance group to be
11448 immediately recreated. Each instance is recreated using the group&#x27;s current
11449 configuration. This operation is marked as DONE when the flag
11450 is set even if the instances have not yet been recreated. You must
11451 separately verify the status of each instance by checking itscurrentAction field; for more information, see Checking
11452 the status of managed instances.
11453
11454 If the group is part of a backend
11455 service that has enabled
11456 connection draining, it can take up to 60 seconds after the connection
11457 draining duration has elapsed before the VM instance is removed or deleted.
11458
11459 You can specify a maximum of 1000 instances with this method per request.
11460
11461 Args:
11462 project: string, Project ID for this request. (required)
11463 zone: string, The name of thezone where the managed
11464 instance group is located. (required)
11465 instanceGroupManager: string, The name of the managed instance group. (required)
11466 body: object, The request body.
11467 The object takes the form of:
11468
11469 {
11470 &quot;instances&quot;: [ # The URLs of one or more instances to recreate. This can be a full URL or
11471 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
11472 &quot;A String&quot;,
11473 ],
11474 }
11475
11476 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance recreation even if it&#x27;s
11477 configured for the instances.
11478 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11479 that if you must retry your request, the server will know to ignore the
11480 request if it has already been completed.
11481
11482 For example, consider a situation where you make an initial request and
11483 the request times out. If you make the request again with the same
11484 request ID, the server can check if original operation with the same
11485 request ID was received, and if so, will ignore the second request. This
11486 prevents clients from accidentally creating duplicate commitments.
11487
11488 The request ID must be
11489 a valid UUID with the exception that zero UUID is not supported
11490 (00000000-0000-0000-0000-000000000000).
11491 x__xgafv: string, V1 error format.
11492 Allowed values
11493 1 - v1 error format
11494 2 - v2 error format
11495
11496 Returns:
11497 An object of the form:
11498
11499 { # Represents an Operation resource.
11500 #
11501 # Google Compute Engine has three Operation resources:
11502 #
11503 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
11504 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
11505 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
11506 #
11507 # You can use an operation resource to manage asynchronous API requests.
11508 # For more information, readHandling
11509 # API responses.
11510 #
11511 # Operations can be global, regional or zonal.
11512 #
11513 # - For global operations, use the `globalOperations`
11514 # resource.
11515 # - For regional operations, use the
11516 # `regionOperations` resource.
11517 # - For zonal operations, use
11518 # the `zoneOperations` resource.
11519 #
11520 #
11521 #
11522 # For more information, read
11523 # Global, Regional, and Zonal Resources.
11524 #
11525 # Note that completed Operation resources have a limited
11526 # retention period.
11527 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11528 # Not present otherwise.
11529 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11530 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11531 # set when the operation is created.
11532 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11533 # text format.
11534 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11535 # this field will be populated.
11536 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11537 # operation.
11538 {
11539 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11540 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11541 # details. There is a set of defined message types to use for providing
11542 # details.The syntax depends on the error code. For example,
11543 # QuotaExceededInfo will have details when the error code is
11544 # QUOTA_EXCEEDED.
11545 {
11546 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11547 #
11548 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11549 # is not enabled:
11550 #
11551 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11552 # &quot;domain&quot;: &quot;googleapis.com&quot;
11553 # &quot;metadata&quot;: {
11554 # &quot;resource&quot;: &quot;projects/123&quot;,
11555 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11556 # }
11557 # }
11558 #
11559 # This response indicates that the pubsub.googleapis.com API is not enabled.
11560 #
11561 # Example of an error that is returned when attempting to create a Spanner
11562 # instance in a region that is out of stock:
11563 #
11564 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11565 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11566 # &quot;metadata&quot;: {
11567 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11568 # }
11569 # }
11570 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11571 # is typically the registered service name of the tool or product that
11572 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11573 # generated by some common infrastructure, the error domain must be a
11574 # globally unique value that identifies the infrastructure. For Google API
11575 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11576 &quot;metadatas&quot;: { # Additional structured details about this error.
11577 #
11578 # Keys must match a regular expression of `a-z+` but should
11579 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11580 # length. When identifying the current value of an exceeded limit, the units
11581 # should be contained in the key, not the value. For example, rather than
11582 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11583 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11584 # instances that can be created in a single (batch) request.
11585 &quot;a_key&quot;: &quot;A String&quot;,
11586 },
11587 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11588 # proximate cause of the error. Error reasons are unique within a particular
11589 # domain of errors. This should be at most 63 characters and match a
11590 # regular expression of `A-Z+[A-Z0-9]`, which represents
11591 # UPPER_SNAKE_CASE.
11592 },
11593 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11594 #
11595 # For example, if a quota check failed with an error indicating the calling
11596 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11597 # directly to the right place in the developer console to flip the bit.
11598 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11599 { # Describes a URL link.
11600 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11601 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11602 },
11603 ],
11604 },
11605 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11606 # which can be attached to an RPC error.
11607 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11608 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11609 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11610 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11611 },
11612 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11613 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11614 &quot;a_key&quot;: &quot;A String&quot;,
11615 },
11616 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11617 # type or metric.
11618 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11619 # or metric.
11620 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11621 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11622 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11623 },
11624 },
11625 ],
11626 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11627 # This property is optional.
11628 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11629 },
11630 ],
11631 },
11632 &quot;getVersionOperationMetadata&quot;: {
11633 &quot;inlineSbomInfo&quot;: {
11634 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11635 # appropriate identifiers.
11636 &quot;a_key&quot;: &quot;A String&quot;,
11637 },
11638 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11639 # identifiers.
11640 &quot;a_key&quot;: &quot;A String&quot;,
11641 },
11642 },
11643 },
11644 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11645 # message that was returned, such as `NOT FOUND`.
11646 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11647 # status code that was returned. For example, a `404` means the
11648 # resource was not found.
11649 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11650 # defined by the server.
11651 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11652 # This value is inRFC3339
11653 # text format.
11654 &quot;instancesBulkInsertOperationMetadata&quot;: {
11655 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11656 # Example key: zones/us-central1-a
11657 &quot;a_key&quot;: {
11658 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11659 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11660 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11661 # error.
11662 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11663 # if the flow is rolling forward or rolling back.
11664 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11665 },
11666 },
11667 },
11668 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11669 # Operation resources.
11670 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11671 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11672 # group of operations results from a `bulkInsert` API request.
11673 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11674 # `update`, or `delete`, and so on.
11675 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11676 # There is no requirement that this be linear or support any granularity of
11677 # operations. This should not be used to guess when the operation will be
11678 # complete. This number should monotonically increase as the operation
11679 # progresses.
11680 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
11681 # applicable when performing regional operations.
11682 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
11683 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
11684 # this field will contain information on all underlying zonal actions and
11685 # their state.
11686 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
11687 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
11688 # Example key: zones/us-central1-a
11689 &quot;a_key&quot;: {
11690 &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
11691 # populated.
11692 # different programming environments, including REST APIs and RPC APIs. It is
11693 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
11694 # three pieces of data: error code, error message, and error details.
11695 #
11696 # You can find out more about this error model and how to work with it in the
11697 # [API Design Guide](https://cloud.google.com/apis/design/errors).
11698 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
11699 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
11700 # message types for APIs to use.
11701 {
11702 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
11703 },
11704 ],
11705 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
11706 # user-facing error message should be localized and sent in the
11707 # google.rpc.Status.details field, or localized by the client.
11708 },
11709 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
11710 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
11711 },
11712 },
11713 },
11714 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
11715 # This value is inRFC3339
11716 # text format.
11717 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
11718 # following:
11719 # `PENDING`, `RUNNING`, or `DONE`.
11720 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
11721 # operation.
11722 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
11723 # of the target resource.
11724 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
11725 # operations related to creating a snapshot, this points to the disk
11726 # that the snapshot was created from.
11727 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
11728 # `[email protected]` or
11729 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
11730 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
11731 # operation, this field will be populated.
11732 {
11733 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
11734 # Engine returns NO_RESULTS_ON_PAGE if there
11735 # are no results in the response.
11736 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
11737 # value format. For example:
11738 #
11739 # &quot;data&quot;: [
11740 # {
11741 # &quot;key&quot;: &quot;scope&quot;,
11742 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
11743 # }
11744 {
11745 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
11746 # returned. For example, for warnings where there are no results in a list
11747 # request for a particular zone, this key might be scope and
11748 # the key value might be the zone name. Other examples might be a key
11749 # indicating a deprecated resource and a suggested replacement, or a
11750 # warning about invalid network settings (for example, if an instance
11751 # attempts to perform IP forwarding but is not enabled for IP forwarding).
11752 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
11753 },
11754 ],
11755 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
11756 },
11757 ],
11758 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
11759 # applicable when performing per-zone operations.
11760 }</pre>
11761 </div>
11762
11763 <div class="method">
11764 <code class="details" id="resize">resize(project, zone, instanceGroupManager, size, requestId=None, x__xgafv=None)</code>
11765 <pre>Resizes the managed instance group. If you increase the size, the group
11766 creates new instances using the current instance template. If you decrease
11767 the size, the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group
11768 has not yet added or deleted any instances. You must separately
11769 verify the status of the creating or deleting
11770 actions with thelistmanagedinstances
11771 method.
11772
11773 When resizing down, the instance group arbitrarily chooses the order in
11774 which VMs are deleted. The group takes into account some VM attributes when
11775 making the selection including:
11776
11777 + The status of the VM instance.
11778 + The health of the VM instance.
11779 + The instance template version the VM is based on.
11780 + For regional managed instance groups, the location of the VM instance.
11781
11782 This list is subject to change.
11783
11784 If the group is part of a backend
11785 service that has enabled
11786 connection draining, it can take up to 60 seconds after the connection
11787 draining duration has elapsed before the VM instance is removed or deleted.
11788
11789 Args:
11790 project: string, Project ID for this request. (required)
11791 zone: string, The name of thezone where the managed
11792 instance group is located. (required)
11793 instanceGroupManager: string, The name of the managed instance group. (required)
11794 size: integer, The number of running instances that the managed instance group should
11795 maintain at any given time. The group automatically adds or removes
11796 instances to maintain the number of instances specified by this parameter. (required)
11797 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
11798 that if you must retry your request, the server will know to ignore the
11799 request if it has already been completed.
11800
11801 For example, consider a situation where you make an initial request and
11802 the request times out. If you make the request again with the same
11803 request ID, the server can check if original operation with the same
11804 request ID was received, and if so, will ignore the second request. This
11805 prevents clients from accidentally creating duplicate commitments.
11806
11807 The request ID must be
11808 a valid UUID with the exception that zero UUID is not supported
11809 (00000000-0000-0000-0000-000000000000).
11810 x__xgafv: string, V1 error format.
11811 Allowed values
11812 1 - v1 error format
11813 2 - v2 error format
11814
11815 Returns:
11816 An object of the form:
11817
11818 { # Represents an Operation resource.
11819 #
11820 # Google Compute Engine has three Operation resources:
11821 #
11822 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
11823 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
11824 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
11825 #
11826 # You can use an operation resource to manage asynchronous API requests.
11827 # For more information, readHandling
11828 # API responses.
11829 #
11830 # Operations can be global, regional or zonal.
11831 #
11832 # - For global operations, use the `globalOperations`
11833 # resource.
11834 # - For regional operations, use the
11835 # `regionOperations` resource.
11836 # - For zonal operations, use
11837 # the `zoneOperations` resource.
11838 #
11839 #
11840 #
11841 # For more information, read
11842 # Global, Regional, and Zonal Resources.
11843 #
11844 # Note that completed Operation resources have a limited
11845 # retention period.
11846 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
11847 # Not present otherwise.
11848 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
11849 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
11850 # set when the operation is created.
11851 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
11852 # text format.
11853 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
11854 # this field will be populated.
11855 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
11856 # operation.
11857 {
11858 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
11859 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
11860 # details. There is a set of defined message types to use for providing
11861 # details.The syntax depends on the error code. For example,
11862 # QuotaExceededInfo will have details when the error code is
11863 # QUOTA_EXCEEDED.
11864 {
11865 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
11866 #
11867 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
11868 # is not enabled:
11869 #
11870 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
11871 # &quot;domain&quot;: &quot;googleapis.com&quot;
11872 # &quot;metadata&quot;: {
11873 # &quot;resource&quot;: &quot;projects/123&quot;,
11874 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
11875 # }
11876 # }
11877 #
11878 # This response indicates that the pubsub.googleapis.com API is not enabled.
11879 #
11880 # Example of an error that is returned when attempting to create a Spanner
11881 # instance in a region that is out of stock:
11882 #
11883 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
11884 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
11885 # &quot;metadata&quot;: {
11886 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
11887 # }
11888 # }
11889 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
11890 # is typically the registered service name of the tool or product that
11891 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
11892 # generated by some common infrastructure, the error domain must be a
11893 # globally unique value that identifies the infrastructure. For Google API
11894 # infrastructure, the error domain is &quot;googleapis.com&quot;.
11895 &quot;metadatas&quot;: { # Additional structured details about this error.
11896 #
11897 # Keys must match a regular expression of `a-z+` but should
11898 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
11899 # length. When identifying the current value of an exceeded limit, the units
11900 # should be contained in the key, not the value. For example, rather than
11901 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
11902 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
11903 # instances that can be created in a single (batch) request.
11904 &quot;a_key&quot;: &quot;A String&quot;,
11905 },
11906 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
11907 # proximate cause of the error. Error reasons are unique within a particular
11908 # domain of errors. This should be at most 63 characters and match a
11909 # regular expression of `A-Z+[A-Z0-9]`, which represents
11910 # UPPER_SNAKE_CASE.
11911 },
11912 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
11913 #
11914 # For example, if a quota check failed with an error indicating the calling
11915 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
11916 # directly to the right place in the developer console to flip the bit.
11917 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
11918 { # Describes a URL link.
11919 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
11920 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
11921 },
11922 ],
11923 },
11924 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
11925 # which can be attached to an RPC error.
11926 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
11927 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
11928 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
11929 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
11930 },
11931 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
11932 &quot;dimensions&quot;: { # The map holding related quota dimensions.
11933 &quot;a_key&quot;: &quot;A String&quot;,
11934 },
11935 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
11936 # type or metric.
11937 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
11938 # or metric.
11939 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
11940 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
11941 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
11942 },
11943 },
11944 ],
11945 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
11946 # This property is optional.
11947 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
11948 },
11949 ],
11950 },
11951 &quot;getVersionOperationMetadata&quot;: {
11952 &quot;inlineSbomInfo&quot;: {
11953 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
11954 # appropriate identifiers.
11955 &quot;a_key&quot;: &quot;A String&quot;,
11956 },
11957 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
11958 # identifiers.
11959 &quot;a_key&quot;: &quot;A String&quot;,
11960 },
11961 },
11962 },
11963 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
11964 # message that was returned, such as `NOT FOUND`.
11965 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
11966 # status code that was returned. For example, a `404` means the
11967 # resource was not found.
11968 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
11969 # defined by the server.
11970 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
11971 # This value is inRFC3339
11972 # text format.
11973 &quot;instancesBulkInsertOperationMetadata&quot;: {
11974 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
11975 # Example key: zones/us-central1-a
11976 &quot;a_key&quot;: {
11977 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
11978 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
11979 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
11980 # error.
11981 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
11982 # if the flow is rolling forward or rolling back.
11983 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
11984 },
11985 },
11986 },
11987 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
11988 # Operation resources.
11989 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
11990 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
11991 # group of operations results from a `bulkInsert` API request.
11992 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
11993 # `update`, or `delete`, and so on.
11994 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
11995 # There is no requirement that this be linear or support any granularity of
11996 # operations. This should not be used to guess when the operation will be
11997 # complete. This number should monotonically increase as the operation
11998 # progresses.
11999 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12000 # applicable when performing regional operations.
12001 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12002 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12003 # this field will contain information on all underlying zonal actions and
12004 # their state.
12005 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12006 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12007 # Example key: zones/us-central1-a
12008 &quot;a_key&quot;: {
12009 &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
12010 # populated.
12011 # different programming environments, including REST APIs and RPC APIs. It is
12012 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12013 # three pieces of data: error code, error message, and error details.
12014 #
12015 # You can find out more about this error model and how to work with it in the
12016 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12017 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12018 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12019 # message types for APIs to use.
12020 {
12021 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12022 },
12023 ],
12024 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12025 # user-facing error message should be localized and sent in the
12026 # google.rpc.Status.details field, or localized by the client.
12027 },
12028 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12029 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12030 },
12031 },
12032 },
12033 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12034 # This value is inRFC3339
12035 # text format.
12036 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12037 # following:
12038 # `PENDING`, `RUNNING`, or `DONE`.
12039 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12040 # operation.
12041 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12042 # of the target resource.
12043 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12044 # operations related to creating a snapshot, this points to the disk
12045 # that the snapshot was created from.
12046 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12047 # `[email protected]` or
12048 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12049 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12050 # operation, this field will be populated.
12051 {
12052 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12053 # Engine returns NO_RESULTS_ON_PAGE if there
12054 # are no results in the response.
12055 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12056 # value format. For example:
12057 #
12058 # &quot;data&quot;: [
12059 # {
12060 # &quot;key&quot;: &quot;scope&quot;,
12061 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12062 # }
12063 {
12064 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12065 # returned. For example, for warnings where there are no results in a list
12066 # request for a particular zone, this key might be scope and
12067 # the key value might be the zone name. Other examples might be a key
12068 # indicating a deprecated resource and a suggested replacement, or a
12069 # warning about invalid network settings (for example, if an instance
12070 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12071 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12072 },
12073 ],
12074 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12075 },
12076 ],
12077 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12078 # applicable when performing per-zone operations.
12079 }</pre>
12080 </div>
12081
12082 <div class="method">
12083 <code class="details" id="resizeAdvanced">resizeAdvanced(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
12084 <pre>Resizes the managed instance group with advanced configuration options like
12085 disabling creation retries. This is an extended version of theresize method.
12086
12087 If you increase the size of the instance group, the group creates new
12088 instances using the current instance template. If you decrease the size,
12089 the group deletes instances. The resize operation is markedDONE when the resize actions are scheduled even if the group
12090 has not yet added or deleted any instances. You must separately
12091 verify the status of the creating,creatingWithoutRetries, or deleting actions with
12092 the get
12093 orlistmanagedinstances
12094 method.
12095
12096 If the group is part of a backend
12097 service that has enabled
12098 connection draining, it can take up to 60 seconds after the connection
12099 draining duration has elapsed before the VM instance is removed or deleted.
12100
12101 Args:
12102 project: string, Project ID for this request. (required)
12103 zone: string, The name of thezone where the managed
12104 instance group is located. (required)
12105 instanceGroupManager: string, The name of the managed instance group. (required)
12106 body: object, The request body.
12107 The object takes the form of:
12108
12109 {
12110 &quot;noCreationRetries&quot;: True or False, # If this flag is true, the managed instance group attempts to create all
12111 # instances initiated by this resize request only once. If there is an error
12112 # during creation, the managed instance group does not retry create this
12113 # instance, and we will decrease the targetSize of the request
12114 # instead. If the flag is false, the group attempts to recreate each instance
12115 # continuously until it succeeds.
12116 #
12117 # This flag matters only in the first attempt of creation of an instance.
12118 # After an instance is successfully created while this flag is enabled, the
12119 # instance behaves the same way as all the other instances created with a
12120 # regular resize request. In particular, if a running instance dies
12121 # unexpectedly at a later time and needs to be recreated, this mode does not
12122 # affect the recreation behavior in that scenario.
12123 #
12124 # This flag is applicable only to the current resize request. It does not
12125 # influence other resize requests in any way.
12126 #
12127 # You can see which instances is being creating in which mode by calling
12128 # the get or listManagedInstances API.
12129 &quot;targetSize&quot;: 42, # The number of running instances that the managed instance group should
12130 # maintain at any given time. The group automatically adds or removes
12131 # instances to maintain the number of instances specified by this parameter.
12132 }
12133
12134 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12135 that if you must retry your request, the server will know to ignore the
12136 request if it has already been completed.
12137
12138 For example, consider a situation where you make an initial request and
12139 the request times out. If you make the request again with the same
12140 request ID, the server can check if original operation with the same
12141 request ID was received, and if so, will ignore the second request. This
12142 prevents clients from accidentally creating duplicate commitments.
12143
12144 The request ID must be
12145 a valid UUID with the exception that zero UUID is not supported
12146 (00000000-0000-0000-0000-000000000000).
12147 x__xgafv: string, V1 error format.
12148 Allowed values
12149 1 - v1 error format
12150 2 - v2 error format
12151
12152 Returns:
12153 An object of the form:
12154
12155 { # Represents an Operation resource.
12156 #
12157 # Google Compute Engine has three Operation resources:
12158 #
12159 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
12160 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
12161 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
12162 #
12163 # You can use an operation resource to manage asynchronous API requests.
12164 # For more information, readHandling
12165 # API responses.
12166 #
12167 # Operations can be global, regional or zonal.
12168 #
12169 # - For global operations, use the `globalOperations`
12170 # resource.
12171 # - For regional operations, use the
12172 # `regionOperations` resource.
12173 # - For zonal operations, use
12174 # the `zoneOperations` resource.
12175 #
12176 #
12177 #
12178 # For more information, read
12179 # Global, Regional, and Zonal Resources.
12180 #
12181 # Note that completed Operation resources have a limited
12182 # retention period.
12183 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12184 # Not present otherwise.
12185 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12186 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12187 # set when the operation is created.
12188 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12189 # text format.
12190 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12191 # this field will be populated.
12192 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12193 # operation.
12194 {
12195 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12196 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12197 # details. There is a set of defined message types to use for providing
12198 # details.The syntax depends on the error code. For example,
12199 # QuotaExceededInfo will have details when the error code is
12200 # QUOTA_EXCEEDED.
12201 {
12202 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12203 #
12204 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12205 # is not enabled:
12206 #
12207 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12208 # &quot;domain&quot;: &quot;googleapis.com&quot;
12209 # &quot;metadata&quot;: {
12210 # &quot;resource&quot;: &quot;projects/123&quot;,
12211 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12212 # }
12213 # }
12214 #
12215 # This response indicates that the pubsub.googleapis.com API is not enabled.
12216 #
12217 # Example of an error that is returned when attempting to create a Spanner
12218 # instance in a region that is out of stock:
12219 #
12220 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12221 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12222 # &quot;metadata&quot;: {
12223 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12224 # }
12225 # }
12226 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12227 # is typically the registered service name of the tool or product that
12228 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12229 # generated by some common infrastructure, the error domain must be a
12230 # globally unique value that identifies the infrastructure. For Google API
12231 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12232 &quot;metadatas&quot;: { # Additional structured details about this error.
12233 #
12234 # Keys must match a regular expression of `a-z+` but should
12235 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12236 # length. When identifying the current value of an exceeded limit, the units
12237 # should be contained in the key, not the value. For example, rather than
12238 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12239 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12240 # instances that can be created in a single (batch) request.
12241 &quot;a_key&quot;: &quot;A String&quot;,
12242 },
12243 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12244 # proximate cause of the error. Error reasons are unique within a particular
12245 # domain of errors. This should be at most 63 characters and match a
12246 # regular expression of `A-Z+[A-Z0-9]`, which represents
12247 # UPPER_SNAKE_CASE.
12248 },
12249 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12250 #
12251 # For example, if a quota check failed with an error indicating the calling
12252 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12253 # directly to the right place in the developer console to flip the bit.
12254 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12255 { # Describes a URL link.
12256 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12257 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12258 },
12259 ],
12260 },
12261 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12262 # which can be attached to an RPC error.
12263 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12264 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12265 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12266 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12267 },
12268 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12269 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12270 &quot;a_key&quot;: &quot;A String&quot;,
12271 },
12272 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12273 # type or metric.
12274 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12275 # or metric.
12276 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12277 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12278 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12279 },
12280 },
12281 ],
12282 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12283 # This property is optional.
12284 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12285 },
12286 ],
12287 },
12288 &quot;getVersionOperationMetadata&quot;: {
12289 &quot;inlineSbomInfo&quot;: {
12290 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12291 # appropriate identifiers.
12292 &quot;a_key&quot;: &quot;A String&quot;,
12293 },
12294 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12295 # identifiers.
12296 &quot;a_key&quot;: &quot;A String&quot;,
12297 },
12298 },
12299 },
12300 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12301 # message that was returned, such as `NOT FOUND`.
12302 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12303 # status code that was returned. For example, a `404` means the
12304 # resource was not found.
12305 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12306 # defined by the server.
12307 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12308 # This value is inRFC3339
12309 # text format.
12310 &quot;instancesBulkInsertOperationMetadata&quot;: {
12311 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12312 # Example key: zones/us-central1-a
12313 &quot;a_key&quot;: {
12314 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12315 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12316 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12317 # error.
12318 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12319 # if the flow is rolling forward or rolling back.
12320 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12321 },
12322 },
12323 },
12324 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12325 # Operation resources.
12326 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12327 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12328 # group of operations results from a `bulkInsert` API request.
12329 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12330 # `update`, or `delete`, and so on.
12331 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12332 # There is no requirement that this be linear or support any granularity of
12333 # operations. This should not be used to guess when the operation will be
12334 # complete. This number should monotonically increase as the operation
12335 # progresses.
12336 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12337 # applicable when performing regional operations.
12338 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12339 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12340 # this field will contain information on all underlying zonal actions and
12341 # their state.
12342 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12343 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12344 # Example key: zones/us-central1-a
12345 &quot;a_key&quot;: {
12346 &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
12347 # populated.
12348 # different programming environments, including REST APIs and RPC APIs. It is
12349 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12350 # three pieces of data: error code, error message, and error details.
12351 #
12352 # You can find out more about this error model and how to work with it in the
12353 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12354 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12355 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12356 # message types for APIs to use.
12357 {
12358 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12359 },
12360 ],
12361 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12362 # user-facing error message should be localized and sent in the
12363 # google.rpc.Status.details field, or localized by the client.
12364 },
12365 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12366 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12367 },
12368 },
12369 },
12370 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12371 # This value is inRFC3339
12372 # text format.
12373 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12374 # following:
12375 # `PENDING`, `RUNNING`, or `DONE`.
12376 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12377 # operation.
12378 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12379 # of the target resource.
12380 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12381 # operations related to creating a snapshot, this points to the disk
12382 # that the snapshot was created from.
12383 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12384 # `[email protected]` or
12385 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12386 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12387 # operation, this field will be populated.
12388 {
12389 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12390 # Engine returns NO_RESULTS_ON_PAGE if there
12391 # are no results in the response.
12392 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12393 # value format. For example:
12394 #
12395 # &quot;data&quot;: [
12396 # {
12397 # &quot;key&quot;: &quot;scope&quot;,
12398 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12399 # }
12400 {
12401 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12402 # returned. For example, for warnings where there are no results in a list
12403 # request for a particular zone, this key might be scope and
12404 # the key value might be the zone name. Other examples might be a key
12405 # indicating a deprecated resource and a suggested replacement, or a
12406 # warning about invalid network settings (for example, if an instance
12407 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12408 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12409 },
12410 ],
12411 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12412 },
12413 ],
12414 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12415 # applicable when performing per-zone operations.
12416 }</pre>
12417 </div>
12418
12419 <div class="method">
12420 <code class="details" id="resumeInstances">resumeInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
12421 <pre>Flags the specified instances in the managed instance group to be
12422 resumed. This method increases thetargetSize and decreases the targetSuspendedSize
12423 of the managed instance group by the number of instances that you resume.
12424 The resumeInstances operation is marked DONE if
12425 the resumeInstances request is successful. The underlying
12426 actions take additional time. You must separately verify the status of theRESUMING action with thelistmanagedinstances
12427 method.
12428
12429 In this request, you can only specify instances that are suspended. For
12430 example, if an instance was previously suspended using the suspendInstances
12431 method, it can be resumed using the resumeInstances method.
12432
12433 If a health check is attached to the managed instance group, the specified
12434 instances will be verified as healthy after they are resumed.
12435
12436 You can specify a maximum of 1000 instances with this method per request.
12437
12438 Args:
12439 project: string, Project ID for this request. (required)
12440 zone: string, The name of thezone where the managed
12441 instance group is located. (required)
12442 instanceGroupManager: string, The name of the managed instance group. (required)
12443 body: object, The request body.
12444 The object takes the form of:
12445
12446 {
12447 &quot;instances&quot;: [ # The URLs of one or more instances to resume. This can be a full URL or
12448 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
12449 &quot;A String&quot;,
12450 ],
12451 }
12452
12453 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12454 that if you must retry your request, the server will know to ignore the
12455 request if it has already been completed.
12456
12457 For example, consider a situation where you make an initial request and
12458 the request times out. If you make the request again with the same
12459 request ID, the server can check if original operation with the same
12460 request ID was received, and if so, will ignore the second request. This
12461 prevents clients from accidentally creating duplicate commitments.
12462
12463 The request ID must be
12464 a valid UUID with the exception that zero UUID is not supported
12465 (00000000-0000-0000-0000-000000000000).
12466 x__xgafv: string, V1 error format.
12467 Allowed values
12468 1 - v1 error format
12469 2 - v2 error format
12470
12471 Returns:
12472 An object of the form:
12473
12474 { # Represents an Operation resource.
12475 #
12476 # Google Compute Engine has three Operation resources:
12477 #
12478 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
12479 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
12480 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
12481 #
12482 # You can use an operation resource to manage asynchronous API requests.
12483 # For more information, readHandling
12484 # API responses.
12485 #
12486 # Operations can be global, regional or zonal.
12487 #
12488 # - For global operations, use the `globalOperations`
12489 # resource.
12490 # - For regional operations, use the
12491 # `regionOperations` resource.
12492 # - For zonal operations, use
12493 # the `zoneOperations` resource.
12494 #
12495 #
12496 #
12497 # For more information, read
12498 # Global, Regional, and Zonal Resources.
12499 #
12500 # Note that completed Operation resources have a limited
12501 # retention period.
12502 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12503 # Not present otherwise.
12504 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12505 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12506 # set when the operation is created.
12507 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12508 # text format.
12509 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12510 # this field will be populated.
12511 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12512 # operation.
12513 {
12514 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12515 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12516 # details. There is a set of defined message types to use for providing
12517 # details.The syntax depends on the error code. For example,
12518 # QuotaExceededInfo will have details when the error code is
12519 # QUOTA_EXCEEDED.
12520 {
12521 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12522 #
12523 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12524 # is not enabled:
12525 #
12526 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12527 # &quot;domain&quot;: &quot;googleapis.com&quot;
12528 # &quot;metadata&quot;: {
12529 # &quot;resource&quot;: &quot;projects/123&quot;,
12530 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12531 # }
12532 # }
12533 #
12534 # This response indicates that the pubsub.googleapis.com API is not enabled.
12535 #
12536 # Example of an error that is returned when attempting to create a Spanner
12537 # instance in a region that is out of stock:
12538 #
12539 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12540 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12541 # &quot;metadata&quot;: {
12542 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12543 # }
12544 # }
12545 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12546 # is typically the registered service name of the tool or product that
12547 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12548 # generated by some common infrastructure, the error domain must be a
12549 # globally unique value that identifies the infrastructure. For Google API
12550 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12551 &quot;metadatas&quot;: { # Additional structured details about this error.
12552 #
12553 # Keys must match a regular expression of `a-z+` but should
12554 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12555 # length. When identifying the current value of an exceeded limit, the units
12556 # should be contained in the key, not the value. For example, rather than
12557 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12558 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12559 # instances that can be created in a single (batch) request.
12560 &quot;a_key&quot;: &quot;A String&quot;,
12561 },
12562 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12563 # proximate cause of the error. Error reasons are unique within a particular
12564 # domain of errors. This should be at most 63 characters and match a
12565 # regular expression of `A-Z+[A-Z0-9]`, which represents
12566 # UPPER_SNAKE_CASE.
12567 },
12568 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12569 #
12570 # For example, if a quota check failed with an error indicating the calling
12571 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12572 # directly to the right place in the developer console to flip the bit.
12573 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12574 { # Describes a URL link.
12575 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12576 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12577 },
12578 ],
12579 },
12580 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12581 # which can be attached to an RPC error.
12582 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12583 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12584 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12585 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12586 },
12587 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12588 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12589 &quot;a_key&quot;: &quot;A String&quot;,
12590 },
12591 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12592 # type or metric.
12593 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12594 # or metric.
12595 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12596 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12597 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12598 },
12599 },
12600 ],
12601 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12602 # This property is optional.
12603 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12604 },
12605 ],
12606 },
12607 &quot;getVersionOperationMetadata&quot;: {
12608 &quot;inlineSbomInfo&quot;: {
12609 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12610 # appropriate identifiers.
12611 &quot;a_key&quot;: &quot;A String&quot;,
12612 },
12613 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12614 # identifiers.
12615 &quot;a_key&quot;: &quot;A String&quot;,
12616 },
12617 },
12618 },
12619 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12620 # message that was returned, such as `NOT FOUND`.
12621 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12622 # status code that was returned. For example, a `404` means the
12623 # resource was not found.
12624 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12625 # defined by the server.
12626 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12627 # This value is inRFC3339
12628 # text format.
12629 &quot;instancesBulkInsertOperationMetadata&quot;: {
12630 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12631 # Example key: zones/us-central1-a
12632 &quot;a_key&quot;: {
12633 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12634 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12635 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12636 # error.
12637 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12638 # if the flow is rolling forward or rolling back.
12639 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12640 },
12641 },
12642 },
12643 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12644 # Operation resources.
12645 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12646 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12647 # group of operations results from a `bulkInsert` API request.
12648 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12649 # `update`, or `delete`, and so on.
12650 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12651 # There is no requirement that this be linear or support any granularity of
12652 # operations. This should not be used to guess when the operation will be
12653 # complete. This number should monotonically increase as the operation
12654 # progresses.
12655 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12656 # applicable when performing regional operations.
12657 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12658 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12659 # this field will contain information on all underlying zonal actions and
12660 # their state.
12661 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12662 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12663 # Example key: zones/us-central1-a
12664 &quot;a_key&quot;: {
12665 &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
12666 # populated.
12667 # different programming environments, including REST APIs and RPC APIs. It is
12668 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12669 # three pieces of data: error code, error message, and error details.
12670 #
12671 # You can find out more about this error model and how to work with it in the
12672 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12673 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12674 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12675 # message types for APIs to use.
12676 {
12677 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12678 },
12679 ],
12680 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12681 # user-facing error message should be localized and sent in the
12682 # google.rpc.Status.details field, or localized by the client.
12683 },
12684 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
12685 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
12686 },
12687 },
12688 },
12689 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
12690 # This value is inRFC3339
12691 # text format.
12692 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
12693 # following:
12694 # `PENDING`, `RUNNING`, or `DONE`.
12695 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
12696 # operation.
12697 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
12698 # of the target resource.
12699 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
12700 # operations related to creating a snapshot, this points to the disk
12701 # that the snapshot was created from.
12702 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
12703 # `[email protected]` or
12704 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
12705 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
12706 # operation, this field will be populated.
12707 {
12708 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
12709 # Engine returns NO_RESULTS_ON_PAGE if there
12710 # are no results in the response.
12711 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
12712 # value format. For example:
12713 #
12714 # &quot;data&quot;: [
12715 # {
12716 # &quot;key&quot;: &quot;scope&quot;,
12717 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
12718 # }
12719 {
12720 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
12721 # returned. For example, for warnings where there are no results in a list
12722 # request for a particular zone, this key might be scope and
12723 # the key value might be the zone name. Other examples might be a key
12724 # indicating a deprecated resource and a suggested replacement, or a
12725 # warning about invalid network settings (for example, if an instance
12726 # attempts to perform IP forwarding but is not enabled for IP forwarding).
12727 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
12728 },
12729 ],
12730 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
12731 },
12732 ],
12733 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
12734 # applicable when performing per-zone operations.
12735 }</pre>
12736 </div>
12737
12738 <div class="method">
12739 <code class="details" id="setAutoHealingPolicies">setAutoHealingPolicies(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
12740 <pre>Motifies the autohealing policy for the instances in this managed
12741 instance group.
12742 [Deprecated] This method is deprecated. UseinstanceGroupManagers.patch instead.
12743
12744 Args:
12745 project: string, Project ID for this request. (required)
12746 zone: string, The name of thezone where the managed
12747 instance group is located. (required)
12748 instanceGroupManager: string, The name of the instance group manager. (required)
12749 body: object, The request body.
12750 The object takes the form of:
12751
12752 {
12753 &quot;autoHealingPolicies&quot;: [
12754 {
12755 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
12756 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
12757 # initialize and run its startup script. During a VM&#x27;s initial delay
12758 # period, the MIG ignores unsuccessful health checks because the VM might
12759 # be in the startup process. This prevents the MIG from prematurely
12760 # recreating a VM. If the health check receives a healthy response during
12761 # the initial delay, it indicates that the startup process is complete and
12762 # the VM is ready. The value of initial delay must be between 0 and 3600
12763 # seconds. The default value is 0.
12764 },
12765 ],
12766 }
12767
12768 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
12769 that if you must retry your request, the server will know to ignore the
12770 request if it has already been completed.
12771
12772 For example, consider a situation where you make an initial request and
12773 the request times out. If you make the request again with the same
12774 request ID, the server can check if original operation with the same
12775 request ID was received, and if so, will ignore the second request. This
12776 prevents clients from accidentally creating duplicate commitments.
12777
12778 The request ID must be
12779 a valid UUID with the exception that zero UUID is not supported
12780 (00000000-0000-0000-0000-000000000000).
12781 x__xgafv: string, V1 error format.
12782 Allowed values
12783 1 - v1 error format
12784 2 - v2 error format
12785
12786 Returns:
12787 An object of the form:
12788
12789 { # Represents an Operation resource.
12790 #
12791 # Google Compute Engine has three Operation resources:
12792 #
12793 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
12794 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
12795 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
12796 #
12797 # You can use an operation resource to manage asynchronous API requests.
12798 # For more information, readHandling
12799 # API responses.
12800 #
12801 # Operations can be global, regional or zonal.
12802 #
12803 # - For global operations, use the `globalOperations`
12804 # resource.
12805 # - For regional operations, use the
12806 # `regionOperations` resource.
12807 # - For zonal operations, use
12808 # the `zoneOperations` resource.
12809 #
12810 #
12811 #
12812 # For more information, read
12813 # Global, Regional, and Zonal Resources.
12814 #
12815 # Note that completed Operation resources have a limited
12816 # retention period.
12817 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
12818 # Not present otherwise.
12819 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
12820 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
12821 # set when the operation is created.
12822 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
12823 # text format.
12824 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
12825 # this field will be populated.
12826 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
12827 # operation.
12828 {
12829 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
12830 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
12831 # details. There is a set of defined message types to use for providing
12832 # details.The syntax depends on the error code. For example,
12833 # QuotaExceededInfo will have details when the error code is
12834 # QUOTA_EXCEEDED.
12835 {
12836 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
12837 #
12838 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
12839 # is not enabled:
12840 #
12841 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
12842 # &quot;domain&quot;: &quot;googleapis.com&quot;
12843 # &quot;metadata&quot;: {
12844 # &quot;resource&quot;: &quot;projects/123&quot;,
12845 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
12846 # }
12847 # }
12848 #
12849 # This response indicates that the pubsub.googleapis.com API is not enabled.
12850 #
12851 # Example of an error that is returned when attempting to create a Spanner
12852 # instance in a region that is out of stock:
12853 #
12854 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
12855 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
12856 # &quot;metadata&quot;: {
12857 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
12858 # }
12859 # }
12860 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
12861 # is typically the registered service name of the tool or product that
12862 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
12863 # generated by some common infrastructure, the error domain must be a
12864 # globally unique value that identifies the infrastructure. For Google API
12865 # infrastructure, the error domain is &quot;googleapis.com&quot;.
12866 &quot;metadatas&quot;: { # Additional structured details about this error.
12867 #
12868 # Keys must match a regular expression of `a-z+` but should
12869 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
12870 # length. When identifying the current value of an exceeded limit, the units
12871 # should be contained in the key, not the value. For example, rather than
12872 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
12873 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
12874 # instances that can be created in a single (batch) request.
12875 &quot;a_key&quot;: &quot;A String&quot;,
12876 },
12877 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
12878 # proximate cause of the error. Error reasons are unique within a particular
12879 # domain of errors. This should be at most 63 characters and match a
12880 # regular expression of `A-Z+[A-Z0-9]`, which represents
12881 # UPPER_SNAKE_CASE.
12882 },
12883 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
12884 #
12885 # For example, if a quota check failed with an error indicating the calling
12886 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
12887 # directly to the right place in the developer console to flip the bit.
12888 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
12889 { # Describes a URL link.
12890 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
12891 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
12892 },
12893 ],
12894 },
12895 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
12896 # which can be attached to an RPC error.
12897 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
12898 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
12899 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
12900 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
12901 },
12902 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
12903 &quot;dimensions&quot;: { # The map holding related quota dimensions.
12904 &quot;a_key&quot;: &quot;A String&quot;,
12905 },
12906 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
12907 # type or metric.
12908 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
12909 # or metric.
12910 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
12911 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
12912 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
12913 },
12914 },
12915 ],
12916 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
12917 # This property is optional.
12918 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
12919 },
12920 ],
12921 },
12922 &quot;getVersionOperationMetadata&quot;: {
12923 &quot;inlineSbomInfo&quot;: {
12924 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
12925 # appropriate identifiers.
12926 &quot;a_key&quot;: &quot;A String&quot;,
12927 },
12928 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
12929 # identifiers.
12930 &quot;a_key&quot;: &quot;A String&quot;,
12931 },
12932 },
12933 },
12934 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
12935 # message that was returned, such as `NOT FOUND`.
12936 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
12937 # status code that was returned. For example, a `404` means the
12938 # resource was not found.
12939 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
12940 # defined by the server.
12941 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
12942 # This value is inRFC3339
12943 # text format.
12944 &quot;instancesBulkInsertOperationMetadata&quot;: {
12945 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
12946 # Example key: zones/us-central1-a
12947 &quot;a_key&quot;: {
12948 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
12949 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
12950 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
12951 # error.
12952 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
12953 # if the flow is rolling forward or rolling back.
12954 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
12955 },
12956 },
12957 },
12958 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
12959 # Operation resources.
12960 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
12961 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
12962 # group of operations results from a `bulkInsert` API request.
12963 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
12964 # `update`, or `delete`, and so on.
12965 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
12966 # There is no requirement that this be linear or support any granularity of
12967 # operations. This should not be used to guess when the operation will be
12968 # complete. This number should monotonically increase as the operation
12969 # progresses.
12970 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
12971 # applicable when performing regional operations.
12972 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
12973 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
12974 # this field will contain information on all underlying zonal actions and
12975 # their state.
12976 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
12977 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
12978 # Example key: zones/us-central1-a
12979 &quot;a_key&quot;: {
12980 &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
12981 # populated.
12982 # different programming environments, including REST APIs and RPC APIs. It is
12983 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
12984 # three pieces of data: error code, error message, and error details.
12985 #
12986 # You can find out more about this error model and how to work with it in the
12987 # [API Design Guide](https://cloud.google.com/apis/design/errors).
12988 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
12989 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
12990 # message types for APIs to use.
12991 {
12992 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
12993 },
12994 ],
12995 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
12996 # user-facing error message should be localized and sent in the
12997 # google.rpc.Status.details field, or localized by the client.
12998 },
12999 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
13000 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
13001 },
13002 },
13003 },
13004 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
13005 # This value is inRFC3339
13006 # text format.
13007 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
13008 # following:
13009 # `PENDING`, `RUNNING`, or `DONE`.
13010 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
13011 # operation.
13012 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
13013 # of the target resource.
13014 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
13015 # operations related to creating a snapshot, this points to the disk
13016 # that the snapshot was created from.
13017 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
13018 # `[email protected]` or
13019 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
13020 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
13021 # operation, this field will be populated.
13022 {
13023 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
13024 # Engine returns NO_RESULTS_ON_PAGE if there
13025 # are no results in the response.
13026 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
13027 # value format. For example:
13028 #
13029 # &quot;data&quot;: [
13030 # {
13031 # &quot;key&quot;: &quot;scope&quot;,
13032 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
13033 # }
13034 {
13035 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
13036 # returned. For example, for warnings where there are no results in a list
13037 # request for a particular zone, this key might be scope and
13038 # the key value might be the zone name. Other examples might be a key
13039 # indicating a deprecated resource and a suggested replacement, or a
13040 # warning about invalid network settings (for example, if an instance
13041 # attempts to perform IP forwarding but is not enabled for IP forwarding).
13042 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
13043 },
13044 ],
13045 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
13046 },
13047 ],
13048 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
13049 # applicable when performing per-zone operations.
13050 }</pre>
13051 </div>
13052
13053 <div class="method">
13054 <code class="details" id="setInstanceTemplate">setInstanceTemplate(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
13055 <pre>Specifies the instance template to use when creating new instances in this
13056 group. The templates for existing instances in the group do not change
13057 unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
13058
13059 Args:
13060 project: string, Project ID for this request. (required)
13061 zone: string, The name of thezone where the managed
13062 instance group is located. (required)
13063 instanceGroupManager: string, The name of the managed instance group. (required)
13064 body: object, The request body.
13065 The object takes the form of:
13066
13067 {
13068 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
13069 # instance group. The group uses this template to create all new instances
13070 # in the managed instance group. The templates for existing instances in the
13071 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
13072 }
13073
13074 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
13075 that if you must retry your request, the server will know to ignore the
13076 request if it has already been completed.
13077
13078 For example, consider a situation where you make an initial request and
13079 the request times out. If you make the request again with the same
13080 request ID, the server can check if original operation with the same
13081 request ID was received, and if so, will ignore the second request. This
13082 prevents clients from accidentally creating duplicate commitments.
13083
13084 The request ID must be
13085 a valid UUID with the exception that zero UUID is not supported
13086 (00000000-0000-0000-0000-000000000000).
13087 x__xgafv: string, V1 error format.
13088 Allowed values
13089 1 - v1 error format
13090 2 - v2 error format
13091
13092 Returns:
13093 An object of the form:
13094
13095 { # Represents an Operation resource.
13096 #
13097 # Google Compute Engine has three Operation resources:
13098 #
13099 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
13100 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
13101 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
13102 #
13103 # You can use an operation resource to manage asynchronous API requests.
13104 # For more information, readHandling
13105 # API responses.
13106 #
13107 # Operations can be global, regional or zonal.
13108 #
13109 # - For global operations, use the `globalOperations`
13110 # resource.
13111 # - For regional operations, use the
13112 # `regionOperations` resource.
13113 # - For zonal operations, use
13114 # the `zoneOperations` resource.
13115 #
13116 #
13117 #
13118 # For more information, read
13119 # Global, Regional, and Zonal Resources.
13120 #
13121 # Note that completed Operation resources have a limited
13122 # retention period.
13123 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
13124 # Not present otherwise.
13125 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
13126 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
13127 # set when the operation is created.
13128 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
13129 # text format.
13130 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
13131 # this field will be populated.
13132 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
13133 # operation.
13134 {
13135 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
13136 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
13137 # details. There is a set of defined message types to use for providing
13138 # details.The syntax depends on the error code. For example,
13139 # QuotaExceededInfo will have details when the error code is
13140 # QUOTA_EXCEEDED.
13141 {
13142 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
13143 #
13144 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
13145 # is not enabled:
13146 #
13147 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
13148 # &quot;domain&quot;: &quot;googleapis.com&quot;
13149 # &quot;metadata&quot;: {
13150 # &quot;resource&quot;: &quot;projects/123&quot;,
13151 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
13152 # }
13153 # }
13154 #
13155 # This response indicates that the pubsub.googleapis.com API is not enabled.
13156 #
13157 # Example of an error that is returned when attempting to create a Spanner
13158 # instance in a region that is out of stock:
13159 #
13160 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
13161 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
13162 # &quot;metadata&quot;: {
13163 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
13164 # }
13165 # }
13166 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
13167 # is typically the registered service name of the tool or product that
13168 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
13169 # generated by some common infrastructure, the error domain must be a
13170 # globally unique value that identifies the infrastructure. For Google API
13171 # infrastructure, the error domain is &quot;googleapis.com&quot;.
13172 &quot;metadatas&quot;: { # Additional structured details about this error.
13173 #
13174 # Keys must match a regular expression of `a-z+` but should
13175 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
13176 # length. When identifying the current value of an exceeded limit, the units
13177 # should be contained in the key, not the value. For example, rather than
13178 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
13179 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
13180 # instances that can be created in a single (batch) request.
13181 &quot;a_key&quot;: &quot;A String&quot;,
13182 },
13183 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
13184 # proximate cause of the error. Error reasons are unique within a particular
13185 # domain of errors. This should be at most 63 characters and match a
13186 # regular expression of `A-Z+[A-Z0-9]`, which represents
13187 # UPPER_SNAKE_CASE.
13188 },
13189 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
13190 #
13191 # For example, if a quota check failed with an error indicating the calling
13192 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
13193 # directly to the right place in the developer console to flip the bit.
13194 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
13195 { # Describes a URL link.
13196 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
13197 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
13198 },
13199 ],
13200 },
13201 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
13202 # which can be attached to an RPC error.
13203 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
13204 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
13205 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
13206 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
13207 },
13208 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
13209 &quot;dimensions&quot;: { # The map holding related quota dimensions.
13210 &quot;a_key&quot;: &quot;A String&quot;,
13211 },
13212 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
13213 # type or metric.
13214 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
13215 # or metric.
13216 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
13217 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
13218 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
13219 },
13220 },
13221 ],
13222 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
13223 # This property is optional.
13224 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
13225 },
13226 ],
13227 },
13228 &quot;getVersionOperationMetadata&quot;: {
13229 &quot;inlineSbomInfo&quot;: {
13230 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
13231 # appropriate identifiers.
13232 &quot;a_key&quot;: &quot;A String&quot;,
13233 },
13234 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
13235 # identifiers.
13236 &quot;a_key&quot;: &quot;A String&quot;,
13237 },
13238 },
13239 },
13240 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
13241 # message that was returned, such as `NOT FOUND`.
13242 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
13243 # status code that was returned. For example, a `404` means the
13244 # resource was not found.
13245 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
13246 # defined by the server.
13247 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
13248 # This value is inRFC3339
13249 # text format.
13250 &quot;instancesBulkInsertOperationMetadata&quot;: {
13251 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
13252 # Example key: zones/us-central1-a
13253 &quot;a_key&quot;: {
13254 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
13255 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
13256 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
13257 # error.
13258 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
13259 # if the flow is rolling forward or rolling back.
13260 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
13261 },
13262 },
13263 },
13264 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
13265 # Operation resources.
13266 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
13267 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
13268 # group of operations results from a `bulkInsert` API request.
13269 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
13270 # `update`, or `delete`, and so on.
13271 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
13272 # There is no requirement that this be linear or support any granularity of
13273 # operations. This should not be used to guess when the operation will be
13274 # complete. This number should monotonically increase as the operation
13275 # progresses.
13276 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
13277 # applicable when performing regional operations.
13278 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
13279 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
13280 # this field will contain information on all underlying zonal actions and
13281 # their state.
13282 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
13283 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
13284 # Example key: zones/us-central1-a
13285 &quot;a_key&quot;: {
13286 &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
13287 # populated.
13288 # different programming environments, including REST APIs and RPC APIs. It is
13289 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
13290 # three pieces of data: error code, error message, and error details.
13291 #
13292 # You can find out more about this error model and how to work with it in the
13293 # [API Design Guide](https://cloud.google.com/apis/design/errors).
13294 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
13295 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
13296 # message types for APIs to use.
13297 {
13298 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
13299 },
13300 ],
13301 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
13302 # user-facing error message should be localized and sent in the
13303 # google.rpc.Status.details field, or localized by the client.
13304 },
13305 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
13306 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
13307 },
13308 },
13309 },
13310 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
13311 # This value is inRFC3339
13312 # text format.
13313 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
13314 # following:
13315 # `PENDING`, `RUNNING`, or `DONE`.
13316 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
13317 # operation.
13318 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
13319 # of the target resource.
13320 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
13321 # operations related to creating a snapshot, this points to the disk
13322 # that the snapshot was created from.
13323 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
13324 # `[email protected]` or
13325 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
13326 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
13327 # operation, this field will be populated.
13328 {
13329 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
13330 # Engine returns NO_RESULTS_ON_PAGE if there
13331 # are no results in the response.
13332 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
13333 # value format. For example:
13334 #
13335 # &quot;data&quot;: [
13336 # {
13337 # &quot;key&quot;: &quot;scope&quot;,
13338 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
13339 # }
13340 {
13341 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
13342 # returned. For example, for warnings where there are no results in a list
13343 # request for a particular zone, this key might be scope and
13344 # the key value might be the zone name. Other examples might be a key
13345 # indicating a deprecated resource and a suggested replacement, or a
13346 # warning about invalid network settings (for example, if an instance
13347 # attempts to perform IP forwarding but is not enabled for IP forwarding).
13348 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
13349 },
13350 ],
13351 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
13352 },
13353 ],
13354 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
13355 # applicable when performing per-zone operations.
13356 }</pre>
13357 </div>
13358
13359 <div class="method">
13360 <code class="details" id="setTargetPools">setTargetPools(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
13361 <pre>Modifies the target pools to which all instances in this managed instance
13362 group are assigned. The target pools automatically apply to all of the
13363 instances in the managed instance group. This operation is markedDONE when you make the request even if the instances have not
13364 yet been added to their target pools. The change might take some time to
13365 apply to all of the instances in the group depending on the size of the
13366 group.
13367
13368 Args:
13369 project: string, Project ID for this request. (required)
13370 zone: string, The name of thezone where the managed
13371 instance group is located. (required)
13372 instanceGroupManager: string, The name of the managed instance group. (required)
13373 body: object, The request body.
13374 The object takes the form of:
13375
13376 {
13377 &quot;fingerprint&quot;: &quot;A String&quot;, # The fingerprint of the target pools information. Use this optional
13378 # property to prevent conflicts when multiple users change the target pools
13379 # settings concurrently. Obtain the fingerprint with theinstanceGroupManagers.get
13380 # method. Then, include the fingerprint in your request to ensure that you
13381 # do not overwrite changes that were applied from another
13382 # concurrent request.
13383 &quot;targetPools&quot;: [ # The list of target pool URLs that instances in this managed instance group
13384 # belong to. The managed instance group applies these target pools to all
13385 # of the instances in the group. Existing instances and new instances in the
13386 # group all receive these target pool settings.
13387 &quot;A String&quot;,
13388 ],
13389 }
13390
13391 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
13392 that if you must retry your request, the server will know to ignore the
13393 request if it has already been completed.
13394
13395 For example, consider a situation where you make an initial request and
13396 the request times out. If you make the request again with the same
13397 request ID, the server can check if original operation with the same
13398 request ID was received, and if so, will ignore the second request. This
13399 prevents clients from accidentally creating duplicate commitments.
13400
13401 The request ID must be
13402 a valid UUID with the exception that zero UUID is not supported
13403 (00000000-0000-0000-0000-000000000000).
13404 x__xgafv: string, V1 error format.
13405 Allowed values
13406 1 - v1 error format
13407 2 - v2 error format
13408
13409 Returns:
13410 An object of the form:
13411
13412 { # Represents an Operation resource.
13413 #
13414 # Google Compute Engine has three Operation resources:
13415 #
13416 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
13417 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
13418 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
13419 #
13420 # You can use an operation resource to manage asynchronous API requests.
13421 # For more information, readHandling
13422 # API responses.
13423 #
13424 # Operations can be global, regional or zonal.
13425 #
13426 # - For global operations, use the `globalOperations`
13427 # resource.
13428 # - For regional operations, use the
13429 # `regionOperations` resource.
13430 # - For zonal operations, use
13431 # the `zoneOperations` resource.
13432 #
13433 #
13434 #
13435 # For more information, read
13436 # Global, Regional, and Zonal Resources.
13437 #
13438 # Note that completed Operation resources have a limited
13439 # retention period.
13440 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
13441 # Not present otherwise.
13442 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
13443 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
13444 # set when the operation is created.
13445 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
13446 # text format.
13447 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
13448 # this field will be populated.
13449 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
13450 # operation.
13451 {
13452 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
13453 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
13454 # details. There is a set of defined message types to use for providing
13455 # details.The syntax depends on the error code. For example,
13456 # QuotaExceededInfo will have details when the error code is
13457 # QUOTA_EXCEEDED.
13458 {
13459 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
13460 #
13461 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
13462 # is not enabled:
13463 #
13464 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
13465 # &quot;domain&quot;: &quot;googleapis.com&quot;
13466 # &quot;metadata&quot;: {
13467 # &quot;resource&quot;: &quot;projects/123&quot;,
13468 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
13469 # }
13470 # }
13471 #
13472 # This response indicates that the pubsub.googleapis.com API is not enabled.
13473 #
13474 # Example of an error that is returned when attempting to create a Spanner
13475 # instance in a region that is out of stock:
13476 #
13477 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
13478 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
13479 # &quot;metadata&quot;: {
13480 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
13481 # }
13482 # }
13483 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
13484 # is typically the registered service name of the tool or product that
13485 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
13486 # generated by some common infrastructure, the error domain must be a
13487 # globally unique value that identifies the infrastructure. For Google API
13488 # infrastructure, the error domain is &quot;googleapis.com&quot;.
13489 &quot;metadatas&quot;: { # Additional structured details about this error.
13490 #
13491 # Keys must match a regular expression of `a-z+` but should
13492 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
13493 # length. When identifying the current value of an exceeded limit, the units
13494 # should be contained in the key, not the value. For example, rather than
13495 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
13496 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
13497 # instances that can be created in a single (batch) request.
13498 &quot;a_key&quot;: &quot;A String&quot;,
13499 },
13500 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
13501 # proximate cause of the error. Error reasons are unique within a particular
13502 # domain of errors. This should be at most 63 characters and match a
13503 # regular expression of `A-Z+[A-Z0-9]`, which represents
13504 # UPPER_SNAKE_CASE.
13505 },
13506 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
13507 #
13508 # For example, if a quota check failed with an error indicating the calling
13509 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
13510 # directly to the right place in the developer console to flip the bit.
13511 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
13512 { # Describes a URL link.
13513 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
13514 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
13515 },
13516 ],
13517 },
13518 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
13519 # which can be attached to an RPC error.
13520 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
13521 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
13522 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
13523 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
13524 },
13525 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
13526 &quot;dimensions&quot;: { # The map holding related quota dimensions.
13527 &quot;a_key&quot;: &quot;A String&quot;,
13528 },
13529 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
13530 # type or metric.
13531 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
13532 # or metric.
13533 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
13534 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
13535 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
13536 },
13537 },
13538 ],
13539 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
13540 # This property is optional.
13541 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
13542 },
13543 ],
13544 },
13545 &quot;getVersionOperationMetadata&quot;: {
13546 &quot;inlineSbomInfo&quot;: {
13547 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
13548 # appropriate identifiers.
13549 &quot;a_key&quot;: &quot;A String&quot;,
13550 },
13551 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
13552 # identifiers.
13553 &quot;a_key&quot;: &quot;A String&quot;,
13554 },
13555 },
13556 },
13557 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
13558 # message that was returned, such as `NOT FOUND`.
13559 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
13560 # status code that was returned. For example, a `404` means the
13561 # resource was not found.
13562 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
13563 # defined by the server.
13564 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
13565 # This value is inRFC3339
13566 # text format.
13567 &quot;instancesBulkInsertOperationMetadata&quot;: {
13568 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
13569 # Example key: zones/us-central1-a
13570 &quot;a_key&quot;: {
13571 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
13572 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
13573 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
13574 # error.
13575 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
13576 # if the flow is rolling forward or rolling back.
13577 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
13578 },
13579 },
13580 },
13581 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
13582 # Operation resources.
13583 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
13584 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
13585 # group of operations results from a `bulkInsert` API request.
13586 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
13587 # `update`, or `delete`, and so on.
13588 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
13589 # There is no requirement that this be linear or support any granularity of
13590 # operations. This should not be used to guess when the operation will be
13591 # complete. This number should monotonically increase as the operation
13592 # progresses.
13593 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
13594 # applicable when performing regional operations.
13595 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
13596 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
13597 # this field will contain information on all underlying zonal actions and
13598 # their state.
13599 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
13600 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
13601 # Example key: zones/us-central1-a
13602 &quot;a_key&quot;: {
13603 &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
13604 # populated.
13605 # different programming environments, including REST APIs and RPC APIs. It is
13606 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
13607 # three pieces of data: error code, error message, and error details.
13608 #
13609 # You can find out more about this error model and how to work with it in the
13610 # [API Design Guide](https://cloud.google.com/apis/design/errors).
13611 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
13612 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
13613 # message types for APIs to use.
13614 {
13615 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
13616 },
13617 ],
13618 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
13619 # user-facing error message should be localized and sent in the
13620 # google.rpc.Status.details field, or localized by the client.
13621 },
13622 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
13623 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
13624 },
13625 },
13626 },
13627 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
13628 # This value is inRFC3339
13629 # text format.
13630 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
13631 # following:
13632 # `PENDING`, `RUNNING`, or `DONE`.
13633 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
13634 # operation.
13635 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
13636 # of the target resource.
13637 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
13638 # operations related to creating a snapshot, this points to the disk
13639 # that the snapshot was created from.
13640 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
13641 # `[email protected]` or
13642 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
13643 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
13644 # operation, this field will be populated.
13645 {
13646 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
13647 # Engine returns NO_RESULTS_ON_PAGE if there
13648 # are no results in the response.
13649 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
13650 # value format. For example:
13651 #
13652 # &quot;data&quot;: [
13653 # {
13654 # &quot;key&quot;: &quot;scope&quot;,
13655 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
13656 # }
13657 {
13658 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
13659 # returned. For example, for warnings where there are no results in a list
13660 # request for a particular zone, this key might be scope and
13661 # the key value might be the zone name. Other examples might be a key
13662 # indicating a deprecated resource and a suggested replacement, or a
13663 # warning about invalid network settings (for example, if an instance
13664 # attempts to perform IP forwarding but is not enabled for IP forwarding).
13665 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
13666 },
13667 ],
13668 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
13669 },
13670 ],
13671 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
13672 # applicable when performing per-zone operations.
13673 }</pre>
13674 </div>
13675
13676 <div class="method">
13677 <code class="details" id="startInstances">startInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
13678 <pre>Flags the specified instances in the managed instance group to be
13679 started. This method increases thetargetSize and decreases the targetStoppedSize
13680 of the managed instance group by the number of instances that you start.
13681 The startInstances operation is marked DONE if
13682 the startInstances request is successful. The underlying
13683 actions take additional time. You must separately verify the status of theSTARTING action with thelistmanagedinstances
13684 method.
13685
13686 In this request, you can only specify instances that are stopped. For
13687 example, if an instance was previously stopped using the stopInstances
13688 method, it can be started using the startInstances method.
13689
13690 If a health check is attached to the managed instance group, the specified
13691 instances will be verified as healthy after they are started.
13692
13693 You can specify a maximum of 1000 instances with this method per request.
13694
13695 Args:
13696 project: string, Project ID for this request. (required)
13697 zone: string, The name of thezone where the managed
13698 instance group is located. (required)
13699 instanceGroupManager: string, The name of the managed instance group. (required)
13700 body: object, The request body.
13701 The object takes the form of:
13702
13703 {
13704 &quot;instances&quot;: [ # The URLs of one or more instances to start. This can be a full URL or
13705 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
13706 &quot;A String&quot;,
13707 ],
13708 }
13709
13710 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
13711 that if you must retry your request, the server will know to ignore the
13712 request if it has already been completed.
13713
13714 For example, consider a situation where you make an initial request and
13715 the request times out. If you make the request again with the same
13716 request ID, the server can check if original operation with the same
13717 request ID was received, and if so, will ignore the second request. This
13718 prevents clients from accidentally creating duplicate commitments.
13719
13720 The request ID must be
13721 a valid UUID with the exception that zero UUID is not supported
13722 (00000000-0000-0000-0000-000000000000).
13723 x__xgafv: string, V1 error format.
13724 Allowed values
13725 1 - v1 error format
13726 2 - v2 error format
13727
13728 Returns:
13729 An object of the form:
13730
13731 { # Represents an Operation resource.
13732 #
13733 # Google Compute Engine has three Operation resources:
13734 #
13735 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
13736 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
13737 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
13738 #
13739 # You can use an operation resource to manage asynchronous API requests.
13740 # For more information, readHandling
13741 # API responses.
13742 #
13743 # Operations can be global, regional or zonal.
13744 #
13745 # - For global operations, use the `globalOperations`
13746 # resource.
13747 # - For regional operations, use the
13748 # `regionOperations` resource.
13749 # - For zonal operations, use
13750 # the `zoneOperations` resource.
13751 #
13752 #
13753 #
13754 # For more information, read
13755 # Global, Regional, and Zonal Resources.
13756 #
13757 # Note that completed Operation resources have a limited
13758 # retention period.
13759 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
13760 # Not present otherwise.
13761 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
13762 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
13763 # set when the operation is created.
13764 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
13765 # text format.
13766 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
13767 # this field will be populated.
13768 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
13769 # operation.
13770 {
13771 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
13772 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
13773 # details. There is a set of defined message types to use for providing
13774 # details.The syntax depends on the error code. For example,
13775 # QuotaExceededInfo will have details when the error code is
13776 # QUOTA_EXCEEDED.
13777 {
13778 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
13779 #
13780 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
13781 # is not enabled:
13782 #
13783 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
13784 # &quot;domain&quot;: &quot;googleapis.com&quot;
13785 # &quot;metadata&quot;: {
13786 # &quot;resource&quot;: &quot;projects/123&quot;,
13787 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
13788 # }
13789 # }
13790 #
13791 # This response indicates that the pubsub.googleapis.com API is not enabled.
13792 #
13793 # Example of an error that is returned when attempting to create a Spanner
13794 # instance in a region that is out of stock:
13795 #
13796 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
13797 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
13798 # &quot;metadata&quot;: {
13799 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
13800 # }
13801 # }
13802 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
13803 # is typically the registered service name of the tool or product that
13804 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
13805 # generated by some common infrastructure, the error domain must be a
13806 # globally unique value that identifies the infrastructure. For Google API
13807 # infrastructure, the error domain is &quot;googleapis.com&quot;.
13808 &quot;metadatas&quot;: { # Additional structured details about this error.
13809 #
13810 # Keys must match a regular expression of `a-z+` but should
13811 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
13812 # length. When identifying the current value of an exceeded limit, the units
13813 # should be contained in the key, not the value. For example, rather than
13814 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
13815 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
13816 # instances that can be created in a single (batch) request.
13817 &quot;a_key&quot;: &quot;A String&quot;,
13818 },
13819 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
13820 # proximate cause of the error. Error reasons are unique within a particular
13821 # domain of errors. This should be at most 63 characters and match a
13822 # regular expression of `A-Z+[A-Z0-9]`, which represents
13823 # UPPER_SNAKE_CASE.
13824 },
13825 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
13826 #
13827 # For example, if a quota check failed with an error indicating the calling
13828 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
13829 # directly to the right place in the developer console to flip the bit.
13830 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
13831 { # Describes a URL link.
13832 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
13833 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
13834 },
13835 ],
13836 },
13837 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
13838 # which can be attached to an RPC error.
13839 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
13840 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
13841 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
13842 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
13843 },
13844 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
13845 &quot;dimensions&quot;: { # The map holding related quota dimensions.
13846 &quot;a_key&quot;: &quot;A String&quot;,
13847 },
13848 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
13849 # type or metric.
13850 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
13851 # or metric.
13852 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
13853 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
13854 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
13855 },
13856 },
13857 ],
13858 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
13859 # This property is optional.
13860 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
13861 },
13862 ],
13863 },
13864 &quot;getVersionOperationMetadata&quot;: {
13865 &quot;inlineSbomInfo&quot;: {
13866 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
13867 # appropriate identifiers.
13868 &quot;a_key&quot;: &quot;A String&quot;,
13869 },
13870 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
13871 # identifiers.
13872 &quot;a_key&quot;: &quot;A String&quot;,
13873 },
13874 },
13875 },
13876 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
13877 # message that was returned, such as `NOT FOUND`.
13878 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
13879 # status code that was returned. For example, a `404` means the
13880 # resource was not found.
13881 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
13882 # defined by the server.
13883 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
13884 # This value is inRFC3339
13885 # text format.
13886 &quot;instancesBulkInsertOperationMetadata&quot;: {
13887 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
13888 # Example key: zones/us-central1-a
13889 &quot;a_key&quot;: {
13890 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
13891 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
13892 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
13893 # error.
13894 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
13895 # if the flow is rolling forward or rolling back.
13896 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
13897 },
13898 },
13899 },
13900 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
13901 # Operation resources.
13902 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
13903 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
13904 # group of operations results from a `bulkInsert` API request.
13905 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
13906 # `update`, or `delete`, and so on.
13907 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
13908 # There is no requirement that this be linear or support any granularity of
13909 # operations. This should not be used to guess when the operation will be
13910 # complete. This number should monotonically increase as the operation
13911 # progresses.
13912 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
13913 # applicable when performing regional operations.
13914 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
13915 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
13916 # this field will contain information on all underlying zonal actions and
13917 # their state.
13918 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
13919 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
13920 # Example key: zones/us-central1-a
13921 &quot;a_key&quot;: {
13922 &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
13923 # populated.
13924 # different programming environments, including REST APIs and RPC APIs. It is
13925 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
13926 # three pieces of data: error code, error message, and error details.
13927 #
13928 # You can find out more about this error model and how to work with it in the
13929 # [API Design Guide](https://cloud.google.com/apis/design/errors).
13930 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
13931 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
13932 # message types for APIs to use.
13933 {
13934 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
13935 },
13936 ],
13937 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
13938 # user-facing error message should be localized and sent in the
13939 # google.rpc.Status.details field, or localized by the client.
13940 },
13941 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
13942 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
13943 },
13944 },
13945 },
13946 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
13947 # This value is inRFC3339
13948 # text format.
13949 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
13950 # following:
13951 # `PENDING`, `RUNNING`, or `DONE`.
13952 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
13953 # operation.
13954 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
13955 # of the target resource.
13956 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
13957 # operations related to creating a snapshot, this points to the disk
13958 # that the snapshot was created from.
13959 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
13960 # `[email protected]` or
13961 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
13962 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
13963 # operation, this field will be populated.
13964 {
13965 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
13966 # Engine returns NO_RESULTS_ON_PAGE if there
13967 # are no results in the response.
13968 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
13969 # value format. For example:
13970 #
13971 # &quot;data&quot;: [
13972 # {
13973 # &quot;key&quot;: &quot;scope&quot;,
13974 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
13975 # }
13976 {
13977 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
13978 # returned. For example, for warnings where there are no results in a list
13979 # request for a particular zone, this key might be scope and
13980 # the key value might be the zone name. Other examples might be a key
13981 # indicating a deprecated resource and a suggested replacement, or a
13982 # warning about invalid network settings (for example, if an instance
13983 # attempts to perform IP forwarding but is not enabled for IP forwarding).
13984 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
13985 },
13986 ],
13987 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
13988 },
13989 ],
13990 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
13991 # applicable when performing per-zone operations.
13992 }</pre>
13993 </div>
13994
13995 <div class="method">
13996 <code class="details" id="stopInstances">stopInstances(project, zone, instanceGroupManager, body=None, noGracefulShutdown=None, requestId=None, x__xgafv=None)</code>
13997 <pre>Flags the specified instances in the managed instance group to be
13998 immediately stopped. You can only specify instances that are running in
13999 this request. This method reduces thetargetSize and increases the targetStoppedSize
14000 of the managed instance group by the number of instances that you stop.
14001 The stopInstances operation is marked DONE if
14002 the stopInstances request is successful. The underlying
14003 actions take additional time. You must separately verify the status of theSTOPPING action with thelistmanagedinstances
14004 method.
14005
14006 If the standbyPolicy.initialDelaySec field is set, the group
14007 delays stopping the instances until initialDelaySec have
14008 passed from instance.creationTimestamp (that is, when the
14009 instance was created). This delay gives your application time to
14010 set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
14011 will be zero delay.
14012
14013 If the group is part of a backend
14014 service that has enabled
14015 connection draining, it can take up to 60 seconds after the connection
14016 draining duration has elapsed before the VM instance is stopped.
14017
14018 Stopped instances can be started using the startInstances
14019 method.
14020
14021 You can specify a maximum of 1000 instances with this method per request.
14022
14023 Args:
14024 project: string, Project ID for this request. (required)
14025 zone: string, The name of thezone where the managed
14026 instance group is located. (required)
14027 instanceGroupManager: string, The name of the managed instance group. (required)
14028 body: object, The request body.
14029 The object takes the form of:
14030
14031 {
14032 &quot;forceStop&quot;: True or False, # If this flag is set to true, the Instance Group Manager will proceed to
14033 # stop the instances, skipping initialization on them.
14034 &quot;instances&quot;: [ # The URLs of one or more instances to stop. This can be a full URL or
14035 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
14036 &quot;A String&quot;,
14037 ],
14038 }
14039
14040 noGracefulShutdown: boolean, When set, graceful shutdown is skipped for instance stopping even if it&#x27;s
14041 configured for the instances.
14042 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14043 that if you must retry your request, the server will know to ignore the
14044 request if it has already been completed.
14045
14046 For example, consider a situation where you make an initial request and
14047 the request times out. If you make the request again with the same
14048 request ID, the server can check if original operation with the same
14049 request ID was received, and if so, will ignore the second request. This
14050 prevents clients from accidentally creating duplicate commitments.
14051
14052 The request ID must be
14053 a valid UUID with the exception that zero UUID is not supported
14054 (00000000-0000-0000-0000-000000000000).
14055 x__xgafv: string, V1 error format.
14056 Allowed values
14057 1 - v1 error format
14058 2 - v2 error format
14059
14060 Returns:
14061 An object of the form:
14062
14063 { # Represents an Operation resource.
14064 #
14065 # Google Compute Engine has three Operation resources:
14066 #
14067 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
14068 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
14069 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
14070 #
14071 # You can use an operation resource to manage asynchronous API requests.
14072 # For more information, readHandling
14073 # API responses.
14074 #
14075 # Operations can be global, regional or zonal.
14076 #
14077 # - For global operations, use the `globalOperations`
14078 # resource.
14079 # - For regional operations, use the
14080 # `regionOperations` resource.
14081 # - For zonal operations, use
14082 # the `zoneOperations` resource.
14083 #
14084 #
14085 #
14086 # For more information, read
14087 # Global, Regional, and Zonal Resources.
14088 #
14089 # Note that completed Operation resources have a limited
14090 # retention period.
14091 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14092 # Not present otherwise.
14093 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14094 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14095 # set when the operation is created.
14096 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14097 # text format.
14098 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14099 # this field will be populated.
14100 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14101 # operation.
14102 {
14103 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14104 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14105 # details. There is a set of defined message types to use for providing
14106 # details.The syntax depends on the error code. For example,
14107 # QuotaExceededInfo will have details when the error code is
14108 # QUOTA_EXCEEDED.
14109 {
14110 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14111 #
14112 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14113 # is not enabled:
14114 #
14115 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14116 # &quot;domain&quot;: &quot;googleapis.com&quot;
14117 # &quot;metadata&quot;: {
14118 # &quot;resource&quot;: &quot;projects/123&quot;,
14119 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14120 # }
14121 # }
14122 #
14123 # This response indicates that the pubsub.googleapis.com API is not enabled.
14124 #
14125 # Example of an error that is returned when attempting to create a Spanner
14126 # instance in a region that is out of stock:
14127 #
14128 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14129 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14130 # &quot;metadata&quot;: {
14131 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14132 # }
14133 # }
14134 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14135 # is typically the registered service name of the tool or product that
14136 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14137 # generated by some common infrastructure, the error domain must be a
14138 # globally unique value that identifies the infrastructure. For Google API
14139 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14140 &quot;metadatas&quot;: { # Additional structured details about this error.
14141 #
14142 # Keys must match a regular expression of `a-z+` but should
14143 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14144 # length. When identifying the current value of an exceeded limit, the units
14145 # should be contained in the key, not the value. For example, rather than
14146 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14147 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14148 # instances that can be created in a single (batch) request.
14149 &quot;a_key&quot;: &quot;A String&quot;,
14150 },
14151 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14152 # proximate cause of the error. Error reasons are unique within a particular
14153 # domain of errors. This should be at most 63 characters and match a
14154 # regular expression of `A-Z+[A-Z0-9]`, which represents
14155 # UPPER_SNAKE_CASE.
14156 },
14157 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14158 #
14159 # For example, if a quota check failed with an error indicating the calling
14160 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14161 # directly to the right place in the developer console to flip the bit.
14162 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14163 { # Describes a URL link.
14164 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14165 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14166 },
14167 ],
14168 },
14169 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14170 # which can be attached to an RPC error.
14171 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14172 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14173 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14174 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14175 },
14176 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14177 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14178 &quot;a_key&quot;: &quot;A String&quot;,
14179 },
14180 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14181 # type or metric.
14182 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14183 # or metric.
14184 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14185 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14186 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14187 },
14188 },
14189 ],
14190 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14191 # This property is optional.
14192 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14193 },
14194 ],
14195 },
14196 &quot;getVersionOperationMetadata&quot;: {
14197 &quot;inlineSbomInfo&quot;: {
14198 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14199 # appropriate identifiers.
14200 &quot;a_key&quot;: &quot;A String&quot;,
14201 },
14202 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14203 # identifiers.
14204 &quot;a_key&quot;: &quot;A String&quot;,
14205 },
14206 },
14207 },
14208 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14209 # message that was returned, such as `NOT FOUND`.
14210 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14211 # status code that was returned. For example, a `404` means the
14212 # resource was not found.
14213 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14214 # defined by the server.
14215 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14216 # This value is inRFC3339
14217 # text format.
14218 &quot;instancesBulkInsertOperationMetadata&quot;: {
14219 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14220 # Example key: zones/us-central1-a
14221 &quot;a_key&quot;: {
14222 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14223 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14224 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14225 # error.
14226 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14227 # if the flow is rolling forward or rolling back.
14228 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14229 },
14230 },
14231 },
14232 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
14233 # Operation resources.
14234 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
14235 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
14236 # group of operations results from a `bulkInsert` API request.
14237 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
14238 # `update`, or `delete`, and so on.
14239 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
14240 # There is no requirement that this be linear or support any granularity of
14241 # operations. This should not be used to guess when the operation will be
14242 # complete. This number should monotonically increase as the operation
14243 # progresses.
14244 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
14245 # applicable when performing regional operations.
14246 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
14247 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
14248 # this field will contain information on all underlying zonal actions and
14249 # their state.
14250 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
14251 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
14252 # Example key: zones/us-central1-a
14253 &quot;a_key&quot;: {
14254 &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
14255 # populated.
14256 # different programming environments, including REST APIs and RPC APIs. It is
14257 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
14258 # three pieces of data: error code, error message, and error details.
14259 #
14260 # You can find out more about this error model and how to work with it in the
14261 # [API Design Guide](https://cloud.google.com/apis/design/errors).
14262 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
14263 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
14264 # message types for APIs to use.
14265 {
14266 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
14267 },
14268 ],
14269 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
14270 # user-facing error message should be localized and sent in the
14271 # google.rpc.Status.details field, or localized by the client.
14272 },
14273 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
14274 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
14275 },
14276 },
14277 },
14278 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
14279 # This value is inRFC3339
14280 # text format.
14281 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
14282 # following:
14283 # `PENDING`, `RUNNING`, or `DONE`.
14284 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
14285 # operation.
14286 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
14287 # of the target resource.
14288 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
14289 # operations related to creating a snapshot, this points to the disk
14290 # that the snapshot was created from.
14291 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
14292 # `[email protected]` or
14293 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
14294 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
14295 # operation, this field will be populated.
14296 {
14297 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
14298 # Engine returns NO_RESULTS_ON_PAGE if there
14299 # are no results in the response.
14300 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
14301 # value format. For example:
14302 #
14303 # &quot;data&quot;: [
14304 # {
14305 # &quot;key&quot;: &quot;scope&quot;,
14306 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
14307 # }
14308 {
14309 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
14310 # returned. For example, for warnings where there are no results in a list
14311 # request for a particular zone, this key might be scope and
14312 # the key value might be the zone name. Other examples might be a key
14313 # indicating a deprecated resource and a suggested replacement, or a
14314 # warning about invalid network settings (for example, if an instance
14315 # attempts to perform IP forwarding but is not enabled for IP forwarding).
14316 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
14317 },
14318 ],
14319 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
14320 },
14321 ],
14322 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
14323 # applicable when performing per-zone operations.
14324 }</pre>
14325 </div>
14326
14327 <div class="method">
14328 <code class="details" id="suspendInstances">suspendInstances(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
14329 <pre>Flags the specified instances in the managed instance group to be
14330 immediately suspended. You can only specify instances that are running in
14331 this request. This method reduces thetargetSize and increases the targetSuspendedSize
14332 of the managed instance group by the number of instances that you suspend.
14333 The suspendInstances operation is marked DONE if
14334 the suspendInstances request is successful. The underlying
14335 actions take additional time. You must separately verify the status of theSUSPENDING action with thelistmanagedinstances
14336 method.
14337
14338 If the standbyPolicy.initialDelaySec field is set, the group
14339 delays suspension of the instances until initialDelaySec have
14340 passed from instance.creationTimestamp (that is, when the
14341 instance was created). This delay gives your application time to
14342 set itself up and initialize on the instance. If more thaninitialDelaySec seconds have passed sinceinstance.creationTimestamp when this method is called, there
14343 will be zero delay.
14344
14345 If the group is part of a backend
14346 service that has enabled
14347 connection draining, it can take up to 60 seconds after the connection
14348 draining duration has elapsed before the VM instance is suspended.
14349
14350 Suspended instances can be resumed using the resumeInstances
14351 method.
14352
14353 You can specify a maximum of 1000 instances with this method per request.
14354
14355 Args:
14356 project: string, Project ID for this request. (required)
14357 zone: string, The name of thezone where the managed
14358 instance group is located. (required)
14359 instanceGroupManager: string, The name of the managed instance group. (required)
14360 body: object, The request body.
14361 The object takes the form of:
14362
14363 {
14364 &quot;forceSuspend&quot;: True or False, # If this flag is set to true, the Instance Group Manager will proceed to
14365 # suspend the instances, skipping initialization on them.
14366 &quot;instances&quot;: [ # The URLs of one or more instances to suspend. This can be a full URL or
14367 # a partial URL, such as zones/[ZONE]/instances/[INSTANCE_NAME].
14368 &quot;A String&quot;,
14369 ],
14370 }
14371
14372 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
14373 that if you must retry your request, the server will know to ignore the
14374 request if it has already been completed.
14375
14376 For example, consider a situation where you make an initial request and
14377 the request times out. If you make the request again with the same
14378 request ID, the server can check if original operation with the same
14379 request ID was received, and if so, will ignore the second request. This
14380 prevents clients from accidentally creating duplicate commitments.
14381
14382 The request ID must be
14383 a valid UUID with the exception that zero UUID is not supported
14384 (00000000-0000-0000-0000-000000000000).
14385 x__xgafv: string, V1 error format.
14386 Allowed values
14387 1 - v1 error format
14388 2 - v2 error format
14389
14390 Returns:
14391 An object of the form:
14392
14393 { # Represents an Operation resource.
14394 #
14395 # Google Compute Engine has three Operation resources:
14396 #
14397 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
14398 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
14399 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
14400 #
14401 # You can use an operation resource to manage asynchronous API requests.
14402 # For more information, readHandling
14403 # API responses.
14404 #
14405 # Operations can be global, regional or zonal.
14406 #
14407 # - For global operations, use the `globalOperations`
14408 # resource.
14409 # - For regional operations, use the
14410 # `regionOperations` resource.
14411 # - For zonal operations, use
14412 # the `zoneOperations` resource.
14413 #
14414 #
14415 #
14416 # For more information, read
14417 # Global, Regional, and Zonal Resources.
14418 #
14419 # Note that completed Operation resources have a limited
14420 # retention period.
14421 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
14422 # Not present otherwise.
14423 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
14424 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
14425 # set when the operation is created.
14426 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
14427 # text format.
14428 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
14429 # this field will be populated.
14430 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
14431 # operation.
14432 {
14433 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
14434 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
14435 # details. There is a set of defined message types to use for providing
14436 # details.The syntax depends on the error code. For example,
14437 # QuotaExceededInfo will have details when the error code is
14438 # QUOTA_EXCEEDED.
14439 {
14440 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
14441 #
14442 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
14443 # is not enabled:
14444 #
14445 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
14446 # &quot;domain&quot;: &quot;googleapis.com&quot;
14447 # &quot;metadata&quot;: {
14448 # &quot;resource&quot;: &quot;projects/123&quot;,
14449 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
14450 # }
14451 # }
14452 #
14453 # This response indicates that the pubsub.googleapis.com API is not enabled.
14454 #
14455 # Example of an error that is returned when attempting to create a Spanner
14456 # instance in a region that is out of stock:
14457 #
14458 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
14459 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
14460 # &quot;metadata&quot;: {
14461 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
14462 # }
14463 # }
14464 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
14465 # is typically the registered service name of the tool or product that
14466 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
14467 # generated by some common infrastructure, the error domain must be a
14468 # globally unique value that identifies the infrastructure. For Google API
14469 # infrastructure, the error domain is &quot;googleapis.com&quot;.
14470 &quot;metadatas&quot;: { # Additional structured details about this error.
14471 #
14472 # Keys must match a regular expression of `a-z+` but should
14473 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
14474 # length. When identifying the current value of an exceeded limit, the units
14475 # should be contained in the key, not the value. For example, rather than
14476 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
14477 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
14478 # instances that can be created in a single (batch) request.
14479 &quot;a_key&quot;: &quot;A String&quot;,
14480 },
14481 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
14482 # proximate cause of the error. Error reasons are unique within a particular
14483 # domain of errors. This should be at most 63 characters and match a
14484 # regular expression of `A-Z+[A-Z0-9]`, which represents
14485 # UPPER_SNAKE_CASE.
14486 },
14487 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
14488 #
14489 # For example, if a quota check failed with an error indicating the calling
14490 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
14491 # directly to the right place in the developer console to flip the bit.
14492 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
14493 { # Describes a URL link.
14494 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
14495 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
14496 },
14497 ],
14498 },
14499 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
14500 # which can be attached to an RPC error.
14501 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
14502 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
14503 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
14504 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
14505 },
14506 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
14507 &quot;dimensions&quot;: { # The map holding related quota dimensions.
14508 &quot;a_key&quot;: &quot;A String&quot;,
14509 },
14510 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
14511 # type or metric.
14512 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
14513 # or metric.
14514 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
14515 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
14516 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
14517 },
14518 },
14519 ],
14520 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
14521 # This property is optional.
14522 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
14523 },
14524 ],
14525 },
14526 &quot;getVersionOperationMetadata&quot;: {
14527 &quot;inlineSbomInfo&quot;: {
14528 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
14529 # appropriate identifiers.
14530 &quot;a_key&quot;: &quot;A String&quot;,
14531 },
14532 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
14533 # identifiers.
14534 &quot;a_key&quot;: &quot;A String&quot;,
14535 },
14536 },
14537 },
14538 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
14539 # message that was returned, such as `NOT FOUND`.
14540 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
14541 # status code that was returned. For example, a `404` means the
14542 # resource was not found.
14543 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
14544 # defined by the server.
14545 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
14546 # This value is inRFC3339
14547 # text format.
14548 &quot;instancesBulkInsertOperationMetadata&quot;: {
14549 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
14550 # Example key: zones/us-central1-a
14551 &quot;a_key&quot;: {
14552 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
14553 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
14554 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
14555 # error.
14556 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
14557 # if the flow is rolling forward or rolling back.
14558 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
14559 },
14560 },
14561 },
14562 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
14563 # Operation resources.
14564 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
14565 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
14566 # group of operations results from a `bulkInsert` API request.
14567 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
14568 # `update`, or `delete`, and so on.
14569 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
14570 # There is no requirement that this be linear or support any granularity of
14571 # operations. This should not be used to guess when the operation will be
14572 # complete. This number should monotonically increase as the operation
14573 # progresses.
14574 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
14575 # applicable when performing regional operations.
14576 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
14577 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
14578 # this field will contain information on all underlying zonal actions and
14579 # their state.
14580 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
14581 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
14582 # Example key: zones/us-central1-a
14583 &quot;a_key&quot;: {
14584 &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
14585 # populated.
14586 # different programming environments, including REST APIs and RPC APIs. It is
14587 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
14588 # three pieces of data: error code, error message, and error details.
14589 #
14590 # You can find out more about this error model and how to work with it in the
14591 # [API Design Guide](https://cloud.google.com/apis/design/errors).
14592 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
14593 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
14594 # message types for APIs to use.
14595 {
14596 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
14597 },
14598 ],
14599 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
14600 # user-facing error message should be localized and sent in the
14601 # google.rpc.Status.details field, or localized by the client.
14602 },
14603 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
14604 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
14605 },
14606 },
14607 },
14608 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
14609 # This value is inRFC3339
14610 # text format.
14611 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
14612 # following:
14613 # `PENDING`, `RUNNING`, or `DONE`.
14614 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
14615 # operation.
14616 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
14617 # of the target resource.
14618 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
14619 # operations related to creating a snapshot, this points to the disk
14620 # that the snapshot was created from.
14621 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
14622 # `[email protected]` or
14623 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
14624 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
14625 # operation, this field will be populated.
14626 {
14627 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
14628 # Engine returns NO_RESULTS_ON_PAGE if there
14629 # are no results in the response.
14630 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
14631 # value format. For example:
14632 #
14633 # &quot;data&quot;: [
14634 # {
14635 # &quot;key&quot;: &quot;scope&quot;,
14636 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
14637 # }
14638 {
14639 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
14640 # returned. For example, for warnings where there are no results in a list
14641 # request for a particular zone, this key might be scope and
14642 # the key value might be the zone name. Other examples might be a key
14643 # indicating a deprecated resource and a suggested replacement, or a
14644 # warning about invalid network settings (for example, if an instance
14645 # attempts to perform IP forwarding but is not enabled for IP forwarding).
14646 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
14647 },
14648 ],
14649 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
14650 },
14651 ],
14652 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
14653 # applicable when performing per-zone operations.
14654 }</pre>
14655 </div>
14656
14657 <div class="method">
14658 <code class="details" id="testIamPermissions">testIamPermissions(project, zone, resource, body=None, x__xgafv=None)</code>
14659 <pre>Returns permissions that a caller has on the specified resource.
14660
14661 Args:
14662 project: string, Project ID for this request. (required)
14663 zone: string, The name of the zone for this request. (required)
14664 resource: string, Name or id of the resource for this request. (required)
14665 body: object, The request body.
14666 The object takes the form of:
14667
14668 {
14669 &quot;permissions&quot;: [ # The set of permissions to check for the &#x27;resource&#x27;. Permissions with
14670 # wildcards (such as &#x27;*&#x27; or &#x27;storage.*&#x27;) are not allowed.
14671 &quot;A String&quot;,
14672 ],
14673 }
14674
14675 x__xgafv: string, V1 error format.
14676 Allowed values
14677 1 - v1 error format
14678 2 - v2 error format
14679
14680 Returns:
14681 An object of the form:
14682
14683 {
14684 &quot;permissions&quot;: [ # A subset of `TestPermissionsRequest.permissions` that the caller is
14685 # allowed.
14686 &quot;A String&quot;,
14687 ],
14688 }</pre>
14689 </div>
14690
14691 <div class="method">
14692 <code class="details" id="update">update(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
14693 <pre>Updates a managed instance group using the information that you specify
14694 in the request.
14695 This operation is marked as DONE when the group is updated
14696 even if the instances in the group have not yet been updated. You must
14697 separately verify the status of the individual instances with thelistManagedInstances
14698 method.
14699
14700 If you update your group to specify a new template or instance
14701 configuration, it&#x27;s possible that your intended specification for each VM
14702 in the group is different from the current state of that VM. To learn how
14703 to apply an updated configuration to the VMs in a MIG, seeUpdating instances in
14704 a MIG.
14705
14706 Args:
14707 project: string, Project ID for this request. (required)
14708 zone: string, The name of the zone
14709 where you want to create the managed instance group. (required)
14710 instanceGroupManager: string, The name of the instance group manager. (required)
14711 body: object, The request body.
14712 The object takes the form of:
14713
14714 { # Represents a Managed Instance Group resource.
14715 #
14716 # An instance group is a collection of VM instances that you can manage as a
14717 # single entity. For more information, readInstance groups.
14718 #
14719 # For zonal Managed Instance Group, use the instanceGroupManagers
14720 # resource.
14721 #
14722 # For regional Managed Instance Group, use theregionInstanceGroupManagers resource.
14723 &quot;allInstancesConfig&quot;: { # Specifies configuration that overrides the instance template configuration
14724 # for the group.
14725 &quot;properties&quot;: { # Represents the change that you want to make to the instance properties. # Properties to set on all instances in the group.
14726 #
14727 # You can add or modify properties using theinstanceGroupManagers.patch orregionInstanceGroupManagers.patch. After settingallInstancesConfig on the group, you must update the group&#x27;s
14728 # instances to apply the configuration. To apply the configuration, set the
14729 # group&#x27;s updatePolicy.type field to use proactive updates or
14730 # use the applyUpdatesToInstances method.
14731 &quot;labels&quot;: { # The label key-value pairs that you want to patch onto the instance.
14732 &quot;a_key&quot;: &quot;A String&quot;,
14733 },
14734 &quot;metadata&quot;: { # The metadata key-value pairs that you want to patch onto the instance. For
14735 # more information, see Project and
14736 # instance metadata.
14737 &quot;a_key&quot;: &quot;A String&quot;,
14738 },
14739 },
14740 },
14741 &quot;autoHealingPolicies&quot;: [ # The autohealing policy for this managed instance group. You can specify
14742 # only one value.
14743 {
14744 &quot;healthCheck&quot;: &quot;A String&quot;, # The URL for the health check that signals autohealing.
14745 &quot;initialDelaySec&quot;: 42, # The initial delay is the number of seconds that a new VM takes to
14746 # initialize and run its startup script. During a VM&#x27;s initial delay
14747 # period, the MIG ignores unsuccessful health checks because the VM might
14748 # be in the startup process. This prevents the MIG from prematurely
14749 # recreating a VM. If the health check receives a healthy response during
14750 # the initial delay, it indicates that the startup process is complete and
14751 # the VM is ready. The value of initial delay must be between 0 and 3600
14752 # seconds. The default value is 0.
14753 },
14754 ],
14755 &quot;baseInstanceName&quot;: &quot;A String&quot;, # The base instance name is a prefix that you want to attach to the names of
14756 # all VMs in a MIG. The maximum character length is 58 and the name must
14757 # comply with RFC1035 format.
14758 #
14759 # When a VM is created in the group, the MIG appends a hyphen and a random
14760 # four-character string to the base instance name. If you want the MIG to
14761 # assign sequential numbers instead of a random string, then end the base
14762 # instance name with a hyphen followed by one or more hash symbols. The hash
14763 # symbols indicate the number of digits. For example, a base instance name of
14764 # &quot;vm-###&quot; results in &quot;vm-001&quot; as a VM name.
14765 # @pattern
14766 # [a-z](([-a-z0-9]{0,57})|([-a-z0-9]{0,51}-#{1,10}(\\[[0-9]{1,10}\\])?))
14767 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this managed instance group inRFC3339
14768 # text format.
14769 &quot;currentActions&quot;: { # Output only. The list of instance actions and the number of instances
14770 # in this managed instance group that are scheduled for each of those
14771 # actions.
14772 &quot;abandoning&quot;: 42, # Output only. The total number of instances in the managed instance group
14773 # that are scheduled to be abandoned. Abandoning an instance removes it
14774 # from the managed instance group without deleting it.
14775 &quot;adopting&quot;: 42, # Output only. The number of instances in the managed instance group that
14776 # are scheduled to be adopted or are currently being adopted.
14777 &quot;creating&quot;: 42, # Output only. The number of instances in the managed instance group that
14778 # are scheduled to be created or are currently being created. If the group
14779 # fails to create any of these instances, it tries again until it creates
14780 # the instance successfully.
14781 #
14782 # If you have disabled creation retries, this field will not be populated;
14783 # instead, the creatingWithoutRetries field will be populated.
14784 &quot;creatingWithoutRetries&quot;: 42, # Output only. The number of instances that the managed instance group
14785 # will attempt to create. The group attempts to create each instance
14786 # only once. If the group fails to create any of these instances, it
14787 # decreases the group&#x27;s targetSize value accordingly.
14788 &quot;deleting&quot;: 42, # Output only. The number of instances in the managed instance group that
14789 # are scheduled to be deleted or are currently being deleted.
14790 &quot;none&quot;: 42, # Output only. The number of instances in the managed instance group that
14791 # are running and have no scheduled actions.
14792 &quot;recreating&quot;: 42, # Output only. The number of instances in the managed instance group that
14793 # are scheduled to be recreated or are currently being being recreated.
14794 # Recreating an instance deletes the existing root persistent disk
14795 # and creates a new disk from the image that is defined in the
14796 # instance template.
14797 &quot;refreshing&quot;: 42, # Output only. The number of instances in the managed instance group that
14798 # are being reconfigured with properties that do not require a restart
14799 # or a recreate action. For example, setting or removing target
14800 # pools for the instance.
14801 &quot;restarting&quot;: 42, # Output only. The number of instances in the managed instance group that
14802 # are scheduled to be restarted or are currently being restarted.
14803 &quot;restartingInPlace&quot;: 42, # Output only. The number of instances in the managed instance group that
14804 # are scheduled to be restarted or are currently being restarted.
14805 &quot;resuming&quot;: 42, # Output only. The number of instances in the managed instance group that
14806 # are scheduled to be resumed or are currently being resumed.
14807 &quot;starting&quot;: 42, # Output only. The number of instances in the managed instance group that
14808 # are scheduled to be started or are currently being started.
14809 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group that
14810 # are scheduled to be stopped or are currently being stopped.
14811 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group that
14812 # are scheduled to be suspended or are currently being suspended.
14813 &quot;verifying&quot;: 42, # Output only. The number of instances in the managed instance group that
14814 # are being verified. See the managedInstances[].currentAction
14815 # property in the listManagedInstances method documentation.
14816 },
14817 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
14818 &quot;distributionPolicy&quot;: { # Policy specifying the intended distribution of managed instances across
14819 # zones in a regional managed instance group.
14820 &quot;targetShape&quot;: &quot;A String&quot;, # The distribution shape to which the group converges either proactively or
14821 # on resize events (depending on the value set inupdatePolicy.instanceRedistributionType).
14822 &quot;zones&quot;: [ # Zones where the regional managed instance group will create and manage
14823 # its instances.
14824 # By default, a regional MIG doesn&#x27;t automatically select an AI zone to create
14825 # instances, even if an AI zone is available in the specified region. To
14826 # create instances in an AI zone in the selected region, you must explicitly
14827 # specify it in the distribution policy together with the other preferred
14828 # zones.
14829 {
14830 &quot;zone&quot;: &quot;A String&quot;, # The URL of thezone.
14831 # The zone must exist in the region where the managed instance group is
14832 # located.
14833 },
14834 ],
14835 },
14836 &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.
14837 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this resource. This field may be used in optimistic locking.
14838 # It will be ignored when inserting an InstanceGroupManager. An up-to-date
14839 # fingerprint must be provided in order to update the InstanceGroupManager,
14840 # otherwise the request will fail with error412 conditionNotMet.
14841 #
14842 # To see the latest fingerprint, make a get() request to
14843 # retrieve an InstanceGroupManager.
14844 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server
14845 # generates this identifier.
14846 &quot;instanceFlexibilityPolicy&quot;: { # Instance flexibility allowing MIG to create VMs from multiple
14847 # types of machines.
14848 # Instance flexibility configuration on MIG overrides instance
14849 # template configuration.
14850 &quot;instanceSelections&quot;: { # Named instance selections configuring properties that the group will use
14851 # when creating new VMs.
14852 &quot;a_key&quot;: {
14853 &quot;disks&quot;: [ # List of disks to be attached to the instances created from this
14854 # selection.
14855 { # An instance-attached disk resource.
14856 &quot;architecture&quot;: &quot;A String&quot;, # Output only. [Output Only] The architecture of the attached disk. Valid values are ARM64
14857 # or X86_64.
14858 &quot;autoDelete&quot;: True or False, # Specifies whether the disk will be auto-deleted when the instance is
14859 # deleted (but not when the disk is detached from the instance).
14860 &quot;boot&quot;: True or False, # Indicates that this is a boot disk. The virtual machine will use the first
14861 # partition of the disk for its root filesystem.
14862 &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
14863 # running within the instance. This name can be used to reference the device
14864 # for mounting, resizing, and so on, from within the instance.
14865 #
14866 # If not specified, the server chooses a default device name to apply to this
14867 # disk, in the form persistent-disk-x, where x is a number
14868 # assigned by Google Compute Engine. This field is only applicable for
14869 # persistent disks.
14870 &quot;diskEncryptionKey&quot;: { # Encrypts or decrypts a disk using acustomer-supplied
14871 # encryption key.
14872 #
14873 # If you are creating a new disk, this field encrypts the new disk using
14874 # an encryption key that you provide. If you are attaching an existing
14875 # disk that is already encrypted, this field decrypts the disk using
14876 # the customer-supplied encryption key.
14877 #
14878 # If you encrypt a disk using a customer-supplied key, you must provide the
14879 # same key again when you attempt to use this resource at a later time. For
14880 # example, you must provide the key when you create a snapshot or an image
14881 # from the disk or when you attach the disk to a virtual machine instance.
14882 #
14883 # If you do not provide an encryption key, then the disk will be encrypted
14884 # using an automatically generated key and you do not need to provide a key
14885 # to use the disk later.
14886 #
14887 # Note:
14888 #
14889 # Instance templates do not storecustomer-supplied
14890 # encryption keys, so you cannot use your own keys to encrypt disks in amanaged instance group.
14891 #
14892 # You cannot create VMs that have disks with customer-supplied keys using
14893 # the bulk
14894 # insert method.
14895 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
14896 # For example:
14897 #
14898 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
14899 # key_region/cryptoKeys/key
14900 #
14901 # The fully-qualifed key name may be returned for resource GET requests. For
14902 # example:
14903 #
14904 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
14905 # key_region/cryptoKeys/key
14906 # /cryptoKeyVersions/1
14907 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
14908 # key. If absent, the Compute Engine default service account is used.
14909 # For example:
14910 #
14911 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
14912 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
14913 # encryption key, encoded in RFC
14914 # 4648 base64 to either encrypt or decrypt this resource. You can
14915 # provide either the rawKey or thersaEncryptedKey.
14916 # For example:
14917 #
14918 # &quot;rawKey&quot;:
14919 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
14920 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
14921 # customer-supplied encryption key to either encrypt or decrypt this
14922 # resource. You can provide either the rawKey or thersaEncryptedKey.
14923 # For example:
14924 #
14925 # &quot;rsaEncryptedKey&quot;:
14926 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
14927 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
14928 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
14929 #
14930 # The key must meet the following requirements before you can provide it to
14931 # Compute Engine:
14932 #
14933 # 1. The key is wrapped using a RSA public key certificate provided by
14934 # Google.
14935 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
14936 # encoding.
14937 #
14938 # Gets the RSA public key certificate provided by Google at:
14939 #
14940 #
14941 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
14942 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
14943 # 4648 base64 encoded SHA-256 hash of the customer-supplied
14944 # encryption key that protects this resource.
14945 },
14946 &quot;diskSizeGb&quot;: &quot;A String&quot;, # The size of the disk in GB.
14947 &quot;forceAttach&quot;: True or False, # [Input Only] Whether to force attach the regional disk even if it&#x27;s
14948 # currently attached to another instance. If you try to force attach a zonal
14949 # disk to an instance, you will receive an error.
14950 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
14951 # only for bootable images. Read
14952 # Enabling guest operating system features to see a list of available
14953 # options.
14954 { # Guest OS features.
14955 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
14956 # separate values. Set to one or more of the following values:
14957 #
14958 # - VIRTIO_SCSI_MULTIQUEUE
14959 # - WINDOWS
14960 # - MULTI_IP_SUBNET
14961 # - UEFI_COMPATIBLE
14962 # - GVNIC
14963 # - SEV_CAPABLE
14964 # - SUSPEND_RESUME_COMPATIBLE
14965 # - SEV_LIVE_MIGRATABLE_V2
14966 # - SEV_SNP_CAPABLE
14967 # - TDX_CAPABLE
14968 # - IDPF
14969 # - SNP_SVSM_CAPABLE
14970 # - CCA_CAPABLE
14971 #
14972 #
14973 # For more information, see
14974 # Enabling guest operating system features.
14975 },
14976 ],
14977 &quot;index&quot;: 42, # Output only. [Output Only] A zero-based index to this disk, where 0 is reserved for the
14978 # boot disk. If you have many disks attached to an instance, each
14979 # disk would have a unique index number.
14980 &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
14981 # alongside the new instance. Use initialization parameters to create boot
14982 # disks or local SSDs attached to the new instance.
14983 #
14984 # This property is mutually exclusive with the source property;
14985 # you can only define one or the other, but not both.
14986 # alongside the new instance. Use initialization parameters to create boot
14987 # disks or local SSDs attached to the new instance.
14988 #
14989 # This field is persisted and returned for instanceTemplate and not returned
14990 # in the context of instance.
14991 #
14992 # This property is mutually exclusive with the source property;
14993 # you can only define one or the other, but not both.
14994 &quot;architecture&quot;: &quot;A String&quot;, # The architecture of the attached disk. Valid values are
14995 # arm64 or x86_64.
14996 &quot;description&quot;: &quot;A String&quot;, # An optional description. Provide this property when creating the disk.
14997 &quot;diskName&quot;: &quot;A String&quot;, # Specifies the disk name. If not specified, the default is to use the name
14998 # of the instance. If a disk with the same name already exists in the given
14999 # region, the existing disk is attached to the new instance and the
15000 # new disk is not created.
15001 &quot;diskSizeGb&quot;: &quot;A String&quot;, # Specifies the size of the disk in base-2 GB. The size must be at least
15002 # 10 GB. If you specify a sourceImage, which is required for
15003 # boot disks, the default size is the size of the sourceImage.
15004 # If you do not specify a sourceImage, the default disk size
15005 # is 500 GB.
15006 &quot;diskType&quot;: &quot;A String&quot;,
15007 &quot;enableConfidentialCompute&quot;: True or False, # Whether this disk is using confidential compute mode.
15008 &quot;guestOsFeatures&quot;: [ # A list of features to enable on the guest operating system. Applicable
15009 # only for bootable images. Read
15010 # Enabling guest operating system features to see a list of available
15011 # options.
15012 #
15013 # Guest OS features are applied by merginginitializeParams.guestOsFeatures anddisks.guestOsFeatures
15014 { # Guest OS features.
15015 &quot;type&quot;: &quot;A String&quot;, # The ID of a supported feature. To add multiple values, use commas to
15016 # separate values. Set to one or more of the following values:
15017 #
15018 # - VIRTIO_SCSI_MULTIQUEUE
15019 # - WINDOWS
15020 # - MULTI_IP_SUBNET
15021 # - UEFI_COMPATIBLE
15022 # - GVNIC
15023 # - SEV_CAPABLE
15024 # - SUSPEND_RESUME_COMPATIBLE
15025 # - SEV_LIVE_MIGRATABLE_V2
15026 # - SEV_SNP_CAPABLE
15027 # - TDX_CAPABLE
15028 # - IDPF
15029 # - SNP_SVSM_CAPABLE
15030 # - CCA_CAPABLE
15031 #
15032 #
15033 # For more information, see
15034 # Enabling guest operating system features.
15035 },
15036 ],
15037 &quot;labels&quot;: { # Labels to apply to this disk. These can be later modified by thedisks.setLabels method. This field is only applicable for
15038 # persistent disks.
15039 &quot;a_key&quot;: &quot;A String&quot;,
15040 },
15041 &quot;licenses&quot;: [ # A list of publicly visible licenses. Reserved for Google&#x27;s use.
15042 &quot;A String&quot;,
15043 ],
15044 &quot;multiWriter&quot;: True or False, # Indicates whether or not the disk can be read/write attached to
15045 # more than one instance.
15046 &quot;onUpdateAction&quot;: &quot;A String&quot;, # Specifies which action to take on instance update with this disk. Default
15047 # is to use the existing disk.
15048 &quot;provisionedIops&quot;: &quot;A String&quot;, # Indicates how many IOPS to provision for the disk. This sets the number
15049 # of I/O operations per second that the disk can handle. Values must be
15050 # between 10,000 and 120,000. For more details, see theExtreme persistent
15051 # disk documentation.
15052 &quot;provisionedThroughput&quot;: &quot;A String&quot;, # Indicates how much throughput to provision for the disk. This sets the
15053 # number of throughput mb per second that the disk can handle. Values must
15054 # greater than or equal to 1.
15055 &quot;replicaZones&quot;: [ # Required for each regional disk associated with the instance. Specify
15056 # the URLs of the zones where the disk should be replicated to.
15057 # You must provide exactly two replica zones, and one zone must be the same
15058 # as the instance zone.
15059 &quot;A String&quot;,
15060 ],
15061 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to be bound to the disk. Tag keys and values
15062 # have the same definition as resource
15063 # manager tags. Keys and values can be either in numeric format,
15064 # such as `tagKeys/{tag_key_id}` and `tagValues/{tag_value_id}` or in
15065 # namespaced format such as `{org_id|project_id}/{tag_key_short_name}` and
15066 # `{tag_value_short_name}`. The field is ignored (both PUT &amp; PATCH) when
15067 # empty.
15068 &quot;a_key&quot;: &quot;A String&quot;,
15069 },
15070 &quot;resourcePolicies&quot;: [ # Resource policies applied to this disk for automatic snapshot creations.
15071 # Specified using the full or partial URL. For instance template, specify
15072 # only the resource policy name.
15073 &quot;A String&quot;,
15074 ],
15075 &quot;sourceImage&quot;: &quot;A String&quot;, # The source image to create this disk. When creating a new instance boot
15076 # disk, one of initializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
15077 # is required.
15078 #
15079 # To create a disk with one of the public operating system
15080 # images, specify the image by its family name. For example, specifyfamily/debian-9 to use the latest Debian 9 image:
15081 #
15082 # projects/debian-cloud/global/images/family/debian-9
15083 #
15084 #
15085 # Alternatively, use a specific version of a public operating system image:
15086 #
15087 # projects/debian-cloud/global/images/debian-9-stretch-vYYYYMMDD
15088 #
15089 #
15090 # To create a disk with a custom image that you created, specify the
15091 # image name in the following format:
15092 #
15093 # global/images/my-custom-image
15094 #
15095 #
15096 # You can also specify a custom image by its image family, which returns
15097 # the latest version of the image in that family. Replace the image name
15098 # with family/family-name:
15099 #
15100 # global/images/family/my-image-family
15101 #
15102 #
15103 # If the source image is deleted later, this field will not be set.
15104 &quot;sourceImageEncryptionKey&quot;: { # Thecustomer-supplied
15105 # encryption key of the source image. Required if the source image is
15106 # protected by a customer-supplied encryption key.
15107 #
15108 # InstanceTemplate and InstancePropertiesPatch do not storecustomer-supplied
15109 # encryption keys, so you cannot create disks for instances in a managed instance group if the
15110 # source images are encrypted with your own keys.
15111 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
15112 # For example:
15113 #
15114 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
15115 # key_region/cryptoKeys/key
15116 #
15117 # The fully-qualifed key name may be returned for resource GET requests. For
15118 # example:
15119 #
15120 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
15121 # key_region/cryptoKeys/key
15122 # /cryptoKeyVersions/1
15123 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
15124 # key. If absent, the Compute Engine default service account is used.
15125 # For example:
15126 #
15127 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
15128 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
15129 # encryption key, encoded in RFC
15130 # 4648 base64 to either encrypt or decrypt this resource. You can
15131 # provide either the rawKey or thersaEncryptedKey.
15132 # For example:
15133 #
15134 # &quot;rawKey&quot;:
15135 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
15136 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
15137 # customer-supplied encryption key to either encrypt or decrypt this
15138 # resource. You can provide either the rawKey or thersaEncryptedKey.
15139 # For example:
15140 #
15141 # &quot;rsaEncryptedKey&quot;:
15142 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
15143 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
15144 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
15145 #
15146 # The key must meet the following requirements before you can provide it to
15147 # Compute Engine:
15148 #
15149 # 1. The key is wrapped using a RSA public key certificate provided by
15150 # Google.
15151 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
15152 # encoding.
15153 #
15154 # Gets the RSA public key certificate provided by Google at:
15155 #
15156 #
15157 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
15158 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
15159 # 4648 base64 encoded SHA-256 hash of the customer-supplied
15160 # encryption key that protects this resource.
15161 },
15162 &quot;sourceInstantSnapshot&quot;: &quot;A String&quot;, # The source instant-snapshot to create this disk. When creating a new
15163 # instance boot disk, one of initializeParams.sourceSnapshot
15164 # or initializeParams.sourceInstantSnapshotinitializeParams.sourceImage or disks.source
15165 # is required.
15166 #
15167 # To create a disk with a snapshot that you created, specify the
15168 # snapshot name in the following format:
15169 #
15170 # us-central1-a/instantSnapshots/my-backup
15171 #
15172 #
15173 # If the source instant-snapshot is deleted later, this field will not be
15174 # set.
15175 &quot;sourceSnapshot&quot;: &quot;A String&quot;, # The source snapshot to create this disk. When creating a new instance
15176 # boot disk, one of initializeParams.sourceSnapshot orinitializeParams.sourceImage or disks.source
15177 # is required.
15178 #
15179 # To create a disk with a snapshot that you created, specify the
15180 # snapshot name in the following format:
15181 #
15182 # global/snapshots/my-backup
15183 #
15184 #
15185 # If the source snapshot is deleted later, this field will not be set.
15186 #
15187 # Note: You cannot create VMs in bulk using a snapshot as the source. Use
15188 # an image instead when you create VMs using
15189 # the bulk
15190 # insert method.
15191 &quot;sourceSnapshotEncryptionKey&quot;: { # Thecustomer-supplied
15192 # encryption key of the source snapshot.
15193 &quot;kmsKeyName&quot;: &quot;A String&quot;, # The name of the encryption key that is stored in Google Cloud KMS.
15194 # For example:
15195 #
15196 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
15197 # key_region/cryptoKeys/key
15198 #
15199 # The fully-qualifed key name may be returned for resource GET requests. For
15200 # example:
15201 #
15202 # &quot;kmsKeyName&quot;: &quot;projects/kms_project_id/locations/region/keyRings/
15203 # key_region/cryptoKeys/key
15204 # /cryptoKeyVersions/1
15205 &quot;kmsKeyServiceAccount&quot;: &quot;A String&quot;, # The service account being used for the encryption request for the given KMS
15206 # key. If absent, the Compute Engine default service account is used.
15207 # For example:
15208 #
15209 # &quot;kmsKeyServiceAccount&quot;: &quot;name@project_id.iam.gserviceaccount.com/
15210 &quot;rawKey&quot;: &quot;A String&quot;, # Specifies a 256-bit customer-supplied
15211 # encryption key, encoded in RFC
15212 # 4648 base64 to either encrypt or decrypt this resource. You can
15213 # provide either the rawKey or thersaEncryptedKey.
15214 # For example:
15215 #
15216 # &quot;rawKey&quot;:
15217 # &quot;SGVsbG8gZnJvbSBHb29nbGUgQ2xvdWQgUGxhdGZvcm0=&quot;
15218 &quot;rsaEncryptedKey&quot;: &quot;A String&quot;, # Specifies an RFC 4648 base64 encoded, RSA-wrapped 2048-bit
15219 # customer-supplied encryption key to either encrypt or decrypt this
15220 # resource. You can provide either the rawKey or thersaEncryptedKey.
15221 # For example:
15222 #
15223 # &quot;rsaEncryptedKey&quot;:
15224 # &quot;ieCx/NcW06PcT7Ep1X6LUTc/hLvUDYyzSZPPVCVPTVEohpeHASqC8uw5TzyO9U+Fka9JFH
15225 # z0mBibXUInrC/jEk014kCK/NPjYgEMOyssZ4ZINPKxlUh2zn1bV+MCaTICrdmuSBTWlUUiFoD
15226 # D6PYznLwh8ZNdaheCeZ8ewEXgFQ8V+sDroLaN3Xs3MDTXQEMMoNUXMCZEIpg9Vtp9x2oe==&quot;
15227 #
15228 # The key must meet the following requirements before you can provide it to
15229 # Compute Engine:
15230 #
15231 # 1. The key is wrapped using a RSA public key certificate provided by
15232 # Google.
15233 # 2. After being wrapped, the key must be encoded in RFC 4648 base64
15234 # encoding.
15235 #
15236 # Gets the RSA public key certificate provided by Google at:
15237 #
15238 #
15239 # https://cloud-certs.storage.googleapis.com/google-cloud-csek-ingress.pem
15240 &quot;sha256&quot;: &quot;A String&quot;, # [Output only] TheRFC
15241 # 4648 base64 encoded SHA-256 hash of the customer-supplied
15242 # encryption key that protects this resource.
15243 },
15244 &quot;storagePool&quot;: &quot;A String&quot;, # The storage pool in which the new disk is created. You can provide
15245 # this as a partial or full URL to the resource. For example, the following
15246 # are valid values:
15247 #
15248 #
15249 # - https://www.googleapis.com/compute/v1/projects/project/zones/zone/storagePools/storagePool
15250 # - projects/project/zones/zone/storagePools/storagePool
15251 # - zones/zone/storagePools/storagePool
15252 },
15253 &quot;interface&quot;: &quot;A String&quot;, # Specifies the disk interface to use for attaching this disk, which is
15254 # either SCSI or NVME. For most machine types, the
15255 # default is SCSI. Local SSDs can use either NVME or SCSI.
15256 # In certain configurations, persistent disks can use NVMe. For more
15257 # information, seeAbout
15258 # persistent disks.
15259 &quot;kind&quot;: &quot;compute#attachedDisk&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#attachedDisk for attached disks.
15260 &quot;licenses&quot;: [ # Output only. [Output Only] Any valid publicly visible licenses.
15261 &quot;A String&quot;,
15262 ],
15263 &quot;locked&quot;: True or False, # Output only. [Output Only] Whether to indicate the attached disk is locked. The locked
15264 # disk is not allowed to be detached from the instance, or to be used as the
15265 # source of the snapshot creation, and the image creation. The instance with
15266 # at least one locked attached disk is not allow to be used as source of
15267 # machine image creation, instant snapshot creation, and not allowed to be
15268 # deleted with --keep-disk parameter set to true for locked disks.
15269 &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
15270 # in READ_WRITE mode.
15271 &quot;savedState&quot;: &quot;A String&quot;, # Output only. For LocalSSD disks on VM Instances in STOPPED or SUSPENDED state, this
15272 # field is set to PRESERVED if the LocalSSD data has been saved
15273 # to a persistent location by customer request. (see the
15274 # discard_local_ssd option on Stop/Suspend).
15275 # Read-only in the api.
15276 &quot;shieldedInstanceInitialState&quot;: { # Initial State for shielded instance, # Output only. [Output Only] shielded vm initial state stored on disk
15277 # these are public keys which are safe to store in public
15278 &quot;dbs&quot;: [ # The Key Database (db).
15279 {
15280 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
15281 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
15282 },
15283 ],
15284 &quot;dbxs&quot;: [ # The forbidden key database (dbx).
15285 {
15286 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
15287 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
15288 },
15289 ],
15290 &quot;keks&quot;: [ # The Key Exchange Key (KEK).
15291 {
15292 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
15293 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
15294 },
15295 ],
15296 &quot;pk&quot;: { # The Platform Key (PK).
15297 &quot;content&quot;: &quot;A String&quot;, # The raw content in the secure keys file.
15298 &quot;fileType&quot;: &quot;A String&quot;, # The file type of source file.
15299 },
15300 },
15301 &quot;source&quot;: &quot;A String&quot;, # Specifies a valid partial or full URL to an existing Persistent Disk
15302 # resource. When creating a new instance boot disk, one ofinitializeParams.sourceImage orinitializeParams.sourceSnapshot or disks.source
15303 # is required.
15304 #
15305 # If desired, you can also attach existing non-root persistent disks using
15306 # this property. This field is only applicable for persistent disks.
15307 #
15308 # Note that for InstanceTemplate, specify the disk name for zonal disk,
15309 # and the URL for regional disk.
15310 &quot;type&quot;: &quot;A String&quot;, # Specifies the type of the disk, either SCRATCH orPERSISTENT. If not specified, the default isPERSISTENT.
15311 },
15312 ],
15313 &quot;machineTypes&quot;: [ # Full machine-type names, e.g. &quot;n1-standard-16&quot;.
15314 &quot;A String&quot;,
15315 ],
15316 &quot;minCpuPlatform&quot;: &quot;A String&quot;, # Name of the minimum CPU platform to be used by this instance selection.
15317 # e.g. &#x27;Intel Ice Lake&#x27;.
15318 &quot;rank&quot;: 42, # Preference of this instance selection. Lower number means higher
15319 # preference. MIG will first try to create a VM based on the machine-type
15320 # with lowest rank and fallback to next rank based on availability.
15321 # Machine types and instance selections with the same rank have the same
15322 # preference.
15323 },
15324 },
15325 &quot;provisioningModelMix&quot;: { # Provisioning model configuration used by this managed instance group to
15326 # create instances.
15327 &quot;standardCapacityBase&quot;: 42, # The base capacity that will always use Standard VMs to avoid risk of
15328 # more preemption than the minimum capacity user needs. MIG will create
15329 # only Standard VMs until it reaches standard_capacity_base and only
15330 # then will start using standard_capacity_percent_above_base to mix Spot
15331 # with Standard VMs.
15332 &quot;standardCapacityPercentAboveBase&quot;: 42, # The percentage of target capacity that should use Standard VM. The
15333 # remaining percentage will use Spot VMs. The percentage applies only to
15334 # the capacity above standard_capacity_base.
15335 },
15336 },
15337 &quot;instanceGroup&quot;: &quot;A String&quot;, # Output only. The URL of the Instance Group resource.
15338 &quot;instanceLifecyclePolicy&quot;: { # The repair policy for this managed instance group.
15339 &quot;defaultActionOnFailure&quot;: &quot;A String&quot;, # The action that a MIG performs on a failed VM. If the value of the
15340 # onFailedHealthCheck field is `DEFAULT_ACTION`, then the same action also
15341 # applies to the VMs on which your application fails a health check.
15342 # Valid values are
15343 #
15344 # - REPAIR (default): MIG automatically repairs a failed VM
15345 # by recreating it. For more information, see About
15346 # repairing VMs in a MIG.
15347 # - DO_NOTHING: MIG does not repair a failed VM.
15348 &quot;forceUpdateOnRepair&quot;: &quot;A String&quot;, # A bit indicating whether to forcefully apply the group&#x27;s latest
15349 # configuration when repairing a VM. Valid options are:
15350 #
15351 #
15352 #
15353 # - NO (default): If configuration updates are available, they are not
15354 # forcefully applied during repair. Instead, configuration updates are
15355 # applied according to the group&#x27;s update policy.
15356 #
15357 # - YES: If configuration updates are available, they are applied
15358 # during repair.
15359 &quot;onFailedHealthCheck&quot;: &quot;A String&quot;, # The action that a MIG performs on an unhealthy VM. A VM is marked as
15360 # unhealthy when the application running on that VM fails a health check.
15361 # Valid values are:
15362 #
15363 # - DEFAULT_ACTION (default): MIG uses the same action
15364 # configured for instanceLifecyclePolicy.defaultActionOnFailure field.
15365 # - REPAIR: MIG automatically repairs an unhealthy VM by
15366 # recreating it.
15367 # - DO_NOTHING: MIG doesn&#x27;t repair an unhealthy VM.
15368 # For more information, see
15369 # About repairing VMs in a MIG.
15370 &quot;onRepair&quot;: { # Configuration for VM repairs in the MIG. # Configuration for VM repairs in the MIG.
15371 &quot;allowChangingZone&quot;: &quot;A String&quot;, # Specifies whether the MIG can change a VM&#x27;s zone during a repair.
15372 # Valid values are:
15373 #
15374 # - NO (default): MIG cannot change a VM&#x27;s zone during a
15375 # repair.
15376 # - YES: MIG can select a different zone for the VM during
15377 # a repair.
15378 },
15379 },
15380 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
15381 # instance group. The group uses this template to create all new instances
15382 # in the managed instance group. The templates for existing instances in the
15383 # group do not change unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE.
15384 &quot;kind&quot;: &quot;compute#instanceGroupManager&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManager for managed instance groups.
15385 &quot;listManagedInstancesResults&quot;: &quot;A String&quot;, # Pagination behavior of the listManagedInstances API method for
15386 # this managed instance group.
15387 &quot;multiMig&quot;: &quot;A String&quot;, # URL to the multi-MIG that this Managed Instance Group belongs to.
15388 &quot;name&quot;: &quot;A String&quot;, # The name of the managed instance group. The name must be 1-63 characters
15389 # long, and comply withRFC1035.
15390 &quot;namedPorts&quot;: [ # [Output Only] Named ports configured on the Instance Groups complementary
15391 # to this Instance Group Manager.
15392 { # The named port. For example: &lt;&quot;http&quot;, 80&gt;.
15393 &quot;name&quot;: &quot;A String&quot;, # The name for this named port.
15394 # The name must be 1-63 characters long, and comply withRFC1035.
15395 &quot;port&quot;: 42, # The port number, which can be a value between 1 and 65535.
15396 },
15397 ],
15398 &quot;params&quot;: { # Input only additional params for instance group manager creation. # Input only. Additional params passed with the request, but not persisted
15399 # as part of resource payload.
15400 &quot;resourceManagerTags&quot;: { # Input only. Resource manager tags to bind to the managed instance group. The tags are
15401 # key-value pairs. Keys and values can be either in numeric format,
15402 # such as `tagKeys/{tag_key_id}` and `tagValues/456` or in namespaced
15403 # format such as `{org_id|project_id}/{tag_key_short_name}` and
15404 # `{tag_value_short_name}`. For more information, seeManage tags
15405 # for resources.
15406 &quot;a_key&quot;: &quot;A String&quot;,
15407 },
15408 },
15409 &quot;region&quot;: &quot;A String&quot;, # Output only. [Output Only] The URL of theregion
15410 # where the managed instance group resides (for regional resources).
15411 &quot;resourcePolicies&quot;: { # Resource policies for this managed instance group.
15412 &quot;workloadPolicy&quot;: &quot;A String&quot;, # The URL of the workload policy that is specified for this managed
15413 # instance group.
15414 # It can be a full or partial URL. For example, the following are
15415 # all valid URLs to a workload policy:
15416 #
15417 #
15418 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/resourcePolicies/resourcePolicy
15419 # - projects/project/regions/region/resourcePolicies/resourcePolicy
15420 # - regions/region/resourcePolicies/resourcePolicy
15421 },
15422 &quot;satisfiesPzi&quot;: True or False, # Output only. Reserved for future use.
15423 &quot;satisfiesPzs&quot;: True or False, # Output only. Reserved for future use.
15424 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this managed instance group. The server defines
15425 # this URL.
15426 &quot;serviceAccount&quot;: &quot;A String&quot;, # The service account to be used as credentials for all operations performed
15427 # by the managed instance group on instances. The service accounts needs all
15428 # permissions required to create and delete instances.
15429 # By default, the service account
15430 # {projectNumber}@cloudservices.gserviceaccount.com is used.
15431 &quot;standbyPolicy&quot;: { # Standby policy for stopped and suspended instances.
15432 &quot;initialDelaySec&quot;: 42, # Specifies the number of seconds that the MIG should wait to suspend or
15433 # stop a VM after that VM was created. The initial delay gives the
15434 # initialization script the time to prepare your VM for a quick scale out.
15435 # The value of initial delay must be between 0 and 3600 seconds. The
15436 # default value is 0.
15437 &quot;mode&quot;: &quot;A String&quot;, # Defines how a MIG resumes or starts VMs from a standby pool when the
15438 # group scales out. The default mode is `MANUAL`.
15439 },
15440 &quot;statefulPolicy&quot;: { # Stateful configuration for this Instanced Group Manager
15441 &quot;preservedState&quot;: { # Configuration of preserved resources.
15442 &quot;disks&quot;: { # Disks created on the instances that will be preserved on instance
15443 # delete, update, etc. This map is keyed with the device names of
15444 # the disks.
15445 &quot;a_key&quot;: {
15446 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
15447 # update or VM instance recreate operations.
15448 # This flag is used to configure if the disk should be deleted after it
15449 # is no longer used by the group, e.g. when the given instance or
15450 # the whole group is deleted. Note: disks attached inREAD_ONLY mode cannot be auto-deleted.
15451 },
15452 },
15453 &quot;externalIPs&quot;: { # External network IPs assigned to the instances that will be preserved on
15454 # instance delete, update, etc. This map is keyed with the network
15455 # interface name.
15456 &quot;a_key&quot;: {
15457 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
15458 # update or VM instance recreate operations.
15459 # This flag is used to configure if the IP reservation should be deleted
15460 # after it is no longer used by the group, e.g. when the given instance
15461 # or the whole group is deleted.
15462 },
15463 },
15464 &quot;internalIPs&quot;: { # Internal network IPs assigned to the instances that will be preserved on
15465 # instance delete, update, etc. This map is keyed with the network
15466 # interface name.
15467 &quot;a_key&quot;: {
15468 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
15469 # update or VM instance recreate operations.
15470 # This flag is used to configure if the IP reservation should be deleted
15471 # after it is no longer used by the group, e.g. when the given instance
15472 # or the whole group is deleted.
15473 },
15474 },
15475 },
15476 },
15477 &quot;status&quot;: { # Output only. The status of this managed instance group.
15478 &quot;allInstancesConfig&quot;: { # Output only. Status of all-instances configuration on the group.
15479 &quot;currentRevision&quot;: &quot;A String&quot;, # Output only. Current all-instances configuration revision.
15480 # This value is in RFC3339 text format.
15481 &quot;effective&quot;: True or False, # Output only. A bit indicating whether this configuration has
15482 # been applied to all managed instances in the group.
15483 },
15484 &quot;appliedAcceleratorTopologies&quot;: [ # Output only. The accelerator topology applied to this MIG.
15485 # Currently only one accelerator topology is supported.
15486 {
15487 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # Output only. Topology in the format of: &quot;16x16&quot;, &quot;4x4x4&quot;, etc.
15488 # The value is the same as configured in the WorkloadPolicy.
15489 &quot;state&quot;: &quot;A String&quot;, # Output only. The state of the accelerator topology.
15490 &quot;stateDetails&quot;: { # Output only. The result of the latest accelerator topology state
15491 # check.
15492 &quot;error&quot;: { # Output only. Encountered errors.
15493 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
15494 # operation.
15495 {
15496 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
15497 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
15498 # details. There is a set of defined message types to use for providing
15499 # details.The syntax depends on the error code. For example,
15500 # QuotaExceededInfo will have details when the error code is
15501 # QUOTA_EXCEEDED.
15502 {
15503 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
15504 #
15505 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
15506 # is not enabled:
15507 #
15508 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
15509 # &quot;domain&quot;: &quot;googleapis.com&quot;
15510 # &quot;metadata&quot;: {
15511 # &quot;resource&quot;: &quot;projects/123&quot;,
15512 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
15513 # }
15514 # }
15515 #
15516 # This response indicates that the pubsub.googleapis.com API is not enabled.
15517 #
15518 # Example of an error that is returned when attempting to create a Spanner
15519 # instance in a region that is out of stock:
15520 #
15521 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
15522 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
15523 # &quot;metadata&quot;: {
15524 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
15525 # }
15526 # }
15527 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
15528 # is typically the registered service name of the tool or product that
15529 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
15530 # generated by some common infrastructure, the error domain must be a
15531 # globally unique value that identifies the infrastructure. For Google API
15532 # infrastructure, the error domain is &quot;googleapis.com&quot;.
15533 &quot;metadatas&quot;: { # Additional structured details about this error.
15534 #
15535 # Keys must match a regular expression of `a-z+` but should
15536 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
15537 # length. When identifying the current value of an exceeded limit, the units
15538 # should be contained in the key, not the value. For example, rather than
15539 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
15540 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
15541 # instances that can be created in a single (batch) request.
15542 &quot;a_key&quot;: &quot;A String&quot;,
15543 },
15544 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
15545 # proximate cause of the error. Error reasons are unique within a particular
15546 # domain of errors. This should be at most 63 characters and match a
15547 # regular expression of `A-Z+[A-Z0-9]`, which represents
15548 # UPPER_SNAKE_CASE.
15549 },
15550 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
15551 #
15552 # For example, if a quota check failed with an error indicating the calling
15553 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
15554 # directly to the right place in the developer console to flip the bit.
15555 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
15556 { # Describes a URL link.
15557 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
15558 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
15559 },
15560 ],
15561 },
15562 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
15563 # which can be attached to an RPC error.
15564 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
15565 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
15566 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
15567 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
15568 },
15569 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
15570 &quot;dimensions&quot;: { # The map holding related quota dimensions.
15571 &quot;a_key&quot;: &quot;A String&quot;,
15572 },
15573 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
15574 # type or metric.
15575 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
15576 # or metric.
15577 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
15578 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
15579 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
15580 },
15581 },
15582 ],
15583 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
15584 # This property is optional.
15585 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
15586 },
15587 ],
15588 },
15589 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp is shown only if there is an error. The field
15590 # has // RFC3339 //
15591 # text format.
15592 },
15593 },
15594 ],
15595 &quot;autoscaler&quot;: &quot;A String&quot;, # Output only. The URL of theAutoscaler
15596 # that targets this instance group manager.
15597 &quot;bulkInstanceOperation&quot;: { # Bulk instance operation is the creation of VMs in a MIG when the # Output only. The status of bulk instance operation.
15598 # targetSizePolicy.mode is set to BULK.
15599 &quot;inProgress&quot;: True or False, # Output only. Informs whether bulk instance operation is in progress.
15600 &quot;lastProgressCheck&quot;: { # Output only. Information from the last progress check of bulk instance
15601 # operation.
15602 &quot;error&quot;: { # Output only. Errors encountered during bulk instance operation.
15603 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
15604 # operation.
15605 {
15606 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
15607 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
15608 # details. There is a set of defined message types to use for providing
15609 # details.The syntax depends on the error code. For example,
15610 # QuotaExceededInfo will have details when the error code is
15611 # QUOTA_EXCEEDED.
15612 {
15613 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
15614 #
15615 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
15616 # is not enabled:
15617 #
15618 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
15619 # &quot;domain&quot;: &quot;googleapis.com&quot;
15620 # &quot;metadata&quot;: {
15621 # &quot;resource&quot;: &quot;projects/123&quot;,
15622 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
15623 # }
15624 # }
15625 #
15626 # This response indicates that the pubsub.googleapis.com API is not enabled.
15627 #
15628 # Example of an error that is returned when attempting to create a Spanner
15629 # instance in a region that is out of stock:
15630 #
15631 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
15632 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
15633 # &quot;metadata&quot;: {
15634 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
15635 # }
15636 # }
15637 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
15638 # is typically the registered service name of the tool or product that
15639 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
15640 # generated by some common infrastructure, the error domain must be a
15641 # globally unique value that identifies the infrastructure. For Google API
15642 # infrastructure, the error domain is &quot;googleapis.com&quot;.
15643 &quot;metadatas&quot;: { # Additional structured details about this error.
15644 #
15645 # Keys must match a regular expression of `a-z+` but should
15646 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
15647 # length. When identifying the current value of an exceeded limit, the units
15648 # should be contained in the key, not the value. For example, rather than
15649 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
15650 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
15651 # instances that can be created in a single (batch) request.
15652 &quot;a_key&quot;: &quot;A String&quot;,
15653 },
15654 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
15655 # proximate cause of the error. Error reasons are unique within a particular
15656 # domain of errors. This should be at most 63 characters and match a
15657 # regular expression of `A-Z+[A-Z0-9]`, which represents
15658 # UPPER_SNAKE_CASE.
15659 },
15660 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
15661 #
15662 # For example, if a quota check failed with an error indicating the calling
15663 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
15664 # directly to the right place in the developer console to flip the bit.
15665 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
15666 { # Describes a URL link.
15667 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
15668 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
15669 },
15670 ],
15671 },
15672 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
15673 # which can be attached to an RPC error.
15674 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
15675 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
15676 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
15677 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
15678 },
15679 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
15680 &quot;dimensions&quot;: { # The map holding related quota dimensions.
15681 &quot;a_key&quot;: &quot;A String&quot;,
15682 },
15683 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
15684 # type or metric.
15685 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
15686 # or metric.
15687 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
15688 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
15689 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
15690 },
15691 },
15692 ],
15693 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
15694 # This property is optional.
15695 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
15696 },
15697 ],
15698 },
15699 &quot;timestamp&quot;: &quot;A String&quot;, # Output only. Timestamp of the last progress check of bulk instance
15700 # operation. Timestamp is in RFC3339 text format.
15701 },
15702 },
15703 &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
15704 # in this managed instance group that have the status. Currently only shown
15705 # for TPU MIGs
15706 # instance group that have the status. For more information about how to
15707 # interpret each status check the instance lifecycle documentation.
15708 # Currently only shown for TPU MIGs.
15709 &quot;deprovisioning&quot;: 42, # Output only. The number of instances in the managed instance group
15710 # that have DEPROVISIONING status.
15711 &quot;nonExistent&quot;: 42, # Output only. The number of instances that have not been created yet or
15712 # have been deleted. Includes only instances that would be shown in the
15713 # listManagedInstances method and not all instances that have been
15714 # deleted in the lifetime of the MIG.
15715 # Does not include FlexStart instances that are waiting for the resources
15716 # availability, they are considered as &#x27;pending&#x27;.
15717 &quot;pending&quot;: 42, # Output only. The number of instances in the managed instance group
15718 # that have PENDING status, that is FlexStart instances that are waiting
15719 # for resources. Instances that do not exist because of the other reasons
15720 # are counted as &#x27;non_existent&#x27;.
15721 &quot;pendingStop&quot;: 42, # Output only. The number of instances in the managed instance group
15722 # that have PENDING_STOP status.
15723 &quot;provisioning&quot;: 42, # Output only. The number of instances in the managed instance group
15724 # that have PROVISIONING status.
15725 &quot;repairing&quot;: 42, # Output only. The number of instances in the managed instance group
15726 # that have REPAIRING status.
15727 &quot;running&quot;: 42, # Output only. The number of instances in the managed instance group
15728 # that have RUNNING status.
15729 &quot;staging&quot;: 42, # Output only. The number of instances in the managed instance group
15730 # that have STAGING status.
15731 &quot;stopped&quot;: 42, # Output only. The number of instances in the managed instance group
15732 # that have STOPPED status.
15733 &quot;stopping&quot;: 42, # Output only. The number of instances in the managed instance group
15734 # that have STOPPING status.
15735 &quot;suspended&quot;: 42, # Output only. The number of instances in the managed instance group
15736 # that have SUSPENDED status.
15737 &quot;suspending&quot;: 42, # Output only. The number of instances in the managed instance group
15738 # that have SUSPENDING status.
15739 &quot;terminated&quot;: 42, # Output only. The number of instances in the managed instance group
15740 # that have TERMINATED status.
15741 },
15742 &quot;isStable&quot;: True or False, # Output only. A bit indicating whether the managed instance group is in a
15743 # stable state. A stable state means that: none of the instances in the
15744 # managed instance group is currently undergoing any type of change (for
15745 # example, creation, restart, or deletion); no future changes are scheduled
15746 # for instances in the managed instance group; and the managed instance
15747 # group itself is not being modified.
15748 &quot;stateful&quot;: { # Output only. Stateful status of the given Instance Group Manager.
15749 &quot;hasStatefulConfig&quot;: True or False, # Output only. A bit indicating whether the managed instance group
15750 # has stateful configuration, that is, if you have configured any items
15751 # in a stateful policy or in per-instance configs.
15752 # The group might report that it has no stateful configuration even when
15753 # there is still some preserved state on a managed instance, for example,
15754 # if you have deleted all PICs but not yet applied those deletions.
15755 &quot;isStateful&quot;: True or False, # Output only. A bit indicating whether the managed instance group
15756 # has stateful configuration, that is, if you have configured any items
15757 # in a stateful policy or in per-instance configs.
15758 # The group might report that it has no stateful configuration even when
15759 # there is still some preserved state on a managed instance, for example,
15760 # if you have deleted all PICs but not yet applied those deletions. This
15761 # field is deprecated in favor of has_stateful_config.
15762 &quot;perInstanceConfigs&quot;: { # Output only. Status of per-instance configurations on the instances.
15763 &quot;allEffective&quot;: True or False, # Output only. A bit indicating if all of the group&#x27;s per-instance configurations
15764 # (listed in the output of a listPerInstanceConfigs API call) have
15765 # status EFFECTIVE or there are no per-instance-configs.
15766 },
15767 },
15768 &quot;versionTarget&quot;: { # Output only. A status of consistency of Instances&#x27; versions with their
15769 # target version specified by version field on Instance Group
15770 # Manager.
15771 &quot;isReached&quot;: True or False, # Output only. A bit indicating whether version target has been reached
15772 # in this managed instance group, i.e. all instances are in their target
15773 # version. Instances&#x27; target version are specified byversion field on Instance Group Manager.
15774 },
15775 },
15776 &quot;targetPools&quot;: [ # The URLs for all TargetPool resources to which instances in theinstanceGroup field are added. The target pools automatically
15777 # apply to all of the instances in the managed instance group.
15778 &quot;A String&quot;,
15779 ],
15780 &quot;targetSize&quot;: 42, # The target number of running instances for this managed instance group.
15781 # You can reduce this number by using the instanceGroupManager
15782 # deleteInstances or abandonInstances methods. Resizing the group also
15783 # changes this number.
15784 &quot;targetSizePolicy&quot;: { # The policy that specifies how the MIG creates its VMs to achieve the target
15785 # size.
15786 &quot;mode&quot;: &quot;A String&quot;, # The mode of target size policy based on which the MIG creates its VMs
15787 # individually or all at once.
15788 },
15789 &quot;targetStoppedSize&quot;: 42, # The target number of stopped instances for this managed instance group.
15790 # This number changes when you:
15791 #
15792 # - Stop instance using the stopInstances
15793 # method or start instances using the startInstances
15794 # method.
15795 # - Manually change the targetStoppedSize using the update
15796 # method.
15797 &quot;targetSuspendedSize&quot;: 42, # The target number of suspended instances for this managed instance group.
15798 # This number changes when you:
15799 #
15800 # - Suspend instance using the suspendInstances
15801 # method or resume instances using the resumeInstances
15802 # method.
15803 # - Manually change the targetSuspendedSize using the update
15804 # method.
15805 &quot;updatePolicy&quot;: { # The update policy for this managed instance group.
15806 &quot;allowedActions&quot;: [ # Actions that are allowed to update instances within MIG.
15807 &quot;A String&quot;,
15808 ],
15809 &quot;instanceRedistributionType&quot;: &quot;A String&quot;, # The
15810 # instance redistribution policy for regional managed instance groups.
15811 # Valid values are:
15812 #
15813 # - PROACTIVE (default): The group attempts to maintain an
15814 # even distribution of VM instances across zones in the region.
15815 # - NONE: For non-autoscaled groups, proactive
15816 # redistribution is disabled.
15817 &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
15818 # either a fixed number or, if the group has 10 or more instances, a
15819 # percentage. If you set a percentage, the number of instances is rounded
15820 # if necessary. The default value for maxSurge is a fixed
15821 # value equal to the number of zones in which the managed instance group
15822 # operates.
15823 #
15824 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxSurge.
15825 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
15826 #
15827 #
15828 #
15829 # - If the value is fixed, then the calculated
15830 # value is equal to the fixed value.
15831 # - If the value is a percent, then the
15832 # calculated
15833 # value is percent/100 * targetSize. For example,
15834 # the calculated value of a 80% of a managed instance group
15835 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
15836 # is a remainder, the number is rounded.
15837 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
15838 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
15839 # example, specify 80 for 80%.
15840 },
15841 &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
15842 # process. An instance is considered available if all of the following
15843 # conditions are satisfied:
15844 #
15845 #
15846 #
15847 # - The instance&#x27;s status is
15848 # RUNNING.
15849 # - If there is a health
15850 # check on the instance group, the instance&#x27;s health check status
15851 # must be HEALTHY at least once. If there is no health check
15852 # on the group, then the instance only needs to have a status of
15853 # RUNNING to be considered available.
15854 #
15855 #
15856 # This value can be either a fixed number or, if the group has 10 or more
15857 # instances, a percentage. If you set a percentage, the number of instances
15858 # is rounded if necessary. The default value formaxUnavailable is a fixed value equal to the number of zones
15859 # in which the managed instance group operates.
15860 #
15861 # At least one of either maxSurge ormaxUnavailable must be greater than 0. Learn more about maxUnavailable.
15862 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
15863 #
15864 #
15865 #
15866 # - If the value is fixed, then the calculated
15867 # value is equal to the fixed value.
15868 # - If the value is a percent, then the
15869 # calculated
15870 # value is percent/100 * targetSize. For example,
15871 # the calculated value of a 80% of a managed instance group
15872 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
15873 # is a remainder, the number is rounded.
15874 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
15875 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
15876 # example, specify 80 for 80%.
15877 },
15878 &quot;minReadySec&quot;: 42, # Minimum number of seconds to wait for after a newly created instance
15879 # becomes available. This value must be from range [0, 3600].
15880 &quot;minimalAction&quot;: &quot;A String&quot;, # Minimal action to be taken on an instance. Use this option to minimize
15881 # disruption as much as possible or to apply a more disruptive action than
15882 # is necessary.
15883 #
15884 # - To limit disruption as much as possible, set the minimal action toREFRESH. If your update requires a more disruptive action,
15885 # Compute Engine performs the necessary action to execute the update.
15886 # - To apply a more disruptive action than is strictly necessary, set the
15887 # minimal action to RESTART or REPLACE. For
15888 # example, Compute Engine does not need to restart a VM to change its
15889 # metadata. But if your application reads instance metadata only when a VM
15890 # is restarted, you can set the minimal action to RESTART in
15891 # order to pick up metadata changes.
15892 &quot;mostDisruptiveAllowedAction&quot;: &quot;A String&quot;, # Most disruptive action that is allowed to be taken on an instance.
15893 # You can specify either NONE to forbid any actions,REFRESH to avoid restarting the VM and to limit disruption
15894 # as much as possible. RESTART to allow actions that can be
15895 # applied without instance replacing or REPLACE to allow all
15896 # possible actions. If the Updater determines that the minimal update
15897 # action needed is more disruptive than most disruptive allowed action you
15898 # specify it will not perform the update at all.
15899 &quot;replacementMethod&quot;: &quot;A String&quot;, # What action should be used to replace instances.
15900 # See minimal_action.REPLACE
15901 &quot;type&quot;: &quot;A String&quot;, # The type
15902 # of update process. You can specify either PROACTIVE so
15903 # that the MIG automatically updates VMs to the latest configurations orOPPORTUNISTIC so that you can select the VMs that you want
15904 # to update.
15905 },
15906 &quot;versions&quot;: [ # Specifies the instance templates used by this managed instance group to
15907 # create instances.
15908 #
15909 # Each version is defined by an instanceTemplate and aname. Every version can appear at most once per instance
15910 # group. This field overrides the top-level instanceTemplate
15911 # field. Read more about therelationships
15912 # between these fields. Exactly one version must leave thetargetSize field unset. That version will be applied to all
15913 # remaining instances. For more information, read aboutcanary
15914 # updates.
15915 {
15916 &quot;instanceTemplate&quot;: &quot;A String&quot;, # The URL of the instance template that is specified for this managed
15917 # instance group. The group uses this template to create new instances in
15918 # the managed instance group until the `targetSize` for this version is
15919 # reached. The templates for existing instances in the group do not change
15920 # unless you run recreateInstances, runapplyUpdatesToInstances, or set the group&#x27;supdatePolicy.type to PROACTIVE; in those cases,
15921 # existing instances are updated until the `targetSize` for this version is
15922 # reached.
15923 &quot;name&quot;: &quot;A String&quot;, # Name of the version. Unique among all versions in the scope of this
15924 # managed instance group.
15925 &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
15926 # from the template will be equal to:
15927 #
15928 #
15929 # - If expressed as a fixed number, the minimum of either
15930 # targetSize.fixed or
15931 # instanceGroupManager.targetSize is used.
15932 # - if expressed as a percent, the targetSize
15933 # would be (targetSize.percent/100 *
15934 # InstanceGroupManager.targetSize) If there is a remainder, the
15935 # number is rounded.
15936 #
15937 # If unset, this version will update any remaining instances not
15938 # updated by another version. ReadStarting
15939 # a canary update for more information.
15940 &quot;calculated&quot;: 42, # Output only. Absolute value of VM instances calculated based on the specific mode.
15941 #
15942 #
15943 #
15944 # - If the value is fixed, then the calculated
15945 # value is equal to the fixed value.
15946 # - If the value is a percent, then the
15947 # calculated
15948 # value is percent/100 * targetSize. For example,
15949 # the calculated value of a 80% of a managed instance group
15950 # with 150 instances would be (80/100 * 150) = 120 VM instances. If there
15951 # is a remainder, the number is rounded.
15952 &quot;fixed&quot;: 42, # Specifies a fixed number of VM instances. This must be a positive integer.
15953 &quot;percent&quot;: 42, # Specifies a percentage of instances between 0 to 100%, inclusive. For
15954 # example, specify 80 for 80%.
15955 },
15956 },
15957 ],
15958 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of azone
15959 # where the managed instance group is located (for zonal resources).
15960 }
15961
15962 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
15963 that if you must retry your request, the server will know to ignore the
15964 request if it has already been completed.
15965
15966 For example, consider a situation where you make an initial request and
15967 the request times out. If you make the request again with the same
15968 request ID, the server can check if original operation with the same
15969 request ID was received, and if so, will ignore the second request. This
15970 prevents clients from accidentally creating duplicate commitments.
15971
15972 The request ID must be
15973 a valid UUID with the exception that zero UUID is not supported
15974 (00000000-0000-0000-0000-000000000000).
15975 x__xgafv: string, V1 error format.
15976 Allowed values
15977 1 - v1 error format
15978 2 - v2 error format
15979
15980 Returns:
15981 An object of the form:
15982
15983 { # Represents an Operation resource.
15984 #
15985 # Google Compute Engine has three Operation resources:
15986 #
15987 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
15988 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
15989 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
15990 #
15991 # You can use an operation resource to manage asynchronous API requests.
15992 # For more information, readHandling
15993 # API responses.
15994 #
15995 # Operations can be global, regional or zonal.
15996 #
15997 # - For global operations, use the `globalOperations`
15998 # resource.
15999 # - For regional operations, use the
16000 # `regionOperations` resource.
16001 # - For zonal operations, use
16002 # the `zoneOperations` resource.
16003 #
16004 #
16005 #
16006 # For more information, read
16007 # Global, Regional, and Zonal Resources.
16008 #
16009 # Note that completed Operation resources have a limited
16010 # retention period.
16011 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
16012 # Not present otherwise.
16013 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
16014 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
16015 # set when the operation is created.
16016 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
16017 # text format.
16018 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
16019 # this field will be populated.
16020 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
16021 # operation.
16022 {
16023 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
16024 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
16025 # details. There is a set of defined message types to use for providing
16026 # details.The syntax depends on the error code. For example,
16027 # QuotaExceededInfo will have details when the error code is
16028 # QUOTA_EXCEEDED.
16029 {
16030 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
16031 #
16032 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
16033 # is not enabled:
16034 #
16035 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
16036 # &quot;domain&quot;: &quot;googleapis.com&quot;
16037 # &quot;metadata&quot;: {
16038 # &quot;resource&quot;: &quot;projects/123&quot;,
16039 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
16040 # }
16041 # }
16042 #
16043 # This response indicates that the pubsub.googleapis.com API is not enabled.
16044 #
16045 # Example of an error that is returned when attempting to create a Spanner
16046 # instance in a region that is out of stock:
16047 #
16048 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
16049 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
16050 # &quot;metadata&quot;: {
16051 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
16052 # }
16053 # }
16054 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
16055 # is typically the registered service name of the tool or product that
16056 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
16057 # generated by some common infrastructure, the error domain must be a
16058 # globally unique value that identifies the infrastructure. For Google API
16059 # infrastructure, the error domain is &quot;googleapis.com&quot;.
16060 &quot;metadatas&quot;: { # Additional structured details about this error.
16061 #
16062 # Keys must match a regular expression of `a-z+` but should
16063 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
16064 # length. When identifying the current value of an exceeded limit, the units
16065 # should be contained in the key, not the value. For example, rather than
16066 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
16067 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
16068 # instances that can be created in a single (batch) request.
16069 &quot;a_key&quot;: &quot;A String&quot;,
16070 },
16071 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
16072 # proximate cause of the error. Error reasons are unique within a particular
16073 # domain of errors. This should be at most 63 characters and match a
16074 # regular expression of `A-Z+[A-Z0-9]`, which represents
16075 # UPPER_SNAKE_CASE.
16076 },
16077 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
16078 #
16079 # For example, if a quota check failed with an error indicating the calling
16080 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
16081 # directly to the right place in the developer console to flip the bit.
16082 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
16083 { # Describes a URL link.
16084 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
16085 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
16086 },
16087 ],
16088 },
16089 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
16090 # which can be attached to an RPC error.
16091 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
16092 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
16093 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
16094 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
16095 },
16096 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
16097 &quot;dimensions&quot;: { # The map holding related quota dimensions.
16098 &quot;a_key&quot;: &quot;A String&quot;,
16099 },
16100 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
16101 # type or metric.
16102 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
16103 # or metric.
16104 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
16105 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
16106 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
16107 },
16108 },
16109 ],
16110 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
16111 # This property is optional.
16112 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
16113 },
16114 ],
16115 },
16116 &quot;getVersionOperationMetadata&quot;: {
16117 &quot;inlineSbomInfo&quot;: {
16118 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
16119 # appropriate identifiers.
16120 &quot;a_key&quot;: &quot;A String&quot;,
16121 },
16122 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
16123 # identifiers.
16124 &quot;a_key&quot;: &quot;A String&quot;,
16125 },
16126 },
16127 },
16128 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
16129 # message that was returned, such as `NOT FOUND`.
16130 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
16131 # status code that was returned. For example, a `404` means the
16132 # resource was not found.
16133 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
16134 # defined by the server.
16135 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
16136 # This value is inRFC3339
16137 # text format.
16138 &quot;instancesBulkInsertOperationMetadata&quot;: {
16139 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
16140 # Example key: zones/us-central1-a
16141 &quot;a_key&quot;: {
16142 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
16143 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
16144 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
16145 # error.
16146 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
16147 # if the flow is rolling forward or rolling back.
16148 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
16149 },
16150 },
16151 },
16152 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
16153 # Operation resources.
16154 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
16155 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
16156 # group of operations results from a `bulkInsert` API request.
16157 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
16158 # `update`, or `delete`, and so on.
16159 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
16160 # There is no requirement that this be linear or support any granularity of
16161 # operations. This should not be used to guess when the operation will be
16162 # complete. This number should monotonically increase as the operation
16163 # progresses.
16164 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
16165 # applicable when performing regional operations.
16166 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
16167 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
16168 # this field will contain information on all underlying zonal actions and
16169 # their state.
16170 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
16171 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
16172 # Example key: zones/us-central1-a
16173 &quot;a_key&quot;: {
16174 &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
16175 # populated.
16176 # different programming environments, including REST APIs and RPC APIs. It is
16177 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
16178 # three pieces of data: error code, error message, and error details.
16179 #
16180 # You can find out more about this error model and how to work with it in the
16181 # [API Design Guide](https://cloud.google.com/apis/design/errors).
16182 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
16183 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
16184 # message types for APIs to use.
16185 {
16186 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
16187 },
16188 ],
16189 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
16190 # user-facing error message should be localized and sent in the
16191 # google.rpc.Status.details field, or localized by the client.
16192 },
16193 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
16194 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
16195 },
16196 },
16197 },
16198 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
16199 # This value is inRFC3339
16200 # text format.
16201 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
16202 # following:
16203 # `PENDING`, `RUNNING`, or `DONE`.
16204 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
16205 # operation.
16206 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
16207 # of the target resource.
16208 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
16209 # operations related to creating a snapshot, this points to the disk
16210 # that the snapshot was created from.
16211 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
16212 # `[email protected]` or
16213 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
16214 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
16215 # operation, this field will be populated.
16216 {
16217 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
16218 # Engine returns NO_RESULTS_ON_PAGE if there
16219 # are no results in the response.
16220 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
16221 # value format. For example:
16222 #
16223 # &quot;data&quot;: [
16224 # {
16225 # &quot;key&quot;: &quot;scope&quot;,
16226 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
16227 # }
16228 {
16229 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
16230 # returned. For example, for warnings where there are no results in a list
16231 # request for a particular zone, this key might be scope and
16232 # the key value might be the zone name. Other examples might be a key
16233 # indicating a deprecated resource and a suggested replacement, or a
16234 # warning about invalid network settings (for example, if an instance
16235 # attempts to perform IP forwarding but is not enabled for IP forwarding).
16236 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
16237 },
16238 ],
16239 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
16240 },
16241 ],
16242 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
16243 # applicable when performing per-zone operations.
16244 }</pre>
16245 </div>
16246
16247 <div class="method">
16248 <code class="details" id="updatePerInstanceConfigs">updatePerInstanceConfigs(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
16249 <pre>Inserts or updates per-instance configurations for the managed instance
16250 group. perInstanceConfig.name serves as a key used to
16251 distinguish whether to perform insert or patch.
16252
16253 Args:
16254 project: string, Project ID for this request. (required)
16255 zone: string, The name of thezone
16256 where the managed instance group is located.
16257 It should conform to RFC1035. (required)
16258 instanceGroupManager: string, The name of the managed instance group.
16259 It should conform to RFC1035. (required)
16260 body: object, The request body.
16261 The object takes the form of:
16262
16263 { # InstanceGroupManagers.updatePerInstanceConfigs
16264 &quot;perInstanceConfigs&quot;: [ # The list of per-instance configurations to insert or patch on this managed
16265 # instance group.
16266 {
16267 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
16268 # optimistic locking. It is ignored when inserting a per-instance
16269 # config. An up-to-date fingerprint must be provided in order to update an
16270 # existing per-instance configuration or the field needs to be unset.
16271 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
16272 # Serves as a merge key during UpdatePerInstanceConfigs
16273 # operations, that is, if a per-instance configuration with the same name
16274 # exists then it will be updated, otherwise a new one will be created for the
16275 # VM instance with the same name. An attempt to create a per-instance
16276 # configuration for a VM instance that either doesn&#x27;t exist or is not part
16277 # of the group will result in an error.
16278 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
16279 # preserved state generated from a stateful policy.
16280 &quot;disks&quot;: { # Preserved disks defined for this instance.
16281 # This map is keyed with the device names of the disks.
16282 &quot;a_key&quot;: {
16283 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
16284 # update, instance recreate operations. This flag is used to configure
16285 # if the disk should be deleted after it is no longer used by the group,
16286 # e.g. when the given instance or the whole MIG is deleted.
16287 # Note: disks attached in READ_ONLY mode cannot be
16288 # auto-deleted.
16289 &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
16290 # disk in READ_WRITE mode.
16291 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
16292 # to the VM instance.
16293 },
16294 },
16295 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
16296 # This map is keyed with the name of the network interface.
16297 &quot;a_key&quot;: {
16298 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
16299 # update or VM instance recreate operations.
16300 # This flag is used to configure if the IP reservation should be deleted
16301 # after it is no longer used by the group, e.g. when the given instance
16302 # or the whole group is deleted.
16303 &quot;ipAddress&quot;: { # Ip address representation
16304 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
16305 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
16306 # network interface.
16307 },
16308 },
16309 },
16310 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
16311 # This map is keyed with the name of the network interface.
16312 &quot;a_key&quot;: {
16313 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
16314 # update or VM instance recreate operations.
16315 # This flag is used to configure if the IP reservation should be deleted
16316 # after it is no longer used by the group, e.g. when the given instance
16317 # or the whole group is deleted.
16318 &quot;ipAddress&quot;: { # Ip address representation
16319 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
16320 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
16321 # network interface.
16322 },
16323 },
16324 },
16325 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
16326 &quot;a_key&quot;: &quot;A String&quot;,
16327 },
16328 },
16329 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
16330 # managed instance.
16331 },
16332 ],
16333 }
16334
16335 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
16336 that if you must retry your request, the server will know to ignore the
16337 request if it has already been completed.
16338
16339 For example, consider a situation where you make an initial request and
16340 the request times out. If you make the request again with the same
16341 request ID, the server can check if original operation with the same
16342 request ID was received, and if so, will ignore the second request. This
16343 prevents clients from accidentally creating duplicate commitments.
16344
16345 The request ID must be
16346 a valid UUID with the exception that zero UUID is not supported
16347 (00000000-0000-0000-0000-000000000000).
16348 x__xgafv: string, V1 error format.
16349 Allowed values
16350 1 - v1 error format
16351 2 - v2 error format
16352
16353 Returns:
16354 An object of the form:
16355
16356 { # Represents an Operation resource.
16357 #
16358 # Google Compute Engine has three Operation resources:
16359 #
16360 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
16361 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
16362 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
16363 #
16364 # You can use an operation resource to manage asynchronous API requests.
16365 # For more information, readHandling
16366 # API responses.
16367 #
16368 # Operations can be global, regional or zonal.
16369 #
16370 # - For global operations, use the `globalOperations`
16371 # resource.
16372 # - For regional operations, use the
16373 # `regionOperations` resource.
16374 # - For zonal operations, use
16375 # the `zoneOperations` resource.
16376 #
16377 #
16378 #
16379 # For more information, read
16380 # Global, Regional, and Zonal Resources.
16381 #
16382 # Note that completed Operation resources have a limited
16383 # retention period.
16384 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
16385 # Not present otherwise.
16386 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
16387 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
16388 # set when the operation is created.
16389 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
16390 # text format.
16391 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
16392 # this field will be populated.
16393 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
16394 # operation.
16395 {
16396 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
16397 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
16398 # details. There is a set of defined message types to use for providing
16399 # details.The syntax depends on the error code. For example,
16400 # QuotaExceededInfo will have details when the error code is
16401 # QUOTA_EXCEEDED.
16402 {
16403 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
16404 #
16405 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
16406 # is not enabled:
16407 #
16408 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
16409 # &quot;domain&quot;: &quot;googleapis.com&quot;
16410 # &quot;metadata&quot;: {
16411 # &quot;resource&quot;: &quot;projects/123&quot;,
16412 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
16413 # }
16414 # }
16415 #
16416 # This response indicates that the pubsub.googleapis.com API is not enabled.
16417 #
16418 # Example of an error that is returned when attempting to create a Spanner
16419 # instance in a region that is out of stock:
16420 #
16421 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
16422 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
16423 # &quot;metadata&quot;: {
16424 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
16425 # }
16426 # }
16427 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
16428 # is typically the registered service name of the tool or product that
16429 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
16430 # generated by some common infrastructure, the error domain must be a
16431 # globally unique value that identifies the infrastructure. For Google API
16432 # infrastructure, the error domain is &quot;googleapis.com&quot;.
16433 &quot;metadatas&quot;: { # Additional structured details about this error.
16434 #
16435 # Keys must match a regular expression of `a-z+` but should
16436 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
16437 # length. When identifying the current value of an exceeded limit, the units
16438 # should be contained in the key, not the value. For example, rather than
16439 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
16440 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
16441 # instances that can be created in a single (batch) request.
16442 &quot;a_key&quot;: &quot;A String&quot;,
16443 },
16444 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
16445 # proximate cause of the error. Error reasons are unique within a particular
16446 # domain of errors. This should be at most 63 characters and match a
16447 # regular expression of `A-Z+[A-Z0-9]`, which represents
16448 # UPPER_SNAKE_CASE.
16449 },
16450 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
16451 #
16452 # For example, if a quota check failed with an error indicating the calling
16453 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
16454 # directly to the right place in the developer console to flip the bit.
16455 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
16456 { # Describes a URL link.
16457 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
16458 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
16459 },
16460 ],
16461 },
16462 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
16463 # which can be attached to an RPC error.
16464 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
16465 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
16466 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
16467 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
16468 },
16469 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
16470 &quot;dimensions&quot;: { # The map holding related quota dimensions.
16471 &quot;a_key&quot;: &quot;A String&quot;,
16472 },
16473 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
16474 # type or metric.
16475 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
16476 # or metric.
16477 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
16478 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
16479 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
16480 },
16481 },
16482 ],
16483 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
16484 # This property is optional.
16485 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
16486 },
16487 ],
16488 },
16489 &quot;getVersionOperationMetadata&quot;: {
16490 &quot;inlineSbomInfo&quot;: {
16491 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
16492 # appropriate identifiers.
16493 &quot;a_key&quot;: &quot;A String&quot;,
16494 },
16495 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
16496 # identifiers.
16497 &quot;a_key&quot;: &quot;A String&quot;,
16498 },
16499 },
16500 },
16501 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
16502 # message that was returned, such as `NOT FOUND`.
16503 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
16504 # status code that was returned. For example, a `404` means the
16505 # resource was not found.
16506 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
16507 # defined by the server.
16508 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
16509 # This value is inRFC3339
16510 # text format.
16511 &quot;instancesBulkInsertOperationMetadata&quot;: {
16512 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
16513 # Example key: zones/us-central1-a
16514 &quot;a_key&quot;: {
16515 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
16516 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
16517 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
16518 # error.
16519 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
16520 # if the flow is rolling forward or rolling back.
16521 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
16522 },
16523 },
16524 },
16525 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
16526 # Operation resources.
16527 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
16528 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
16529 # group of operations results from a `bulkInsert` API request.
16530 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
16531 # `update`, or `delete`, and so on.
16532 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
16533 # There is no requirement that this be linear or support any granularity of
16534 # operations. This should not be used to guess when the operation will be
16535 # complete. This number should monotonically increase as the operation
16536 # progresses.
16537 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
16538 # applicable when performing regional operations.
16539 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
16540 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
16541 # this field will contain information on all underlying zonal actions and
16542 # their state.
16543 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
16544 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
16545 # Example key: zones/us-central1-a
16546 &quot;a_key&quot;: {
16547 &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
16548 # populated.
16549 # different programming environments, including REST APIs and RPC APIs. It is
16550 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
16551 # three pieces of data: error code, error message, and error details.
16552 #
16553 # You can find out more about this error model and how to work with it in the
16554 # [API Design Guide](https://cloud.google.com/apis/design/errors).
16555 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
16556 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
16557 # message types for APIs to use.
16558 {
16559 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
16560 },
16561 ],
16562 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
16563 # user-facing error message should be localized and sent in the
16564 # google.rpc.Status.details field, or localized by the client.
16565 },
16566 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
16567 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
16568 },
16569 },
16570 },
16571 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
16572 # This value is inRFC3339
16573 # text format.
16574 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
16575 # following:
16576 # `PENDING`, `RUNNING`, or `DONE`.
16577 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
16578 # operation.
16579 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
16580 # of the target resource.
16581 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
16582 # operations related to creating a snapshot, this points to the disk
16583 # that the snapshot was created from.
16584 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
16585 # `[email protected]` or
16586 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
16587 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
16588 # operation, this field will be populated.
16589 {
16590 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
16591 # Engine returns NO_RESULTS_ON_PAGE if there
16592 # are no results in the response.
16593 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
16594 # value format. For example:
16595 #
16596 # &quot;data&quot;: [
16597 # {
16598 # &quot;key&quot;: &quot;scope&quot;,
16599 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
16600 # }
16601 {
16602 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
16603 # returned. For example, for warnings where there are no results in a list
16604 # request for a particular zone, this key might be scope and
16605 # the key value might be the zone name. Other examples might be a key
16606 # indicating a deprecated resource and a suggested replacement, or a
16607 # warning about invalid network settings (for example, if an instance
16608 # attempts to perform IP forwarding but is not enabled for IP forwarding).
16609 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
16610 },
16611 ],
16612 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
16613 },
16614 ],
16615 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
16616 # applicable when performing per-zone operations.
16617 }</pre>
16618 </div>
16619
16620 </body></html>