Debian Codegraph @

docs/dyn/compute_alpha.instanceGroupManagerResizeRequests.html

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