Debian Codegraph @

docs/dyn/compute_beta.instanceGroupManagerResizeRequests.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.instanceGroupManagerResizeRequests.html">instanceGroupManagerResizeRequests</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#cancel">cancel(project, zone, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Cancels the specified resize request and removes it from the queue.</p>
80 <p class="toc_element">
81 <code><a href="#close">close()</a></code></p>
82 <p class="firstline">Close httplib2 connections.</p>
83 <p class="toc_element">
84 <code><a href="#delete">delete(project, zone, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)</a></code></p>
85 <p class="firstline">Deletes the specified, inactive resize request. Requests that are still</p>
86 <p class="toc_element">
87 <code><a href="#get">get(project, zone, instanceGroupManager, resizeRequest, x__xgafv=None)</a></code></p>
88 <p class="firstline">Returns all of the details about the specified resize request.</p>
89 <p class="toc_element">
90 <code><a href="#insert">insert(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Creates a new resize request that starts provisioning VMs immediately</p>
92 <p class="toc_element">
93 <code><a href="#list">list(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
94 <p class="firstline">Retrieves a list of resize requests that are contained in the</p>
95 <p class="toc_element">
96 <code><a href="#list_next">list_next()</a></code></p>
97 <p class="firstline">Retrieves the next page of results.</p>
98 <h3>Method Details</h3>
99 <div class="method">
100 <code class="details" id="cancel">cancel(project, zone, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)</code>
101 <pre>Cancels the specified resize request and removes it from the queue.
102 Cancelled resize request does no longer wait for the resources to be
103 provisioned. Cancel is only possible for requests that are accepted in the
104 queue.
105
106 Args:
107 project: string, Project ID for this request. (required)
108 zone: string, The name of thezone where the managed
109 instance group is located. The name should conform to RFC1035. (required)
110 instanceGroupManager: string, The name of the managed instance group.
111 The name should conform to RFC1035 or be a resource ID. (required)
112 resizeRequest: string, The name of the resize request to cancel.
113 The name should conform to RFC1035 or be a resource ID. (required)
114 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
115 that if you must retry your request, the server will know to ignore the
116 request if it has already been completed.
117
118 For example, consider a situation where you make an initial request and
119 the request times out. If you make the request again with the same
120 request ID, the server can check if original operation with the same
121 request ID was received, and if so, will ignore the second request. This
122 prevents clients from accidentally creating duplicate commitments.
123
124 The request ID must be
125 a valid UUID with the exception that zero UUID is not supported
126 (00000000-0000-0000-0000-000000000000).
127 x__xgafv: string, V1 error format.
128 Allowed values
129 1 - v1 error format
130 2 - v2 error format
131
132 Returns:
133 An object of the form:
134
135 { # Represents an Operation resource.
136 #
137 # Google Compute Engine has three Operation resources:
138 #
139 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
140 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
141 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
142 #
143 # You can use an operation resource to manage asynchronous API requests.
144 # For more information, readHandling
145 # API responses.
146 #
147 # Operations can be global, regional or zonal.
148 #
149 # - For global operations, use the `globalOperations`
150 # resource.
151 # - For regional operations, use the
152 # `regionOperations` resource.
153 # - For zonal operations, use
154 # the `zoneOperations` resource.
155 #
156 #
157 #
158 # For more information, read
159 # Global, Regional, and Zonal Resources.
160 #
161 # Note that completed Operation resources have a limited
162 # retention period.
163 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
164 # Not present otherwise.
165 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
166 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
167 # set when the operation is created.
168 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
169 # text format.
170 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
171 # this field will be populated.
172 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
173 # operation.
174 {
175 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
176 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
177 # details. There is a set of defined message types to use for providing
178 # details.The syntax depends on the error code. For example,
179 # QuotaExceededInfo will have details when the error code is
180 # QUOTA_EXCEEDED.
181 {
182 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
183 #
184 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
185 # is not enabled:
186 #
187 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
188 # &quot;domain&quot;: &quot;googleapis.com&quot;
189 # &quot;metadata&quot;: {
190 # &quot;resource&quot;: &quot;projects/123&quot;,
191 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
192 # }
193 # }
194 #
195 # This response indicates that the pubsub.googleapis.com API is not enabled.
196 #
197 # Example of an error that is returned when attempting to create a Spanner
198 # instance in a region that is out of stock:
199 #
200 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
201 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
202 # &quot;metadata&quot;: {
203 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
204 # }
205 # }
206 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
207 # is typically the registered service name of the tool or product that
208 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
209 # generated by some common infrastructure, the error domain must be a
210 # globally unique value that identifies the infrastructure. For Google API
211 # infrastructure, the error domain is &quot;googleapis.com&quot;.
212 &quot;metadatas&quot;: { # Additional structured details about this error.
213 #
214 # Keys must match a regular expression of `a-z+` but should
215 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
216 # length. When identifying the current value of an exceeded limit, the units
217 # should be contained in the key, not the value. For example, rather than
218 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
219 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
220 # instances that can be created in a single (batch) request.
221 &quot;a_key&quot;: &quot;A String&quot;,
222 },
223 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
224 # proximate cause of the error. Error reasons are unique within a particular
225 # domain of errors. This should be at most 63 characters and match a
226 # regular expression of `A-Z+[A-Z0-9]`, which represents
227 # UPPER_SNAKE_CASE.
228 },
229 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
230 #
231 # For example, if a quota check failed with an error indicating the calling
232 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
233 # directly to the right place in the developer console to flip the bit.
234 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
235 { # Describes a URL link.
236 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
237 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
238 },
239 ],
240 },
241 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
242 # which can be attached to an RPC error.
243 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
244 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
245 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
246 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
247 },
248 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
249 &quot;dimensions&quot;: { # The map holding related quota dimensions.
250 &quot;a_key&quot;: &quot;A String&quot;,
251 },
252 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
253 # type or metric.
254 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
255 # or metric.
256 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
257 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
258 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
259 },
260 },
261 ],
262 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
263 # This property is optional.
264 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
265 },
266 ],
267 },
268 &quot;getVersionOperationMetadata&quot;: {
269 &quot;inlineSbomInfo&quot;: {
270 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
271 # appropriate identifiers.
272 &quot;a_key&quot;: &quot;A String&quot;,
273 },
274 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
275 # identifiers.
276 &quot;a_key&quot;: &quot;A String&quot;,
277 },
278 },
279 },
280 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
281 # message that was returned, such as `NOT FOUND`.
282 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
283 # status code that was returned. For example, a `404` means the
284 # resource was not found.
285 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
286 # defined by the server.
287 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
288 # This value is inRFC3339
289 # text format.
290 &quot;instancesBulkInsertOperationMetadata&quot;: {
291 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
292 # Example key: zones/us-central1-a
293 &quot;a_key&quot;: {
294 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
295 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
296 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
297 # error.
298 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
299 # if the flow is rolling forward or rolling back.
300 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
301 },
302 },
303 },
304 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
305 # Operation resources.
306 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
307 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
308 # group of operations results from a `bulkInsert` API request.
309 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
310 # `update`, or `delete`, and so on.
311 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
312 # There is no requirement that this be linear or support any granularity of
313 # operations. This should not be used to guess when the operation will be
314 # complete. This number should monotonically increase as the operation
315 # progresses.
316 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
317 # applicable when performing regional operations.
318 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
319 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
320 # this field will contain information on all underlying zonal actions and
321 # their state.
322 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
323 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
324 # Example key: zones/us-central1-a
325 &quot;a_key&quot;: {
326 &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
327 # populated.
328 # different programming environments, including REST APIs and RPC APIs. It is
329 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
330 # three pieces of data: error code, error message, and error details.
331 #
332 # You can find out more about this error model and how to work with it in the
333 # [API Design Guide](https://cloud.google.com/apis/design/errors).
334 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
335 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
336 # message types for APIs to use.
337 {
338 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
339 },
340 ],
341 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
342 # user-facing error message should be localized and sent in the
343 # google.rpc.Status.details field, or localized by the client.
344 },
345 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
346 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
347 },
348 },
349 },
350 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
351 # This value is inRFC3339
352 # text format.
353 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
354 # following:
355 # `PENDING`, `RUNNING`, or `DONE`.
356 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
357 # operation.
358 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
359 # of the target resource.
360 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
361 # operations related to creating a snapshot, this points to the disk
362 # that the snapshot was created from.
363 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
364 # `[email protected]` or
365 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
366 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
367 # operation, this field will be populated.
368 {
369 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
370 # Engine returns NO_RESULTS_ON_PAGE if there
371 # are no results in the response.
372 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
373 # value format. For example:
374 #
375 # &quot;data&quot;: [
376 # {
377 # &quot;key&quot;: &quot;scope&quot;,
378 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
379 # }
380 {
381 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
382 # returned. For example, for warnings where there are no results in a list
383 # request for a particular zone, this key might be scope and
384 # the key value might be the zone name. Other examples might be a key
385 # indicating a deprecated resource and a suggested replacement, or a
386 # warning about invalid network settings (for example, if an instance
387 # attempts to perform IP forwarding but is not enabled for IP forwarding).
388 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
389 },
390 ],
391 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
392 },
393 ],
394 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
395 # applicable when performing per-zone operations.
396 }</pre>
397 </div>
398
399 <div class="method">
400 <code class="details" id="close">close()</code>
401 <pre>Close httplib2 connections.</pre>
402 </div>
403
404 <div class="method">
405 <code class="details" id="delete">delete(project, zone, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)</code>
406 <pre>Deletes the specified, inactive resize request. Requests that are still
407 active cannot be deleted. Deleting request does not delete instances that
408 were provisioned previously.
409
410 Args:
411 project: string, Project ID for this request. (required)
412 zone: string, The name of thezone where the managed
413 instance group is located. The name should conform to RFC1035. (required)
414 instanceGroupManager: string, The name of the managed instance group.
415 The name should conform to RFC1035 or be a resource ID. (required)
416 resizeRequest: string, The name of the resize request to delete.
417 The name should conform to RFC1035 or be a resource ID. (required)
418 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
419 that if you must retry your request, the server will know to ignore the
420 request if it has already been completed.
421
422 For example, consider a situation where you make an initial request and
423 the request times out. If you make the request again with the same
424 request ID, the server can check if original operation with the same
425 request ID was received, and if so, will ignore the second request. This
426 prevents clients from accidentally creating duplicate commitments.
427
428 The request ID must be
429 a valid UUID with the exception that zero UUID is not supported
430 (00000000-0000-0000-0000-000000000000).
431 x__xgafv: string, V1 error format.
432 Allowed values
433 1 - v1 error format
434 2 - v2 error format
435
436 Returns:
437 An object of the form:
438
439 { # Represents an Operation resource.
440 #
441 # Google Compute Engine has three Operation resources:
442 #
443 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
444 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
445 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
446 #
447 # You can use an operation resource to manage asynchronous API requests.
448 # For more information, readHandling
449 # API responses.
450 #
451 # Operations can be global, regional or zonal.
452 #
453 # - For global operations, use the `globalOperations`
454 # resource.
455 # - For regional operations, use the
456 # `regionOperations` resource.
457 # - For zonal operations, use
458 # the `zoneOperations` resource.
459 #
460 #
461 #
462 # For more information, read
463 # Global, Regional, and Zonal Resources.
464 #
465 # Note that completed Operation resources have a limited
466 # retention period.
467 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
468 # Not present otherwise.
469 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
470 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
471 # set when the operation is created.
472 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
473 # text format.
474 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
475 # this field will be populated.
476 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
477 # operation.
478 {
479 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
480 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
481 # details. There is a set of defined message types to use for providing
482 # details.The syntax depends on the error code. For example,
483 # QuotaExceededInfo will have details when the error code is
484 # QUOTA_EXCEEDED.
485 {
486 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
487 #
488 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
489 # is not enabled:
490 #
491 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
492 # &quot;domain&quot;: &quot;googleapis.com&quot;
493 # &quot;metadata&quot;: {
494 # &quot;resource&quot;: &quot;projects/123&quot;,
495 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
496 # }
497 # }
498 #
499 # This response indicates that the pubsub.googleapis.com API is not enabled.
500 #
501 # Example of an error that is returned when attempting to create a Spanner
502 # instance in a region that is out of stock:
503 #
504 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
505 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
506 # &quot;metadata&quot;: {
507 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
508 # }
509 # }
510 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
511 # is typically the registered service name of the tool or product that
512 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
513 # generated by some common infrastructure, the error domain must be a
514 # globally unique value that identifies the infrastructure. For Google API
515 # infrastructure, the error domain is &quot;googleapis.com&quot;.
516 &quot;metadatas&quot;: { # Additional structured details about this error.
517 #
518 # Keys must match a regular expression of `a-z+` but should
519 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
520 # length. When identifying the current value of an exceeded limit, the units
521 # should be contained in the key, not the value. For example, rather than
522 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
523 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
524 # instances that can be created in a single (batch) request.
525 &quot;a_key&quot;: &quot;A String&quot;,
526 },
527 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
528 # proximate cause of the error. Error reasons are unique within a particular
529 # domain of errors. This should be at most 63 characters and match a
530 # regular expression of `A-Z+[A-Z0-9]`, which represents
531 # UPPER_SNAKE_CASE.
532 },
533 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
534 #
535 # For example, if a quota check failed with an error indicating the calling
536 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
537 # directly to the right place in the developer console to flip the bit.
538 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
539 { # Describes a URL link.
540 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
541 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
542 },
543 ],
544 },
545 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
546 # which can be attached to an RPC error.
547 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
548 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
549 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
550 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
551 },
552 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
553 &quot;dimensions&quot;: { # The map holding related quota dimensions.
554 &quot;a_key&quot;: &quot;A String&quot;,
555 },
556 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
557 # type or metric.
558 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
559 # or metric.
560 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
561 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
562 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
563 },
564 },
565 ],
566 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
567 # This property is optional.
568 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
569 },
570 ],
571 },
572 &quot;getVersionOperationMetadata&quot;: {
573 &quot;inlineSbomInfo&quot;: {
574 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
575 # appropriate identifiers.
576 &quot;a_key&quot;: &quot;A String&quot;,
577 },
578 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
579 # identifiers.
580 &quot;a_key&quot;: &quot;A String&quot;,
581 },
582 },
583 },
584 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
585 # message that was returned, such as `NOT FOUND`.
586 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
587 # status code that was returned. For example, a `404` means the
588 # resource was not found.
589 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
590 # defined by the server.
591 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
592 # This value is inRFC3339
593 # text format.
594 &quot;instancesBulkInsertOperationMetadata&quot;: {
595 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
596 # Example key: zones/us-central1-a
597 &quot;a_key&quot;: {
598 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
599 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
600 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
601 # error.
602 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
603 # if the flow is rolling forward or rolling back.
604 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
605 },
606 },
607 },
608 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
609 # Operation resources.
610 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
611 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
612 # group of operations results from a `bulkInsert` API request.
613 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
614 # `update`, or `delete`, and so on.
615 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
616 # There is no requirement that this be linear or support any granularity of
617 # operations. This should not be used to guess when the operation will be
618 # complete. This number should monotonically increase as the operation
619 # progresses.
620 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
621 # applicable when performing regional operations.
622 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
623 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
624 # this field will contain information on all underlying zonal actions and
625 # their state.
626 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
627 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
628 # Example key: zones/us-central1-a
629 &quot;a_key&quot;: {
630 &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
631 # populated.
632 # different programming environments, including REST APIs and RPC APIs. It is
633 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
634 # three pieces of data: error code, error message, and error details.
635 #
636 # You can find out more about this error model and how to work with it in the
637 # [API Design Guide](https://cloud.google.com/apis/design/errors).
638 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
639 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
640 # message types for APIs to use.
641 {
642 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
643 },
644 ],
645 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
646 # user-facing error message should be localized and sent in the
647 # google.rpc.Status.details field, or localized by the client.
648 },
649 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
650 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
651 },
652 },
653 },
654 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
655 # This value is inRFC3339
656 # text format.
657 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
658 # following:
659 # `PENDING`, `RUNNING`, or `DONE`.
660 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
661 # operation.
662 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
663 # of the target resource.
664 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
665 # operations related to creating a snapshot, this points to the disk
666 # that the snapshot was created from.
667 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
668 # `[email protected]` or
669 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
670 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
671 # operation, this field will be populated.
672 {
673 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
674 # Engine returns NO_RESULTS_ON_PAGE if there
675 # are no results in the response.
676 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
677 # value format. For example:
678 #
679 # &quot;data&quot;: [
680 # {
681 # &quot;key&quot;: &quot;scope&quot;,
682 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
683 # }
684 {
685 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
686 # returned. For example, for warnings where there are no results in a list
687 # request for a particular zone, this key might be scope and
688 # the key value might be the zone name. Other examples might be a key
689 # indicating a deprecated resource and a suggested replacement, or a
690 # warning about invalid network settings (for example, if an instance
691 # attempts to perform IP forwarding but is not enabled for IP forwarding).
692 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
693 },
694 ],
695 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
696 },
697 ],
698 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
699 # applicable when performing per-zone operations.
700 }</pre>
701 </div>
702
703 <div class="method">
704 <code class="details" id="get">get(project, zone, instanceGroupManager, resizeRequest, x__xgafv=None)</code>
705 <pre>Returns all of the details about the specified resize request.
706
707 Args:
708 project: string, Project ID for this request. (required)
709 zone: string, Name of the href=&quot;/compute/docs/regions-zones/#available&quot;&gt;zone
710 scoping this request. Name should conform to RFC1035. (required)
711 instanceGroupManager: string, The name of the managed instance group.
712 Name should conform to RFC1035 or be a resource ID. (required)
713 resizeRequest: string, The name of the resize request.
714 Name should conform to RFC1035 or be a resource ID. (required)
715 x__xgafv: string, V1 error format.
716 Allowed values
717 1 - v1 error format
718 2 - v2 error format
719
720 Returns:
721 An object of the form:
722
723 { # InstanceGroupManagerResizeRequest represents a request to create
724 # a number of VMs: either immediately or by queuing the request for the
725 # specified time. This resize request is nested under InstanceGroupManager
726 # and the VMs created by this request are added to the owning
727 # InstanceGroupManager.
728 &quot;count&quot;: 42, # This field is deprecated, please use resize_by instead.
729 # The count of instances to create as part of this resize request.
730 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this resize request inRFC3339
731 # text format.
732 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
733 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server generates this
734 # identifier.
735 &quot;instances&quot;: [ # The names of instances to be created by this resize request. The number of
736 # names specified determines the number of instances to create. The group&#x27;s
737 # target size will be increased by this number. This field cannot be used
738 # together with &#x27;resize_by&#x27;.
739 {
740 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
741 # optimistic locking. It is ignored when inserting a per-instance
742 # config. An up-to-date fingerprint must be provided in order to update an
743 # existing per-instance configuration or the field needs to be unset.
744 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
745 # Serves as a merge key during UpdatePerInstanceConfigs
746 # operations, that is, if a per-instance configuration with the same name
747 # exists then it will be updated, otherwise a new one will be created for the
748 # VM instance with the same name. An attempt to create a per-instance
749 # configuration for a VM instance that either doesn&#x27;t exist or is not part
750 # of the group will result in an error.
751 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
752 # preserved state generated from a stateful policy.
753 &quot;disks&quot;: { # Preserved disks defined for this instance.
754 # This map is keyed with the device names of the disks.
755 &quot;a_key&quot;: {
756 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
757 # update, instance recreate operations. This flag is used to configure
758 # if the disk should be deleted after it is no longer used by the group,
759 # e.g. when the given instance or the whole MIG is deleted.
760 # Note: disks attached in READ_ONLY mode cannot be
761 # auto-deleted.
762 &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
763 # disk in READ_WRITE mode.
764 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
765 # to the VM instance.
766 },
767 },
768 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
769 # This map is keyed with the name of the network interface.
770 &quot;a_key&quot;: {
771 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
772 # update or VM instance recreate operations.
773 # This flag is used to configure if the IP reservation should be deleted
774 # after it is no longer used by the group, e.g. when the given instance
775 # or the whole group is deleted.
776 &quot;ipAddress&quot;: { # Ip address representation
777 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
778 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
779 # network interface.
780 },
781 },
782 },
783 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
784 # This map is keyed with the name of the network interface.
785 &quot;a_key&quot;: {
786 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
787 # update or VM instance recreate operations.
788 # This flag is used to configure if the IP reservation should be deleted
789 # after it is no longer used by the group, e.g. when the given instance
790 # or the whole group is deleted.
791 &quot;ipAddress&quot;: { # Ip address representation
792 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
793 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
794 # network interface.
795 },
796 },
797 },
798 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
799 &quot;a_key&quot;: &quot;A String&quot;,
800 },
801 },
802 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
803 # managed instance.
804 },
805 ],
806 &quot;kind&quot;: &quot;compute#instanceGroupManagerResizeRequest&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
807 &quot;name&quot;: &quot;A String&quot;, # The name of this resize request. The name must be 1-63 characters
808 # long, and comply withRFC1035.
809 &quot;region&quot;: &quot;A String&quot;, # Output only. The URL of a region
810 # where the resize request is located. Populated only for regional resize
811 # requests.
812 &quot;requestedRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Requested run duration for instances that will be created by this request.
813 # At the end of the run duration instance will be deleted.
814 # as a count of seconds and fractions of seconds at nanosecond
815 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
816 # or &quot;month&quot;. Range is approximately 10,000 years.
817 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
818 # Durations less than one second are represented with a 0
819 # `seconds` field and a positive `nanos` field. Must be from 0
820 # to 999,999,999 inclusive.
821 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
822 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
823 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
824 },
825 &quot;resizeBy&quot;: 42, # The number of instances to be created by this resize request. The group&#x27;s
826 # target size will be increased by this number. This field cannot be used
827 # together with &#x27;instances&#x27;.
828 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this resize request. The server defines this URL.
829 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
830 &quot;state&quot;: &quot;A String&quot;, # Output only. Current state of the request.
831 &quot;status&quot;: { # Output only. Status of the request.
832 &quot;error&quot;: { # Output only. Fatal errors encountered during the queueing or provisioning phases of
833 # the ResizeRequest that caused the transition to the FAILED state.
834 # Contrary to the last_attempt errors, this field is final and errors are
835 # never removed from here, as the ResizeRequest is not going to retry.
836 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
837 # operation.
838 {
839 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
840 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
841 # details. There is a set of defined message types to use for providing
842 # details.The syntax depends on the error code. For example,
843 # QuotaExceededInfo will have details when the error code is
844 # QUOTA_EXCEEDED.
845 {
846 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
847 #
848 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
849 # is not enabled:
850 #
851 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
852 # &quot;domain&quot;: &quot;googleapis.com&quot;
853 # &quot;metadata&quot;: {
854 # &quot;resource&quot;: &quot;projects/123&quot;,
855 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
856 # }
857 # }
858 #
859 # This response indicates that the pubsub.googleapis.com API is not enabled.
860 #
861 # Example of an error that is returned when attempting to create a Spanner
862 # instance in a region that is out of stock:
863 #
864 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
865 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
866 # &quot;metadata&quot;: {
867 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
868 # }
869 # }
870 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
871 # is typically the registered service name of the tool or product that
872 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
873 # generated by some common infrastructure, the error domain must be a
874 # globally unique value that identifies the infrastructure. For Google API
875 # infrastructure, the error domain is &quot;googleapis.com&quot;.
876 &quot;metadatas&quot;: { # Additional structured details about this error.
877 #
878 # Keys must match a regular expression of `a-z+` but should
879 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
880 # length. When identifying the current value of an exceeded limit, the units
881 # should be contained in the key, not the value. For example, rather than
882 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
883 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
884 # instances that can be created in a single (batch) request.
885 &quot;a_key&quot;: &quot;A String&quot;,
886 },
887 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
888 # proximate cause of the error. Error reasons are unique within a particular
889 # domain of errors. This should be at most 63 characters and match a
890 # regular expression of `A-Z+[A-Z0-9]`, which represents
891 # UPPER_SNAKE_CASE.
892 },
893 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
894 #
895 # For example, if a quota check failed with an error indicating the calling
896 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
897 # directly to the right place in the developer console to flip the bit.
898 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
899 { # Describes a URL link.
900 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
901 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
902 },
903 ],
904 },
905 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
906 # which can be attached to an RPC error.
907 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
908 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
909 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
910 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
911 },
912 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
913 &quot;dimensions&quot;: { # The map holding related quota dimensions.
914 &quot;a_key&quot;: &quot;A String&quot;,
915 },
916 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
917 # type or metric.
918 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
919 # or metric.
920 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
921 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
922 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
923 },
924 },
925 ],
926 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
927 # This property is optional.
928 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
929 },
930 ],
931 },
932 &quot;lastAttempt&quot;: { # Output only. Information about the last attempt to fulfill the request. The value is
933 # temporary since the ResizeRequest can retry, as long as it&#x27;s still active
934 # and the last attempt value can either be cleared or replaced with a
935 # different error. Since ResizeRequest retries infrequently, the value may
936 # be stale and no longer show an active problem. The value is cleared when
937 # ResizeRequest transitions to the final state (becomes inactive). If the
938 # final state is FAILED the error describing it will be stored in the
939 # &quot;error&quot; field only.
940 &quot;error&quot;: { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
941 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
942 # operation.
943 {
944 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
945 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
946 # details. There is a set of defined message types to use for providing
947 # details.The syntax depends on the error code. For example,
948 # QuotaExceededInfo will have details when the error code is
949 # QUOTA_EXCEEDED.
950 {
951 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
952 #
953 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
954 # is not enabled:
955 #
956 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
957 # &quot;domain&quot;: &quot;googleapis.com&quot;
958 # &quot;metadata&quot;: {
959 # &quot;resource&quot;: &quot;projects/123&quot;,
960 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
961 # }
962 # }
963 #
964 # This response indicates that the pubsub.googleapis.com API is not enabled.
965 #
966 # Example of an error that is returned when attempting to create a Spanner
967 # instance in a region that is out of stock:
968 #
969 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
970 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
971 # &quot;metadata&quot;: {
972 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
973 # }
974 # }
975 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
976 # is typically the registered service name of the tool or product that
977 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
978 # generated by some common infrastructure, the error domain must be a
979 # globally unique value that identifies the infrastructure. For Google API
980 # infrastructure, the error domain is &quot;googleapis.com&quot;.
981 &quot;metadatas&quot;: { # Additional structured details about this error.
982 #
983 # Keys must match a regular expression of `a-z+` but should
984 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
985 # length. When identifying the current value of an exceeded limit, the units
986 # should be contained in the key, not the value. For example, rather than
987 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
988 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
989 # instances that can be created in a single (batch) request.
990 &quot;a_key&quot;: &quot;A String&quot;,
991 },
992 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
993 # proximate cause of the error. Error reasons are unique within a particular
994 # domain of errors. This should be at most 63 characters and match a
995 # regular expression of `A-Z+[A-Z0-9]`, which represents
996 # UPPER_SNAKE_CASE.
997 },
998 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
999 #
1000 # For example, if a quota check failed with an error indicating the calling
1001 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1002 # directly to the right place in the developer console to flip the bit.
1003 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1004 { # Describes a URL link.
1005 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1006 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1007 },
1008 ],
1009 },
1010 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1011 # which can be attached to an RPC error.
1012 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1013 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1014 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1015 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1016 },
1017 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1018 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1019 &quot;a_key&quot;: &quot;A String&quot;,
1020 },
1021 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1022 # type or metric.
1023 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1024 # or metric.
1025 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1026 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1027 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1028 },
1029 },
1030 ],
1031 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1032 # This property is optional.
1033 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1034 },
1035 ],
1036 },
1037 },
1038 },
1039 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of a zone
1040 # where the resize request is located. Populated only for zonal resize
1041 # requests.
1042 }</pre>
1043 </div>
1044
1045 <div class="method">
1046 <code class="details" id="insert">insert(project, zone, instanceGroupManager, body=None, requestId=None, x__xgafv=None)</code>
1047 <pre>Creates a new resize request that starts provisioning VMs immediately
1048 or queues VM creation.
1049
1050 Args:
1051 project: string, Project ID for this request. (required)
1052 zone: string, The name of thezone where the managed
1053 instance group is located and where the resize request will be created.
1054 Name should conform to RFC1035. (required)
1055 instanceGroupManager: string, The name of the managed instance group to which the resize request will
1056 be added.
1057 Name should conform to RFC1035 or be a resource ID. (required)
1058 body: object, The request body.
1059 The object takes the form of:
1060
1061 { # InstanceGroupManagerResizeRequest represents a request to create
1062 # a number of VMs: either immediately or by queuing the request for the
1063 # specified time. This resize request is nested under InstanceGroupManager
1064 # and the VMs created by this request are added to the owning
1065 # InstanceGroupManager.
1066 &quot;count&quot;: 42, # This field is deprecated, please use resize_by instead.
1067 # The count of instances to create as part of this resize request.
1068 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this resize request inRFC3339
1069 # text format.
1070 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
1071 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server generates this
1072 # identifier.
1073 &quot;instances&quot;: [ # The names of instances to be created by this resize request. The number of
1074 # names specified determines the number of instances to create. The group&#x27;s
1075 # target size will be increased by this number. This field cannot be used
1076 # together with &#x27;resize_by&#x27;.
1077 {
1078 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
1079 # optimistic locking. It is ignored when inserting a per-instance
1080 # config. An up-to-date fingerprint must be provided in order to update an
1081 # existing per-instance configuration or the field needs to be unset.
1082 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
1083 # Serves as a merge key during UpdatePerInstanceConfigs
1084 # operations, that is, if a per-instance configuration with the same name
1085 # exists then it will be updated, otherwise a new one will be created for the
1086 # VM instance with the same name. An attempt to create a per-instance
1087 # configuration for a VM instance that either doesn&#x27;t exist or is not part
1088 # of the group will result in an error.
1089 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
1090 # preserved state generated from a stateful policy.
1091 &quot;disks&quot;: { # Preserved disks defined for this instance.
1092 # This map is keyed with the device names of the disks.
1093 &quot;a_key&quot;: {
1094 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
1095 # update, instance recreate operations. This flag is used to configure
1096 # if the disk should be deleted after it is no longer used by the group,
1097 # e.g. when the given instance or the whole MIG is deleted.
1098 # Note: disks attached in READ_ONLY mode cannot be
1099 # auto-deleted.
1100 &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
1101 # disk in READ_WRITE mode.
1102 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
1103 # to the VM instance.
1104 },
1105 },
1106 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
1107 # This map is keyed with the name of the network interface.
1108 &quot;a_key&quot;: {
1109 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1110 # update or VM instance recreate operations.
1111 # This flag is used to configure if the IP reservation should be deleted
1112 # after it is no longer used by the group, e.g. when the given instance
1113 # or the whole group is deleted.
1114 &quot;ipAddress&quot;: { # Ip address representation
1115 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1116 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1117 # network interface.
1118 },
1119 },
1120 },
1121 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
1122 # This map is keyed with the name of the network interface.
1123 &quot;a_key&quot;: {
1124 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1125 # update or VM instance recreate operations.
1126 # This flag is used to configure if the IP reservation should be deleted
1127 # after it is no longer used by the group, e.g. when the given instance
1128 # or the whole group is deleted.
1129 &quot;ipAddress&quot;: { # Ip address representation
1130 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1131 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1132 # network interface.
1133 },
1134 },
1135 },
1136 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
1137 &quot;a_key&quot;: &quot;A String&quot;,
1138 },
1139 },
1140 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
1141 # managed instance.
1142 },
1143 ],
1144 &quot;kind&quot;: &quot;compute#instanceGroupManagerResizeRequest&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
1145 &quot;name&quot;: &quot;A String&quot;, # The name of this resize request. The name must be 1-63 characters
1146 # long, and comply withRFC1035.
1147 &quot;region&quot;: &quot;A String&quot;, # Output only. The URL of a region
1148 # where the resize request is located. Populated only for regional resize
1149 # requests.
1150 &quot;requestedRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Requested run duration for instances that will be created by this request.
1151 # At the end of the run duration instance will be deleted.
1152 # as a count of seconds and fractions of seconds at nanosecond
1153 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1154 # or &quot;month&quot;. Range is approximately 10,000 years.
1155 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1156 # Durations less than one second are represented with a 0
1157 # `seconds` field and a positive `nanos` field. Must be from 0
1158 # to 999,999,999 inclusive.
1159 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1160 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1161 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1162 },
1163 &quot;resizeBy&quot;: 42, # The number of instances to be created by this resize request. The group&#x27;s
1164 # target size will be increased by this number. This field cannot be used
1165 # together with &#x27;instances&#x27;.
1166 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this resize request. The server defines this URL.
1167 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
1168 &quot;state&quot;: &quot;A String&quot;, # Output only. Current state of the request.
1169 &quot;status&quot;: { # Output only. Status of the request.
1170 &quot;error&quot;: { # Output only. Fatal errors encountered during the queueing or provisioning phases of
1171 # the ResizeRequest that caused the transition to the FAILED state.
1172 # Contrary to the last_attempt errors, this field is final and errors are
1173 # never removed from here, as the ResizeRequest is not going to retry.
1174 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1175 # operation.
1176 {
1177 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1178 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1179 # details. There is a set of defined message types to use for providing
1180 # details.The syntax depends on the error code. For example,
1181 # QuotaExceededInfo will have details when the error code is
1182 # QUOTA_EXCEEDED.
1183 {
1184 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1185 #
1186 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1187 # is not enabled:
1188 #
1189 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1190 # &quot;domain&quot;: &quot;googleapis.com&quot;
1191 # &quot;metadata&quot;: {
1192 # &quot;resource&quot;: &quot;projects/123&quot;,
1193 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1194 # }
1195 # }
1196 #
1197 # This response indicates that the pubsub.googleapis.com API is not enabled.
1198 #
1199 # Example of an error that is returned when attempting to create a Spanner
1200 # instance in a region that is out of stock:
1201 #
1202 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1203 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1204 # &quot;metadata&quot;: {
1205 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1206 # }
1207 # }
1208 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1209 # is typically the registered service name of the tool or product that
1210 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1211 # generated by some common infrastructure, the error domain must be a
1212 # globally unique value that identifies the infrastructure. For Google API
1213 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1214 &quot;metadatas&quot;: { # Additional structured details about this error.
1215 #
1216 # Keys must match a regular expression of `a-z+` but should
1217 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1218 # length. When identifying the current value of an exceeded limit, the units
1219 # should be contained in the key, not the value. For example, rather than
1220 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1221 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1222 # instances that can be created in a single (batch) request.
1223 &quot;a_key&quot;: &quot;A String&quot;,
1224 },
1225 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1226 # proximate cause of the error. Error reasons are unique within a particular
1227 # domain of errors. This should be at most 63 characters and match a
1228 # regular expression of `A-Z+[A-Z0-9]`, which represents
1229 # UPPER_SNAKE_CASE.
1230 },
1231 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1232 #
1233 # For example, if a quota check failed with an error indicating the calling
1234 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1235 # directly to the right place in the developer console to flip the bit.
1236 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1237 { # Describes a URL link.
1238 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1239 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1240 },
1241 ],
1242 },
1243 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1244 # which can be attached to an RPC error.
1245 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1246 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1247 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1248 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1249 },
1250 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1251 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1252 &quot;a_key&quot;: &quot;A String&quot;,
1253 },
1254 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1255 # type or metric.
1256 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1257 # or metric.
1258 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1259 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1260 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1261 },
1262 },
1263 ],
1264 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1265 # This property is optional.
1266 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1267 },
1268 ],
1269 },
1270 &quot;lastAttempt&quot;: { # Output only. Information about the last attempt to fulfill the request. The value is
1271 # temporary since the ResizeRequest can retry, as long as it&#x27;s still active
1272 # and the last attempt value can either be cleared or replaced with a
1273 # different error. Since ResizeRequest retries infrequently, the value may
1274 # be stale and no longer show an active problem. The value is cleared when
1275 # ResizeRequest transitions to the final state (becomes inactive). If the
1276 # final state is FAILED the error describing it will be stored in the
1277 # &quot;error&quot; field only.
1278 &quot;error&quot;: { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
1279 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1280 # operation.
1281 {
1282 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1283 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1284 # details. There is a set of defined message types to use for providing
1285 # details.The syntax depends on the error code. For example,
1286 # QuotaExceededInfo will have details when the error code is
1287 # QUOTA_EXCEEDED.
1288 {
1289 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1290 #
1291 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1292 # is not enabled:
1293 #
1294 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1295 # &quot;domain&quot;: &quot;googleapis.com&quot;
1296 # &quot;metadata&quot;: {
1297 # &quot;resource&quot;: &quot;projects/123&quot;,
1298 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1299 # }
1300 # }
1301 #
1302 # This response indicates that the pubsub.googleapis.com API is not enabled.
1303 #
1304 # Example of an error that is returned when attempting to create a Spanner
1305 # instance in a region that is out of stock:
1306 #
1307 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1308 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1309 # &quot;metadata&quot;: {
1310 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1311 # }
1312 # }
1313 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1314 # is typically the registered service name of the tool or product that
1315 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1316 # generated by some common infrastructure, the error domain must be a
1317 # globally unique value that identifies the infrastructure. For Google API
1318 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1319 &quot;metadatas&quot;: { # Additional structured details about this error.
1320 #
1321 # Keys must match a regular expression of `a-z+` but should
1322 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1323 # length. When identifying the current value of an exceeded limit, the units
1324 # should be contained in the key, not the value. For example, rather than
1325 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1326 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1327 # instances that can be created in a single (batch) request.
1328 &quot;a_key&quot;: &quot;A String&quot;,
1329 },
1330 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1331 # proximate cause of the error. Error reasons are unique within a particular
1332 # domain of errors. This should be at most 63 characters and match a
1333 # regular expression of `A-Z+[A-Z0-9]`, which represents
1334 # UPPER_SNAKE_CASE.
1335 },
1336 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1337 #
1338 # For example, if a quota check failed with an error indicating the calling
1339 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1340 # directly to the right place in the developer console to flip the bit.
1341 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1342 { # Describes a URL link.
1343 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1344 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1345 },
1346 ],
1347 },
1348 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1349 # which can be attached to an RPC error.
1350 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1351 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1352 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1353 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1354 },
1355 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1356 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1357 &quot;a_key&quot;: &quot;A String&quot;,
1358 },
1359 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1360 # type or metric.
1361 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1362 # or metric.
1363 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1364 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1365 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1366 },
1367 },
1368 ],
1369 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1370 # This property is optional.
1371 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1372 },
1373 ],
1374 },
1375 },
1376 },
1377 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of a zone
1378 # where the resize request is located. Populated only for zonal resize
1379 # requests.
1380 }
1381
1382 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1383 that if you must retry your request, the server will know to ignore the
1384 request if it has already been completed.
1385
1386 For example, consider a situation where you make an initial request and
1387 the request times out. If you make the request again with the same
1388 request ID, the server can check if original operation with the same
1389 request ID was received, and if so, will ignore the second request. This
1390 prevents clients from accidentally creating duplicate commitments.
1391
1392 The request ID must be
1393 a valid UUID with the exception that zero UUID is not supported
1394 (00000000-0000-0000-0000-000000000000).
1395 x__xgafv: string, V1 error format.
1396 Allowed values
1397 1 - v1 error format
1398 2 - v2 error format
1399
1400 Returns:
1401 An object of the form:
1402
1403 { # Represents an Operation resource.
1404 #
1405 # Google Compute Engine has three Operation resources:
1406 #
1407 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
1408 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
1409 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
1410 #
1411 # You can use an operation resource to manage asynchronous API requests.
1412 # For more information, readHandling
1413 # API responses.
1414 #
1415 # Operations can be global, regional or zonal.
1416 #
1417 # - For global operations, use the `globalOperations`
1418 # resource.
1419 # - For regional operations, use the
1420 # `regionOperations` resource.
1421 # - For zonal operations, use
1422 # the `zoneOperations` resource.
1423 #
1424 #
1425 #
1426 # For more information, read
1427 # Global, Regional, and Zonal Resources.
1428 #
1429 # Note that completed Operation resources have a limited
1430 # retention period.
1431 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1432 # Not present otherwise.
1433 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1434 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1435 # set when the operation is created.
1436 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1437 # text format.
1438 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1439 # this field will be populated.
1440 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1441 # operation.
1442 {
1443 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1444 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1445 # details. There is a set of defined message types to use for providing
1446 # details.The syntax depends on the error code. For example,
1447 # QuotaExceededInfo will have details when the error code is
1448 # QUOTA_EXCEEDED.
1449 {
1450 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1451 #
1452 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1453 # is not enabled:
1454 #
1455 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1456 # &quot;domain&quot;: &quot;googleapis.com&quot;
1457 # &quot;metadata&quot;: {
1458 # &quot;resource&quot;: &quot;projects/123&quot;,
1459 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1460 # }
1461 # }
1462 #
1463 # This response indicates that the pubsub.googleapis.com API is not enabled.
1464 #
1465 # Example of an error that is returned when attempting to create a Spanner
1466 # instance in a region that is out of stock:
1467 #
1468 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1469 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1470 # &quot;metadata&quot;: {
1471 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1472 # }
1473 # }
1474 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1475 # is typically the registered service name of the tool or product that
1476 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1477 # generated by some common infrastructure, the error domain must be a
1478 # globally unique value that identifies the infrastructure. For Google API
1479 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1480 &quot;metadatas&quot;: { # Additional structured details about this error.
1481 #
1482 # Keys must match a regular expression of `a-z+` but should
1483 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1484 # length. When identifying the current value of an exceeded limit, the units
1485 # should be contained in the key, not the value. For example, rather than
1486 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1487 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1488 # instances that can be created in a single (batch) request.
1489 &quot;a_key&quot;: &quot;A String&quot;,
1490 },
1491 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1492 # proximate cause of the error. Error reasons are unique within a particular
1493 # domain of errors. This should be at most 63 characters and match a
1494 # regular expression of `A-Z+[A-Z0-9]`, which represents
1495 # UPPER_SNAKE_CASE.
1496 },
1497 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1498 #
1499 # For example, if a quota check failed with an error indicating the calling
1500 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1501 # directly to the right place in the developer console to flip the bit.
1502 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1503 { # Describes a URL link.
1504 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1505 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1506 },
1507 ],
1508 },
1509 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1510 # which can be attached to an RPC error.
1511 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1512 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1513 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1514 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1515 },
1516 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1517 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1518 &quot;a_key&quot;: &quot;A String&quot;,
1519 },
1520 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1521 # type or metric.
1522 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1523 # or metric.
1524 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1525 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1526 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1527 },
1528 },
1529 ],
1530 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1531 # This property is optional.
1532 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1533 },
1534 ],
1535 },
1536 &quot;getVersionOperationMetadata&quot;: {
1537 &quot;inlineSbomInfo&quot;: {
1538 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1539 # appropriate identifiers.
1540 &quot;a_key&quot;: &quot;A String&quot;,
1541 },
1542 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1543 # identifiers.
1544 &quot;a_key&quot;: &quot;A String&quot;,
1545 },
1546 },
1547 },
1548 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1549 # message that was returned, such as `NOT FOUND`.
1550 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1551 # status code that was returned. For example, a `404` means the
1552 # resource was not found.
1553 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1554 # defined by the server.
1555 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1556 # This value is inRFC3339
1557 # text format.
1558 &quot;instancesBulkInsertOperationMetadata&quot;: {
1559 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1560 # Example key: zones/us-central1-a
1561 &quot;a_key&quot;: {
1562 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1563 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1564 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1565 # error.
1566 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1567 # if the flow is rolling forward or rolling back.
1568 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1569 },
1570 },
1571 },
1572 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1573 # Operation resources.
1574 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1575 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1576 # group of operations results from a `bulkInsert` API request.
1577 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1578 # `update`, or `delete`, and so on.
1579 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1580 # There is no requirement that this be linear or support any granularity of
1581 # operations. This should not be used to guess when the operation will be
1582 # complete. This number should monotonically increase as the operation
1583 # progresses.
1584 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1585 # applicable when performing regional operations.
1586 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1587 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1588 # this field will contain information on all underlying zonal actions and
1589 # their state.
1590 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1591 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1592 # Example key: zones/us-central1-a
1593 &quot;a_key&quot;: {
1594 &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
1595 # populated.
1596 # different programming environments, including REST APIs and RPC APIs. It is
1597 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1598 # three pieces of data: error code, error message, and error details.
1599 #
1600 # You can find out more about this error model and how to work with it in the
1601 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1602 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1603 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1604 # message types for APIs to use.
1605 {
1606 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1607 },
1608 ],
1609 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1610 # user-facing error message should be localized and sent in the
1611 # google.rpc.Status.details field, or localized by the client.
1612 },
1613 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1614 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1615 },
1616 },
1617 },
1618 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1619 # This value is inRFC3339
1620 # text format.
1621 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1622 # following:
1623 # `PENDING`, `RUNNING`, or `DONE`.
1624 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1625 # operation.
1626 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1627 # of the target resource.
1628 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1629 # operations related to creating a snapshot, this points to the disk
1630 # that the snapshot was created from.
1631 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1632 # `[email protected]` or
1633 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1634 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1635 # operation, this field will be populated.
1636 {
1637 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1638 # Engine returns NO_RESULTS_ON_PAGE if there
1639 # are no results in the response.
1640 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1641 # value format. For example:
1642 #
1643 # &quot;data&quot;: [
1644 # {
1645 # &quot;key&quot;: &quot;scope&quot;,
1646 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1647 # }
1648 {
1649 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1650 # returned. For example, for warnings where there are no results in a list
1651 # request for a particular zone, this key might be scope and
1652 # the key value might be the zone name. Other examples might be a key
1653 # indicating a deprecated resource and a suggested replacement, or a
1654 # warning about invalid network settings (for example, if an instance
1655 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1656 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1657 },
1658 ],
1659 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1660 },
1661 ],
1662 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1663 # applicable when performing per-zone operations.
1664 }</pre>
1665 </div>
1666
1667 <div class="method">
1668 <code class="details" id="list">list(project, zone, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
1669 <pre>Retrieves a list of resize requests that are contained in the
1670 managed instance group.
1671
1672 Args:
1673 project: string, Project ID for this request. (required)
1674 zone: string, The name of thezone where the managed
1675 instance group is located. The name should conform to RFC1035. (required)
1676 instanceGroupManager: string, The name of the managed instance group. The name should conform to RFC1035. (required)
1677 filter: string, A filter expression that filters resources listed in the response. Most
1678 Compute resources support two types of filter expressions:
1679 expressions that support regular expressions and expressions that follow
1680 API improvement proposal AIP-160.
1681 These two types of filter expressions cannot be mixed in one request.
1682
1683 If you want to use AIP-160, your expression must specify the field name, an
1684 operator, and the value that you want to use for filtering. The value
1685 must be a string, a number, or a boolean. The operator
1686 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
1687
1688 For example, if you are filtering Compute Engine instances, you can
1689 exclude instances named `example-instance` by specifying
1690 `name != example-instance`.
1691
1692 The `:*` comparison can be used to test whether a key has been defined.
1693 For example, to find all objects with `owner` label use:
1694 ```
1695 labels.owner:*
1696 ```
1697
1698 You can also filter nested fields. For example, you could specify
1699 `scheduling.automaticRestart = false` to include instances only
1700 if they are not scheduled for automatic restarts. You can use filtering
1701 on nested fields to filter based onresource labels.
1702
1703 To filter on multiple expressions, provide each separate expression within
1704 parentheses. For example:
1705 ```
1706 (scheduling.automaticRestart = true)
1707 (cpuPlatform = &quot;Intel Skylake&quot;)
1708 ```
1709 By default, each expression is an `AND` expression. However, you
1710 can include `AND` and `OR` expressions explicitly.
1711 For example:
1712 ```
1713 (cpuPlatform = &quot;Intel Skylake&quot;) OR
1714 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
1715 (scheduling.automaticRestart = true)
1716 ```
1717
1718 If you want to use a regular expression, use the `eq` (equal) or `ne`
1719 (not equal) operator against a single un-parenthesized expression with or
1720 without quotes or against multiple parenthesized expressions. Examples:
1721
1722 `fieldname eq unquoted literal`
1723 `fieldname eq &#x27;single quoted literal&#x27;`
1724 `fieldname eq &quot;double quoted literal&quot;`
1725 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
1726
1727 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1728 The literal value must match the entire field.
1729
1730 For example, to filter for instances that do not end with name &quot;instance&quot;,
1731 you would use `name ne .*instance`.
1732
1733 You cannot combine constraints on multiple fields using regular
1734 expressions.
1735 maxResults: integer, The maximum number of results per page that should be returned.
1736 If the number of available results is larger than `maxResults`,
1737 Compute Engine returns a `nextPageToken` that can be used to get
1738 the next page of results in subsequent list requests. Acceptable values are
1739 `0` to `500`, inclusive. (Default: `500`)
1740 orderBy: string, Sorts list results by a certain order. By default, results
1741 are returned in alphanumerical order based on the resource name.
1742
1743 You can also sort results in descending order based on the creation
1744 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
1745 results based on the `creationTimestamp` field in
1746 reverse chronological order (newest result first). Use this to sort
1747 resources like operations so that the newest operation is returned first.
1748
1749 Currently, only sorting by `name` or
1750 `creationTimestamp desc` is supported.
1751 pageToken: string, Specifies a page token to use. Set `pageToken` to the
1752 `nextPageToken` returned by a previous list request to get
1753 the next page of results.
1754 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
1755 of failure. The default value is false.
1756
1757 For example, when partial success behavior is enabled, aggregatedList for a
1758 single zone scope either returns all resources in the zone or no resources,
1759 with an error code.
1760 x__xgafv: string, V1 error format.
1761 Allowed values
1762 1 - v1 error format
1763 2 - v2 error format
1764
1765 Returns:
1766 An object of the form:
1767
1768 { # [Output Only] A list of resize requests.
1769 &quot;id&quot;: &quot;A String&quot;, # Output only. Unique identifier for the resource; defined by the server.
1770 &quot;items&quot;: [ # A list of resize request resources.
1771 { # InstanceGroupManagerResizeRequest represents a request to create
1772 # a number of VMs: either immediately or by queuing the request for the
1773 # specified time. This resize request is nested under InstanceGroupManager
1774 # and the VMs created by this request are added to the owning
1775 # InstanceGroupManager.
1776 &quot;count&quot;: 42, # This field is deprecated, please use resize_by instead.
1777 # The count of instances to create as part of this resize request.
1778 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this resize request inRFC3339
1779 # text format.
1780 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
1781 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server generates this
1782 # identifier.
1783 &quot;instances&quot;: [ # The names of instances to be created by this resize request. The number of
1784 # names specified determines the number of instances to create. The group&#x27;s
1785 # target size will be increased by this number. This field cannot be used
1786 # together with &#x27;resize_by&#x27;.
1787 {
1788 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
1789 # optimistic locking. It is ignored when inserting a per-instance
1790 # config. An up-to-date fingerprint must be provided in order to update an
1791 # existing per-instance configuration or the field needs to be unset.
1792 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
1793 # Serves as a merge key during UpdatePerInstanceConfigs
1794 # operations, that is, if a per-instance configuration with the same name
1795 # exists then it will be updated, otherwise a new one will be created for the
1796 # VM instance with the same name. An attempt to create a per-instance
1797 # configuration for a VM instance that either doesn&#x27;t exist or is not part
1798 # of the group will result in an error.
1799 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
1800 # preserved state generated from a stateful policy.
1801 &quot;disks&quot;: { # Preserved disks defined for this instance.
1802 # This map is keyed with the device names of the disks.
1803 &quot;a_key&quot;: {
1804 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
1805 # update, instance recreate operations. This flag is used to configure
1806 # if the disk should be deleted after it is no longer used by the group,
1807 # e.g. when the given instance or the whole MIG is deleted.
1808 # Note: disks attached in READ_ONLY mode cannot be
1809 # auto-deleted.
1810 &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
1811 # disk in READ_WRITE mode.
1812 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
1813 # to the VM instance.
1814 },
1815 },
1816 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
1817 # This map is keyed with the name of the network interface.
1818 &quot;a_key&quot;: {
1819 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1820 # update or VM instance recreate operations.
1821 # This flag is used to configure if the IP reservation should be deleted
1822 # after it is no longer used by the group, e.g. when the given instance
1823 # or the whole group is deleted.
1824 &quot;ipAddress&quot;: { # Ip address representation
1825 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1826 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1827 # network interface.
1828 },
1829 },
1830 },
1831 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
1832 # This map is keyed with the name of the network interface.
1833 &quot;a_key&quot;: {
1834 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1835 # update or VM instance recreate operations.
1836 # This flag is used to configure if the IP reservation should be deleted
1837 # after it is no longer used by the group, e.g. when the given instance
1838 # or the whole group is deleted.
1839 &quot;ipAddress&quot;: { # Ip address representation
1840 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1841 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1842 # network interface.
1843 },
1844 },
1845 },
1846 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
1847 &quot;a_key&quot;: &quot;A String&quot;,
1848 },
1849 },
1850 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
1851 # managed instance.
1852 },
1853 ],
1854 &quot;kind&quot;: &quot;compute#instanceGroupManagerResizeRequest&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
1855 &quot;name&quot;: &quot;A String&quot;, # The name of this resize request. The name must be 1-63 characters
1856 # long, and comply withRFC1035.
1857 &quot;region&quot;: &quot;A String&quot;, # Output only. The URL of a region
1858 # where the resize request is located. Populated only for regional resize
1859 # requests.
1860 &quot;requestedRunDuration&quot;: { # A Duration represents a fixed-length span of time represented # Requested run duration for instances that will be created by this request.
1861 # At the end of the run duration instance will be deleted.
1862 # as a count of seconds and fractions of seconds at nanosecond
1863 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1864 # or &quot;month&quot;. Range is approximately 10,000 years.
1865 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1866 # Durations less than one second are represented with a 0
1867 # `seconds` field and a positive `nanos` field. Must be from 0
1868 # to 999,999,999 inclusive.
1869 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1870 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1871 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1872 },
1873 &quot;resizeBy&quot;: 42, # The number of instances to be created by this resize request. The group&#x27;s
1874 # target size will be increased by this number. This field cannot be used
1875 # together with &#x27;instances&#x27;.
1876 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this resize request. The server defines this URL.
1877 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
1878 &quot;state&quot;: &quot;A String&quot;, # Output only. Current state of the request.
1879 &quot;status&quot;: { # Output only. Status of the request.
1880 &quot;error&quot;: { # Output only. Fatal errors encountered during the queueing or provisioning phases of
1881 # the ResizeRequest that caused the transition to the FAILED state.
1882 # Contrary to the last_attempt errors, this field is final and errors are
1883 # never removed from here, as the ResizeRequest is not going to retry.
1884 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1885 # operation.
1886 {
1887 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1888 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1889 # details. There is a set of defined message types to use for providing
1890 # details.The syntax depends on the error code. For example,
1891 # QuotaExceededInfo will have details when the error code is
1892 # QUOTA_EXCEEDED.
1893 {
1894 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1895 #
1896 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1897 # is not enabled:
1898 #
1899 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1900 # &quot;domain&quot;: &quot;googleapis.com&quot;
1901 # &quot;metadata&quot;: {
1902 # &quot;resource&quot;: &quot;projects/123&quot;,
1903 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1904 # }
1905 # }
1906 #
1907 # This response indicates that the pubsub.googleapis.com API is not enabled.
1908 #
1909 # Example of an error that is returned when attempting to create a Spanner
1910 # instance in a region that is out of stock:
1911 #
1912 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1913 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1914 # &quot;metadata&quot;: {
1915 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1916 # }
1917 # }
1918 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1919 # is typically the registered service name of the tool or product that
1920 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1921 # generated by some common infrastructure, the error domain must be a
1922 # globally unique value that identifies the infrastructure. For Google API
1923 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1924 &quot;metadatas&quot;: { # Additional structured details about this error.
1925 #
1926 # Keys must match a regular expression of `a-z+` but should
1927 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1928 # length. When identifying the current value of an exceeded limit, the units
1929 # should be contained in the key, not the value. For example, rather than
1930 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1931 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1932 # instances that can be created in a single (batch) request.
1933 &quot;a_key&quot;: &quot;A String&quot;,
1934 },
1935 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1936 # proximate cause of the error. Error reasons are unique within a particular
1937 # domain of errors. This should be at most 63 characters and match a
1938 # regular expression of `A-Z+[A-Z0-9]`, which represents
1939 # UPPER_SNAKE_CASE.
1940 },
1941 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1942 #
1943 # For example, if a quota check failed with an error indicating the calling
1944 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1945 # directly to the right place in the developer console to flip the bit.
1946 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1947 { # Describes a URL link.
1948 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1949 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1950 },
1951 ],
1952 },
1953 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1954 # which can be attached to an RPC error.
1955 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1956 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1957 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1958 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1959 },
1960 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1961 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1962 &quot;a_key&quot;: &quot;A String&quot;,
1963 },
1964 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1965 # type or metric.
1966 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1967 # or metric.
1968 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1969 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1970 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1971 },
1972 },
1973 ],
1974 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1975 # This property is optional.
1976 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1977 },
1978 ],
1979 },
1980 &quot;lastAttempt&quot;: { # Output only. Information about the last attempt to fulfill the request. The value is
1981 # temporary since the ResizeRequest can retry, as long as it&#x27;s still active
1982 # and the last attempt value can either be cleared or replaced with a
1983 # different error. Since ResizeRequest retries infrequently, the value may
1984 # be stale and no longer show an active problem. The value is cleared when
1985 # ResizeRequest transitions to the final state (becomes inactive). If the
1986 # final state is FAILED the error describing it will be stored in the
1987 # &quot;error&quot; field only.
1988 &quot;error&quot;: { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
1989 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1990 # operation.
1991 {
1992 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1993 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1994 # details. There is a set of defined message types to use for providing
1995 # details.The syntax depends on the error code. For example,
1996 # QuotaExceededInfo will have details when the error code is
1997 # QUOTA_EXCEEDED.
1998 {
1999 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2000 #
2001 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2002 # is not enabled:
2003 #
2004 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2005 # &quot;domain&quot;: &quot;googleapis.com&quot;
2006 # &quot;metadata&quot;: {
2007 # &quot;resource&quot;: &quot;projects/123&quot;,
2008 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2009 # }
2010 # }
2011 #
2012 # This response indicates that the pubsub.googleapis.com API is not enabled.
2013 #
2014 # Example of an error that is returned when attempting to create a Spanner
2015 # instance in a region that is out of stock:
2016 #
2017 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2018 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2019 # &quot;metadata&quot;: {
2020 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2021 # }
2022 # }
2023 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2024 # is typically the registered service name of the tool or product that
2025 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2026 # generated by some common infrastructure, the error domain must be a
2027 # globally unique value that identifies the infrastructure. For Google API
2028 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2029 &quot;metadatas&quot;: { # Additional structured details about this error.
2030 #
2031 # Keys must match a regular expression of `a-z+` but should
2032 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2033 # length. When identifying the current value of an exceeded limit, the units
2034 # should be contained in the key, not the value. For example, rather than
2035 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2036 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2037 # instances that can be created in a single (batch) request.
2038 &quot;a_key&quot;: &quot;A String&quot;,
2039 },
2040 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2041 # proximate cause of the error. Error reasons are unique within a particular
2042 # domain of errors. This should be at most 63 characters and match a
2043 # regular expression of `A-Z+[A-Z0-9]`, which represents
2044 # UPPER_SNAKE_CASE.
2045 },
2046 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2047 #
2048 # For example, if a quota check failed with an error indicating the calling
2049 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2050 # directly to the right place in the developer console to flip the bit.
2051 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2052 { # Describes a URL link.
2053 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2054 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2055 },
2056 ],
2057 },
2058 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2059 # which can be attached to an RPC error.
2060 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2061 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2062 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2063 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2064 },
2065 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2066 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2067 &quot;a_key&quot;: &quot;A String&quot;,
2068 },
2069 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2070 # type or metric.
2071 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2072 # or metric.
2073 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2074 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2075 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2076 },
2077 },
2078 ],
2079 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2080 # This property is optional.
2081 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2082 },
2083 ],
2084 },
2085 },
2086 },
2087 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of a zone
2088 # where the resize request is located. Populated only for zonal resize
2089 # requests.
2090 },
2091 ],
2092 &quot;kind&quot;: &quot;compute#instanceGroupManagerResizeRequestList&quot;, # Output only. Type of the resource. Alwayscompute#instanceGroupManagerResizeRequestList for
2093 # a list of resize requests.
2094 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. This token allows you to get the next page of results for list requests.
2095 # If the number of results is larger than maxResults, use thenextPageToken as a value for the query parameterpageToken in the next list request.
2096 # Subsequent list requests will have their own nextPageToken to
2097 # continue paging through the results.
2098 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource.
2099 &quot;warning&quot;: { # Output only. Informational warning message.
2100 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2101 # Engine returns NO_RESULTS_ON_PAGE if there
2102 # are no results in the response.
2103 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2104 # value format. For example:
2105 #
2106 # &quot;data&quot;: [
2107 # {
2108 # &quot;key&quot;: &quot;scope&quot;,
2109 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2110 # }
2111 {
2112 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2113 # returned. For example, for warnings where there are no results in a list
2114 # request for a particular zone, this key might be scope and
2115 # the key value might be the zone name. Other examples might be a key
2116 # indicating a deprecated resource and a suggested replacement, or a
2117 # warning about invalid network settings (for example, if an instance
2118 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2119 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2120 },
2121 ],
2122 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2123 },
2124 }</pre>
2125 </div>
2126
2127 <div class="method">
2128 <code class="details" id="list_next">list_next()</code>
2129 <pre>Retrieves the next page of results.
2130
2131 Args:
2132 previous_request: The request for the previous page. (required)
2133 previous_response: The response from the request for the previous page. (required)
2134
2135 Returns:
2136 A request object that you can call &#x27;execute()&#x27; on to request the next
2137 page. Returns None if there are no more items in the collection.
2138 </pre>
2139 </div>
2140
2141 </body></html>