Debian Codegraph @

docs/dyn/compute_alpha.reservationSubBlocks.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.reservationSubBlocks.html">reservationSubBlocks</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#close">close()</a></code></p>
79 <p class="firstline">Close httplib2 connections.</p>
80 <p class="toc_element">
81 <code><a href="#get">get(project, zone, parentName, reservationSubBlock, view=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Retrieves information about the specified reservation subBlock.</p>
83 <p class="toc_element">
84 <code><a href="#getVersion">getVersion(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None)</a></code></p>
85 <p class="firstline">Allows customers to get SBOM versions of a reservation subBlock.</p>
86 <p class="toc_element">
87 <code><a href="#list">list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Retrieves a list of reservation subBlocks under a single reservation.</p>
89 <p class="toc_element">
90 <code><a href="#list_next">list_next()</a></code></p>
91 <p class="firstline">Retrieves the next page of results.</p>
92 <p class="toc_element">
93 <code><a href="#performMaintenance">performMaintenance(project, zone, parentName, reservationSubBlock, requestId=None, x__xgafv=None)</a></code></p>
94 <p class="firstline">Allows customers to perform maintenance on a reservation subBlock</p>
95 <p class="toc_element">
96 <code><a href="#reportFaulty">reportFaulty(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Allows customers to report a faulty subBlock.</p>
98 <p class="toc_element">
99 <code><a href="#update">update(project, zone, parentName, reservationSubBlock, body=None, requestId=None, updateMask=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Updates a reservation subBlock.</p>
101 <h3>Method Details</h3>
102 <div class="method">
103 <code class="details" id="close">close()</code>
104 <pre>Close httplib2 connections.</pre>
105 </div>
106
107 <div class="method">
108 <code class="details" id="get">get(project, zone, parentName, reservationSubBlock, view=None, x__xgafv=None)</code>
109 <pre>Retrieves information about the specified reservation subBlock.
110
111 Args:
112 project: string, Project ID for this request. (required)
113 zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
114 parentName: string, The name of the parent reservation and parent block. In the format of
115 reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
116 reservationSubBlock: string, The name of the reservation subBlock.
117 Name should conform to RFC1035 or be a resource ID. (required)
118 view: string, View of the subBlock.
119 Allowed values
120 SUB_BLOCK_VIEW_BASIC - This view includes basic information about the reservation sub block
121 SUB_BLOCK_VIEW_FULL - Includes detailed topology view.
122 SUB_BLOCK_VIEW_UNSPECIFIED - The default / unset value. The API will default to the BASIC view.
123 x__xgafv: string, V1 error format.
124 Allowed values
125 1 - v1 error format
126 2 - v2 error format
127
128 Returns:
129 An object of the form:
130
131 {
132 &quot;resource&quot;: { # Represents a reservation subBlock resource.
133 &quot;acceleratorTopologiesInfo&quot;: { # Info for accelerator topologies within a densely packed reservation. # Output only. [Output Only] Slice info for the reservation subBlock.
134 &quot;acceleratorTopologyInfos&quot;: [ # Info for each accelerator topology.
135 { # Info for a slice of a given topology.
136 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # The accelerator topology.
137 &quot;infoPerTopologyStates&quot;: [ # Info for each topology state.
138 { # Info for each topology state.
139 &quot;count&quot;: 42, # The number of accelerator topologies in this state.
140 &quot;state&quot;: &quot;A String&quot;, # The state of the accelerator topology.
141 },
142 ],
143 },
144 ],
145 },
146 &quot;count&quot;: 42, # Output only. [Output Only] The number of hosts that are allocated in this
147 # reservation subBlock.
148 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339 text format.
149 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
150 # defined by the server.
151 &quot;inUseCount&quot;: 42, # Output only. [Output Only] The number of instances that are currently in use on this
152 # reservation subBlock.
153 &quot;inUseHostCount&quot;: 42, # Output only. Number of hosts currently in use. If there is one or more Instances running
154 # on the host, it is considered in use.
155 &quot;kind&quot;: &quot;compute#reservationSubBlock&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks.
156 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] The name of this reservation subBlock generated by Google
157 # Compute Engine. The name must be 1-63 characters long, and comply with
158 # RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?
159 &quot;physicalTopology&quot;: { # Output only. [Output Only] The physical topology of the reservation subBlock.
160 &quot;block&quot;: &quot;A String&quot;, # The hash of the capacity block within the cluster.
161 &quot;cluster&quot;: &quot;A String&quot;, # The cluster name of the reservation subBlock.
162 &quot;subBlock&quot;: &quot;A String&quot;, # The hash of the capacity sub-block within the capacity block.
163 },
164 &quot;reservationSubBlockMaintenance&quot;: { # Maintenance Info for ReservationBlocks. # Output only. Maintenance information for this reservation subBlock.
165 &quot;instanceMaintenanceOngoingCount&quot;: 42, # Describes number of instances that have ongoing maintenance.
166 &quot;instanceMaintenancePendingCount&quot;: 42, # Describes number of instances that have pending maintenance.
167 &quot;maintenanceOngoingCount&quot;: 42, # Progress for ongoing maintenance for this group of VMs/hosts.
168 # Describes number of hosts in the block that have ongoing maintenance.
169 &quot;maintenancePendingCount&quot;: 42, # Progress for ongoing maintenance for this group of VMs/hosts.
170 # Describes number of hosts in the block that have pending maintenance.
171 &quot;schedulingType&quot;: &quot;A String&quot;, # The type of maintenance for the reservation.
172 &quot;subblockInfraMaintenanceOngoingCount&quot;: 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
173 # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
174 # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
175 # Domains). Not all VM Families will support this field.
176 &quot;subblockInfraMaintenancePendingCount&quot;: 42, # Describes number of subblock Infrastructure that has pending maintenance.
177 # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
178 # contained in the Subblock that is necessary for a VM Family (e.g. NVLink
179 # Domains). Not all VM Families will support this field.
180 &quot;upcomingGroupMaintenance&quot;: { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
181 &quot;canReschedule&quot;: True or False, # Indicates if the maintenance can be customer triggered.
182 &quot;date&quot;: &quot;A String&quot;, # [Output Only] The date when the maintenance will take place.
183 # This value is inRFC3339
184 # text format.
185 # DEPRECATED: Use window_start_time instead.
186 &quot;latestWindowStartTime&quot;: &quot;A String&quot;, # The latest time for the planned maintenance window to start.
187 # This timestamp value is in RFC3339 text format.
188 &quot;maintenanceMethod&quot;: &quot;A String&quot;, # Output only. Maintenance method for the upcoming maintenance.
189 &quot;maintenanceOnShutdown&quot;: True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
190 &quot;maintenanceReasons&quot;: [ # The reasons for the maintenance. Only valid for vms.
191 &quot;A String&quot;,
192 ],
193 &quot;maintenanceStatus&quot;: &quot;A String&quot;,
194 &quot;startTimeWindow&quot;: { # Represents a window of time using two timestamps: `earliest` and `latest`. # [Output Only] The start time window of the maintenance disruption.
195 # DEPRECATED: Use window_start_time instead.
196 # TimeWindow is a container for two strings that represent timestamps in
197 # &quot;yyyy-MM-dd&#x27;T&#x27;HH:mm:ssZ&quot; text format.
198 &quot;earliest&quot;: &quot;A String&quot;,
199 &quot;latest&quot;: &quot;A String&quot;,
200 },
201 &quot;time&quot;: &quot;A String&quot;, # [Output Only] The time when the maintenance will take place.
202 # This value is inRFC3339
203 # text format.
204 # DEPRECATED: Use window_start_time instead.
205 &quot;type&quot;: &quot;A String&quot;, # Defines the type of maintenance.
206 &quot;windowEndTime&quot;: &quot;A String&quot;, # The time by which the maintenance disruption will be completed.
207 # This timestamp value is in RFC3339 text format.
208 &quot;windowStartTime&quot;: &quot;A String&quot;, # The current start time of the maintenance window.
209 # This timestamp value is in RFC3339 text format.
210 },
211 },
212 &quot;retentionPriority&quot;: 42, # Customer specified retention priority for power shedding events.
213 # Used to determine priority of the subBlock relative to others during
214 # a power shedding event. Higher priorities are retained over lower ones.
215 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
216 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
217 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] Status of the reservation subBlock.
218 &quot;subBlockHealthInfo&quot;: { # Health information for the reservation subBlock. # Output only. [Output Only] Health information for the reservation subBlock.
219 &quot;degradedHostCount&quot;: 42, # The number of degraded hosts in the reservation subBlock.
220 &quot;degradedInfraCount&quot;: 42, # The number of degraded infrastructure (e.g NV link domain) in the
221 # reservation subblock.
222 &quot;healthStatus&quot;: &quot;A String&quot;, # The health status of the reservation subBlock.
223 &quot;healthyHostCount&quot;: 42, # The number of healthy hosts in the reservation subBlock.
224 &quot;healthyInfraCount&quot;: 42, # The number of healthy infrastructure (e.g NV link domain) in the
225 # reservation subblock.
226 },
227 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] Zone in which the reservation subBlock resides.
228 },
229 }</pre>
230 </div>
231
232 <div class="method">
233 <code class="details" id="getVersion">getVersion(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None)</code>
234 <pre>Allows customers to get SBOM versions of a reservation subBlock.
235
236 Args:
237 project: string, Project ID for this request. (required)
238 zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
239 parentName: string, The name of the parent reservation and parent block. In the format of
240 reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
241 reservationSubBlock: string, The name of the reservation subBlock.
242 Name should conform to RFC1035 or be a resource ID. (required)
243 body: object, The request body.
244 The object takes the form of:
245
246 {
247 &quot;sbomSelections&quot;: [ # The SBOM selection to return.
248 &quot;A String&quot;,
249 ],
250 }
251
252 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
253 that if you must retry your request, the server will know to ignore the
254 request if it has already been completed.
255
256 For example, consider a situation where you make an initial request and
257 the request times out. If you make the request again with the same
258 request ID, the server can check if original operation with the same
259 request ID was received, and if so, will ignore the second request. This
260 prevents clients from accidentally creating duplicate commitments.
261
262 The request ID must be
263 a valid UUID with the exception that zero UUID is not supported
264 (00000000-0000-0000-0000-000000000000).
265 x__xgafv: string, V1 error format.
266 Allowed values
267 1 - v1 error format
268 2 - v2 error format
269
270 Returns:
271 An object of the form:
272
273 { # Represents an Operation resource.
274 #
275 # Google Compute Engine has three Operation resources:
276 #
277 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
278 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
279 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
280 #
281 # You can use an operation resource to manage asynchronous API requests.
282 # For more information, readHandling
283 # API responses.
284 #
285 # Operations can be global, regional or zonal.
286 #
287 # - For global operations, use the `globalOperations`
288 # resource.
289 # - For regional operations, use the
290 # `regionOperations` resource.
291 # - For zonal operations, use
292 # the `zoneOperations` resource.
293 #
294 #
295 #
296 # For more information, read
297 # Global, Regional, and Zonal Resources.
298 #
299 # Note that completed Operation resources have a limited
300 # retention period.
301 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
302 # Not present otherwise.
303 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
304 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
305 # set when the operation is created.
306 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
307 # text format.
308 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
309 # this field will be populated.
310 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
311 # operation.
312 {
313 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
314 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
315 # details. There is a set of defined message types to use for providing
316 # details.The syntax depends on the error code. For example,
317 # QuotaExceededInfo will have details when the error code is
318 # QUOTA_EXCEEDED.
319 {
320 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
321 #
322 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
323 # is not enabled:
324 #
325 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
326 # &quot;domain&quot;: &quot;googleapis.com&quot;
327 # &quot;metadata&quot;: {
328 # &quot;resource&quot;: &quot;projects/123&quot;,
329 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
330 # }
331 # }
332 #
333 # This response indicates that the pubsub.googleapis.com API is not enabled.
334 #
335 # Example of an error that is returned when attempting to create a Spanner
336 # instance in a region that is out of stock:
337 #
338 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
339 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
340 # &quot;metadata&quot;: {
341 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
342 # }
343 # }
344 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
345 # is typically the registered service name of the tool or product that
346 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
347 # generated by some common infrastructure, the error domain must be a
348 # globally unique value that identifies the infrastructure. For Google API
349 # infrastructure, the error domain is &quot;googleapis.com&quot;.
350 &quot;metadatas&quot;: { # Additional structured details about this error.
351 #
352 # Keys must match a regular expression of `a-z+` but should
353 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
354 # length. When identifying the current value of an exceeded limit, the units
355 # should be contained in the key, not the value. For example, rather than
356 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
357 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
358 # instances that can be created in a single (batch) request.
359 &quot;a_key&quot;: &quot;A String&quot;,
360 },
361 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
362 # proximate cause of the error. Error reasons are unique within a particular
363 # domain of errors. This should be at most 63 characters and match a
364 # regular expression of `A-Z+[A-Z0-9]`, which represents
365 # UPPER_SNAKE_CASE.
366 },
367 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
368 #
369 # For example, if a quota check failed with an error indicating the calling
370 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
371 # directly to the right place in the developer console to flip the bit.
372 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
373 { # Describes a URL link.
374 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
375 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
376 },
377 ],
378 },
379 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
380 # which can be attached to an RPC error.
381 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
382 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
383 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
384 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
385 },
386 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
387 &quot;dimensions&quot;: { # The map holding related quota dimensions.
388 &quot;a_key&quot;: &quot;A String&quot;,
389 },
390 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
391 # type or metric.
392 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
393 # or metric.
394 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
395 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
396 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
397 },
398 },
399 ],
400 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
401 # This property is optional.
402 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
403 },
404 ],
405 },
406 &quot;getVersionOperationMetadata&quot;: {
407 &quot;inlineSbomInfo&quot;: {
408 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
409 # appropriate identifiers.
410 &quot;a_key&quot;: &quot;A String&quot;,
411 },
412 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
413 # identifiers.
414 &quot;a_key&quot;: &quot;A String&quot;,
415 },
416 },
417 },
418 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
419 # message that was returned, such as `NOT FOUND`.
420 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
421 # status code that was returned. For example, a `404` means the
422 # resource was not found.
423 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
424 # defined by the server.
425 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
426 # This value is inRFC3339
427 # text format.
428 &quot;instancesBulkInsertOperationMetadata&quot;: {
429 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
430 # Example key: zones/us-central1-a
431 &quot;a_key&quot;: {
432 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
433 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
434 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
435 # error.
436 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
437 # if the flow is rolling forward or rolling back.
438 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
439 },
440 },
441 },
442 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
443 # Operation resources.
444 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
445 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
446 # group of operations results from a `bulkInsert` API request.
447 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
448 # `update`, or `delete`, and so on.
449 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
450 # There is no requirement that this be linear or support any granularity of
451 # operations. This should not be used to guess when the operation will be
452 # complete. This number should monotonically increase as the operation
453 # progresses.
454 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
455 # applicable when performing regional operations.
456 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
457 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
458 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
459 # this field will contain information on all underlying zonal actions and
460 # their state.
461 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
462 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
463 # Example key: zones/us-central1-a
464 &quot;a_key&quot;: {
465 &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
466 # populated.
467 # different programming environments, including REST APIs and RPC APIs. It is
468 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
469 # three pieces of data: error code, error message, and error details.
470 #
471 # You can find out more about this error model and how to work with it in the
472 # [API Design Guide](https://cloud.google.com/apis/design/errors).
473 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
474 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
475 # message types for APIs to use.
476 {
477 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
478 },
479 ],
480 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
481 # user-facing error message should be localized and sent in the
482 # google.rpc.Status.details field, or localized by the client.
483 },
484 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
485 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
486 },
487 },
488 },
489 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
490 # This value is inRFC3339
491 # text format.
492 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
493 # following:
494 # `PENDING`, `RUNNING`, or `DONE`.
495 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
496 # operation.
497 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
498 # of the target resource.
499 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
500 # operations related to creating a snapshot, this points to the disk
501 # that the snapshot was created from.
502 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
503 # `[email protected]` or
504 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
505 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
506 # operation, this field will be populated.
507 {
508 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
509 # Engine returns NO_RESULTS_ON_PAGE if there
510 # are no results in the response.
511 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
512 # value format. For example:
513 #
514 # &quot;data&quot;: [
515 # {
516 # &quot;key&quot;: &quot;scope&quot;,
517 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
518 # }
519 {
520 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
521 # returned. For example, for warnings where there are no results in a list
522 # request for a particular zone, this key might be scope and
523 # the key value might be the zone name. Other examples might be a key
524 # indicating a deprecated resource and a suggested replacement, or a
525 # warning about invalid network settings (for example, if an instance
526 # attempts to perform IP forwarding but is not enabled for IP forwarding).
527 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
528 },
529 ],
530 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
531 },
532 ],
533 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
534 # applicable when performing per-zone operations.
535 }</pre>
536 </div>
537
538 <div class="method">
539 <code class="details" id="list">list(project, zone, parentName, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
540 <pre>Retrieves a list of reservation subBlocks under a single reservation.
541
542 Args:
543 project: string, Project ID for this request. (required)
544 zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
545 parentName: string, The name of the parent reservation and parent block. In the format of
546 reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
547 filter: string, A filter expression that filters resources listed in the response. Most
548 Compute resources support two types of filter expressions:
549 expressions that support regular expressions and expressions that follow
550 API improvement proposal AIP-160.
551 These two types of filter expressions cannot be mixed in one request.
552
553 If you want to use AIP-160, your expression must specify the field name, an
554 operator, and the value that you want to use for filtering. The value
555 must be a string, a number, or a boolean. The operator
556 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
557
558 For example, if you are filtering Compute Engine instances, you can
559 exclude instances named `example-instance` by specifying
560 `name != example-instance`.
561
562 The `:*` comparison can be used to test whether a key has been defined.
563 For example, to find all objects with `owner` label use:
564 ```
565 labels.owner:*
566 ```
567
568 You can also filter nested fields. For example, you could specify
569 `scheduling.automaticRestart = false` to include instances only
570 if they are not scheduled for automatic restarts. You can use filtering
571 on nested fields to filter based onresource labels.
572
573 To filter on multiple expressions, provide each separate expression within
574 parentheses. For example:
575 ```
576 (scheduling.automaticRestart = true)
577 (cpuPlatform = &quot;Intel Skylake&quot;)
578 ```
579 By default, each expression is an `AND` expression. However, you
580 can include `AND` and `OR` expressions explicitly.
581 For example:
582 ```
583 (cpuPlatform = &quot;Intel Skylake&quot;) OR
584 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
585 (scheduling.automaticRestart = true)
586 ```
587
588 If you want to use a regular expression, use the `eq` (equal) or `ne`
589 (not equal) operator against a single un-parenthesized expression with or
590 without quotes or against multiple parenthesized expressions. Examples:
591
592 `fieldname eq unquoted literal`
593 `fieldname eq &#x27;single quoted literal&#x27;`
594 `fieldname eq &quot;double quoted literal&quot;`
595 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
596
597 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
598 The literal value must match the entire field.
599
600 For example, to filter for instances that do not end with name &quot;instance&quot;,
601 you would use `name ne .*instance`.
602
603 You cannot combine constraints on multiple fields using regular
604 expressions.
605 maxResults: integer, The maximum number of results per page that should be returned.
606 If the number of available results is larger than `maxResults`,
607 Compute Engine returns a `nextPageToken` that can be used to get
608 the next page of results in subsequent list requests. Acceptable values are
609 `0` to `500`, inclusive. (Default: `500`)
610 orderBy: string, Sorts list results by a certain order. By default, results
611 are returned in alphanumerical order based on the resource name.
612
613 You can also sort results in descending order based on the creation
614 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
615 results based on the `creationTimestamp` field in
616 reverse chronological order (newest result first). Use this to sort
617 resources like operations so that the newest operation is returned first.
618
619 Currently, only sorting by `name` or
620 `creationTimestamp desc` is supported.
621 pageToken: string, Specifies a page token to use. Set `pageToken` to the
622 `nextPageToken` returned by a previous list request to get
623 the next page of results.
624 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
625 of failure. The default value is false.
626
627 For example, when partial success behavior is enabled, aggregatedList for a
628 single zone scope either returns all resources in the zone or no resources,
629 with an error code.
630 x__xgafv: string, V1 error format.
631 Allowed values
632 1 - v1 error format
633 2 - v2 error format
634
635 Returns:
636 An object of the form:
637
638 { # A list of reservation subBlocks under a single reservation.
639 &quot;id&quot;: &quot;A String&quot;, # Unique identifier for the resource; defined by the server.
640 &quot;items&quot;: [ # A list of reservation subBlock resources.
641 { # Represents a reservation subBlock resource.
642 &quot;acceleratorTopologiesInfo&quot;: { # Info for accelerator topologies within a densely packed reservation. # Output only. [Output Only] Slice info for the reservation subBlock.
643 &quot;acceleratorTopologyInfos&quot;: [ # Info for each accelerator topology.
644 { # Info for a slice of a given topology.
645 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # The accelerator topology.
646 &quot;infoPerTopologyStates&quot;: [ # Info for each topology state.
647 { # Info for each topology state.
648 &quot;count&quot;: 42, # The number of accelerator topologies in this state.
649 &quot;state&quot;: &quot;A String&quot;, # The state of the accelerator topology.
650 },
651 ],
652 },
653 ],
654 },
655 &quot;count&quot;: 42, # Output only. [Output Only] The number of hosts that are allocated in this
656 # reservation subBlock.
657 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339 text format.
658 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
659 # defined by the server.
660 &quot;inUseCount&quot;: 42, # Output only. [Output Only] The number of instances that are currently in use on this
661 # reservation subBlock.
662 &quot;inUseHostCount&quot;: 42, # Output only. Number of hosts currently in use. If there is one or more Instances running
663 # on the host, it is considered in use.
664 &quot;kind&quot;: &quot;compute#reservationSubBlock&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks.
665 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] The name of this reservation subBlock generated by Google
666 # Compute Engine. The name must be 1-63 characters long, and comply with
667 # RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?
668 &quot;physicalTopology&quot;: { # Output only. [Output Only] The physical topology of the reservation subBlock.
669 &quot;block&quot;: &quot;A String&quot;, # The hash of the capacity block within the cluster.
670 &quot;cluster&quot;: &quot;A String&quot;, # The cluster name of the reservation subBlock.
671 &quot;subBlock&quot;: &quot;A String&quot;, # The hash of the capacity sub-block within the capacity block.
672 },
673 &quot;reservationSubBlockMaintenance&quot;: { # Maintenance Info for ReservationBlocks. # Output only. Maintenance information for this reservation subBlock.
674 &quot;instanceMaintenanceOngoingCount&quot;: 42, # Describes number of instances that have ongoing maintenance.
675 &quot;instanceMaintenancePendingCount&quot;: 42, # Describes number of instances that have pending maintenance.
676 &quot;maintenanceOngoingCount&quot;: 42, # Progress for ongoing maintenance for this group of VMs/hosts.
677 # Describes number of hosts in the block that have ongoing maintenance.
678 &quot;maintenancePendingCount&quot;: 42, # Progress for ongoing maintenance for this group of VMs/hosts.
679 # Describes number of hosts in the block that have pending maintenance.
680 &quot;schedulingType&quot;: &quot;A String&quot;, # The type of maintenance for the reservation.
681 &quot;subblockInfraMaintenanceOngoingCount&quot;: 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
682 # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
683 # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
684 # Domains). Not all VM Families will support this field.
685 &quot;subblockInfraMaintenancePendingCount&quot;: 42, # Describes number of subblock Infrastructure that has pending maintenance.
686 # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
687 # contained in the Subblock that is necessary for a VM Family (e.g. NVLink
688 # Domains). Not all VM Families will support this field.
689 &quot;upcomingGroupMaintenance&quot;: { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
690 &quot;canReschedule&quot;: True or False, # Indicates if the maintenance can be customer triggered.
691 &quot;date&quot;: &quot;A String&quot;, # [Output Only] The date when the maintenance will take place.
692 # This value is inRFC3339
693 # text format.
694 # DEPRECATED: Use window_start_time instead.
695 &quot;latestWindowStartTime&quot;: &quot;A String&quot;, # The latest time for the planned maintenance window to start.
696 # This timestamp value is in RFC3339 text format.
697 &quot;maintenanceMethod&quot;: &quot;A String&quot;, # Output only. Maintenance method for the upcoming maintenance.
698 &quot;maintenanceOnShutdown&quot;: True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
699 &quot;maintenanceReasons&quot;: [ # The reasons for the maintenance. Only valid for vms.
700 &quot;A String&quot;,
701 ],
702 &quot;maintenanceStatus&quot;: &quot;A String&quot;,
703 &quot;startTimeWindow&quot;: { # Represents a window of time using two timestamps: `earliest` and `latest`. # [Output Only] The start time window of the maintenance disruption.
704 # DEPRECATED: Use window_start_time instead.
705 # TimeWindow is a container for two strings that represent timestamps in
706 # &quot;yyyy-MM-dd&#x27;T&#x27;HH:mm:ssZ&quot; text format.
707 &quot;earliest&quot;: &quot;A String&quot;,
708 &quot;latest&quot;: &quot;A String&quot;,
709 },
710 &quot;time&quot;: &quot;A String&quot;, # [Output Only] The time when the maintenance will take place.
711 # This value is inRFC3339
712 # text format.
713 # DEPRECATED: Use window_start_time instead.
714 &quot;type&quot;: &quot;A String&quot;, # Defines the type of maintenance.
715 &quot;windowEndTime&quot;: &quot;A String&quot;, # The time by which the maintenance disruption will be completed.
716 # This timestamp value is in RFC3339 text format.
717 &quot;windowStartTime&quot;: &quot;A String&quot;, # The current start time of the maintenance window.
718 # This timestamp value is in RFC3339 text format.
719 },
720 },
721 &quot;retentionPriority&quot;: 42, # Customer specified retention priority for power shedding events.
722 # Used to determine priority of the subBlock relative to others during
723 # a power shedding event. Higher priorities are retained over lower ones.
724 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
725 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
726 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] Status of the reservation subBlock.
727 &quot;subBlockHealthInfo&quot;: { # Health information for the reservation subBlock. # Output only. [Output Only] Health information for the reservation subBlock.
728 &quot;degradedHostCount&quot;: 42, # The number of degraded hosts in the reservation subBlock.
729 &quot;degradedInfraCount&quot;: 42, # The number of degraded infrastructure (e.g NV link domain) in the
730 # reservation subblock.
731 &quot;healthStatus&quot;: &quot;A String&quot;, # The health status of the reservation subBlock.
732 &quot;healthyHostCount&quot;: 42, # The number of healthy hosts in the reservation subBlock.
733 &quot;healthyInfraCount&quot;: 42, # The number of healthy infrastructure (e.g NV link domain) in the
734 # reservation subblock.
735 },
736 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] Zone in which the reservation subBlock resides.
737 },
738 ],
739 &quot;kind&quot;: &quot;compute#reservationSubBlock&quot;, # Type of the resource. Alwayscompute#reservationSubBlock for a list of reservation
740 # subBlocks.
741 &quot;nextPageToken&quot;: &quot;A String&quot;, # This token allows you to get the next page of results for
742 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
743 # the query parameter pageToken in the next list request.
744 # Subsequent list requests will have their own nextPageToken to
745 # continue paging through the results.
746 &quot;selfLink&quot;: &quot;A String&quot;, # Server-defined URL for this resource.
747 &quot;warning&quot;: { # Informational warning message.
748 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
749 # Engine returns NO_RESULTS_ON_PAGE if there
750 # are no results in the response.
751 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
752 # value format. For example:
753 #
754 # &quot;data&quot;: [
755 # {
756 # &quot;key&quot;: &quot;scope&quot;,
757 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
758 # }
759 {
760 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
761 # returned. For example, for warnings where there are no results in a list
762 # request for a particular zone, this key might be scope and
763 # the key value might be the zone name. Other examples might be a key
764 # indicating a deprecated resource and a suggested replacement, or a
765 # warning about invalid network settings (for example, if an instance
766 # attempts to perform IP forwarding but is not enabled for IP forwarding).
767 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
768 },
769 ],
770 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
771 },
772 }</pre>
773 </div>
774
775 <div class="method">
776 <code class="details" id="list_next">list_next()</code>
777 <pre>Retrieves the next page of results.
778
779 Args:
780 previous_request: The request for the previous page. (required)
781 previous_response: The response from the request for the previous page. (required)
782
783 Returns:
784 A request object that you can call &#x27;execute()&#x27; on to request the next
785 page. Returns None if there are no more items in the collection.
786 </pre>
787 </div>
788
789 <div class="method">
790 <code class="details" id="performMaintenance">performMaintenance(project, zone, parentName, reservationSubBlock, requestId=None, x__xgafv=None)</code>
791 <pre>Allows customers to perform maintenance on a reservation subBlock
792
793 Args:
794 project: string, Project ID for this request. (required)
795 zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
796 parentName: string, The name of the parent reservation and parent block. In the format of
797 reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
798 reservationSubBlock: string, The name of the reservation subBlock.
799 Name should conform to RFC1035 or be a resource ID. (required)
800 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
801 that if you must retry your request, the server will know to ignore the
802 request if it has already been completed.
803
804 For example, consider a situation where you make an initial request and
805 the request times out. If you make the request again with the same
806 request ID, the server can check if original operation with the same
807 request ID was received, and if so, will ignore the second request. This
808 prevents clients from accidentally creating duplicate commitments.
809
810 The request ID must be
811 a valid UUID with the exception that zero UUID is not supported
812 (00000000-0000-0000-0000-000000000000).
813 x__xgafv: string, V1 error format.
814 Allowed values
815 1 - v1 error format
816 2 - v2 error format
817
818 Returns:
819 An object of the form:
820
821 { # Represents an Operation resource.
822 #
823 # Google Compute Engine has three Operation resources:
824 #
825 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
826 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
827 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
828 #
829 # You can use an operation resource to manage asynchronous API requests.
830 # For more information, readHandling
831 # API responses.
832 #
833 # Operations can be global, regional or zonal.
834 #
835 # - For global operations, use the `globalOperations`
836 # resource.
837 # - For regional operations, use the
838 # `regionOperations` resource.
839 # - For zonal operations, use
840 # the `zoneOperations` resource.
841 #
842 #
843 #
844 # For more information, read
845 # Global, Regional, and Zonal Resources.
846 #
847 # Note that completed Operation resources have a limited
848 # retention period.
849 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
850 # Not present otherwise.
851 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
852 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
853 # set when the operation is created.
854 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
855 # text format.
856 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
857 # this field will be populated.
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;getVersionOperationMetadata&quot;: {
955 &quot;inlineSbomInfo&quot;: {
956 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
957 # appropriate identifiers.
958 &quot;a_key&quot;: &quot;A String&quot;,
959 },
960 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
961 # identifiers.
962 &quot;a_key&quot;: &quot;A String&quot;,
963 },
964 },
965 },
966 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
967 # message that was returned, such as `NOT FOUND`.
968 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
969 # status code that was returned. For example, a `404` means the
970 # resource was not found.
971 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
972 # defined by the server.
973 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
974 # This value is inRFC3339
975 # text format.
976 &quot;instancesBulkInsertOperationMetadata&quot;: {
977 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
978 # Example key: zones/us-central1-a
979 &quot;a_key&quot;: {
980 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
981 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
982 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
983 # error.
984 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
985 # if the flow is rolling forward or rolling back.
986 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
987 },
988 },
989 },
990 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
991 # Operation resources.
992 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
993 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
994 # group of operations results from a `bulkInsert` API request.
995 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
996 # `update`, or `delete`, and so on.
997 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
998 # There is no requirement that this be linear or support any granularity of
999 # operations. This should not be used to guess when the operation will be
1000 # complete. This number should monotonically increase as the operation
1001 # progresses.
1002 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1003 # applicable when performing regional operations.
1004 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1005 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1006 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1007 # this field will contain information on all underlying zonal actions and
1008 # their state.
1009 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1010 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1011 # Example key: zones/us-central1-a
1012 &quot;a_key&quot;: {
1013 &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
1014 # populated.
1015 # different programming environments, including REST APIs and RPC APIs. It is
1016 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1017 # three pieces of data: error code, error message, and error details.
1018 #
1019 # You can find out more about this error model and how to work with it in the
1020 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1021 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1022 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1023 # message types for APIs to use.
1024 {
1025 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1026 },
1027 ],
1028 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1029 # user-facing error message should be localized and sent in the
1030 # google.rpc.Status.details field, or localized by the client.
1031 },
1032 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1033 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1034 },
1035 },
1036 },
1037 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1038 # This value is inRFC3339
1039 # text format.
1040 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1041 # following:
1042 # `PENDING`, `RUNNING`, or `DONE`.
1043 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1044 # operation.
1045 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1046 # of the target resource.
1047 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1048 # operations related to creating a snapshot, this points to the disk
1049 # that the snapshot was created from.
1050 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1051 # `[email protected]` or
1052 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1053 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1054 # operation, this field will be populated.
1055 {
1056 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1057 # Engine returns NO_RESULTS_ON_PAGE if there
1058 # are no results in the response.
1059 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1060 # value format. For example:
1061 #
1062 # &quot;data&quot;: [
1063 # {
1064 # &quot;key&quot;: &quot;scope&quot;,
1065 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1066 # }
1067 {
1068 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1069 # returned. For example, for warnings where there are no results in a list
1070 # request for a particular zone, this key might be scope and
1071 # the key value might be the zone name. Other examples might be a key
1072 # indicating a deprecated resource and a suggested replacement, or a
1073 # warning about invalid network settings (for example, if an instance
1074 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1075 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1076 },
1077 ],
1078 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1079 },
1080 ],
1081 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1082 # applicable when performing per-zone operations.
1083 }</pre>
1084 </div>
1085
1086 <div class="method">
1087 <code class="details" id="reportFaulty">reportFaulty(project, zone, parentName, reservationSubBlock, body=None, requestId=None, x__xgafv=None)</code>
1088 <pre>Allows customers to report a faulty subBlock.
1089
1090 Args:
1091 project: string, Project ID for this request. (required)
1092 zone: string, Name of the zone for this request. Zone name should conform to RFC1035. (required)
1093 parentName: string, The name of the parent reservation and parent block. In the format of
1094 reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
1095 reservationSubBlock: string, The name of the reservation subBlock.
1096 Name should conform to RFC1035 or be a resource ID. (required)
1097 body: object, The request body.
1098 The object takes the form of:
1099
1100 {
1101 &quot;disruptionSchedule&quot;: &quot;A String&quot;, # The disruption schedule for the subBlock.
1102 &quot;failureComponent&quot;: &quot;A String&quot;, # The component that experienced the fault.
1103 &quot;faultReasons&quot;: [ # The reasons for the fault experienced with the subBlock.
1104 { # The reason for the fault experienced with the subBlock.
1105 &quot;behavior&quot;: &quot;A String&quot;, # The behavior of the fault experienced with the subBlock.
1106 &quot;description&quot;: &quot;A String&quot;, # The description of the fault experienced with the subBlock.
1107 },
1108 ],
1109 }
1110
1111 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1112 that if you must retry your request, the server will know to ignore the
1113 request if it has already been completed.
1114
1115 For example, consider a situation where you make an initial request and
1116 the request times out. If you make the request again with the same
1117 request ID, the server can check if original operation with the same
1118 request ID was received, and if so, will ignore the second request. This
1119 prevents clients from accidentally creating duplicate commitments.
1120
1121 The request ID must be
1122 a valid UUID with the exception that zero UUID is not supported
1123 (00000000-0000-0000-0000-000000000000).
1124 x__xgafv: string, V1 error format.
1125 Allowed values
1126 1 - v1 error format
1127 2 - v2 error format
1128
1129 Returns:
1130 An object of the form:
1131
1132 { # Represents an Operation resource.
1133 #
1134 # Google Compute Engine has three Operation resources:
1135 #
1136 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1137 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1138 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1139 #
1140 # You can use an operation resource to manage asynchronous API requests.
1141 # For more information, readHandling
1142 # API responses.
1143 #
1144 # Operations can be global, regional or zonal.
1145 #
1146 # - For global operations, use the `globalOperations`
1147 # resource.
1148 # - For regional operations, use the
1149 # `regionOperations` resource.
1150 # - For zonal operations, use
1151 # the `zoneOperations` resource.
1152 #
1153 #
1154 #
1155 # For more information, read
1156 # Global, Regional, and Zonal Resources.
1157 #
1158 # Note that completed Operation resources have a limited
1159 # retention period.
1160 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1161 # Not present otherwise.
1162 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1163 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1164 # set when the operation is created.
1165 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1166 # text format.
1167 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1168 # this field will be populated.
1169 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1170 # operation.
1171 {
1172 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1173 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1174 # details. There is a set of defined message types to use for providing
1175 # details.The syntax depends on the error code. For example,
1176 # QuotaExceededInfo will have details when the error code is
1177 # QUOTA_EXCEEDED.
1178 {
1179 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1180 #
1181 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1182 # is not enabled:
1183 #
1184 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1185 # &quot;domain&quot;: &quot;googleapis.com&quot;
1186 # &quot;metadata&quot;: {
1187 # &quot;resource&quot;: &quot;projects/123&quot;,
1188 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1189 # }
1190 # }
1191 #
1192 # This response indicates that the pubsub.googleapis.com API is not enabled.
1193 #
1194 # Example of an error that is returned when attempting to create a Spanner
1195 # instance in a region that is out of stock:
1196 #
1197 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1198 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1199 # &quot;metadata&quot;: {
1200 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1201 # }
1202 # }
1203 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1204 # is typically the registered service name of the tool or product that
1205 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1206 # generated by some common infrastructure, the error domain must be a
1207 # globally unique value that identifies the infrastructure. For Google API
1208 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1209 &quot;metadatas&quot;: { # Additional structured details about this error.
1210 #
1211 # Keys must match a regular expression of `a-z+` but should
1212 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1213 # length. When identifying the current value of an exceeded limit, the units
1214 # should be contained in the key, not the value. For example, rather than
1215 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1216 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1217 # instances that can be created in a single (batch) request.
1218 &quot;a_key&quot;: &quot;A String&quot;,
1219 },
1220 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1221 # proximate cause of the error. Error reasons are unique within a particular
1222 # domain of errors. This should be at most 63 characters and match a
1223 # regular expression of `A-Z+[A-Z0-9]`, which represents
1224 # UPPER_SNAKE_CASE.
1225 },
1226 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1227 #
1228 # For example, if a quota check failed with an error indicating the calling
1229 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1230 # directly to the right place in the developer console to flip the bit.
1231 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1232 { # Describes a URL link.
1233 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1234 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1235 },
1236 ],
1237 },
1238 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1239 # which can be attached to an RPC error.
1240 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1241 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1242 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1243 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1244 },
1245 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1246 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1247 &quot;a_key&quot;: &quot;A String&quot;,
1248 },
1249 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1250 # type or metric.
1251 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1252 # or metric.
1253 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1254 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1255 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1256 },
1257 },
1258 ],
1259 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1260 # This property is optional.
1261 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1262 },
1263 ],
1264 },
1265 &quot;getVersionOperationMetadata&quot;: {
1266 &quot;inlineSbomInfo&quot;: {
1267 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1268 # appropriate identifiers.
1269 &quot;a_key&quot;: &quot;A String&quot;,
1270 },
1271 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1272 # identifiers.
1273 &quot;a_key&quot;: &quot;A String&quot;,
1274 },
1275 },
1276 },
1277 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1278 # message that was returned, such as `NOT FOUND`.
1279 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1280 # status code that was returned. For example, a `404` means the
1281 # resource was not found.
1282 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1283 # defined by the server.
1284 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1285 # This value is inRFC3339
1286 # text format.
1287 &quot;instancesBulkInsertOperationMetadata&quot;: {
1288 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1289 # Example key: zones/us-central1-a
1290 &quot;a_key&quot;: {
1291 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1292 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1293 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1294 # error.
1295 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1296 # if the flow is rolling forward or rolling back.
1297 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1298 },
1299 },
1300 },
1301 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1302 # Operation resources.
1303 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1304 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1305 # group of operations results from a `bulkInsert` API request.
1306 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1307 # `update`, or `delete`, and so on.
1308 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1309 # There is no requirement that this be linear or support any granularity of
1310 # operations. This should not be used to guess when the operation will be
1311 # complete. This number should monotonically increase as the operation
1312 # progresses.
1313 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1314 # applicable when performing regional operations.
1315 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1316 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1317 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1318 # this field will contain information on all underlying zonal actions and
1319 # their state.
1320 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1321 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1322 # Example key: zones/us-central1-a
1323 &quot;a_key&quot;: {
1324 &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
1325 # populated.
1326 # different programming environments, including REST APIs and RPC APIs. It is
1327 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1328 # three pieces of data: error code, error message, and error details.
1329 #
1330 # You can find out more about this error model and how to work with it in the
1331 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1332 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1333 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1334 # message types for APIs to use.
1335 {
1336 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1337 },
1338 ],
1339 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1340 # user-facing error message should be localized and sent in the
1341 # google.rpc.Status.details field, or localized by the client.
1342 },
1343 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1344 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1345 },
1346 },
1347 },
1348 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1349 # This value is inRFC3339
1350 # text format.
1351 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1352 # following:
1353 # `PENDING`, `RUNNING`, or `DONE`.
1354 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1355 # operation.
1356 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1357 # of the target resource.
1358 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1359 # operations related to creating a snapshot, this points to the disk
1360 # that the snapshot was created from.
1361 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1362 # `[email protected]` or
1363 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1364 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1365 # operation, this field will be populated.
1366 {
1367 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1368 # Engine returns NO_RESULTS_ON_PAGE if there
1369 # are no results in the response.
1370 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1371 # value format. For example:
1372 #
1373 # &quot;data&quot;: [
1374 # {
1375 # &quot;key&quot;: &quot;scope&quot;,
1376 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1377 # }
1378 {
1379 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1380 # returned. For example, for warnings where there are no results in a list
1381 # request for a particular zone, this key might be scope and
1382 # the key value might be the zone name. Other examples might be a key
1383 # indicating a deprecated resource and a suggested replacement, or a
1384 # warning about invalid network settings (for example, if an instance
1385 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1386 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1387 },
1388 ],
1389 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1390 },
1391 ],
1392 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1393 # applicable when performing per-zone operations.
1394 }</pre>
1395 </div>
1396
1397 <div class="method">
1398 <code class="details" id="update">update(project, zone, parentName, reservationSubBlock, body=None, requestId=None, updateMask=None, x__xgafv=None)</code>
1399 <pre>Updates a reservation subBlock.
1400
1401 Args:
1402 project: string, The project ID for this request. (required)
1403 zone: string, The name of the zone for this request. (required)
1404 parentName: string, The name of the parent reservation and parent block. In the format of
1405 reservations/{reservation_name}/reservationBlocks/{reservation_block_name} (required)
1406 reservationSubBlock: string, The name of the subBlock resource. (required)
1407 body: object, The request body.
1408 The object takes the form of:
1409
1410 { # Represents a reservation subBlock resource.
1411 &quot;acceleratorTopologiesInfo&quot;: { # Info for accelerator topologies within a densely packed reservation. # Output only. [Output Only] Slice info for the reservation subBlock.
1412 &quot;acceleratorTopologyInfos&quot;: [ # Info for each accelerator topology.
1413 { # Info for a slice of a given topology.
1414 &quot;acceleratorTopology&quot;: &quot;A String&quot;, # The accelerator topology.
1415 &quot;infoPerTopologyStates&quot;: [ # Info for each topology state.
1416 { # Info for each topology state.
1417 &quot;count&quot;: 42, # The number of accelerator topologies in this state.
1418 &quot;state&quot;: &quot;A String&quot;, # The state of the accelerator topology.
1419 },
1420 ],
1421 },
1422 ],
1423 },
1424 &quot;count&quot;: 42, # Output only. [Output Only] The number of hosts that are allocated in this
1425 # reservation subBlock.
1426 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339 text format.
1427 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
1428 # defined by the server.
1429 &quot;inUseCount&quot;: 42, # Output only. [Output Only] The number of instances that are currently in use on this
1430 # reservation subBlock.
1431 &quot;inUseHostCount&quot;: 42, # Output only. Number of hosts currently in use. If there is one or more Instances running
1432 # on the host, it is considered in use.
1433 &quot;kind&quot;: &quot;compute#reservationSubBlock&quot;, # Output only. [Output Only] Type of the resource. Alwayscompute#reservationSubBlock for reservation subBlocks.
1434 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] The name of this reservation subBlock generated by Google
1435 # Compute Engine. The name must be 1-63 characters long, and comply with
1436 # RFC1035 @pattern [a-z](?:[-a-z0-9]{0,61}[a-z0-9])?
1437 &quot;physicalTopology&quot;: { # Output only. [Output Only] The physical topology of the reservation subBlock.
1438 &quot;block&quot;: &quot;A String&quot;, # The hash of the capacity block within the cluster.
1439 &quot;cluster&quot;: &quot;A String&quot;, # The cluster name of the reservation subBlock.
1440 &quot;subBlock&quot;: &quot;A String&quot;, # The hash of the capacity sub-block within the capacity block.
1441 },
1442 &quot;reservationSubBlockMaintenance&quot;: { # Maintenance Info for ReservationBlocks. # Output only. Maintenance information for this reservation subBlock.
1443 &quot;instanceMaintenanceOngoingCount&quot;: 42, # Describes number of instances that have ongoing maintenance.
1444 &quot;instanceMaintenancePendingCount&quot;: 42, # Describes number of instances that have pending maintenance.
1445 &quot;maintenanceOngoingCount&quot;: 42, # Progress for ongoing maintenance for this group of VMs/hosts.
1446 # Describes number of hosts in the block that have ongoing maintenance.
1447 &quot;maintenancePendingCount&quot;: 42, # Progress for ongoing maintenance for this group of VMs/hosts.
1448 # Describes number of hosts in the block that have pending maintenance.
1449 &quot;schedulingType&quot;: &quot;A String&quot;, # The type of maintenance for the reservation.
1450 &quot;subblockInfraMaintenanceOngoingCount&quot;: 42, # Describes number of subblock Infrastructure that has ongoing maintenance.
1451 # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
1452 # contained in the Subblock that is necessary for a VM Family(e.g. NVLink
1453 # Domains). Not all VM Families will support this field.
1454 &quot;subblockInfraMaintenancePendingCount&quot;: 42, # Describes number of subblock Infrastructure that has pending maintenance.
1455 # Here, Subblock Infrastructure Maintenance pertains to upstream hardware
1456 # contained in the Subblock that is necessary for a VM Family (e.g. NVLink
1457 # Domains). Not all VM Families will support this field.
1458 &quot;upcomingGroupMaintenance&quot;: { # Upcoming Maintenance notification information. # Maintenance information on this group of VMs.
1459 &quot;canReschedule&quot;: True or False, # Indicates if the maintenance can be customer triggered.
1460 &quot;date&quot;: &quot;A String&quot;, # [Output Only] The date when the maintenance will take place.
1461 # This value is inRFC3339
1462 # text format.
1463 # DEPRECATED: Use window_start_time instead.
1464 &quot;latestWindowStartTime&quot;: &quot;A String&quot;, # The latest time for the planned maintenance window to start.
1465 # This timestamp value is in RFC3339 text format.
1466 &quot;maintenanceMethod&quot;: &quot;A String&quot;, # Output only. Maintenance method for the upcoming maintenance.
1467 &quot;maintenanceOnShutdown&quot;: True or False, # Indicates whether the UpcomingMaintenance will be triggered on VM shutdown.
1468 &quot;maintenanceReasons&quot;: [ # The reasons for the maintenance. Only valid for vms.
1469 &quot;A String&quot;,
1470 ],
1471 &quot;maintenanceStatus&quot;: &quot;A String&quot;,
1472 &quot;startTimeWindow&quot;: { # Represents a window of time using two timestamps: `earliest` and `latest`. # [Output Only] The start time window of the maintenance disruption.
1473 # DEPRECATED: Use window_start_time instead.
1474 # TimeWindow is a container for two strings that represent timestamps in
1475 # &quot;yyyy-MM-dd&#x27;T&#x27;HH:mm:ssZ&quot; text format.
1476 &quot;earliest&quot;: &quot;A String&quot;,
1477 &quot;latest&quot;: &quot;A String&quot;,
1478 },
1479 &quot;time&quot;: &quot;A String&quot;, # [Output Only] The time when the maintenance will take place.
1480 # This value is inRFC3339
1481 # text format.
1482 # DEPRECATED: Use window_start_time instead.
1483 &quot;type&quot;: &quot;A String&quot;, # Defines the type of maintenance.
1484 &quot;windowEndTime&quot;: &quot;A String&quot;, # The time by which the maintenance disruption will be completed.
1485 # This timestamp value is in RFC3339 text format.
1486 &quot;windowStartTime&quot;: &quot;A String&quot;, # The current start time of the maintenance window.
1487 # This timestamp value is in RFC3339 text format.
1488 },
1489 },
1490 &quot;retentionPriority&quot;: 42, # Customer specified retention priority for power shedding events.
1491 # Used to determine priority of the subBlock relative to others during
1492 # a power shedding event. Higher priorities are retained over lower ones.
1493 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined fully-qualified URL for this resource.
1494 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1495 &quot;status&quot;: &quot;A String&quot;, # Output only. [Output Only] Status of the reservation subBlock.
1496 &quot;subBlockHealthInfo&quot;: { # Health information for the reservation subBlock. # Output only. [Output Only] Health information for the reservation subBlock.
1497 &quot;degradedHostCount&quot;: 42, # The number of degraded hosts in the reservation subBlock.
1498 &quot;degradedInfraCount&quot;: 42, # The number of degraded infrastructure (e.g NV link domain) in the
1499 # reservation subblock.
1500 &quot;healthStatus&quot;: &quot;A String&quot;, # The health status of the reservation subBlock.
1501 &quot;healthyHostCount&quot;: 42, # The number of healthy hosts in the reservation subBlock.
1502 &quot;healthyInfraCount&quot;: 42, # The number of healthy infrastructure (e.g NV link domain) in the
1503 # reservation subblock.
1504 },
1505 &quot;zone&quot;: &quot;A String&quot;, # Output only. [Output Only] Zone in which the reservation subBlock resides.
1506 }
1507
1508 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
1509 that if you must retry your request, the server will know to ignore the
1510 request if it has already been completed.
1511 updateMask: string, The fields to be updated as part of this request.
1512 x__xgafv: string, V1 error format.
1513 Allowed values
1514 1 - v1 error format
1515 2 - v2 error format
1516
1517 Returns:
1518 An object of the form:
1519
1520 { # Represents an Operation resource.
1521 #
1522 # Google Compute Engine has three Operation resources:
1523 #
1524 # * [Global](/compute/docs/reference/rest/alpha/globalOperations)
1525 # * [Regional](/compute/docs/reference/rest/alpha/regionOperations)
1526 # * [Zonal](/compute/docs/reference/rest/alpha/zoneOperations)
1527 #
1528 # You can use an operation resource to manage asynchronous API requests.
1529 # For more information, readHandling
1530 # API responses.
1531 #
1532 # Operations can be global, regional or zonal.
1533 #
1534 # - For global operations, use the `globalOperations`
1535 # resource.
1536 # - For regional operations, use the
1537 # `regionOperations` resource.
1538 # - For zonal operations, use
1539 # the `zoneOperations` resource.
1540 #
1541 #
1542 #
1543 # For more information, read
1544 # Global, Regional, and Zonal Resources.
1545 #
1546 # Note that completed Operation resources have a limited
1547 # retention period.
1548 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
1549 # Not present otherwise.
1550 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
1551 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
1552 # set when the operation is created.
1553 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
1554 # text format.
1555 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
1556 # this field will be populated.
1557 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
1558 # operation.
1559 {
1560 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
1561 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
1562 # details. There is a set of defined message types to use for providing
1563 # details.The syntax depends on the error code. For example,
1564 # QuotaExceededInfo will have details when the error code is
1565 # QUOTA_EXCEEDED.
1566 {
1567 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
1568 #
1569 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
1570 # is not enabled:
1571 #
1572 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
1573 # &quot;domain&quot;: &quot;googleapis.com&quot;
1574 # &quot;metadata&quot;: {
1575 # &quot;resource&quot;: &quot;projects/123&quot;,
1576 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
1577 # }
1578 # }
1579 #
1580 # This response indicates that the pubsub.googleapis.com API is not enabled.
1581 #
1582 # Example of an error that is returned when attempting to create a Spanner
1583 # instance in a region that is out of stock:
1584 #
1585 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
1586 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
1587 # &quot;metadata&quot;: {
1588 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
1589 # }
1590 # }
1591 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
1592 # is typically the registered service name of the tool or product that
1593 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
1594 # generated by some common infrastructure, the error domain must be a
1595 # globally unique value that identifies the infrastructure. For Google API
1596 # infrastructure, the error domain is &quot;googleapis.com&quot;.
1597 &quot;metadatas&quot;: { # Additional structured details about this error.
1598 #
1599 # Keys must match a regular expression of `a-z+` but should
1600 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
1601 # length. When identifying the current value of an exceeded limit, the units
1602 # should be contained in the key, not the value. For example, rather than
1603 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
1604 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
1605 # instances that can be created in a single (batch) request.
1606 &quot;a_key&quot;: &quot;A String&quot;,
1607 },
1608 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
1609 # proximate cause of the error. Error reasons are unique within a particular
1610 # domain of errors. This should be at most 63 characters and match a
1611 # regular expression of `A-Z+[A-Z0-9]`, which represents
1612 # UPPER_SNAKE_CASE.
1613 },
1614 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
1615 #
1616 # For example, if a quota check failed with an error indicating the calling
1617 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
1618 # directly to the right place in the developer console to flip the bit.
1619 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
1620 { # Describes a URL link.
1621 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
1622 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
1623 },
1624 ],
1625 },
1626 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
1627 # which can be attached to an RPC error.
1628 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
1629 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
1630 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
1631 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
1632 },
1633 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
1634 &quot;dimensions&quot;: { # The map holding related quota dimensions.
1635 &quot;a_key&quot;: &quot;A String&quot;,
1636 },
1637 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
1638 # type or metric.
1639 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
1640 # or metric.
1641 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
1642 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
1643 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
1644 },
1645 },
1646 ],
1647 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
1648 # This property is optional.
1649 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
1650 },
1651 ],
1652 },
1653 &quot;getVersionOperationMetadata&quot;: {
1654 &quot;inlineSbomInfo&quot;: {
1655 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
1656 # appropriate identifiers.
1657 &quot;a_key&quot;: &quot;A String&quot;,
1658 },
1659 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
1660 # identifiers.
1661 &quot;a_key&quot;: &quot;A String&quot;,
1662 },
1663 },
1664 },
1665 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
1666 # message that was returned, such as `NOT FOUND`.
1667 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
1668 # status code that was returned. For example, a `404` means the
1669 # resource was not found.
1670 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
1671 # defined by the server.
1672 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
1673 # This value is inRFC3339
1674 # text format.
1675 &quot;instancesBulkInsertOperationMetadata&quot;: {
1676 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1677 # Example key: zones/us-central1-a
1678 &quot;a_key&quot;: {
1679 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1680 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1681 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1682 # error.
1683 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1684 # if the flow is rolling forward or rolling back.
1685 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1686 },
1687 },
1688 },
1689 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1690 # Operation resources.
1691 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1692 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1693 # group of operations results from a `bulkInsert` API request.
1694 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1695 # `update`, or `delete`, and so on.
1696 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1697 # There is no requirement that this be linear or support any granularity of
1698 # operations. This should not be used to guess when the operation will be
1699 # complete. This number should monotonically increase as the operation
1700 # progresses.
1701 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1702 # applicable when performing regional operations.
1703 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1704 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1705 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1706 # this field will contain information on all underlying zonal actions and
1707 # their state.
1708 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1709 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1710 # Example key: zones/us-central1-a
1711 &quot;a_key&quot;: {
1712 &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
1713 # populated.
1714 # different programming environments, including REST APIs and RPC APIs. It is
1715 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1716 # three pieces of data: error code, error message, and error details.
1717 #
1718 # You can find out more about this error model and how to work with it in the
1719 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1720 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1721 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1722 # message types for APIs to use.
1723 {
1724 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1725 },
1726 ],
1727 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1728 # user-facing error message should be localized and sent in the
1729 # google.rpc.Status.details field, or localized by the client.
1730 },
1731 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1732 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1733 },
1734 },
1735 },
1736 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1737 # This value is inRFC3339
1738 # text format.
1739 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1740 # following:
1741 # `PENDING`, `RUNNING`, or `DONE`.
1742 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1743 # operation.
1744 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1745 # of the target resource.
1746 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1747 # operations related to creating a snapshot, this points to the disk
1748 # that the snapshot was created from.
1749 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1750 # `[email protected]` or
1751 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1752 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1753 # operation, this field will be populated.
1754 {
1755 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1756 # Engine returns NO_RESULTS_ON_PAGE if there
1757 # are no results in the response.
1758 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1759 # value format. For example:
1760 #
1761 # &quot;data&quot;: [
1762 # {
1763 # &quot;key&quot;: &quot;scope&quot;,
1764 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1765 # }
1766 {
1767 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1768 # returned. For example, for warnings where there are no results in a list
1769 # request for a particular zone, this key might be scope and
1770 # the key value might be the zone name. Other examples might be a key
1771 # indicating a deprecated resource and a suggested replacement, or a
1772 # warning about invalid network settings (for example, if an instance
1773 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1774 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1775 },
1776 ],
1777 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1778 },
1779 ],
1780 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1781 # applicable when performing per-zone operations.
1782 }</pre>
1783 </div>
1784
1785 </body></html>