Debian Codegraph @

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