Debian Codegraph @

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