Debian Codegraph @

docs/dyn/compute_beta.regionInstanceGroupManagerResizeRequests.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.regionInstanceGroupManagerResizeRequests.html">regionInstanceGroupManagerResizeRequests</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#cancel">cancel(project, region, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Cancels the specified resize request.</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, region, 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, region, 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, region, 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, region, 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, region, instanceGroupManager, resizeRequest, requestId=None, x__xgafv=None)</code>
101 <pre>Cancels the specified resize request.
102 Cancelled resize request no longer waits for the resources to be
103 provisioned. Cancel is only possible for requests that are in accepted
104 state.
105
106 Args:
107 project: string, Project ID for this request. (required)
108 region: string, The name of the region
109 scoping this request. Name should conform to RFC1035. (required)
110 instanceGroupManager: string, The name of the managed instance group.
111 Name should conform to RFC1035 or be a resource ID. (required)
112 resizeRequest: string, The name of the resize request to cancel.
113 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, region, 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 region: string, The name of the region
413 scoping this request. Name should conform to RFC1035. (required)
414 instanceGroupManager: string, The name of the managed instance group.
415 Name should conform to RFC1035 or be a resource ID. (required)
416 resizeRequest: string, The name of the resize request to delete.
417 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, region, 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 region: string, The name of the region
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, region, 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 region: string, Name of the region
1053 scoping this request. Name should conform to RFC1035. (required)
1054 instanceGroupManager: string, Name of the managed instance group to which the resize request is scoped.
1055 Name should conform to RFC1035 or be a resource ID. (required)
1056 body: object, The request body.
1057 The object takes the form of:
1058
1059 { # InstanceGroupManagerResizeRequest represents a request to create
1060 # a number of VMs: either immediately or by queuing the request for the
1061 # specified time. This resize request is nested under InstanceGroupManager
1062 # and the VMs created by this request are added to the owning
1063 # InstanceGroupManager.
1064 &quot;count&quot;: 42, # This field is deprecated, please use resize_by instead.
1065 # The count of instances to create as part of this resize request.
1066 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this resize request inRFC3339
1067 # text format.
1068 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
1069 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server generates this
1070 # identifier.
1071 &quot;instances&quot;: [ # The names of instances to be created by this resize request. The number of
1072 # names specified determines the number of instances to create. The group&#x27;s
1073 # target size will be increased by this number. This field cannot be used
1074 # together with &#x27;resize_by&#x27;.
1075 {
1076 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
1077 # optimistic locking. It is ignored when inserting a per-instance
1078 # config. An up-to-date fingerprint must be provided in order to update an
1079 # existing per-instance configuration or the field needs to be unset.
1080 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
1081 # Serves as a merge key during UpdatePerInstanceConfigs
1082 # operations, that is, if a per-instance configuration with the same name
1083 # exists then it will be updated, otherwise a new one will be created for the
1084 # VM instance with the same name. An attempt to create a per-instance
1085 # configuration for a VM instance that either doesn&#x27;t exist or is not part
1086 # of the group will result in an error.
1087 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
1088 # preserved state generated from a stateful policy.
1089 &quot;disks&quot;: { # Preserved disks defined for this instance.
1090 # This map is keyed with the device names of the disks.
1091 &quot;a_key&quot;: {
1092 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
1093 # update, instance recreate operations. This flag is used to configure
1094 # if the disk should be deleted after it is no longer used by the group,
1095 # e.g. when the given instance or the whole MIG is deleted.
1096 # Note: disks attached in READ_ONLY mode cannot be
1097 # auto-deleted.
1098 &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
1099 # disk in READ_WRITE mode.
1100 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
1101 # to the VM instance.
1102 },
1103 },
1104 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
1105 # This map is keyed with the name of the network interface.
1106 &quot;a_key&quot;: {
1107 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1108 # update or VM instance recreate operations.
1109 # This flag is used to configure if the IP reservation should be deleted
1110 # after it is no longer used by the group, e.g. when the given instance
1111 # or the whole group is deleted.
1112 &quot;ipAddress&quot;: { # Ip address representation
1113 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1114 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1115 # network interface.
1116 },
1117 },
1118 },
1119 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
1120 # This map is keyed with the name of the network interface.
1121 &quot;a_key&quot;: {
1122 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1123 # update or VM instance recreate operations.
1124 # This flag is used to configure if the IP reservation should be deleted
1125 # after it is no longer used by the group, e.g. when the given instance
1126 # or the whole group is deleted.
1127 &quot;ipAddress&quot;: { # Ip address representation
1128 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1129 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1130 # network interface.
1131 },
1132 },
1133 },
1134 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
1135 &quot;a_key&quot;: &quot;A String&quot;,
1136 },
1137 },
1138 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
1139 # managed instance.
1140 },
1141 ],
1142 &quot;kind&quot;: &quot;compute#instanceGroupManagerResizeRequest&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
1143 &quot;name&quot;: &quot;A String&quot;, # The name of this resize request. The name must be 1-63 characters
1144 # long, and comply withRFC1035.
1145 &quot;region&quot;: &quot;A String&quot;, # Output only. The URL of a region
1146 # where the resize request is located. Populated only for regional resize
1147 # requests.
1148 &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.
1149 # At the end of the run duration instance will be deleted.
1150 # as a count of seconds and fractions of seconds at nanosecond
1151 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1152 # or &quot;month&quot;. Range is approximately 10,000 years.
1153 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1154 # Durations less than one second are represented with a 0
1155 # `seconds` field and a positive `nanos` field. Must be from 0
1156 # to 999,999,999 inclusive.
1157 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1158 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1159 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1160 },
1161 &quot;resizeBy&quot;: 42, # The number of instances to be created by this resize request. The group&#x27;s
1162 # target size will be increased by this number. This field cannot be used
1163 # together with &#x27;instances&#x27;.
1164 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this resize request. The server defines this URL.
1165 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
1166 &quot;state&quot;: &quot;A String&quot;, # Output only. Current state of the request.
1167 &quot;status&quot;: { # Output only. Status of the request.
1168 &quot;error&quot;: { # Output only. Fatal errors encountered during the queueing or provisioning phases of
1169 # the ResizeRequest that caused the transition to the FAILED state.
1170 # Contrary to the last_attempt errors, this field is final and errors are
1171 # never removed from here, as the ResizeRequest is not going to retry.
1172 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1173 # operation.
1174 {
1175 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1176 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1177 # details. There is a set of defined message types to use for providing
1178 # details.The syntax depends on the error code. For example,
1179 # QuotaExceededInfo will have details when the error code is
1180 # QUOTA_EXCEEDED.
1181 {
1182 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1183 #
1184 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1185 # is not enabled:
1186 #
1187 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1188 # &quot;domain&quot;: &quot;googleapis.com&quot;
1189 # &quot;metadata&quot;: {
1190 # &quot;resource&quot;: &quot;projects/123&quot;,
1191 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1192 # }
1193 # }
1194 #
1195 # This response indicates that the pubsub.googleapis.com API is not enabled.
1196 #
1197 # Example of an error that is returned when attempting to create a Spanner
1198 # instance in a region that is out of stock:
1199 #
1200 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1201 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1202 # &quot;metadata&quot;: {
1203 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1204 # }
1205 # }
1206 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1207 # is typically the registered service name of the tool or product that
1208 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1209 # generated by some common infrastructure, the error domain must be a
1210 # globally unique value that identifies the infrastructure. For Google API
1211 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1212 &quot;metadatas&quot;: { # Additional structured details about this error.
1213 #
1214 # Keys must match a regular expression of `a-z+` but should
1215 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1216 # length. When identifying the current value of an exceeded limit, the units
1217 # should be contained in the key, not the value. For example, rather than
1218 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1219 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1220 # instances that can be created in a single (batch) request.
1221 &quot;a_key&quot;: &quot;A String&quot;,
1222 },
1223 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1224 # proximate cause of the error. Error reasons are unique within a particular
1225 # domain of errors. This should be at most 63 characters and match a
1226 # regular expression of `A-Z+[A-Z0-9]`, which represents
1227 # UPPER_SNAKE_CASE.
1228 },
1229 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1230 #
1231 # For example, if a quota check failed with an error indicating the calling
1232 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1233 # directly to the right place in the developer console to flip the bit.
1234 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1235 { # Describes a URL link.
1236 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1237 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1238 },
1239 ],
1240 },
1241 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1242 # which can be attached to an RPC error.
1243 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1244 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1245 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1246 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1247 },
1248 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1249 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1250 &quot;a_key&quot;: &quot;A String&quot;,
1251 },
1252 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1253 # type or metric.
1254 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1255 # or metric.
1256 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1257 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1258 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1259 },
1260 },
1261 ],
1262 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1263 # This property is optional.
1264 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1265 },
1266 ],
1267 },
1268 &quot;lastAttempt&quot;: { # Output only. Information about the last attempt to fulfill the request. The value is
1269 # temporary since the ResizeRequest can retry, as long as it&#x27;s still active
1270 # and the last attempt value can either be cleared or replaced with a
1271 # different error. Since ResizeRequest retries infrequently, the value may
1272 # be stale and no longer show an active problem. The value is cleared when
1273 # ResizeRequest transitions to the final state (becomes inactive). If the
1274 # final state is FAILED the error describing it will be stored in the
1275 # &quot;error&quot; field only.
1276 &quot;error&quot;: { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
1277 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1278 # operation.
1279 {
1280 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1281 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1282 # details. There is a set of defined message types to use for providing
1283 # details.The syntax depends on the error code. For example,
1284 # QuotaExceededInfo will have details when the error code is
1285 # QUOTA_EXCEEDED.
1286 {
1287 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1288 #
1289 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1290 # is not enabled:
1291 #
1292 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1293 # &quot;domain&quot;: &quot;googleapis.com&quot;
1294 # &quot;metadata&quot;: {
1295 # &quot;resource&quot;: &quot;projects/123&quot;,
1296 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1297 # }
1298 # }
1299 #
1300 # This response indicates that the pubsub.googleapis.com API is not enabled.
1301 #
1302 # Example of an error that is returned when attempting to create a Spanner
1303 # instance in a region that is out of stock:
1304 #
1305 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1306 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1307 # &quot;metadata&quot;: {
1308 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1309 # }
1310 # }
1311 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1312 # is typically the registered service name of the tool or product that
1313 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1314 # generated by some common infrastructure, the error domain must be a
1315 # globally unique value that identifies the infrastructure. For Google API
1316 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1317 &quot;metadatas&quot;: { # Additional structured details about this error.
1318 #
1319 # Keys must match a regular expression of `a-z+` but should
1320 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1321 # length. When identifying the current value of an exceeded limit, the units
1322 # should be contained in the key, not the value. For example, rather than
1323 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1324 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1325 # instances that can be created in a single (batch) request.
1326 &quot;a_key&quot;: &quot;A String&quot;,
1327 },
1328 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1329 # proximate cause of the error. Error reasons are unique within a particular
1330 # domain of errors. This should be at most 63 characters and match a
1331 # regular expression of `A-Z+[A-Z0-9]`, which represents
1332 # UPPER_SNAKE_CASE.
1333 },
1334 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1335 #
1336 # For example, if a quota check failed with an error indicating the calling
1337 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1338 # directly to the right place in the developer console to flip the bit.
1339 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1340 { # Describes a URL link.
1341 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1342 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1343 },
1344 ],
1345 },
1346 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1347 # which can be attached to an RPC error.
1348 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1349 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1350 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1351 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1352 },
1353 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1354 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1355 &quot;a_key&quot;: &quot;A String&quot;,
1356 },
1357 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1358 # type or metric.
1359 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1360 # or metric.
1361 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1362 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1363 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1364 },
1365 },
1366 ],
1367 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1368 # This property is optional.
1369 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1370 },
1371 ],
1372 },
1373 },
1374 },
1375 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of a zone
1376 # where the resize request is located. Populated only for zonal resize
1377 # requests.
1378 }
1379
1380 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1381 that if you must retry your request, the server will know to ignore the
1382 request if it has already been completed.
1383
1384 For example, consider a situation where you make an initial request and
1385 the request times out. If you make the request again with the same
1386 request ID, the server can check if original operation with the same
1387 request ID was received, and if so, will ignore the second request. This
1388 prevents clients from accidentally creating duplicate commitments.
1389
1390 The request ID must be
1391 a valid UUID with the exception that zero UUID is not supported
1392 (00000000-0000-0000-0000-000000000000).
1393 x__xgafv: string, V1 error format.
1394 Allowed values
1395 1 - v1 error format
1396 2 - v2 error format
1397
1398 Returns:
1399 An object of the form:
1400
1401 { # Represents an Operation resource.
1402 #
1403 # Google Compute Engine has three Operation resources:
1404 #
1405 # * [Global](/compute/docs/reference/rest/beta/globalOperations)
1406 # * [Regional](/compute/docs/reference/rest/beta/regionOperations)
1407 # * [Zonal](/compute/docs/reference/rest/beta/zoneOperations)
1408 #
1409 # You can use an operation resource to manage asynchronous API requests.
1410 # For more information, readHandling
1411 # API responses.
1412 #
1413 # Operations can be global, regional or zonal.
1414 #
1415 # - For global operations, use the `globalOperations`
1416 # resource.
1417 # - For regional operations, use the
1418 # `regionOperations` resource.
1419 # - For zonal operations, use
1420 # the `zoneOperations` resource.
1421 #
1422 #
1423 #
1424 # For more information, read
1425 # Global, Regional, and Zonal Resources.
1426 #
1427 # Note that completed Operation resources have a limited
1428 # retention period.
1429 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1430 # Not present otherwise.
1431 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1432 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1433 # set when the operation is created.
1434 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1435 # text format.
1436 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1437 # this field will be populated.
1438 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1439 # operation.
1440 {
1441 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1442 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1443 # details. There is a set of defined message types to use for providing
1444 # details.The syntax depends on the error code. For example,
1445 # QuotaExceededInfo will have details when the error code is
1446 # QUOTA_EXCEEDED.
1447 {
1448 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1449 #
1450 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1451 # is not enabled:
1452 #
1453 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1454 # &quot;domain&quot;: &quot;googleapis.com&quot;
1455 # &quot;metadata&quot;: {
1456 # &quot;resource&quot;: &quot;projects/123&quot;,
1457 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1458 # }
1459 # }
1460 #
1461 # This response indicates that the pubsub.googleapis.com API is not enabled.
1462 #
1463 # Example of an error that is returned when attempting to create a Spanner
1464 # instance in a region that is out of stock:
1465 #
1466 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1467 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1468 # &quot;metadata&quot;: {
1469 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1470 # }
1471 # }
1472 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1473 # is typically the registered service name of the tool or product that
1474 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1475 # generated by some common infrastructure, the error domain must be a
1476 # globally unique value that identifies the infrastructure. For Google API
1477 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1478 &quot;metadatas&quot;: { # Additional structured details about this error.
1479 #
1480 # Keys must match a regular expression of `a-z+` but should
1481 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1482 # length. When identifying the current value of an exceeded limit, the units
1483 # should be contained in the key, not the value. For example, rather than
1484 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1485 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1486 # instances that can be created in a single (batch) request.
1487 &quot;a_key&quot;: &quot;A String&quot;,
1488 },
1489 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1490 # proximate cause of the error. Error reasons are unique within a particular
1491 # domain of errors. This should be at most 63 characters and match a
1492 # regular expression of `A-Z+[A-Z0-9]`, which represents
1493 # UPPER_SNAKE_CASE.
1494 },
1495 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1496 #
1497 # For example, if a quota check failed with an error indicating the calling
1498 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1499 # directly to the right place in the developer console to flip the bit.
1500 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1501 { # Describes a URL link.
1502 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1503 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1504 },
1505 ],
1506 },
1507 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1508 # which can be attached to an RPC error.
1509 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1510 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1511 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1512 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1513 },
1514 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1515 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1516 &quot;a_key&quot;: &quot;A String&quot;,
1517 },
1518 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1519 # type or metric.
1520 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1521 # or metric.
1522 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1523 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1524 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1525 },
1526 },
1527 ],
1528 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1529 # This property is optional.
1530 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1531 },
1532 ],
1533 },
1534 &quot;getVersionOperationMetadata&quot;: {
1535 &quot;inlineSbomInfo&quot;: {
1536 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1537 # appropriate identifiers.
1538 &quot;a_key&quot;: &quot;A String&quot;,
1539 },
1540 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1541 # identifiers.
1542 &quot;a_key&quot;: &quot;A String&quot;,
1543 },
1544 },
1545 },
1546 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1547 # message that was returned, such as `NOT FOUND`.
1548 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1549 # status code that was returned. For example, a `404` means the
1550 # resource was not found.
1551 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1552 # defined by the server.
1553 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1554 # This value is inRFC3339
1555 # text format.
1556 &quot;instancesBulkInsertOperationMetadata&quot;: {
1557 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1558 # Example key: zones/us-central1-a
1559 &quot;a_key&quot;: {
1560 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1561 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1562 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1563 # error.
1564 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1565 # if the flow is rolling forward or rolling back.
1566 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1567 },
1568 },
1569 },
1570 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1571 # Operation resources.
1572 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1573 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1574 # group of operations results from a `bulkInsert` API request.
1575 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1576 # `update`, or `delete`, and so on.
1577 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1578 # There is no requirement that this be linear or support any granularity of
1579 # operations. This should not be used to guess when the operation will be
1580 # complete. This number should monotonically increase as the operation
1581 # progresses.
1582 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1583 # applicable when performing regional operations.
1584 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1585 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1586 # this field will contain information on all underlying zonal actions and
1587 # their state.
1588 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1589 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1590 # Example key: zones/us-central1-a
1591 &quot;a_key&quot;: {
1592 &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
1593 # populated.
1594 # different programming environments, including REST APIs and RPC APIs. It is
1595 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1596 # three pieces of data: error code, error message, and error details.
1597 #
1598 # You can find out more about this error model and how to work with it in the
1599 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1600 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1601 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1602 # message types for APIs to use.
1603 {
1604 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1605 },
1606 ],
1607 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1608 # user-facing error message should be localized and sent in the
1609 # google.rpc.Status.details field, or localized by the client.
1610 },
1611 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1612 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1613 },
1614 },
1615 },
1616 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1617 # This value is inRFC3339
1618 # text format.
1619 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1620 # following:
1621 # `PENDING`, `RUNNING`, or `DONE`.
1622 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1623 # operation.
1624 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1625 # of the target resource.
1626 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1627 # operations related to creating a snapshot, this points to the disk
1628 # that the snapshot was created from.
1629 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1630 # `[email protected]` or
1631 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1632 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1633 # operation, this field will be populated.
1634 {
1635 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1636 # Engine returns NO_RESULTS_ON_PAGE if there
1637 # are no results in the response.
1638 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1639 # value format. For example:
1640 #
1641 # &quot;data&quot;: [
1642 # {
1643 # &quot;key&quot;: &quot;scope&quot;,
1644 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1645 # }
1646 {
1647 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1648 # returned. For example, for warnings where there are no results in a list
1649 # request for a particular zone, this key might be scope and
1650 # the key value might be the zone name. Other examples might be a key
1651 # indicating a deprecated resource and a suggested replacement, or a
1652 # warning about invalid network settings (for example, if an instance
1653 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1654 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1655 },
1656 ],
1657 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1658 },
1659 ],
1660 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1661 # applicable when performing per-zone operations.
1662 }</pre>
1663 </div>
1664
1665 <div class="method">
1666 <code class="details" id="list">list(project, region, instanceGroupManager, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
1667 <pre>Retrieves a list of Resize Requests that are contained in the
1668 managed instance group.
1669
1670 Args:
1671 project: string, Project ID for this request. (required)
1672 region: string, Name of the region
1673 scoping this request. Name should conform to RFC1035. (required)
1674 instanceGroupManager: string, The name of the managed instance group. The name should conform to RFC1035. (required)
1675 filter: string, A filter expression that filters resources listed in the response. Most
1676 Compute resources support two types of filter expressions:
1677 expressions that support regular expressions and expressions that follow
1678 API improvement proposal AIP-160.
1679 These two types of filter expressions cannot be mixed in one request.
1680
1681 If you want to use AIP-160, your expression must specify the field name, an
1682 operator, and the value that you want to use for filtering. The value
1683 must be a string, a number, or a boolean. The operator
1684 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
1685
1686 For example, if you are filtering Compute Engine instances, you can
1687 exclude instances named `example-instance` by specifying
1688 `name != example-instance`.
1689
1690 The `:*` comparison can be used to test whether a key has been defined.
1691 For example, to find all objects with `owner` label use:
1692 ```
1693 labels.owner:*
1694 ```
1695
1696 You can also filter nested fields. For example, you could specify
1697 `scheduling.automaticRestart = false` to include instances only
1698 if they are not scheduled for automatic restarts. You can use filtering
1699 on nested fields to filter based onresource labels.
1700
1701 To filter on multiple expressions, provide each separate expression within
1702 parentheses. For example:
1703 ```
1704 (scheduling.automaticRestart = true)
1705 (cpuPlatform = &quot;Intel Skylake&quot;)
1706 ```
1707 By default, each expression is an `AND` expression. However, you
1708 can include `AND` and `OR` expressions explicitly.
1709 For example:
1710 ```
1711 (cpuPlatform = &quot;Intel Skylake&quot;) OR
1712 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
1713 (scheduling.automaticRestart = true)
1714 ```
1715
1716 If you want to use a regular expression, use the `eq` (equal) or `ne`
1717 (not equal) operator against a single un-parenthesized expression with or
1718 without quotes or against multiple parenthesized expressions. Examples:
1719
1720 `fieldname eq unquoted literal`
1721 `fieldname eq &#x27;single quoted literal&#x27;`
1722 `fieldname eq &quot;double quoted literal&quot;`
1723 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
1724
1725 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
1726 The literal value must match the entire field.
1727
1728 For example, to filter for instances that do not end with name &quot;instance&quot;,
1729 you would use `name ne .*instance`.
1730
1731 You cannot combine constraints on multiple fields using regular
1732 expressions.
1733 maxResults: integer, The maximum number of results per page that should be returned.
1734 If the number of available results is larger than `maxResults`,
1735 Compute Engine returns a `nextPageToken` that can be used to get
1736 the next page of results in subsequent list requests. Acceptable values are
1737 `0` to `500`, inclusive. (Default: `500`)
1738 orderBy: string, Sorts list results by a certain order. By default, results
1739 are returned in alphanumerical order based on the resource name.
1740
1741 You can also sort results in descending order based on the creation
1742 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
1743 results based on the `creationTimestamp` field in
1744 reverse chronological order (newest result first). Use this to sort
1745 resources like operations so that the newest operation is returned first.
1746
1747 Currently, only sorting by `name` or
1748 `creationTimestamp desc` is supported.
1749 pageToken: string, Specifies a page token to use. Set `pageToken` to the
1750 `nextPageToken` returned by a previous list request to get
1751 the next page of results.
1752 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
1753 of failure. The default value is false.
1754
1755 For example, when partial success behavior is enabled, aggregatedList for a
1756 single zone scope either returns all resources in the zone or no resources,
1757 with an error code.
1758 x__xgafv: string, V1 error format.
1759 Allowed values
1760 1 - v1 error format
1761 2 - v2 error format
1762
1763 Returns:
1764 An object of the form:
1765
1766 {
1767 &quot;etag&quot;: &quot;A String&quot;,
1768 &quot;id&quot;: &quot;A String&quot;, # Output only. Unique identifier for the resource; defined by the server.
1769 &quot;items&quot;: [ # A list of Resize Request resources.
1770 { # InstanceGroupManagerResizeRequest represents a request to create
1771 # a number of VMs: either immediately or by queuing the request for the
1772 # specified time. This resize request is nested under InstanceGroupManager
1773 # and the VMs created by this request are added to the owning
1774 # InstanceGroupManager.
1775 &quot;count&quot;: 42, # This field is deprecated, please use resize_by instead.
1776 # The count of instances to create as part of this resize request.
1777 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. The creation timestamp for this resize request inRFC3339
1778 # text format.
1779 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource.
1780 &quot;id&quot;: &quot;A String&quot;, # Output only. A unique identifier for this resource type. The server generates this
1781 # identifier.
1782 &quot;instances&quot;: [ # The names of instances to be created by this resize request. The number of
1783 # names specified determines the number of instances to create. The group&#x27;s
1784 # target size will be increased by this number. This field cannot be used
1785 # together with &#x27;resize_by&#x27;.
1786 {
1787 &quot;fingerprint&quot;: &quot;A String&quot;, # Fingerprint of this per-instance config. This field can be used in
1788 # optimistic locking. It is ignored when inserting a per-instance
1789 # config. An up-to-date fingerprint must be provided in order to update an
1790 # existing per-instance configuration or the field needs to be unset.
1791 &quot;name&quot;: &quot;A String&quot;, # The name of a per-instance configuration and its corresponding instance.
1792 # Serves as a merge key during UpdatePerInstanceConfigs
1793 # operations, that is, if a per-instance configuration with the same name
1794 # exists then it will be updated, otherwise a new one will be created for the
1795 # VM instance with the same name. An attempt to create a per-instance
1796 # configuration for a VM instance that either doesn&#x27;t exist or is not part
1797 # of the group will result in an error.
1798 &quot;preservedState&quot;: { # Preserved state for a given instance. # The intended preserved state for the given instance. Does not contain
1799 # preserved state generated from a stateful policy.
1800 &quot;disks&quot;: { # Preserved disks defined for this instance.
1801 # This map is keyed with the device names of the disks.
1802 &quot;a_key&quot;: {
1803 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful disks will never be deleted during autohealing,
1804 # update, instance recreate operations. This flag is used to configure
1805 # if the disk should be deleted after it is no longer used by the group,
1806 # e.g. when the given instance or the whole MIG is deleted.
1807 # Note: disks attached in READ_ONLY mode cannot be
1808 # auto-deleted.
1809 &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
1810 # disk in READ_WRITE mode.
1811 &quot;source&quot;: &quot;A String&quot;, # The URL of the disk resource that is stateful and should be attached
1812 # to the VM instance.
1813 },
1814 },
1815 &quot;externalIPs&quot;: { # Preserved external IPs defined for this instance.
1816 # This map is keyed with the name of the network interface.
1817 &quot;a_key&quot;: {
1818 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1819 # update or VM instance recreate operations.
1820 # This flag is used to configure if the IP reservation should be deleted
1821 # after it is no longer used by the group, e.g. when the given instance
1822 # or the whole group is deleted.
1823 &quot;ipAddress&quot;: { # Ip address representation
1824 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1825 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1826 # network interface.
1827 },
1828 },
1829 },
1830 &quot;internalIPs&quot;: { # Preserved internal IPs defined for this instance.
1831 # This map is keyed with the name of the network interface.
1832 &quot;a_key&quot;: {
1833 &quot;autoDelete&quot;: &quot;A String&quot;, # These stateful IPs will never be released during autohealing,
1834 # update or VM instance recreate operations.
1835 # This flag is used to configure if the IP reservation should be deleted
1836 # after it is no longer used by the group, e.g. when the given instance
1837 # or the whole group is deleted.
1838 &quot;ipAddress&quot;: { # Ip address representation
1839 &quot;address&quot;: &quot;A String&quot;, # The URL of the reservation for this IP address.
1840 &quot;literal&quot;: &quot;A String&quot;, # An IPv4 internal network address to assign to the instance for this
1841 # network interface.
1842 },
1843 },
1844 },
1845 &quot;metadata&quot;: { # Preserved metadata defined for this instance.
1846 &quot;a_key&quot;: &quot;A String&quot;,
1847 },
1848 },
1849 &quot;status&quot;: &quot;A String&quot;, # The status of applying this per-instance configuration on the corresponding
1850 # managed instance.
1851 },
1852 ],
1853 &quot;kind&quot;: &quot;compute#instanceGroupManagerResizeRequest&quot;, # Output only. The resource type, which is alwayscompute#instanceGroupManagerResizeRequest for resize requests.
1854 &quot;name&quot;: &quot;A String&quot;, # The name of this resize request. The name must be 1-63 characters
1855 # long, and comply withRFC1035.
1856 &quot;region&quot;: &quot;A String&quot;, # Output only. The URL of a region
1857 # where the resize request is located. Populated only for regional resize
1858 # requests.
1859 &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.
1860 # At the end of the run duration instance will be deleted.
1861 # as a count of seconds and fractions of seconds at nanosecond
1862 # resolution. It is independent of any calendar and concepts like &quot;day&quot;
1863 # or &quot;month&quot;. Range is approximately 10,000 years.
1864 &quot;nanos&quot;: 42, # Span of time that&#x27;s a fraction of a second at nanosecond resolution.
1865 # Durations less than one second are represented with a 0
1866 # `seconds` field and a positive `nanos` field. Must be from 0
1867 # to 999,999,999 inclusive.
1868 &quot;seconds&quot;: &quot;A String&quot;, # Span of time at a resolution of a second. Must be from 0
1869 # to 315,576,000,000 inclusive. Note: these bounds are computed from:
1870 # 60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
1871 },
1872 &quot;resizeBy&quot;: 42, # The number of instances to be created by this resize request. The group&#x27;s
1873 # target size will be increased by this number. This field cannot be used
1874 # together with &#x27;instances&#x27;.
1875 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. The URL for this resize request. The server defines this URL.
1876 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. Server-defined URL for this resource with the resource id.
1877 &quot;state&quot;: &quot;A String&quot;, # Output only. Current state of the request.
1878 &quot;status&quot;: { # Output only. Status of the request.
1879 &quot;error&quot;: { # Output only. Fatal errors encountered during the queueing or provisioning phases of
1880 # the ResizeRequest that caused the transition to the FAILED state.
1881 # Contrary to the last_attempt errors, this field is final and errors are
1882 # never removed from here, as the ResizeRequest is not going to retry.
1883 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1884 # operation.
1885 {
1886 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1887 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1888 # details. There is a set of defined message types to use for providing
1889 # details.The syntax depends on the error code. For example,
1890 # QuotaExceededInfo will have details when the error code is
1891 # QUOTA_EXCEEDED.
1892 {
1893 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1894 #
1895 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1896 # is not enabled:
1897 #
1898 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1899 # &quot;domain&quot;: &quot;googleapis.com&quot;
1900 # &quot;metadata&quot;: {
1901 # &quot;resource&quot;: &quot;projects/123&quot;,
1902 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1903 # }
1904 # }
1905 #
1906 # This response indicates that the pubsub.googleapis.com API is not enabled.
1907 #
1908 # Example of an error that is returned when attempting to create a Spanner
1909 # instance in a region that is out of stock:
1910 #
1911 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1912 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1913 # &quot;metadata&quot;: {
1914 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1915 # }
1916 # }
1917 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1918 # is typically the registered service name of the tool or product that
1919 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1920 # generated by some common infrastructure, the error domain must be a
1921 # globally unique value that identifies the infrastructure. For Google API
1922 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1923 &quot;metadatas&quot;: { # Additional structured details about this error.
1924 #
1925 # Keys must match a regular expression of `a-z+` but should
1926 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1927 # length. When identifying the current value of an exceeded limit, the units
1928 # should be contained in the key, not the value. For example, rather than
1929 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1930 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1931 # instances that can be created in a single (batch) request.
1932 &quot;a_key&quot;: &quot;A String&quot;,
1933 },
1934 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1935 # proximate cause of the error. Error reasons are unique within a particular
1936 # domain of errors. This should be at most 63 characters and match a
1937 # regular expression of `A-Z+[A-Z0-9]`, which represents
1938 # UPPER_SNAKE_CASE.
1939 },
1940 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1941 #
1942 # For example, if a quota check failed with an error indicating the calling
1943 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1944 # directly to the right place in the developer console to flip the bit.
1945 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1946 { # Describes a URL link.
1947 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1948 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1949 },
1950 ],
1951 },
1952 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1953 # which can be attached to an RPC error.
1954 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1955 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1956 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1957 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1958 },
1959 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1960 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1961 &quot;a_key&quot;: &quot;A String&quot;,
1962 },
1963 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1964 # type or metric.
1965 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1966 # or metric.
1967 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1968 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1969 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1970 },
1971 },
1972 ],
1973 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1974 # This property is optional.
1975 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1976 },
1977 ],
1978 },
1979 &quot;lastAttempt&quot;: { # Output only. Information about the last attempt to fulfill the request. The value is
1980 # temporary since the ResizeRequest can retry, as long as it&#x27;s still active
1981 # and the last attempt value can either be cleared or replaced with a
1982 # different error. Since ResizeRequest retries infrequently, the value may
1983 # be stale and no longer show an active problem. The value is cleared when
1984 # ResizeRequest transitions to the final state (becomes inactive). If the
1985 # final state is FAILED the error describing it will be stored in the
1986 # &quot;error&quot; field only.
1987 &quot;error&quot;: { # Output only. Errors that prevented the ResizeRequest to be fulfilled.
1988 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1989 # operation.
1990 {
1991 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1992 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1993 # details. There is a set of defined message types to use for providing
1994 # details.The syntax depends on the error code. For example,
1995 # QuotaExceededInfo will have details when the error code is
1996 # QUOTA_EXCEEDED.
1997 {
1998 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1999 #
2000 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2001 # is not enabled:
2002 #
2003 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2004 # &quot;domain&quot;: &quot;googleapis.com&quot;
2005 # &quot;metadata&quot;: {
2006 # &quot;resource&quot;: &quot;projects/123&quot;,
2007 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2008 # }
2009 # }
2010 #
2011 # This response indicates that the pubsub.googleapis.com API is not enabled.
2012 #
2013 # Example of an error that is returned when attempting to create a Spanner
2014 # instance in a region that is out of stock:
2015 #
2016 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2017 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2018 # &quot;metadata&quot;: {
2019 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2020 # }
2021 # }
2022 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2023 # is typically the registered service name of the tool or product that
2024 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2025 # generated by some common infrastructure, the error domain must be a
2026 # globally unique value that identifies the infrastructure. For Google API
2027 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2028 &quot;metadatas&quot;: { # Additional structured details about this error.
2029 #
2030 # Keys must match a regular expression of `a-z+` but should
2031 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2032 # length. When identifying the current value of an exceeded limit, the units
2033 # should be contained in the key, not the value. For example, rather than
2034 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2035 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2036 # instances that can be created in a single (batch) request.
2037 &quot;a_key&quot;: &quot;A String&quot;,
2038 },
2039 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2040 # proximate cause of the error. Error reasons are unique within a particular
2041 # domain of errors. This should be at most 63 characters and match a
2042 # regular expression of `A-Z+[A-Z0-9]`, which represents
2043 # UPPER_SNAKE_CASE.
2044 },
2045 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2046 #
2047 # For example, if a quota check failed with an error indicating the calling
2048 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2049 # directly to the right place in the developer console to flip the bit.
2050 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2051 { # Describes a URL link.
2052 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2053 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2054 },
2055 ],
2056 },
2057 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2058 # which can be attached to an RPC error.
2059 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2060 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2061 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2062 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2063 },
2064 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2065 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2066 &quot;a_key&quot;: &quot;A String&quot;,
2067 },
2068 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2069 # type or metric.
2070 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2071 # or metric.
2072 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2073 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2074 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2075 },
2076 },
2077 ],
2078 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2079 # This property is optional.
2080 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2081 },
2082 ],
2083 },
2084 },
2085 },
2086 &quot;zone&quot;: &quot;A String&quot;, # Output only. The URL of a zone
2087 # where the resize request is located. Populated only for zonal resize
2088 # requests.
2089 },
2090 ],
2091 &quot;kind&quot;: &quot;compute#regionInstanceGroupManagerResizeRequestList&quot;, # Output only. Type of the resource. Alwayscompute#regionInstanceGroupManagerResizeRequestList for
2092 # a list of Resize Requests.
2093 &quot;nextPageToken&quot;: &quot;A String&quot;, # Output only. This token allows you to get the next page of results for
2094 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
2095 # the query parameter pageToken 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;unreachables&quot;: [ # Output only. Unreachable resources.
2100 # end_interface: MixerListResponseWithEtagBuilder
2101 &quot;A String&quot;,
2102 ],
2103 &quot;warning&quot;: { # Output only. Informational warning message.
2104 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2105 # Engine returns NO_RESULTS_ON_PAGE if there
2106 # are no results in the response.
2107 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2108 # value format. For example:
2109 #
2110 # &quot;data&quot;: [
2111 # {
2112 # &quot;key&quot;: &quot;scope&quot;,
2113 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2114 # }
2115 {
2116 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2117 # returned. For example, for warnings where there are no results in a list
2118 # request for a particular zone, this key might be scope and
2119 # the key value might be the zone name. Other examples might be a key
2120 # indicating a deprecated resource and a suggested replacement, or a
2121 # warning about invalid network settings (for example, if an instance
2122 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2123 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2124 },
2125 ],
2126 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2127 },
2128 }</pre>
2129 </div>
2130
2131 <div class="method">
2132 <code class="details" id="list_next">list_next()</code>
2133 <pre>Retrieves the next page of results.
2134
2135 Args:
2136 previous_request: The request for the previous page. (required)
2137 previous_response: The response from the request for the previous page. (required)
2138
2139 Returns:
2140 A request object that you can call &#x27;execute()&#x27; on to request the next
2141 page. Returns None if there are no more items in the collection.
2142 </pre>
2143 </div>
2144
2145 </body></html>