Debian Codegraph @

docs/dyn/compute_beta.diskTypes.html

raw
1 <html><body>
2 <style>
3
4 body, h1, h2, h3, div, span, p, pre, a {
5 margin: 0;
6 padding: 0;
7 border: 0;
8 font-weight: inherit;
9 font-style: inherit;
10 font-size: 100%;
11 font-family: inherit;
12 vertical-align: baseline;
13 }
14
15 body {
16 font-size: 13px;
17 padding: 1em;
18 }
19
20 h1 {
21 font-size: 26px;
22 margin-bottom: 1em;
23 }
24
25 h2 {
26 font-size: 24px;
27 margin-bottom: 1em;
28 }
29
30 h3 {
31 font-size: 20px;
32 margin-bottom: 1em;
33 margin-top: 1em;
34 }
35
36 pre, code {
37 line-height: 1.5;
38 font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
39 }
40
41 pre {
42 margin-top: 0.5em;
43 }
44
45 h1, h2, h3, p {
46 font-family: Arial, sans serif;
47 }
48
49 h1, h2, h3 {
50 border-bottom: solid #CCC 1px;
51 }
52
53 .toc_element {
54 margin-top: 0.5em;
55 }
56
57 .firstline {
58 margin-left: 2 em;
59 }
60
61 .method {
62 margin-top: 1em;
63 border: solid 1px #CCC;
64 padding: 1em;
65 background: #EEE;
66 }
67
68 .details {
69 font-weight: bold;
70 font-size: 14px;
71 }
72
73 </style>
74
75 <h1><a href="compute_beta.html">Compute Engine API</a> . <a href="compute_beta.diskTypes.html">diskTypes</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Retrieves an aggregated list of disk types.</p>
80 <p class="toc_element">
81 <code><a href="#aggregatedList_next">aggregatedList_next()</a></code></p>
82 <p class="firstline">Retrieves the next page of results.</p>
83 <p class="toc_element">
84 <code><a href="#close">close()</a></code></p>
85 <p class="firstline">Close httplib2 connections.</p>
86 <p class="toc_element">
87 <code><a href="#get">get(project, zone, diskType, x__xgafv=None)</a></code></p>
88 <p class="firstline">Returns the specified disk type.</p>
89 <p class="toc_element">
90 <code><a href="#list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
91 <p class="firstline">Retrieves a list of disk types available to the specified</p>
92 <p class="toc_element">
93 <code><a href="#list_next">list_next()</a></code></p>
94 <p class="firstline">Retrieves the next page of results.</p>
95 <h3>Method Details</h3>
96 <div class="method">
97 <code class="details" id="aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, serviceProjectNumber=None, x__xgafv=None)</code>
98 <pre>Retrieves an aggregated list of disk types.
99
100 To prevent failure, it is recommended that you set the
101 `returnPartialSuccess` parameter to `true`.
102
103 Args:
104 project: string, Project ID for this request. (required)
105 filter: string, A filter expression that filters resources listed in the response. Most
106 Compute resources support two types of filter expressions:
107 expressions that support regular expressions and expressions that follow
108 API improvement proposal AIP-160.
109 These two types of filter expressions cannot be mixed in one request.
110
111 If you want to use AIP-160, your expression must specify the field name, an
112 operator, and the value that you want to use for filtering. The value
113 must be a string, a number, or a boolean. The operator
114 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
115
116 For example, if you are filtering Compute Engine instances, you can
117 exclude instances named `example-instance` by specifying
118 `name != example-instance`.
119
120 The `:*` comparison can be used to test whether a key has been defined.
121 For example, to find all objects with `owner` label use:
122 ```
123 labels.owner:*
124 ```
125
126 You can also filter nested fields. For example, you could specify
127 `scheduling.automaticRestart = false` to include instances only
128 if they are not scheduled for automatic restarts. You can use filtering
129 on nested fields to filter based onresource labels.
130
131 To filter on multiple expressions, provide each separate expression within
132 parentheses. For example:
133 ```
134 (scheduling.automaticRestart = true)
135 (cpuPlatform = &quot;Intel Skylake&quot;)
136 ```
137 By default, each expression is an `AND` expression. However, you
138 can include `AND` and `OR` expressions explicitly.
139 For example:
140 ```
141 (cpuPlatform = &quot;Intel Skylake&quot;) OR
142 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
143 (scheduling.automaticRestart = true)
144 ```
145
146 If you want to use a regular expression, use the `eq` (equal) or `ne`
147 (not equal) operator against a single un-parenthesized expression with or
148 without quotes or against multiple parenthesized expressions. Examples:
149
150 `fieldname eq unquoted literal`
151 `fieldname eq &#x27;single quoted literal&#x27;`
152 `fieldname eq &quot;double quoted literal&quot;`
153 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
154
155 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
156 The literal value must match the entire field.
157
158 For example, to filter for instances that do not end with name &quot;instance&quot;,
159 you would use `name ne .*instance`.
160
161 You cannot combine constraints on multiple fields using regular
162 expressions.
163 includeAllScopes: boolean, Indicates whether every visible scope for each scope type (zone, region,
164 global) should be included in the response. For new resource types added
165 after this field, the flag has no effect as new resource types will always
166 include every visible scope for each scope type in response. For resource
167 types which predate this field, if this flag is omitted or false, only
168 scopes of the scope types where the resource type is expected to be found
169 will be included.
170 maxResults: integer, The maximum number of results per page that should be returned.
171 If the number of available results is larger than `maxResults`,
172 Compute Engine returns a `nextPageToken` that can be used to get
173 the next page of results in subsequent list requests. Acceptable values are
174 `0` to `500`, inclusive. (Default: `500`)
175 orderBy: string, Sorts list results by a certain order. By default, results
176 are returned in alphanumerical order based on the resource name.
177
178 You can also sort results in descending order based on the creation
179 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
180 results based on the `creationTimestamp` field in
181 reverse chronological order (newest result first). Use this to sort
182 resources like operations so that the newest operation is returned first.
183
184 Currently, only sorting by `name` or
185 `creationTimestamp desc` is supported.
186 pageToken: string, Specifies a page token to use. Set `pageToken` to the
187 `nextPageToken` returned by a previous list request to get
188 the next page of results.
189 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
190 of failure. The default value is false.
191
192 For example, when partial success behavior is enabled, aggregatedList for a
193 single zone scope either returns all resources in the zone or no resources,
194 with an error code.
195 serviceProjectNumber: string, The Shared VPC service project id or service project number for which
196 aggregated list request is invoked for subnetworks list-usable api.
197 x__xgafv: string, V1 error format.
198 Allowed values
199 1 - v1 error format
200 2 - v2 error format
201
202 Returns:
203 An object of the form:
204
205 {
206 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
207 &quot;items&quot;: { # A list of DiskTypesScopedList resources.
208 &quot;a_key&quot;: { # [Output Only] Name of the scope containing this set of disk types.
209 &quot;diskTypes&quot;: [ # [Output Only] A list of disk types contained in this scope.
210 { # Represents a Disk Type resource.
211 #
212 # Google Compute Engine has two Disk Type resources:
213 #
214 # * [Regional](/compute/docs/reference/rest/beta/regionDiskTypes)
215 # * [Zonal](/compute/docs/reference/rest/beta/diskTypes)
216 #
217 # You can choose from a variety of disk types based on your needs.
218 # For more information, readStorage options.
219 #
220 # The diskTypes resource represents disk types for a zonal
221 # persistent disk.
222 # For more information, readZonal persistent disks.
223 #
224 # The regionDiskTypes resource represents disk types for a
225 # regional persistent disk. For more information, read Regional persistent disks.
226 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp inRFC3339
227 # text format.
228 &quot;defaultDiskSizeGb&quot;: &quot;A String&quot;, # [Output Only] Server-defined default disk size in GB.
229 &quot;deprecated&quot;: { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
230 &quot;deleted&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
231 # resource is intended to change to DELETED. This is only
232 # informational and the status will not change unless the client explicitly
233 # changes it.
234 &quot;deprecated&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
235 # resource is intended to change to DEPRECATED. This is only
236 # informational and the status will not change unless the client explicitly
237 # changes it.
238 &quot;obsolete&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
239 # resource is intended to change to OBSOLETE. This is only
240 # informational and the status will not change unless the client explicitly
241 # changes it.
242 &quot;replacement&quot;: &quot;A String&quot;, # The URL of the suggested replacement for a deprecated resource.
243 # The suggested replacement resource must be the same kind of resource as the
244 # deprecated resource.
245 &quot;state&quot;: &quot;A String&quot;, # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
246 # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
247 # warning indicating the deprecated resource and recommending its
248 # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
249 &quot;stateOverride&quot;: { # A rollout policy configuration. # The rollout policy for this deprecation. This policy is only enforced by
250 # image family views. The rollout policy restricts the zones where the
251 # associated resource is considered in a deprecated state. When the rollout
252 # policy does not include the user specified zone, or if the zone is rolled
253 # out, the associated resource is considered in a deprecated state.
254 #
255 # The rollout policy for this deprecation is read-only, except for
256 # allowlisted users. This field might not be configured. To view the latest
257 # non-deprecated image in a specific zone, use theimageFamilyViews.get method.
258 &quot;defaultRolloutTime&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the update is
259 # considered rolled out to any zone that is not explicitly stated.
260 &quot;locationRolloutPolicies&quot;: { # Location based rollout policies to apply to the resource.
261 #
262 # Currently only zone names are supported and must be represented
263 # as valid URLs, like: zones/us-central1-a.
264 #
265 # The value expects an RFC3339 timestamp on or after which the update is
266 # considered rolled out to the specified location.
267 &quot;a_key&quot;: &quot;A String&quot;,
268 },
269 },
270 },
271 &quot;description&quot;: &quot;A String&quot;, # [Output Only] An optional description of this resource.
272 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
273 # defined by the server.
274 &quot;kind&quot;: &quot;compute#diskType&quot;, # Output only. [Output Only] Type of the resource. Always compute#diskType
275 # for disk types.
276 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the resource.
277 &quot;region&quot;: &quot;A String&quot;, # [Output Only] URL of the region where the disk type resides. Only
278 # applicable for regional resources.
279 # You must specify this field as part of the HTTP request URL. It is
280 # not settable as a field in the request body.
281 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
282 &quot;validDiskSize&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the valid disk size,
283 # such as &quot;10GB-10TB&quot;.
284 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] URL of the zone where the disk type resides.
285 # You must specify this field as part of the HTTP request URL. It is
286 # not settable as a field in the request body.
287 },
288 ],
289 &quot;warning&quot;: { # [Output Only] Informational warning which replaces the list of disk types
290 # when the list is empty.
291 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
292 # Engine returns NO_RESULTS_ON_PAGE if there
293 # are no results in the response.
294 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
295 # value format. For example:
296 #
297 # &quot;data&quot;: [
298 # {
299 # &quot;key&quot;: &quot;scope&quot;,
300 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
301 # }
302 {
303 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
304 # returned. For example, for warnings where there are no results in a list
305 # request for a particular zone, this key might be scope and
306 # the key value might be the zone name. Other examples might be a key
307 # indicating a deprecated resource and a suggested replacement, or a
308 # warning about invalid network settings (for example, if an instance
309 # attempts to perform IP forwarding but is not enabled for IP forwarding).
310 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
311 },
312 ],
313 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
314 },
315 },
316 },
317 &quot;kind&quot;: &quot;compute#diskTypeAggregatedList&quot;, # Output only. [Output Only] Type of resource. Alwayscompute#diskTypeAggregatedList.
318 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
319 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
320 # the query parameter pageToken in the next list request.
321 # Subsequent list requests will have their own nextPageToken to
322 # continue paging through the results.
323 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
324 &quot;unreachables&quot;: [ # Output only. [Output Only] Unreachable resources.
325 &quot;A String&quot;,
326 ],
327 &quot;warning&quot;: { # [Output Only] Informational warning message.
328 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
329 # Engine returns NO_RESULTS_ON_PAGE if there
330 # are no results in the response.
331 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
332 # value format. For example:
333 #
334 # &quot;data&quot;: [
335 # {
336 # &quot;key&quot;: &quot;scope&quot;,
337 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
338 # }
339 {
340 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
341 # returned. For example, for warnings where there are no results in a list
342 # request for a particular zone, this key might be scope and
343 # the key value might be the zone name. Other examples might be a key
344 # indicating a deprecated resource and a suggested replacement, or a
345 # warning about invalid network settings (for example, if an instance
346 # attempts to perform IP forwarding but is not enabled for IP forwarding).
347 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
348 },
349 ],
350 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
351 },
352 }</pre>
353 </div>
354
355 <div class="method">
356 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
357 <pre>Retrieves the next page of results.
358
359 Args:
360 previous_request: The request for the previous page. (required)
361 previous_response: The response from the request for the previous page. (required)
362
363 Returns:
364 A request object that you can call &#x27;execute()&#x27; on to request the next
365 page. Returns None if there are no more items in the collection.
366 </pre>
367 </div>
368
369 <div class="method">
370 <code class="details" id="close">close()</code>
371 <pre>Close httplib2 connections.</pre>
372 </div>
373
374 <div class="method">
375 <code class="details" id="get">get(project, zone, diskType, x__xgafv=None)</code>
376 <pre>Returns the specified disk type.
377
378 Args:
379 project: string, Project ID for this request. (required)
380 zone: string, The name of the zone for this request. (required)
381 diskType: string, Name of the disk type to return. (required)
382 x__xgafv: string, V1 error format.
383 Allowed values
384 1 - v1 error format
385 2 - v2 error format
386
387 Returns:
388 An object of the form:
389
390 { # Represents a Disk Type resource.
391 #
392 # Google Compute Engine has two Disk Type resources:
393 #
394 # * [Regional](/compute/docs/reference/rest/beta/regionDiskTypes)
395 # * [Zonal](/compute/docs/reference/rest/beta/diskTypes)
396 #
397 # You can choose from a variety of disk types based on your needs.
398 # For more information, readStorage options.
399 #
400 # The diskTypes resource represents disk types for a zonal
401 # persistent disk.
402 # For more information, readZonal persistent disks.
403 #
404 # The regionDiskTypes resource represents disk types for a
405 # regional persistent disk. For more information, read Regional persistent disks.
406 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp inRFC3339
407 # text format.
408 &quot;defaultDiskSizeGb&quot;: &quot;A String&quot;, # [Output Only] Server-defined default disk size in GB.
409 &quot;deprecated&quot;: { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
410 &quot;deleted&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
411 # resource is intended to change to DELETED. This is only
412 # informational and the status will not change unless the client explicitly
413 # changes it.
414 &quot;deprecated&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
415 # resource is intended to change to DEPRECATED. This is only
416 # informational and the status will not change unless the client explicitly
417 # changes it.
418 &quot;obsolete&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
419 # resource is intended to change to OBSOLETE. This is only
420 # informational and the status will not change unless the client explicitly
421 # changes it.
422 &quot;replacement&quot;: &quot;A String&quot;, # The URL of the suggested replacement for a deprecated resource.
423 # The suggested replacement resource must be the same kind of resource as the
424 # deprecated resource.
425 &quot;state&quot;: &quot;A String&quot;, # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
426 # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
427 # warning indicating the deprecated resource and recommending its
428 # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
429 &quot;stateOverride&quot;: { # A rollout policy configuration. # The rollout policy for this deprecation. This policy is only enforced by
430 # image family views. The rollout policy restricts the zones where the
431 # associated resource is considered in a deprecated state. When the rollout
432 # policy does not include the user specified zone, or if the zone is rolled
433 # out, the associated resource is considered in a deprecated state.
434 #
435 # The rollout policy for this deprecation is read-only, except for
436 # allowlisted users. This field might not be configured. To view the latest
437 # non-deprecated image in a specific zone, use theimageFamilyViews.get method.
438 &quot;defaultRolloutTime&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the update is
439 # considered rolled out to any zone that is not explicitly stated.
440 &quot;locationRolloutPolicies&quot;: { # Location based rollout policies to apply to the resource.
441 #
442 # Currently only zone names are supported and must be represented
443 # as valid URLs, like: zones/us-central1-a.
444 #
445 # The value expects an RFC3339 timestamp on or after which the update is
446 # considered rolled out to the specified location.
447 &quot;a_key&quot;: &quot;A String&quot;,
448 },
449 },
450 },
451 &quot;description&quot;: &quot;A String&quot;, # [Output Only] An optional description of this resource.
452 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
453 # defined by the server.
454 &quot;kind&quot;: &quot;compute#diskType&quot;, # Output only. [Output Only] Type of the resource. Always compute#diskType
455 # for disk types.
456 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the resource.
457 &quot;region&quot;: &quot;A String&quot;, # [Output Only] URL of the region where the disk type resides. Only
458 # applicable for regional resources.
459 # You must specify this field as part of the HTTP request URL. It is
460 # not settable as a field in the request body.
461 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
462 &quot;validDiskSize&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the valid disk size,
463 # such as &quot;10GB-10TB&quot;.
464 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] URL of the zone where the disk type resides.
465 # You must specify this field as part of the HTTP request URL. It is
466 # not settable as a field in the request body.
467 }</pre>
468 </div>
469
470 <div class="method">
471 <code class="details" id="list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
472 <pre>Retrieves a list of disk types available to the specified
473 project.
474
475 Args:
476 project: string, Project ID for this request. (required)
477 zone: string, The name of the zone for this request. (required)
478 filter: string, A filter expression that filters resources listed in the response. Most
479 Compute resources support two types of filter expressions:
480 expressions that support regular expressions and expressions that follow
481 API improvement proposal AIP-160.
482 These two types of filter expressions cannot be mixed in one request.
483
484 If you want to use AIP-160, your expression must specify the field name, an
485 operator, and the value that you want to use for filtering. The value
486 must be a string, a number, or a boolean. The operator
487 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
488
489 For example, if you are filtering Compute Engine instances, you can
490 exclude instances named `example-instance` by specifying
491 `name != example-instance`.
492
493 The `:*` comparison can be used to test whether a key has been defined.
494 For example, to find all objects with `owner` label use:
495 ```
496 labels.owner:*
497 ```
498
499 You can also filter nested fields. For example, you could specify
500 `scheduling.automaticRestart = false` to include instances only
501 if they are not scheduled for automatic restarts. You can use filtering
502 on nested fields to filter based onresource labels.
503
504 To filter on multiple expressions, provide each separate expression within
505 parentheses. For example:
506 ```
507 (scheduling.automaticRestart = true)
508 (cpuPlatform = &quot;Intel Skylake&quot;)
509 ```
510 By default, each expression is an `AND` expression. However, you
511 can include `AND` and `OR` expressions explicitly.
512 For example:
513 ```
514 (cpuPlatform = &quot;Intel Skylake&quot;) OR
515 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
516 (scheduling.automaticRestart = true)
517 ```
518
519 If you want to use a regular expression, use the `eq` (equal) or `ne`
520 (not equal) operator against a single un-parenthesized expression with or
521 without quotes or against multiple parenthesized expressions. Examples:
522
523 `fieldname eq unquoted literal`
524 `fieldname eq &#x27;single quoted literal&#x27;`
525 `fieldname eq &quot;double quoted literal&quot;`
526 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
527
528 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
529 The literal value must match the entire field.
530
531 For example, to filter for instances that do not end with name &quot;instance&quot;,
532 you would use `name ne .*instance`.
533
534 You cannot combine constraints on multiple fields using regular
535 expressions.
536 maxResults: integer, The maximum number of results per page that should be returned.
537 If the number of available results is larger than `maxResults`,
538 Compute Engine returns a `nextPageToken` that can be used to get
539 the next page of results in subsequent list requests. Acceptable values are
540 `0` to `500`, inclusive. (Default: `500`)
541 orderBy: string, Sorts list results by a certain order. By default, results
542 are returned in alphanumerical order based on the resource name.
543
544 You can also sort results in descending order based on the creation
545 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
546 results based on the `creationTimestamp` field in
547 reverse chronological order (newest result first). Use this to sort
548 resources like operations so that the newest operation is returned first.
549
550 Currently, only sorting by `name` or
551 `creationTimestamp desc` is supported.
552 pageToken: string, Specifies a page token to use. Set `pageToken` to the
553 `nextPageToken` returned by a previous list request to get
554 the next page of results.
555 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
556 of failure. The default value is false.
557
558 For example, when partial success behavior is enabled, aggregatedList for a
559 single zone scope either returns all resources in the zone or no resources,
560 with an error code.
561 x__xgafv: string, V1 error format.
562 Allowed values
563 1 - v1 error format
564 2 - v2 error format
565
566 Returns:
567 An object of the form:
568
569 { # Contains a list of disk types.
570 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
571 &quot;items&quot;: [ # A list of DiskType resources.
572 { # Represents a Disk Type resource.
573 #
574 # Google Compute Engine has two Disk Type resources:
575 #
576 # * [Regional](/compute/docs/reference/rest/beta/regionDiskTypes)
577 # * [Zonal](/compute/docs/reference/rest/beta/diskTypes)
578 #
579 # You can choose from a variety of disk types based on your needs.
580 # For more information, readStorage options.
581 #
582 # The diskTypes resource represents disk types for a zonal
583 # persistent disk.
584 # For more information, readZonal persistent disks.
585 #
586 # The regionDiskTypes resource represents disk types for a
587 # regional persistent disk. For more information, read Regional persistent disks.
588 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp inRFC3339
589 # text format.
590 &quot;defaultDiskSizeGb&quot;: &quot;A String&quot;, # [Output Only] Server-defined default disk size in GB.
591 &quot;deprecated&quot;: { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this disk type.
592 &quot;deleted&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
593 # resource is intended to change to DELETED. This is only
594 # informational and the status will not change unless the client explicitly
595 # changes it.
596 &quot;deprecated&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
597 # resource is intended to change to DEPRECATED. This is only
598 # informational and the status will not change unless the client explicitly
599 # changes it.
600 &quot;obsolete&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
601 # resource is intended to change to OBSOLETE. This is only
602 # informational and the status will not change unless the client explicitly
603 # changes it.
604 &quot;replacement&quot;: &quot;A String&quot;, # The URL of the suggested replacement for a deprecated resource.
605 # The suggested replacement resource must be the same kind of resource as the
606 # deprecated resource.
607 &quot;state&quot;: &quot;A String&quot;, # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
608 # Operations which communicate the end of life date for an image, can useACTIVE. Operations which create a new resource using aDEPRECATED resource will return successfully, but with a
609 # warning indicating the deprecated resource and recommending its
610 # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
611 &quot;stateOverride&quot;: { # A rollout policy configuration. # The rollout policy for this deprecation. This policy is only enforced by
612 # image family views. The rollout policy restricts the zones where the
613 # associated resource is considered in a deprecated state. When the rollout
614 # policy does not include the user specified zone, or if the zone is rolled
615 # out, the associated resource is considered in a deprecated state.
616 #
617 # The rollout policy for this deprecation is read-only, except for
618 # allowlisted users. This field might not be configured. To view the latest
619 # non-deprecated image in a specific zone, use theimageFamilyViews.get method.
620 &quot;defaultRolloutTime&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the update is
621 # considered rolled out to any zone that is not explicitly stated.
622 &quot;locationRolloutPolicies&quot;: { # Location based rollout policies to apply to the resource.
623 #
624 # Currently only zone names are supported and must be represented
625 # as valid URLs, like: zones/us-central1-a.
626 #
627 # The value expects an RFC3339 timestamp on or after which the update is
628 # considered rolled out to the specified location.
629 &quot;a_key&quot;: &quot;A String&quot;,
630 },
631 },
632 },
633 &quot;description&quot;: &quot;A String&quot;, # [Output Only] An optional description of this resource.
634 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
635 # defined by the server.
636 &quot;kind&quot;: &quot;compute#diskType&quot;, # Output only. [Output Only] Type of the resource. Always compute#diskType
637 # for disk types.
638 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the resource.
639 &quot;region&quot;: &quot;A String&quot;, # [Output Only] URL of the region where the disk type resides. Only
640 # applicable for regional resources.
641 # You must specify this field as part of the HTTP request URL. It is
642 # not settable as a field in the request body.
643 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
644 &quot;validDiskSize&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the valid disk size,
645 # such as &quot;10GB-10TB&quot;.
646 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] URL of the zone where the disk type resides.
647 # You must specify this field as part of the HTTP request URL. It is
648 # not settable as a field in the request body.
649 },
650 ],
651 &quot;kind&quot;: &quot;compute#diskTypeList&quot;, # Output only. [Output Only] Type of resource. Always compute#diskTypeList
652 # for disk types.
653 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
654 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
655 # the query parameter pageToken in the next list request.
656 # Subsequent list requests will have their own nextPageToken to
657 # continue paging through the results.
658 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
659 &quot;warning&quot;: { # [Output Only] Informational warning message.
660 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
661 # Engine returns NO_RESULTS_ON_PAGE if there
662 # are no results in the response.
663 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
664 # value format. For example:
665 #
666 # &quot;data&quot;: [
667 # {
668 # &quot;key&quot;: &quot;scope&quot;,
669 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
670 # }
671 {
672 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
673 # returned. For example, for warnings where there are no results in a list
674 # request for a particular zone, this key might be scope and
675 # the key value might be the zone name. Other examples might be a key
676 # indicating a deprecated resource and a suggested replacement, or a
677 # warning about invalid network settings (for example, if an instance
678 # attempts to perform IP forwarding but is not enabled for IP forwarding).
679 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
680 },
681 ],
682 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
683 },
684 }</pre>
685 </div>
686
687 <div class="method">
688 <code class="details" id="list_next">list_next()</code>
689 <pre>Retrieves the next page of results.
690
691 Args:
692 previous_request: The request for the previous page. (required)
693 previous_response: The response from the request for the previous page. (required)
694
695 Returns:
696 A request object that you can call &#x27;execute()&#x27; on to request the next
697 page. Returns None if there are no more items in the collection.
698 </pre>
699 </div>
700
701 </body></html>