Debian Codegraph @

docs/dyn/compute_beta.machineTypes.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.machineTypes.html">machineTypes</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 machine 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, machineType, x__xgafv=None)</a></code></p>
88 <p class="firstline">Returns the specified machine 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 machine 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 machine types.
99
100 To prevent failure, Google recommends 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 MachineTypesScopedList resources.
208 &quot;a_key&quot;: { # [Output Only] Name of the scope containing this set of machine types.
209 &quot;machineTypes&quot;: [ # [Output Only] A list of machine types contained in this scope.
210 { # Represents a Machine Type resource.
211 #
212 # You can use specific machine types for your VM instances based on performance
213 # and pricing requirements. For more information, readMachine Types.
214 &quot;accelerators&quot;: [ # [Output Only] A list of accelerator configurations assigned to this
215 # machine type.
216 {
217 &quot;guestAcceleratorCount&quot;: 42, # Number of accelerator cards exposed to the guest.
218 &quot;guestAcceleratorType&quot;: &quot;A String&quot;, # The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4.
219 },
220 ],
221 &quot;architecture&quot;: &quot;A String&quot;, # [Output Only] The architecture of the machine type.
222 &quot;bundledLocalSsds&quot;: { # [Output Only] The configuration of bundled local SSD for the machine type.
223 &quot;defaultInterface&quot;: &quot;A String&quot;, # The default disk interface if the interface is not specified.
224 &quot;partitionCount&quot;: 42, # The number of partitions.
225 },
226 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp inRFC3339
227 # text format.
228 &quot;deprecated&quot;: { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
229 # Only applicable if the machine type is unavailable.
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 textual description of the resource.
272 &quot;guestCpus&quot;: 42, # [Output Only] The number of virtual CPUs that are available to the
273 # instance.
274 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
275 # defined by the server.
276 &quot;isSharedCpu&quot;: True or False, # [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine
277 # types for more information.
278 &quot;kind&quot;: &quot;compute#machineType&quot;, # Output only. [Output Only] The type of the resource. Alwayscompute#machineType for machine types.
279 &quot;maximumPersistentDisks&quot;: 42, # [Output Only] Maximum persistent disks allowed.
280 &quot;maximumPersistentDisksSizeGb&quot;: &quot;A String&quot;, # [Output Only] Maximum total persistent disks size (GB) allowed.
281 &quot;memoryMb&quot;: 42, # [Output Only] The amount of physical memory available to the instance,
282 # defined in MB.
283 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the resource.
284 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
285 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The name of the zone where the machine type resides,
286 # such as us-central1-a.
287 },
288 ],
289 &quot;warning&quot;: { # [Output Only] An informational warning that appears when the machine types
290 # 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#machineTypeAggregatedList&quot;, # Output only. [Output Only] Type of resource. Alwayscompute#machineTypeAggregatedList for aggregated lists of
318 # machine types.
319 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
320 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
321 # the query parameter pageToken in the next list request.
322 # Subsequent list requests will have their own nextPageToken to
323 # continue paging through the results.
324 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
325 &quot;unreachables&quot;: [ # Output only. [Output Only] Unreachable resources.
326 &quot;A String&quot;,
327 ],
328 &quot;warning&quot;: { # [Output Only] Informational warning message.
329 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
330 # Engine returns NO_RESULTS_ON_PAGE if there
331 # are no results in the response.
332 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
333 # value format. For example:
334 #
335 # &quot;data&quot;: [
336 # {
337 # &quot;key&quot;: &quot;scope&quot;,
338 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
339 # }
340 {
341 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
342 # returned. For example, for warnings where there are no results in a list
343 # request for a particular zone, this key might be scope and
344 # the key value might be the zone name. Other examples might be a key
345 # indicating a deprecated resource and a suggested replacement, or a
346 # warning about invalid network settings (for example, if an instance
347 # attempts to perform IP forwarding but is not enabled for IP forwarding).
348 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
349 },
350 ],
351 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
352 },
353 }</pre>
354 </div>
355
356 <div class="method">
357 <code class="details" id="aggregatedList_next">aggregatedList_next()</code>
358 <pre>Retrieves the next page of results.
359
360 Args:
361 previous_request: The request for the previous page. (required)
362 previous_response: The response from the request for the previous page. (required)
363
364 Returns:
365 A request object that you can call &#x27;execute()&#x27; on to request the next
366 page. Returns None if there are no more items in the collection.
367 </pre>
368 </div>
369
370 <div class="method">
371 <code class="details" id="close">close()</code>
372 <pre>Close httplib2 connections.</pre>
373 </div>
374
375 <div class="method">
376 <code class="details" id="get">get(project, zone, machineType, x__xgafv=None)</code>
377 <pre>Returns the specified machine type.
378
379 Args:
380 project: string, Project ID for this request. (required)
381 zone: string, The name of the zone for this request. (required)
382 machineType: string, Name of the machine type to return. (required)
383 x__xgafv: string, V1 error format.
384 Allowed values
385 1 - v1 error format
386 2 - v2 error format
387
388 Returns:
389 An object of the form:
390
391 { # Represents a Machine Type resource.
392 #
393 # You can use specific machine types for your VM instances based on performance
394 # and pricing requirements. For more information, readMachine Types.
395 &quot;accelerators&quot;: [ # [Output Only] A list of accelerator configurations assigned to this
396 # machine type.
397 {
398 &quot;guestAcceleratorCount&quot;: 42, # Number of accelerator cards exposed to the guest.
399 &quot;guestAcceleratorType&quot;: &quot;A String&quot;, # The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4.
400 },
401 ],
402 &quot;architecture&quot;: &quot;A String&quot;, # [Output Only] The architecture of the machine type.
403 &quot;bundledLocalSsds&quot;: { # [Output Only] The configuration of bundled local SSD for the machine type.
404 &quot;defaultInterface&quot;: &quot;A String&quot;, # The default disk interface if the interface is not specified.
405 &quot;partitionCount&quot;: 42, # The number of partitions.
406 },
407 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp inRFC3339
408 # text format.
409 &quot;deprecated&quot;: { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
410 # Only applicable if the machine type is unavailable.
411 &quot;deleted&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
412 # resource is intended to change to DELETED. This is only
413 # informational and the status will not change unless the client explicitly
414 # changes it.
415 &quot;deprecated&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
416 # resource is intended to change to DEPRECATED. This is only
417 # informational and the status will not change unless the client explicitly
418 # changes it.
419 &quot;obsolete&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
420 # resource is intended to change to OBSOLETE. This is only
421 # informational and the status will not change unless the client explicitly
422 # changes it.
423 &quot;replacement&quot;: &quot;A String&quot;, # The URL of the suggested replacement for a deprecated resource.
424 # The suggested replacement resource must be the same kind of resource as the
425 # deprecated resource.
426 &quot;state&quot;: &quot;A String&quot;, # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
427 # 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
428 # warning indicating the deprecated resource and recommending its
429 # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
430 &quot;stateOverride&quot;: { # A rollout policy configuration. # The rollout policy for this deprecation. This policy is only enforced by
431 # image family views. The rollout policy restricts the zones where the
432 # associated resource is considered in a deprecated state. When the rollout
433 # policy does not include the user specified zone, or if the zone is rolled
434 # out, the associated resource is considered in a deprecated state.
435 #
436 # The rollout policy for this deprecation is read-only, except for
437 # allowlisted users. This field might not be configured. To view the latest
438 # non-deprecated image in a specific zone, use theimageFamilyViews.get method.
439 &quot;defaultRolloutTime&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the update is
440 # considered rolled out to any zone that is not explicitly stated.
441 &quot;locationRolloutPolicies&quot;: { # Location based rollout policies to apply to the resource.
442 #
443 # Currently only zone names are supported and must be represented
444 # as valid URLs, like: zones/us-central1-a.
445 #
446 # The value expects an RFC3339 timestamp on or after which the update is
447 # considered rolled out to the specified location.
448 &quot;a_key&quot;: &quot;A String&quot;,
449 },
450 },
451 },
452 &quot;description&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the resource.
453 &quot;guestCpus&quot;: 42, # [Output Only] The number of virtual CPUs that are available to the
454 # instance.
455 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
456 # defined by the server.
457 &quot;isSharedCpu&quot;: True or False, # [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine
458 # types for more information.
459 &quot;kind&quot;: &quot;compute#machineType&quot;, # Output only. [Output Only] The type of the resource. Alwayscompute#machineType for machine types.
460 &quot;maximumPersistentDisks&quot;: 42, # [Output Only] Maximum persistent disks allowed.
461 &quot;maximumPersistentDisksSizeGb&quot;: &quot;A String&quot;, # [Output Only] Maximum total persistent disks size (GB) allowed.
462 &quot;memoryMb&quot;: 42, # [Output Only] The amount of physical memory available to the instance,
463 # defined in MB.
464 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the resource.
465 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
466 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The name of the zone where the machine type resides,
467 # such as us-central1-a.
468 }</pre>
469 </div>
470
471 <div class="method">
472 <code class="details" id="list">list(project, zone, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
473 <pre>Retrieves a list of machine types available to the specified
474 project.
475
476 Args:
477 project: string, Project ID for this request. (required)
478 zone: string, The name of the zone for this request. (required)
479 filter: string, A filter expression that filters resources listed in the response. Most
480 Compute resources support two types of filter expressions:
481 expressions that support regular expressions and expressions that follow
482 API improvement proposal AIP-160.
483 These two types of filter expressions cannot be mixed in one request.
484
485 If you want to use AIP-160, your expression must specify the field name, an
486 operator, and the value that you want to use for filtering. The value
487 must be a string, a number, or a boolean. The operator
488 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
489
490 For example, if you are filtering Compute Engine instances, you can
491 exclude instances named `example-instance` by specifying
492 `name != example-instance`.
493
494 The `:*` comparison can be used to test whether a key has been defined.
495 For example, to find all objects with `owner` label use:
496 ```
497 labels.owner:*
498 ```
499
500 You can also filter nested fields. For example, you could specify
501 `scheduling.automaticRestart = false` to include instances only
502 if they are not scheduled for automatic restarts. You can use filtering
503 on nested fields to filter based onresource labels.
504
505 To filter on multiple expressions, provide each separate expression within
506 parentheses. For example:
507 ```
508 (scheduling.automaticRestart = true)
509 (cpuPlatform = &quot;Intel Skylake&quot;)
510 ```
511 By default, each expression is an `AND` expression. However, you
512 can include `AND` and `OR` expressions explicitly.
513 For example:
514 ```
515 (cpuPlatform = &quot;Intel Skylake&quot;) OR
516 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
517 (scheduling.automaticRestart = true)
518 ```
519
520 If you want to use a regular expression, use the `eq` (equal) or `ne`
521 (not equal) operator against a single un-parenthesized expression with or
522 without quotes or against multiple parenthesized expressions. Examples:
523
524 `fieldname eq unquoted literal`
525 `fieldname eq &#x27;single quoted literal&#x27;`
526 `fieldname eq &quot;double quoted literal&quot;`
527 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
528
529 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
530 The literal value must match the entire field.
531
532 For example, to filter for instances that do not end with name &quot;instance&quot;,
533 you would use `name ne .*instance`.
534
535 You cannot combine constraints on multiple fields using regular
536 expressions.
537 maxResults: integer, The maximum number of results per page that should be returned.
538 If the number of available results is larger than `maxResults`,
539 Compute Engine returns a `nextPageToken` that can be used to get
540 the next page of results in subsequent list requests. Acceptable values are
541 `0` to `500`, inclusive. (Default: `500`)
542 orderBy: string, Sorts list results by a certain order. By default, results
543 are returned in alphanumerical order based on the resource name.
544
545 You can also sort results in descending order based on the creation
546 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
547 results based on the `creationTimestamp` field in
548 reverse chronological order (newest result first). Use this to sort
549 resources like operations so that the newest operation is returned first.
550
551 Currently, only sorting by `name` or
552 `creationTimestamp desc` is supported.
553 pageToken: string, Specifies a page token to use. Set `pageToken` to the
554 `nextPageToken` returned by a previous list request to get
555 the next page of results.
556 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
557 of failure. The default value is false.
558
559 For example, when partial success behavior is enabled, aggregatedList for a
560 single zone scope either returns all resources in the zone or no resources,
561 with an error code.
562 x__xgafv: string, V1 error format.
563 Allowed values
564 1 - v1 error format
565 2 - v2 error format
566
567 Returns:
568 An object of the form:
569
570 { # Contains a list of machine types.
571 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
572 &quot;items&quot;: [ # A list of MachineType resources.
573 { # Represents a Machine Type resource.
574 #
575 # You can use specific machine types for your VM instances based on performance
576 # and pricing requirements. For more information, readMachine Types.
577 &quot;accelerators&quot;: [ # [Output Only] A list of accelerator configurations assigned to this
578 # machine type.
579 {
580 &quot;guestAcceleratorCount&quot;: 42, # Number of accelerator cards exposed to the guest.
581 &quot;guestAcceleratorType&quot;: &quot;A String&quot;, # The accelerator type resource name, not a full URL, e.g.nvidia-tesla-t4.
582 },
583 ],
584 &quot;architecture&quot;: &quot;A String&quot;, # [Output Only] The architecture of the machine type.
585 &quot;bundledLocalSsds&quot;: { # [Output Only] The configuration of bundled local SSD for the machine type.
586 &quot;defaultInterface&quot;: &quot;A String&quot;, # The default disk interface if the interface is not specified.
587 &quot;partitionCount&quot;: 42, # The number of partitions.
588 },
589 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp inRFC3339
590 # text format.
591 &quot;deprecated&quot;: { # Deprecation status for a public resource. # [Output Only] The deprecation status associated with this machine type.
592 # Only applicable if the machine type is unavailable.
593 &quot;deleted&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
594 # resource is intended to change to DELETED. This is only
595 # informational and the status will not change unless the client explicitly
596 # changes it.
597 &quot;deprecated&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
598 # resource is intended to change to DEPRECATED. This is only
599 # informational and the status will not change unless the client explicitly
600 # changes it.
601 &quot;obsolete&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the state of this
602 # resource is intended to change to OBSOLETE. This is only
603 # informational and the status will not change unless the client explicitly
604 # changes it.
605 &quot;replacement&quot;: &quot;A String&quot;, # The URL of the suggested replacement for a deprecated resource.
606 # The suggested replacement resource must be the same kind of resource as the
607 # deprecated resource.
608 &quot;state&quot;: &quot;A String&quot;, # The deprecation state of this resource. This can be ACTIVE,DEPRECATED, OBSOLETE, or DELETED.
609 # 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
610 # warning indicating the deprecated resource and recommending its
611 # replacement. Operations which use OBSOLETE orDELETED resources will be rejected and result in an error.
612 &quot;stateOverride&quot;: { # A rollout policy configuration. # The rollout policy for this deprecation. This policy is only enforced by
613 # image family views. The rollout policy restricts the zones where the
614 # associated resource is considered in a deprecated state. When the rollout
615 # policy does not include the user specified zone, or if the zone is rolled
616 # out, the associated resource is considered in a deprecated state.
617 #
618 # The rollout policy for this deprecation is read-only, except for
619 # allowlisted users. This field might not be configured. To view the latest
620 # non-deprecated image in a specific zone, use theimageFamilyViews.get method.
621 &quot;defaultRolloutTime&quot;: &quot;A String&quot;, # An optional RFC3339 timestamp on or after which the update is
622 # considered rolled out to any zone that is not explicitly stated.
623 &quot;locationRolloutPolicies&quot;: { # Location based rollout policies to apply to the resource.
624 #
625 # Currently only zone names are supported and must be represented
626 # as valid URLs, like: zones/us-central1-a.
627 #
628 # The value expects an RFC3339 timestamp on or after which the update is
629 # considered rolled out to the specified location.
630 &quot;a_key&quot;: &quot;A String&quot;,
631 },
632 },
633 },
634 &quot;description&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the resource.
635 &quot;guestCpus&quot;: 42, # [Output Only] The number of virtual CPUs that are available to the
636 # instance.
637 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the resource. This identifier is
638 # defined by the server.
639 &quot;isSharedCpu&quot;: True or False, # [Output Only] Whether this machine type has a shared CPU. SeeShared-core machine
640 # types for more information.
641 &quot;kind&quot;: &quot;compute#machineType&quot;, # Output only. [Output Only] The type of the resource. Alwayscompute#machineType for machine types.
642 &quot;maximumPersistentDisks&quot;: 42, # [Output Only] Maximum persistent disks allowed.
643 &quot;maximumPersistentDisksSizeGb&quot;: &quot;A String&quot;, # [Output Only] Maximum total persistent disks size (GB) allowed.
644 &quot;memoryMb&quot;: 42, # [Output Only] The amount of physical memory available to the instance,
645 # defined in MB.
646 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the resource.
647 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
648 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The name of the zone where the machine type resides,
649 # such as us-central1-a.
650 },
651 ],
652 &quot;kind&quot;: &quot;compute#machineTypeList&quot;, # Output only. [Output Only] Type of resource. Always compute#machineTypeList
653 # for lists of machine types.
654 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
655 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
656 # the query parameter pageToken in the next list request.
657 # Subsequent list requests will have their own nextPageToken to
658 # continue paging through the results.
659 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
660 &quot;warning&quot;: { # [Output Only] Informational warning message.
661 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
662 # Engine returns NO_RESULTS_ON_PAGE if there
663 # are no results in the response.
664 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
665 # value format. For example:
666 #
667 # &quot;data&quot;: [
668 # {
669 # &quot;key&quot;: &quot;scope&quot;,
670 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
671 # }
672 {
673 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
674 # returned. For example, for warnings where there are no results in a list
675 # request for a particular zone, this key might be scope and
676 # the key value might be the zone name. Other examples might be a key
677 # indicating a deprecated resource and a suggested replacement, or a
678 # warning about invalid network settings (for example, if an instance
679 # attempts to perform IP forwarding but is not enabled for IP forwarding).
680 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
681 },
682 ],
683 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
684 },
685 }</pre>
686 </div>
687
688 <div class="method">
689 <code class="details" id="list_next">list_next()</code>
690 <pre>Retrieves the next page of results.
691
692 Args:
693 previous_request: The request for the previous page. (required)
694 previous_response: The response from the request for the previous page. (required)
695
696 Returns:
697 A request object that you can call &#x27;execute()&#x27; on to request the next
698 page. Returns None if there are no more items in the collection.
699 </pre>
700 </div>
701
702 </body></html>