Debian Codegraph @

docs/dyn/compute_v1.networks.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.networks.html">networks</a></h1>
76 <h2>Instance Methods</h2>
77 <p class="toc_element">
78 <code><a href="#addPeering">addPeering(project, network, body=None, requestId=None, x__xgafv=None)</a></code></p>
79 <p class="firstline">Adds a peering to the specified network.</p>
80 <p class="toc_element">
81 <code><a href="#cancelRequestRemovePeering">cancelRequestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None)</a></code></p>
82 <p class="firstline">Cancel requests to remove a peering from the specified network. Applicable</p>
83 <p class="toc_element">
84 <code><a href="#close">close()</a></code></p>
85 <p class="firstline">Close httplib2 connections.</p>
86 <p class="toc_element">
87 <code><a href="#delete">delete(project, network, requestId=None, x__xgafv=None)</a></code></p>
88 <p class="firstline">Deletes the specified network.</p>
89 <p class="toc_element">
90 <code><a href="#get">get(project, network, x__xgafv=None)</a></code></p>
91 <p class="firstline">Returns the specified network.</p>
92 <p class="toc_element">
93 <code><a href="#getEffectiveFirewalls">getEffectiveFirewalls(project, network, x__xgafv=None)</a></code></p>
94 <p class="firstline">Returns the effective firewalls on a given network.</p>
95 <p class="toc_element">
96 <code><a href="#insert">insert(project, body=None, requestId=None, x__xgafv=None)</a></code></p>
97 <p class="firstline">Creates a network in the specified project using the data included</p>
98 <p class="toc_element">
99 <code><a href="#list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
100 <p class="firstline">Retrieves the list of networks available to the specified project.</p>
101 <p class="toc_element">
102 <code><a href="#listPeeringRoutes">listPeeringRoutes(project, network, direction=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peeringName=None, region=None, returnPartialSuccess=None, x__xgafv=None)</a></code></p>
103 <p class="firstline">Lists the peering routes exchanged over peering connection.</p>
104 <p class="toc_element">
105 <code><a href="#listPeeringRoutes_next">listPeeringRoutes_next()</a></code></p>
106 <p class="firstline">Retrieves the next page of results.</p>
107 <p class="toc_element">
108 <code><a href="#list_next">list_next()</a></code></p>
109 <p class="firstline">Retrieves the next page of results.</p>
110 <p class="toc_element">
111 <code><a href="#patch">patch(project, network, body=None, requestId=None, x__xgafv=None)</a></code></p>
112 <p class="firstline">Patches the specified network with the data included in the request.</p>
113 <p class="toc_element">
114 <code><a href="#removePeering">removePeering(project, network, body=None, requestId=None, x__xgafv=None)</a></code></p>
115 <p class="firstline">Removes a peering from the specified network.</p>
116 <p class="toc_element">
117 <code><a href="#requestRemovePeering">requestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None)</a></code></p>
118 <p class="firstline">Requests to remove a peering from the specified network. Applicable only</p>
119 <p class="toc_element">
120 <code><a href="#switchToCustomMode">switchToCustomMode(project, network, requestId=None, x__xgafv=None)</a></code></p>
121 <p class="firstline">Switches the network mode from auto subnet mode to custom subnet mode.</p>
122 <p class="toc_element">
123 <code><a href="#updatePeering">updatePeering(project, network, body=None, requestId=None, x__xgafv=None)</a></code></p>
124 <p class="firstline">Updates the specified network peering with the data included in the</p>
125 <h3>Method Details</h3>
126 <div class="method">
127 <code class="details" id="addPeering">addPeering(project, network, body=None, requestId=None, x__xgafv=None)</code>
128 <pre>Adds a peering to the specified network.
129
130 Args:
131 project: string, Project ID for this request. (required)
132 network: string, Name of the network resource to add peering to. (required)
133 body: object, The request body.
134 The object takes the form of:
135
136 {
137 &quot;autoCreateRoutes&quot;: True or False, # This field will be deprecated soon. Useexchange_subnet_routes in network_peering
138 # instead.
139 # Indicates whether full mesh connectivity is created and managed
140 # automatically between peered networks. Currently this field should always
141 # be true since Google Compute Engine will automatically create and manage
142 # subnetwork routes between two networks when peering state isACTIVE.
143 &quot;name&quot;: &quot;A String&quot;, # Name of the peering, which should conform to RFC1035.
144 &quot;networkPeering&quot;: { # A network peering attached to a network resource. The message includes the # Network peering parameters.
145 # In order to specify route policies for peering using import and export
146 # custom routes, you must specify all peering related parameters
147 # (name, peer network,exchange_subnet_routes) in the network_peering
148 # field.
149 # The corresponding fields in NetworksAddPeeringRequest will be
150 # deprecated soon.
151 # peering name, peer network, peering state, and a flag indicating whether
152 # Google Compute Engine should automatically create routes for the peering.
153 &quot;autoCreateRoutes&quot;: True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
154 # Indicates whether full mesh connectivity is created and managed
155 # automatically between peered networks. Currently this field should always
156 # be true since Google Compute Engine will automatically create and manage
157 # subnetwork routes between two networks when peering state isACTIVE.
158 &quot;connectionStatus&quot;: { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
159 # as a whole.
160 # local peering. This field provides information about the effective settings
161 # for the connection as a whole, including pending delete/update requests for
162 # CONSENSUS peerings.
163 &quot;consensusState&quot;: { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
164 # and delete for a consensus peering connection.
165 # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
166 # strategy to CONSENSUS.
167 &quot;deleteStatus&quot;: &quot;A String&quot;, # The status of the delete request.
168 &quot;updateStatus&quot;: &quot;A String&quot;, # The status of the update request.
169 },
170 &quot;trafficConfiguration&quot;: { # The active connectivity settings for the peering connection based on the
171 # settings of the network peerings.
172 &quot;exportCustomRoutesToPeer&quot;: True or False, # Whether custom routes are being exported to the peer network.
173 &quot;exportSubnetRoutesWithPublicIpToPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being exported to the
174 # peer network.
175 &quot;importCustomRoutesFromPeer&quot;: True or False, # Whether custom routes are being imported from the peer network.
176 &quot;importSubnetRoutesWithPublicIpFromPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being imported
177 # from the peer network.
178 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are being imported or
179 # exported between peer networks.
180 },
181 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the update/delete semantics for this
182 # peering connection.
183 },
184 &quot;exchangeSubnetRoutes&quot;: True or False, # Indicates whether full mesh connectivity is created and managed
185 # automatically between peered networks. Currently this field should always
186 # be true since Google Compute Engine will automatically create and manage
187 # subnetwork routes between two networks when peering state isACTIVE.
188 &quot;exportCustomRoutes&quot;: True or False, # Whether to export the custom routes to peer network. The default value is
189 # false.
190 &quot;exportSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are exported. The default value
191 # is true, all subnet routes are exported.IPv4
192 # special-use ranges are always
193 # exported to peers and are not controlled by this field.
194 &quot;importCustomRoutes&quot;: True or False, # Whether to import the custom routes from peer network. The default value is
195 # false.
196 &quot;importSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are imported. The default value
197 # is false.IPv4
198 # special-use ranges are always
199 # imported from peers and are not controlled by this field.
200 &quot;name&quot;: &quot;A String&quot;, # Name of this peering. Provided by the client when the peering is created.
201 # The name must comply withRFC1035.
202 # Specifically, the name must be 1-63 characters long and match regular
203 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
204 # lowercase letter, and all the following characters must be a dash,
205 # lowercase letter, or digit, except the last character, which cannot be a
206 # dash.
207 &quot;network&quot;: &quot;A String&quot;, # The URL of the peer network. It can be either full URL or partial URL. The
208 # peer network may belong to a different project. If the partial URL does not
209 # contain project, it is assumed that the peer network is in the same project
210 # as the current network.
211 &quot;peerMtu&quot;: 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
212 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are allowed to be imported or
213 # exported between peer networks. The default value is IPV4_ONLY.
214 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State for the peering.
215 &quot;stateDetails&quot;: &quot;A String&quot;, # Output only. [Output Only] Details about the current state of the peering.
216 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the semantics for updates and deletes to the
217 # peering connection configuration.
218 },
219 &quot;peerNetwork&quot;: &quot;A String&quot;, # URL of the peer network. It can be either full URL or partial URL. The
220 # peer network may belong to a different project. If the partial URL does not
221 # contain project, it is assumed that the peer network is in the same project
222 # as the current network.
223 }
224
225 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
226 that if you must retry your request, the server will know to ignore the
227 request if it has already been completed.
228
229 For example, consider a situation where you make an initial request and
230 the request times out. If you make the request again with the same
231 request ID, the server can check if original operation with the same
232 request ID was received, and if so, will ignore the second request. This
233 prevents clients from accidentally creating duplicate commitments.
234
235 The request ID must be
236 a valid UUID with the exception that zero UUID is not supported
237 (00000000-0000-0000-0000-000000000000).
238 x__xgafv: string, V1 error format.
239 Allowed values
240 1 - v1 error format
241 2 - v2 error format
242
243 Returns:
244 An object of the form:
245
246 { # Represents an Operation resource.
247 #
248 # Google Compute Engine has three Operation resources:
249 #
250 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
251 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
252 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
253 #
254 # You can use an operation resource to manage asynchronous API requests.
255 # For more information, readHandling
256 # API responses.
257 #
258 # Operations can be global, regional or zonal.
259 #
260 # - For global operations, use the `globalOperations`
261 # resource.
262 # - For regional operations, use the
263 # `regionOperations` resource.
264 # - For zonal operations, use
265 # the `zoneOperations` resource.
266 #
267 #
268 #
269 # For more information, read
270 # Global, Regional, and Zonal Resources.
271 #
272 # Note that completed Operation resources have a limited
273 # retention period.
274 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
275 # Not present otherwise.
276 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
277 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
278 # set when the operation is created.
279 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
280 # text format.
281 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
282 # this field will be populated.
283 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
284 # operation.
285 {
286 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
287 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
288 # details. There is a set of defined message types to use for providing
289 # details.The syntax depends on the error code. For example,
290 # QuotaExceededInfo will have details when the error code is
291 # QUOTA_EXCEEDED.
292 {
293 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
294 #
295 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
296 # is not enabled:
297 #
298 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
299 # &quot;domain&quot;: &quot;googleapis.com&quot;
300 # &quot;metadata&quot;: {
301 # &quot;resource&quot;: &quot;projects/123&quot;,
302 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
303 # }
304 # }
305 #
306 # This response indicates that the pubsub.googleapis.com API is not enabled.
307 #
308 # Example of an error that is returned when attempting to create a Spanner
309 # instance in a region that is out of stock:
310 #
311 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
312 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
313 # &quot;metadata&quot;: {
314 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
315 # }
316 # }
317 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
318 # is typically the registered service name of the tool or product that
319 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
320 # generated by some common infrastructure, the error domain must be a
321 # globally unique value that identifies the infrastructure. For Google API
322 # infrastructure, the error domain is &quot;googleapis.com&quot;.
323 &quot;metadatas&quot;: { # Additional structured details about this error.
324 #
325 # Keys must match a regular expression of `a-z+` but should
326 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
327 # length. When identifying the current value of an exceeded limit, the units
328 # should be contained in the key, not the value. For example, rather than
329 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
330 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
331 # instances that can be created in a single (batch) request.
332 &quot;a_key&quot;: &quot;A String&quot;,
333 },
334 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
335 # proximate cause of the error. Error reasons are unique within a particular
336 # domain of errors. This should be at most 63 characters and match a
337 # regular expression of `A-Z+[A-Z0-9]`, which represents
338 # UPPER_SNAKE_CASE.
339 },
340 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
341 #
342 # For example, if a quota check failed with an error indicating the calling
343 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
344 # directly to the right place in the developer console to flip the bit.
345 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
346 { # Describes a URL link.
347 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
348 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
349 },
350 ],
351 },
352 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
353 # which can be attached to an RPC error.
354 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
355 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
356 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
357 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
358 },
359 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
360 &quot;dimensions&quot;: { # The map holding related quota dimensions.
361 &quot;a_key&quot;: &quot;A String&quot;,
362 },
363 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
364 # type or metric.
365 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
366 # or metric.
367 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
368 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
369 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
370 },
371 },
372 ],
373 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
374 # This property is optional.
375 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
376 },
377 ],
378 },
379 &quot;getVersionOperationMetadata&quot;: {
380 &quot;inlineSbomInfo&quot;: {
381 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
382 # appropriate identifiers.
383 &quot;a_key&quot;: &quot;A String&quot;,
384 },
385 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
386 # identifiers.
387 &quot;a_key&quot;: &quot;A String&quot;,
388 },
389 },
390 },
391 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
392 # message that was returned, such as `NOT FOUND`.
393 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
394 # status code that was returned. For example, a `404` means the
395 # resource was not found.
396 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
397 # defined by the server.
398 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
399 # This value is inRFC3339
400 # text format.
401 &quot;instancesBulkInsertOperationMetadata&quot;: {
402 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
403 # Example key: zones/us-central1-a
404 &quot;a_key&quot;: {
405 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
406 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
407 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
408 # error.
409 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
410 # if the flow is rolling forward or rolling back.
411 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
412 },
413 },
414 },
415 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
416 # Operation resources.
417 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
418 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
419 # group of operations results from a `bulkInsert` API request.
420 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
421 # `update`, or `delete`, and so on.
422 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
423 # There is no requirement that this be linear or support any granularity of
424 # operations. This should not be used to guess when the operation will be
425 # complete. This number should monotonically increase as the operation
426 # progresses.
427 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
428 # applicable when performing regional operations.
429 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
430 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
431 # this field will contain information on all underlying zonal actions and
432 # their state.
433 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
434 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
435 # Example key: zones/us-central1-a
436 &quot;a_key&quot;: {
437 &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
438 # populated.
439 # different programming environments, including REST APIs and RPC APIs. It is
440 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
441 # three pieces of data: error code, error message, and error details.
442 #
443 # You can find out more about this error model and how to work with it in the
444 # [API Design Guide](https://cloud.google.com/apis/design/errors).
445 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
446 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
447 # message types for APIs to use.
448 {
449 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
450 },
451 ],
452 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
453 # user-facing error message should be localized and sent in the
454 # google.rpc.Status.details field, or localized by the client.
455 },
456 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
457 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
458 },
459 },
460 },
461 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
462 # This value is inRFC3339
463 # text format.
464 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
465 # following:
466 # `PENDING`, `RUNNING`, or `DONE`.
467 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
468 # operation.
469 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
470 # of the target resource.
471 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
472 # operations related to creating a snapshot, this points to the disk
473 # that the snapshot was created from.
474 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
475 # `[email protected]` or
476 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
477 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
478 # operation, this field will be populated.
479 {
480 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
481 # Engine returns NO_RESULTS_ON_PAGE if there
482 # are no results in the response.
483 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
484 # value format. For example:
485 #
486 # &quot;data&quot;: [
487 # {
488 # &quot;key&quot;: &quot;scope&quot;,
489 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
490 # }
491 {
492 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
493 # returned. For example, for warnings where there are no results in a list
494 # request for a particular zone, this key might be scope and
495 # the key value might be the zone name. Other examples might be a key
496 # indicating a deprecated resource and a suggested replacement, or a
497 # warning about invalid network settings (for example, if an instance
498 # attempts to perform IP forwarding but is not enabled for IP forwarding).
499 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
500 },
501 ],
502 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
503 },
504 ],
505 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
506 # applicable when performing per-zone operations.
507 }</pre>
508 </div>
509
510 <div class="method">
511 <code class="details" id="cancelRequestRemovePeering">cancelRequestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None)</code>
512 <pre>Cancel requests to remove a peering from the specified network. Applicable
513 only for PeeringConnection with update_strategy=CONSENSUS. Cancels a
514 request to remove a peering from the specified network.
515
516 Args:
517 project: string, Project ID for this request. (required)
518 network: string, Name of the network resource to remove peering from. (required)
519 body: object, The request body.
520 The object takes the form of:
521
522 {
523 &quot;name&quot;: &quot;A String&quot;, # Name of the peering, which should conform to RFC1035.
524 }
525
526 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
527 that if you must retry your request, the server will know to ignore the
528 request if it has already been completed.
529
530 For example, consider a situation where you make an initial request and
531 the request times out. If you make the request again with the same
532 request ID, the server can check if original operation with the same
533 request ID was received, and if so, will ignore the second request. This
534 prevents clients from accidentally creating duplicate commitments.
535
536 The request ID must be
537 a valid UUID with the exception that zero UUID is not supported
538 (00000000-0000-0000-0000-000000000000).
539 x__xgafv: string, V1 error format.
540 Allowed values
541 1 - v1 error format
542 2 - v2 error format
543
544 Returns:
545 An object of the form:
546
547 { # Represents an Operation resource.
548 #
549 # Google Compute Engine has three Operation resources:
550 #
551 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
552 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
553 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
554 #
555 # You can use an operation resource to manage asynchronous API requests.
556 # For more information, readHandling
557 # API responses.
558 #
559 # Operations can be global, regional or zonal.
560 #
561 # - For global operations, use the `globalOperations`
562 # resource.
563 # - For regional operations, use the
564 # `regionOperations` resource.
565 # - For zonal operations, use
566 # the `zoneOperations` resource.
567 #
568 #
569 #
570 # For more information, read
571 # Global, Regional, and Zonal Resources.
572 #
573 # Note that completed Operation resources have a limited
574 # retention period.
575 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
576 # Not present otherwise.
577 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
578 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
579 # set when the operation is created.
580 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
581 # text format.
582 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
583 # this field will be populated.
584 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
585 # operation.
586 {
587 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
588 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
589 # details. There is a set of defined message types to use for providing
590 # details.The syntax depends on the error code. For example,
591 # QuotaExceededInfo will have details when the error code is
592 # QUOTA_EXCEEDED.
593 {
594 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
595 #
596 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
597 # is not enabled:
598 #
599 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
600 # &quot;domain&quot;: &quot;googleapis.com&quot;
601 # &quot;metadata&quot;: {
602 # &quot;resource&quot;: &quot;projects/123&quot;,
603 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
604 # }
605 # }
606 #
607 # This response indicates that the pubsub.googleapis.com API is not enabled.
608 #
609 # Example of an error that is returned when attempting to create a Spanner
610 # instance in a region that is out of stock:
611 #
612 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
613 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
614 # &quot;metadata&quot;: {
615 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
616 # }
617 # }
618 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
619 # is typically the registered service name of the tool or product that
620 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
621 # generated by some common infrastructure, the error domain must be a
622 # globally unique value that identifies the infrastructure. For Google API
623 # infrastructure, the error domain is &quot;googleapis.com&quot;.
624 &quot;metadatas&quot;: { # Additional structured details about this error.
625 #
626 # Keys must match a regular expression of `a-z+` but should
627 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
628 # length. When identifying the current value of an exceeded limit, the units
629 # should be contained in the key, not the value. For example, rather than
630 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
631 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
632 # instances that can be created in a single (batch) request.
633 &quot;a_key&quot;: &quot;A String&quot;,
634 },
635 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
636 # proximate cause of the error. Error reasons are unique within a particular
637 # domain of errors. This should be at most 63 characters and match a
638 # regular expression of `A-Z+[A-Z0-9]`, which represents
639 # UPPER_SNAKE_CASE.
640 },
641 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
642 #
643 # For example, if a quota check failed with an error indicating the calling
644 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
645 # directly to the right place in the developer console to flip the bit.
646 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
647 { # Describes a URL link.
648 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
649 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
650 },
651 ],
652 },
653 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
654 # which can be attached to an RPC error.
655 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
656 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
657 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
658 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
659 },
660 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
661 &quot;dimensions&quot;: { # The map holding related quota dimensions.
662 &quot;a_key&quot;: &quot;A String&quot;,
663 },
664 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
665 # type or metric.
666 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
667 # or metric.
668 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
669 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
670 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
671 },
672 },
673 ],
674 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
675 # This property is optional.
676 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
677 },
678 ],
679 },
680 &quot;getVersionOperationMetadata&quot;: {
681 &quot;inlineSbomInfo&quot;: {
682 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
683 # appropriate identifiers.
684 &quot;a_key&quot;: &quot;A String&quot;,
685 },
686 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
687 # identifiers.
688 &quot;a_key&quot;: &quot;A String&quot;,
689 },
690 },
691 },
692 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
693 # message that was returned, such as `NOT FOUND`.
694 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
695 # status code that was returned. For example, a `404` means the
696 # resource was not found.
697 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
698 # defined by the server.
699 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
700 # This value is inRFC3339
701 # text format.
702 &quot;instancesBulkInsertOperationMetadata&quot;: {
703 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
704 # Example key: zones/us-central1-a
705 &quot;a_key&quot;: {
706 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
707 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
708 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
709 # error.
710 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
711 # if the flow is rolling forward or rolling back.
712 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
713 },
714 },
715 },
716 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
717 # Operation resources.
718 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
719 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
720 # group of operations results from a `bulkInsert` API request.
721 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
722 # `update`, or `delete`, and so on.
723 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
724 # There is no requirement that this be linear or support any granularity of
725 # operations. This should not be used to guess when the operation will be
726 # complete. This number should monotonically increase as the operation
727 # progresses.
728 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
729 # applicable when performing regional operations.
730 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
731 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
732 # this field will contain information on all underlying zonal actions and
733 # their state.
734 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
735 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
736 # Example key: zones/us-central1-a
737 &quot;a_key&quot;: {
738 &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
739 # populated.
740 # different programming environments, including REST APIs and RPC APIs. It is
741 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
742 # three pieces of data: error code, error message, and error details.
743 #
744 # You can find out more about this error model and how to work with it in the
745 # [API Design Guide](https://cloud.google.com/apis/design/errors).
746 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
747 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
748 # message types for APIs to use.
749 {
750 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
751 },
752 ],
753 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
754 # user-facing error message should be localized and sent in the
755 # google.rpc.Status.details field, or localized by the client.
756 },
757 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
758 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
759 },
760 },
761 },
762 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
763 # This value is inRFC3339
764 # text format.
765 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
766 # following:
767 # `PENDING`, `RUNNING`, or `DONE`.
768 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
769 # operation.
770 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
771 # of the target resource.
772 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
773 # operations related to creating a snapshot, this points to the disk
774 # that the snapshot was created from.
775 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
776 # `[email protected]` or
777 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
778 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
779 # operation, this field will be populated.
780 {
781 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
782 # Engine returns NO_RESULTS_ON_PAGE if there
783 # are no results in the response.
784 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
785 # value format. For example:
786 #
787 # &quot;data&quot;: [
788 # {
789 # &quot;key&quot;: &quot;scope&quot;,
790 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
791 # }
792 {
793 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
794 # returned. For example, for warnings where there are no results in a list
795 # request for a particular zone, this key might be scope and
796 # the key value might be the zone name. Other examples might be a key
797 # indicating a deprecated resource and a suggested replacement, or a
798 # warning about invalid network settings (for example, if an instance
799 # attempts to perform IP forwarding but is not enabled for IP forwarding).
800 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
801 },
802 ],
803 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
804 },
805 ],
806 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
807 # applicable when performing per-zone operations.
808 }</pre>
809 </div>
810
811 <div class="method">
812 <code class="details" id="close">close()</code>
813 <pre>Close httplib2 connections.</pre>
814 </div>
815
816 <div class="method">
817 <code class="details" id="delete">delete(project, network, requestId=None, x__xgafv=None)</code>
818 <pre>Deletes the specified network.
819
820 Args:
821 project: string, Project ID for this request. (required)
822 network: string, Name of the network to delete. (required)
823 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
824 that if you must retry your request, the server will know to ignore the
825 request if it has already been completed.
826
827 For example, consider a situation where you make an initial request and
828 the request times out. If you make the request again with the same
829 request ID, the server can check if original operation with the same
830 request ID was received, and if so, will ignore the second request. This
831 prevents clients from accidentally creating duplicate commitments.
832
833 The request ID must be
834 a valid UUID with the exception that zero UUID is not supported
835 (00000000-0000-0000-0000-000000000000).
836 x__xgafv: string, V1 error format.
837 Allowed values
838 1 - v1 error format
839 2 - v2 error format
840
841 Returns:
842 An object of the form:
843
844 { # Represents an Operation resource.
845 #
846 # Google Compute Engine has three Operation resources:
847 #
848 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
849 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
850 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
851 #
852 # You can use an operation resource to manage asynchronous API requests.
853 # For more information, readHandling
854 # API responses.
855 #
856 # Operations can be global, regional or zonal.
857 #
858 # - For global operations, use the `globalOperations`
859 # resource.
860 # - For regional operations, use the
861 # `regionOperations` resource.
862 # - For zonal operations, use
863 # the `zoneOperations` resource.
864 #
865 #
866 #
867 # For more information, read
868 # Global, Regional, and Zonal Resources.
869 #
870 # Note that completed Operation resources have a limited
871 # retention period.
872 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
873 # Not present otherwise.
874 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
875 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
876 # set when the operation is created.
877 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
878 # text format.
879 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
880 # this field will be populated.
881 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
882 # operation.
883 {
884 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
885 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
886 # details. There is a set of defined message types to use for providing
887 # details.The syntax depends on the error code. For example,
888 # QuotaExceededInfo will have details when the error code is
889 # QUOTA_EXCEEDED.
890 {
891 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
892 #
893 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
894 # is not enabled:
895 #
896 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
897 # &quot;domain&quot;: &quot;googleapis.com&quot;
898 # &quot;metadata&quot;: {
899 # &quot;resource&quot;: &quot;projects/123&quot;,
900 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
901 # }
902 # }
903 #
904 # This response indicates that the pubsub.googleapis.com API is not enabled.
905 #
906 # Example of an error that is returned when attempting to create a Spanner
907 # instance in a region that is out of stock:
908 #
909 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
910 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
911 # &quot;metadata&quot;: {
912 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
913 # }
914 # }
915 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
916 # is typically the registered service name of the tool or product that
917 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
918 # generated by some common infrastructure, the error domain must be a
919 # globally unique value that identifies the infrastructure. For Google API
920 # infrastructure, the error domain is &quot;googleapis.com&quot;.
921 &quot;metadatas&quot;: { # Additional structured details about this error.
922 #
923 # Keys must match a regular expression of `a-z+` but should
924 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
925 # length. When identifying the current value of an exceeded limit, the units
926 # should be contained in the key, not the value. For example, rather than
927 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
928 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
929 # instances that can be created in a single (batch) request.
930 &quot;a_key&quot;: &quot;A String&quot;,
931 },
932 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
933 # proximate cause of the error. Error reasons are unique within a particular
934 # domain of errors. This should be at most 63 characters and match a
935 # regular expression of `A-Z+[A-Z0-9]`, which represents
936 # UPPER_SNAKE_CASE.
937 },
938 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
939 #
940 # For example, if a quota check failed with an error indicating the calling
941 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
942 # directly to the right place in the developer console to flip the bit.
943 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
944 { # Describes a URL link.
945 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
946 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
947 },
948 ],
949 },
950 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
951 # which can be attached to an RPC error.
952 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
953 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
954 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
955 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
956 },
957 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
958 &quot;dimensions&quot;: { # The map holding related quota dimensions.
959 &quot;a_key&quot;: &quot;A String&quot;,
960 },
961 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
962 # type or metric.
963 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
964 # or metric.
965 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
966 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
967 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
968 },
969 },
970 ],
971 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
972 # This property is optional.
973 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
974 },
975 ],
976 },
977 &quot;getVersionOperationMetadata&quot;: {
978 &quot;inlineSbomInfo&quot;: {
979 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
980 # appropriate identifiers.
981 &quot;a_key&quot;: &quot;A String&quot;,
982 },
983 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
984 # identifiers.
985 &quot;a_key&quot;: &quot;A String&quot;,
986 },
987 },
988 },
989 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
990 # message that was returned, such as `NOT FOUND`.
991 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
992 # status code that was returned. For example, a `404` means the
993 # resource was not found.
994 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
995 # defined by the server.
996 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
997 # This value is inRFC3339
998 # text format.
999 &quot;instancesBulkInsertOperationMetadata&quot;: {
1000 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
1001 # Example key: zones/us-central1-a
1002 &quot;a_key&quot;: {
1003 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
1004 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
1005 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
1006 # error.
1007 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
1008 # if the flow is rolling forward or rolling back.
1009 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
1010 },
1011 },
1012 },
1013 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
1014 # Operation resources.
1015 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
1016 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
1017 # group of operations results from a `bulkInsert` API request.
1018 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
1019 # `update`, or `delete`, and so on.
1020 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
1021 # There is no requirement that this be linear or support any granularity of
1022 # operations. This should not be used to guess when the operation will be
1023 # complete. This number should monotonically increase as the operation
1024 # progresses.
1025 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
1026 # applicable when performing regional operations.
1027 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1028 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
1029 # this field will contain information on all underlying zonal actions and
1030 # their state.
1031 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
1032 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
1033 # Example key: zones/us-central1-a
1034 &quot;a_key&quot;: {
1035 &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
1036 # populated.
1037 # different programming environments, including REST APIs and RPC APIs. It is
1038 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
1039 # three pieces of data: error code, error message, and error details.
1040 #
1041 # You can find out more about this error model and how to work with it in the
1042 # [API Design Guide](https://cloud.google.com/apis/design/errors).
1043 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
1044 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
1045 # message types for APIs to use.
1046 {
1047 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
1048 },
1049 ],
1050 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
1051 # user-facing error message should be localized and sent in the
1052 # google.rpc.Status.details field, or localized by the client.
1053 },
1054 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
1055 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
1056 },
1057 },
1058 },
1059 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
1060 # This value is inRFC3339
1061 # text format.
1062 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
1063 # following:
1064 # `PENDING`, `RUNNING`, or `DONE`.
1065 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
1066 # operation.
1067 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
1068 # of the target resource.
1069 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
1070 # operations related to creating a snapshot, this points to the disk
1071 # that the snapshot was created from.
1072 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
1073 # `[email protected]` or
1074 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
1075 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
1076 # operation, this field will be populated.
1077 {
1078 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
1079 # Engine returns NO_RESULTS_ON_PAGE if there
1080 # are no results in the response.
1081 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
1082 # value format. For example:
1083 #
1084 # &quot;data&quot;: [
1085 # {
1086 # &quot;key&quot;: &quot;scope&quot;,
1087 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
1088 # }
1089 {
1090 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
1091 # returned. For example, for warnings where there are no results in a list
1092 # request for a particular zone, this key might be scope and
1093 # the key value might be the zone name. Other examples might be a key
1094 # indicating a deprecated resource and a suggested replacement, or a
1095 # warning about invalid network settings (for example, if an instance
1096 # attempts to perform IP forwarding but is not enabled for IP forwarding).
1097 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
1098 },
1099 ],
1100 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
1101 },
1102 ],
1103 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
1104 # applicable when performing per-zone operations.
1105 }</pre>
1106 </div>
1107
1108 <div class="method">
1109 <code class="details" id="get">get(project, network, x__xgafv=None)</code>
1110 <pre>Returns the specified network.
1111
1112 Args:
1113 project: string, Project ID for this request. (required)
1114 network: string, Name of the network to return. (required)
1115 x__xgafv: string, V1 error format.
1116 Allowed values
1117 1 - v1 error format
1118 2 - v2 error format
1119
1120 Returns:
1121 An object of the form:
1122
1123 { # Represents a VPC Network resource.
1124 #
1125 # Networks connect resources to each other and to the internet. For more
1126 # information, readVirtual Private Cloud (VPC) Network.
1127 &quot;IPv4Range&quot;: &quot;A String&quot;, # Deprecated in favor of subnet mode networks.
1128 # The range of internal addresses that are legal on this network. This
1129 # range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is
1130 # created.
1131 &quot;autoCreateSubnetworks&quot;: True or False, # Must be set to create a VPC network. If not set, a legacy network is
1132 # created.
1133 #
1134 # When set to true, the VPC network is created in auto mode.
1135 # When set to false, the VPC network is created in custom mode.
1136 #
1137 # An auto mode VPC network starts with one subnet per region. Each subnet
1138 # has a predetermined range as described inAuto mode VPC network IP ranges.
1139 #
1140 # For custom mode VPC networks, you can add subnets using the subnetworksinsert
1141 # method.
1142 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
1143 # text format.
1144 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this field when you
1145 # create the resource.
1146 &quot;enableUlaInternalIpv6&quot;: True or False, # Enable ULA internal ipv6 on this network. Enabling this feature will assign
1147 # a /48 from google defined ULA prefix fd20::/20.
1148 # .
1149 &quot;firewallPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the firewall policy the network is associated with.
1150 &quot;gatewayIPv4&quot;: &quot;A String&quot;, # [Output Only] The gateway address for default routing out of the network,
1151 # selected by Google Cloud.
1152 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
1153 # defined by the server.
1154 &quot;internalIpv6Range&quot;: &quot;A String&quot;, # When enabling ula internal ipv6, caller optionally can specify the /48
1155 # range they want from the google defined ULA prefix fd20::/20. The input
1156 # must be a valid /48 ULA IPv6 address and must be within the fd20::/20.
1157 # Operation will fail if the speficied /48 is already in used by another
1158 # resource. If the field is not speficied, then a /48 range will be randomly
1159 # allocated from fd20::/20 and returned via this field.
1160 # .
1161 &quot;kind&quot;: &quot;compute#network&quot;, # Output only. [Output Only] Type of the resource. Always compute#network for
1162 # networks.
1163 &quot;mtu&quot;: 42, # Maximum Transmission Unit in bytes.
1164 # The minimum value for this field is 1300 and the maximum value is 8896.
1165 # The suggested value is 1500, which is the default MTU used on the
1166 # Internet, or 8896 if you want to use Jumbo frames. If unspecified, the
1167 # value defaults to 1460.
1168 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1169 # The name must be 1-63 characters long, and comply withRFC1035.
1170 # Specifically, the name must be 1-63 characters long and match the regular
1171 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
1172 # lowercase letter, and all following characters (except for the last
1173 # character) must be a dash, lowercase letter, or digit. The last character
1174 # must be a lowercase letter or digit.
1175 &quot;networkFirewallPolicyEnforcementOrder&quot;: &quot;A String&quot;, # The network firewall policy enforcement order. Can be either
1176 # AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to
1177 # AFTER_CLASSIC_FIREWALL if the field is not specified.
1178 &quot;networkProfile&quot;: &quot;A String&quot;, # A full or partial URL of the network profile to apply to this network.
1179 # This field can be set only at resource creation time. For example, the
1180 # following are valid URLs:
1181 #
1182 # - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}
1183 # - projects/{project_id}/global/networkProfiles/{network_profile_name}
1184 &quot;params&quot;: { # Additional network parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted
1185 # as part of resource payload.
1186 &quot;resourceManagerTags&quot;: { # Tag keys/values directly bound to this resource.
1187 # Tag keys and values have the same definition as resource
1188 # manager tags. The field is allowed for INSERT
1189 # only. The keys/values to set on the resource should be specified in
1190 # either ID { : } or Namespaced format
1191 # { : }.
1192 # For example the following are valid inputs:
1193 # * {&quot;tagKeys/333&quot; : &quot;tagValues/444&quot;, &quot;tagKeys/123&quot; : &quot;tagValues/456&quot;}
1194 # * {&quot;123/environment&quot; : &quot;production&quot;, &quot;345/abc&quot; : &quot;xyz&quot;}
1195 # Note:
1196 # * Invalid combinations of ID &amp; namespaced format is not supported. For
1197 # instance: {&quot;123/environment&quot; : &quot;tagValues/444&quot;} is invalid.
1198 &quot;a_key&quot;: &quot;A String&quot;,
1199 },
1200 },
1201 &quot;peerings&quot;: [ # Output only. [Output Only] A list of network peerings for the resource.
1202 { # A network peering attached to a network resource. The message includes the
1203 # peering name, peer network, peering state, and a flag indicating whether
1204 # Google Compute Engine should automatically create routes for the peering.
1205 &quot;autoCreateRoutes&quot;: True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
1206 # Indicates whether full mesh connectivity is created and managed
1207 # automatically between peered networks. Currently this field should always
1208 # be true since Google Compute Engine will automatically create and manage
1209 # subnetwork routes between two networks when peering state isACTIVE.
1210 &quot;connectionStatus&quot;: { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
1211 # as a whole.
1212 # local peering. This field provides information about the effective settings
1213 # for the connection as a whole, including pending delete/update requests for
1214 # CONSENSUS peerings.
1215 &quot;consensusState&quot;: { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
1216 # and delete for a consensus peering connection.
1217 # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
1218 # strategy to CONSENSUS.
1219 &quot;deleteStatus&quot;: &quot;A String&quot;, # The status of the delete request.
1220 &quot;updateStatus&quot;: &quot;A String&quot;, # The status of the update request.
1221 },
1222 &quot;trafficConfiguration&quot;: { # The active connectivity settings for the peering connection based on the
1223 # settings of the network peerings.
1224 &quot;exportCustomRoutesToPeer&quot;: True or False, # Whether custom routes are being exported to the peer network.
1225 &quot;exportSubnetRoutesWithPublicIpToPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being exported to the
1226 # peer network.
1227 &quot;importCustomRoutesFromPeer&quot;: True or False, # Whether custom routes are being imported from the peer network.
1228 &quot;importSubnetRoutesWithPublicIpFromPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being imported
1229 # from the peer network.
1230 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are being imported or
1231 # exported between peer networks.
1232 },
1233 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the update/delete semantics for this
1234 # peering connection.
1235 },
1236 &quot;exchangeSubnetRoutes&quot;: True or False, # Indicates whether full mesh connectivity is created and managed
1237 # automatically between peered networks. Currently this field should always
1238 # be true since Google Compute Engine will automatically create and manage
1239 # subnetwork routes between two networks when peering state isACTIVE.
1240 &quot;exportCustomRoutes&quot;: True or False, # Whether to export the custom routes to peer network. The default value is
1241 # false.
1242 &quot;exportSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are exported. The default value
1243 # is true, all subnet routes are exported.IPv4
1244 # special-use ranges are always
1245 # exported to peers and are not controlled by this field.
1246 &quot;importCustomRoutes&quot;: True or False, # Whether to import the custom routes from peer network. The default value is
1247 # false.
1248 &quot;importSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are imported. The default value
1249 # is false.IPv4
1250 # special-use ranges are always
1251 # imported from peers and are not controlled by this field.
1252 &quot;name&quot;: &quot;A String&quot;, # Name of this peering. Provided by the client when the peering is created.
1253 # The name must comply withRFC1035.
1254 # Specifically, the name must be 1-63 characters long and match regular
1255 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
1256 # lowercase letter, and all the following characters must be a dash,
1257 # lowercase letter, or digit, except the last character, which cannot be a
1258 # dash.
1259 &quot;network&quot;: &quot;A String&quot;, # The URL of the peer network. It can be either full URL or partial URL. The
1260 # peer network may belong to a different project. If the partial URL does not
1261 # contain project, it is assumed that the peer network is in the same project
1262 # as the current network.
1263 &quot;peerMtu&quot;: 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
1264 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are allowed to be imported or
1265 # exported between peer networks. The default value is IPV4_ONLY.
1266 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State for the peering.
1267 &quot;stateDetails&quot;: &quot;A String&quot;, # Output only. [Output Only] Details about the current state of the peering.
1268 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the semantics for updates and deletes to the
1269 # peering connection configuration.
1270 },
1271 ],
1272 &quot;routingConfig&quot;: { # A routing configuration attached to a network resource. The message # The network-level routing configuration for this network. Used by Cloud
1273 # Router to determine what type of network-wide routing behavior to enforce.
1274 # includes the list of routers associated with the network, and a flag
1275 # indicating the type of routing behavior to enforce network-wide.
1276 &quot;bgpAlwaysCompareMed&quot;: True or False, # Enable comparison of Multi-Exit Discriminators (MED) across routes with
1277 # different neighbor ASNs when using the STANDARD BGP best path selection
1278 # algorithm.
1279 &quot;bgpBestPathSelectionMode&quot;: &quot;A String&quot;, # The BGP best path selection algorithm to be employed within this network
1280 # for dynamic routes learned by Cloud Routers. Can be LEGACY
1281 # (default) or STANDARD.
1282 &quot;bgpInterRegionCost&quot;: &quot;A String&quot;, # Allows to define a preferred approach for handling inter-region cost in
1283 # the selection process when using the STANDARD BGP best path
1284 # selection algorithm. Can be DEFAULT orADD_COST_TO_MED.
1285 &quot;effectiveBgpAlwaysCompareMed&quot;: True or False, # Output only. [Output Only] Effective value of the bgp_always_compare_med
1286 # field.
1287 &quot;effectiveBgpInterRegionCost&quot;: &quot;A String&quot;, # Output only. [Output Only] Effective value of the bgp_inter_region_cost
1288 # field.
1289 &quot;routingMode&quot;: &quot;A String&quot;, # The network-wide routing mode to use. If set to REGIONAL,
1290 # this network&#x27;s Cloud Routers will only advertise routes with subnets
1291 # of this network in the same region as the router. If set toGLOBAL, this network&#x27;s Cloud Routers will advertise
1292 # routes with all subnets of this network, across regions.
1293 },
1294 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1295 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
1296 &quot;subnetworks&quot;: [ # [Output Only] Server-defined fully-qualified URLs for all subnetworks
1297 # in this VPC network.
1298 &quot;A String&quot;,
1299 ],
1300 }</pre>
1301 </div>
1302
1303 <div class="method">
1304 <code class="details" id="getEffectiveFirewalls">getEffectiveFirewalls(project, network, x__xgafv=None)</code>
1305 <pre>Returns the effective firewalls on a given network.
1306
1307 Args:
1308 project: string, Project ID for this request. (required)
1309 network: string, Name of the network for this request. (required)
1310 x__xgafv: string, V1 error format.
1311 Allowed values
1312 1 - v1 error format
1313 2 - v2 error format
1314
1315 Returns:
1316 An object of the form:
1317
1318 {
1319 &quot;firewallPolicys&quot;: [ # [Output Only] Effective firewalls from firewall policy. It returns Global
1320 # Network Firewall Policies and Hierarchical Firewall Policies. UseregionNetworkFirewallPolicies.getEffectiveFirewalls to get
1321 # Regional Network Firewall Policies as well.
1322 {
1323 &quot;displayName&quot;: &quot;A String&quot;, # Output only. [Output Only] Deprecated, please use short name instead. The display name
1324 # of the firewall policy.
1325 &quot;name&quot;: &quot;A String&quot;, # Output only. [Output Only] The name of the firewall policy.
1326 &quot;packetMirroringRules&quot;: [ # Output only. [Output Only] The packet mirroring rules that apply to the network.
1327 { # Represents a rule that describes one or more match conditions along with
1328 # the action to be taken when traffic matches this condition (allow or deny).
1329 &quot;action&quot;: &quot;A String&quot;, # The Action to perform when the client connection triggers the rule.
1330 # Valid actions for firewall rules are: &quot;allow&quot;, &quot;deny&quot;,
1331 # &quot;apply_security_profile_group&quot; and &quot;goto_next&quot;.
1332 # Valid actions for packet mirroring rules are: &quot;mirror&quot;, &quot;do_not_mirror&quot;
1333 # and &quot;goto_next&quot;.
1334 &quot;description&quot;: &quot;A String&quot;, # An optional description for this resource.
1335 &quot;direction&quot;: &quot;A String&quot;, # The direction in which this rule applies.
1336 &quot;disabled&quot;: True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
1337 # the firewall policy rule is not enforced and traffic behaves as if it did
1338 # not exist. If this is unspecified, the firewall policy rule will be
1339 # enabled.
1340 &quot;enableLogging&quot;: True or False, # Denotes whether to enable logging for a particular rule. If logging is
1341 # enabled, logs will be exported to the configured export destination in
1342 # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
1343 # cannot enable logging on &quot;goto_next&quot; rules.
1344 &quot;kind&quot;: &quot;compute#firewallPolicyRule&quot;, # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
1345 &quot;match&quot;: { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
1346 # If it evaluates to true, the corresponding &#x27;action&#x27; is enforced.
1347 # Exactly one field must be specified.
1348 &quot;destAddressGroups&quot;: [ # Address groups which should be matched against the traffic destination.
1349 # Maximum number of destination address groups is 10.
1350 &quot;A String&quot;,
1351 ],
1352 &quot;destFqdns&quot;: [ # Fully Qualified Domain Name (FQDN) which should be matched against
1353 # traffic destination.
1354 # Maximum number of destination fqdn allowed is 100.
1355 &quot;A String&quot;,
1356 ],
1357 &quot;destIpRanges&quot;: [ # CIDR IP address range.
1358 # Maximum number of destination CIDR IP ranges allowed is 5000.
1359 &quot;A String&quot;,
1360 ],
1361 &quot;destNetworkContext&quot;: &quot;A String&quot;, # Network context of the traffic destination. Allowed values are:
1362 #
1363 #
1364 # - UNSPECIFIED
1365 # - INTERNET
1366 # - NON_INTERNET
1367 &quot;destNetworkType&quot;: &quot;A String&quot;, # Network type of the traffic destination. Allowed values are:
1368 #
1369 #
1370 # - UNSPECIFIED
1371 # - INTERNET
1372 # - NON_INTERNET
1373 &quot;destRegionCodes&quot;: [ # Region codes whose IP addresses will be used to match for destination
1374 # of traffic. Should be specified as 2 letter country code defined as per
1375 # ISO 3166 alpha-2 country codes. ex.&quot;US&quot;
1376 # Maximum number of dest region codes allowed is 5000.
1377 &quot;A String&quot;,
1378 ],
1379 &quot;destThreatIntelligences&quot;: [ # Names of Network Threat Intelligence lists.
1380 # The IPs in these lists will be matched against traffic destination.
1381 &quot;A String&quot;,
1382 ],
1383 &quot;layer4Configs&quot;: [ # Pairs of IP protocols and ports that the rule should match.
1384 {
1385 &quot;ipProtocol&quot;: &quot;A String&quot;, # The IP protocol to which this rule applies. The protocol type is
1386 # required when creating a firewall rule. This value can either be
1387 # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
1388 # protocol number.
1389 &quot;ports&quot;: [ # An optional list of ports to which this rule applies. This field is
1390 # only applicable for UDP or TCP protocol. Each entry must be either
1391 # an integer or a range. If not specified, this rule applies to
1392 # connections through any port.
1393 #
1394 # Example inputs include: [&quot;22&quot;],[&quot;80&quot;,&quot;443&quot;], and [&quot;12345-12349&quot;].
1395 &quot;A String&quot;,
1396 ],
1397 },
1398 ],
1399 &quot;srcAddressGroups&quot;: [ # Address groups which should be matched against the traffic source.
1400 # Maximum number of source address groups is 10.
1401 &quot;A String&quot;,
1402 ],
1403 &quot;srcFqdns&quot;: [ # Fully Qualified Domain Name (FQDN) which should be matched against
1404 # traffic source.
1405 # Maximum number of source fqdn allowed is 100.
1406 &quot;A String&quot;,
1407 ],
1408 &quot;srcIpRanges&quot;: [ # CIDR IP address range.
1409 # Maximum number of source CIDR IP ranges allowed is 5000.
1410 &quot;A String&quot;,
1411 ],
1412 &quot;srcNetworkContext&quot;: &quot;A String&quot;, # Network context of the traffic source. Allowed values are:
1413 #
1414 #
1415 # - UNSPECIFIED
1416 # - INTERNET
1417 # - INTRA_VPC
1418 # - NON_INTERNET
1419 # - VPC_NETWORKS
1420 &quot;srcNetworkType&quot;: &quot;A String&quot;, # Network type of the traffic source. Allowed values are:
1421 #
1422 #
1423 # - UNSPECIFIED
1424 # - INTERNET
1425 # - INTRA_VPC
1426 # - NON_INTERNET
1427 # - VPC_NETWORKS
1428 &quot;srcNetworks&quot;: [ # Networks of the traffic source. It can be either a full or partial url.
1429 &quot;A String&quot;,
1430 ],
1431 &quot;srcRegionCodes&quot;: [ # Region codes whose IP addresses will be used to match for source
1432 # of traffic. Should be specified as 2 letter country code defined as per
1433 # ISO 3166 alpha-2 country codes. ex.&quot;US&quot;
1434 # Maximum number of source region codes allowed is 5000.
1435 &quot;A String&quot;,
1436 ],
1437 &quot;srcSecureTags&quot;: [ # List of secure tag values, which should be matched at the source
1438 # of the traffic.
1439 # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
1440 # and there is no srcIpRange, this rule will be ignored.
1441 # Maximum number of source tag values allowed is 256.
1442 {
1443 &quot;name&quot;: &quot;A String&quot;, # Name of the secure tag, created with TagManager&#x27;s TagValue API.
1444 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
1445 # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
1446 # or its network is deleted.
1447 },
1448 ],
1449 &quot;srcThreatIntelligences&quot;: [ # Names of Network Threat Intelligence lists.
1450 # The IPs in these lists will be matched against traffic source.
1451 &quot;A String&quot;,
1452 ],
1453 },
1454 &quot;priority&quot;: 42, # An integer indicating the priority of a rule in the list. The priority
1455 # must be a positive value between 0 and 2147483647.
1456 # Rules are evaluated from highest to lowest priority where 0 is the
1457 # highest priority and 2147483647 is the lowest priority.
1458 &quot;ruleName&quot;: &quot;A String&quot;, # An optional name for the rule. This field is not a unique identifier
1459 # and can be updated.
1460 &quot;ruleTupleCount&quot;: 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
1461 # rule.
1462 &quot;securityProfileGroup&quot;: &quot;A String&quot;, # A fully-qualified URL of a SecurityProfile resource instance.
1463 # Example:
1464 # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
1465 # Must be specified if action is one of &#x27;apply_security_profile_group&#x27; or
1466 # &#x27;mirror&#x27;. Cannot be specified for other actions.
1467 &quot;targetForwardingRules&quot;: [ # A list of forwarding rules to which this rule applies.
1468 # This field allows you to control which load balancers get this rule.
1469 # For example, the following are valid values:
1470 #
1471 #
1472 # - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
1473 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
1474 # - projects/project/global/
1475 # forwardingRules/forwardingRule
1476 # - projects/project/regions/region/forwardingRules/
1477 # forwardingRule
1478 &quot;A String&quot;,
1479 ],
1480 &quot;targetResources&quot;: [ # A list of network resource URLs to which this rule applies. This field
1481 # allows you to control which network&#x27;s VMs get this rule. If this field
1482 # is left blank, all VMs within the organization will receive the rule.
1483 &quot;A String&quot;,
1484 ],
1485 &quot;targetSecureTags&quot;: [ # A list of secure tags that controls which instances the firewall rule
1486 # applies to. If targetSecureTag are specified, then the
1487 # firewall rule applies only to instances in the VPC network that have one
1488 # of those EFFECTIVE secure tags, if all the target_secure_tag are in
1489 # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
1490 # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
1491 # to all instances on the specified network.
1492 # Maximum number of target label tags allowed is 256.
1493 {
1494 &quot;name&quot;: &quot;A String&quot;, # Name of the secure tag, created with TagManager&#x27;s TagValue API.
1495 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
1496 # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
1497 # or its network is deleted.
1498 },
1499 ],
1500 &quot;targetServiceAccounts&quot;: [ # A list of service accounts indicating the sets of instances that are
1501 # applied with this rule.
1502 &quot;A String&quot;,
1503 ],
1504 &quot;targetType&quot;: &quot;A String&quot;, # Target types of the firewall policy rule.
1505 # Default value is INSTANCES.
1506 &quot;tlsInspect&quot;: True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
1507 # Can be set only if action = &#x27;apply_security_profile_group&#x27; and cannot
1508 # be set for other actions.
1509 },
1510 ],
1511 &quot;priority&quot;: 42, # Output only. [Output only] Priority of firewall policy association. Not applicable for
1512 # type=HIERARCHY.
1513 &quot;rules&quot;: [ # [Output Only] The rules that apply to the network.
1514 { # Represents a rule that describes one or more match conditions along with
1515 # the action to be taken when traffic matches this condition (allow or deny).
1516 &quot;action&quot;: &quot;A String&quot;, # The Action to perform when the client connection triggers the rule.
1517 # Valid actions for firewall rules are: &quot;allow&quot;, &quot;deny&quot;,
1518 # &quot;apply_security_profile_group&quot; and &quot;goto_next&quot;.
1519 # Valid actions for packet mirroring rules are: &quot;mirror&quot;, &quot;do_not_mirror&quot;
1520 # and &quot;goto_next&quot;.
1521 &quot;description&quot;: &quot;A String&quot;, # An optional description for this resource.
1522 &quot;direction&quot;: &quot;A String&quot;, # The direction in which this rule applies.
1523 &quot;disabled&quot;: True or False, # Denotes whether the firewall policy rule is disabled. When set to true,
1524 # the firewall policy rule is not enforced and traffic behaves as if it did
1525 # not exist. If this is unspecified, the firewall policy rule will be
1526 # enabled.
1527 &quot;enableLogging&quot;: True or False, # Denotes whether to enable logging for a particular rule. If logging is
1528 # enabled, logs will be exported to the configured export destination in
1529 # Stackdriver. Logs may be exported to BigQuery or Pub/Sub. Note: you
1530 # cannot enable logging on &quot;goto_next&quot; rules.
1531 &quot;kind&quot;: &quot;compute#firewallPolicyRule&quot;, # Output only. [Output only] Type of the resource. Returnscompute#firewallPolicyRule for firewall rules andcompute#packetMirroringRule for packet mirroring rules.
1532 &quot;match&quot;: { # Represents a match condition that incoming traffic is evaluated against. # A match condition that incoming traffic is evaluated against.
1533 # If it evaluates to true, the corresponding &#x27;action&#x27; is enforced.
1534 # Exactly one field must be specified.
1535 &quot;destAddressGroups&quot;: [ # Address groups which should be matched against the traffic destination.
1536 # Maximum number of destination address groups is 10.
1537 &quot;A String&quot;,
1538 ],
1539 &quot;destFqdns&quot;: [ # Fully Qualified Domain Name (FQDN) which should be matched against
1540 # traffic destination.
1541 # Maximum number of destination fqdn allowed is 100.
1542 &quot;A String&quot;,
1543 ],
1544 &quot;destIpRanges&quot;: [ # CIDR IP address range.
1545 # Maximum number of destination CIDR IP ranges allowed is 5000.
1546 &quot;A String&quot;,
1547 ],
1548 &quot;destNetworkContext&quot;: &quot;A String&quot;, # Network context of the traffic destination. Allowed values are:
1549 #
1550 #
1551 # - UNSPECIFIED
1552 # - INTERNET
1553 # - NON_INTERNET
1554 &quot;destNetworkType&quot;: &quot;A String&quot;, # Network type of the traffic destination. Allowed values are:
1555 #
1556 #
1557 # - UNSPECIFIED
1558 # - INTERNET
1559 # - NON_INTERNET
1560 &quot;destRegionCodes&quot;: [ # Region codes whose IP addresses will be used to match for destination
1561 # of traffic. Should be specified as 2 letter country code defined as per
1562 # ISO 3166 alpha-2 country codes. ex.&quot;US&quot;
1563 # Maximum number of dest region codes allowed is 5000.
1564 &quot;A String&quot;,
1565 ],
1566 &quot;destThreatIntelligences&quot;: [ # Names of Network Threat Intelligence lists.
1567 # The IPs in these lists will be matched against traffic destination.
1568 &quot;A String&quot;,
1569 ],
1570 &quot;layer4Configs&quot;: [ # Pairs of IP protocols and ports that the rule should match.
1571 {
1572 &quot;ipProtocol&quot;: &quot;A String&quot;, # The IP protocol to which this rule applies. The protocol type is
1573 # required when creating a firewall rule. This value can either be
1574 # one of the following well known protocol strings (tcp,udp, icmp, esp,ah, ipip, sctp), or the IP
1575 # protocol number.
1576 &quot;ports&quot;: [ # An optional list of ports to which this rule applies. This field is
1577 # only applicable for UDP or TCP protocol. Each entry must be either
1578 # an integer or a range. If not specified, this rule applies to
1579 # connections through any port.
1580 #
1581 # Example inputs include: [&quot;22&quot;],[&quot;80&quot;,&quot;443&quot;], and [&quot;12345-12349&quot;].
1582 &quot;A String&quot;,
1583 ],
1584 },
1585 ],
1586 &quot;srcAddressGroups&quot;: [ # Address groups which should be matched against the traffic source.
1587 # Maximum number of source address groups is 10.
1588 &quot;A String&quot;,
1589 ],
1590 &quot;srcFqdns&quot;: [ # Fully Qualified Domain Name (FQDN) which should be matched against
1591 # traffic source.
1592 # Maximum number of source fqdn allowed is 100.
1593 &quot;A String&quot;,
1594 ],
1595 &quot;srcIpRanges&quot;: [ # CIDR IP address range.
1596 # Maximum number of source CIDR IP ranges allowed is 5000.
1597 &quot;A String&quot;,
1598 ],
1599 &quot;srcNetworkContext&quot;: &quot;A String&quot;, # Network context of the traffic source. Allowed values are:
1600 #
1601 #
1602 # - UNSPECIFIED
1603 # - INTERNET
1604 # - INTRA_VPC
1605 # - NON_INTERNET
1606 # - VPC_NETWORKS
1607 &quot;srcNetworkType&quot;: &quot;A String&quot;, # Network type of the traffic source. Allowed values are:
1608 #
1609 #
1610 # - UNSPECIFIED
1611 # - INTERNET
1612 # - INTRA_VPC
1613 # - NON_INTERNET
1614 # - VPC_NETWORKS
1615 &quot;srcNetworks&quot;: [ # Networks of the traffic source. It can be either a full or partial url.
1616 &quot;A String&quot;,
1617 ],
1618 &quot;srcRegionCodes&quot;: [ # Region codes whose IP addresses will be used to match for source
1619 # of traffic. Should be specified as 2 letter country code defined as per
1620 # ISO 3166 alpha-2 country codes. ex.&quot;US&quot;
1621 # Maximum number of source region codes allowed is 5000.
1622 &quot;A String&quot;,
1623 ],
1624 &quot;srcSecureTags&quot;: [ # List of secure tag values, which should be matched at the source
1625 # of the traffic.
1626 # For INGRESS rule, if all the srcSecureTag are INEFFECTIVE,
1627 # and there is no srcIpRange, this rule will be ignored.
1628 # Maximum number of source tag values allowed is 256.
1629 {
1630 &quot;name&quot;: &quot;A String&quot;, # Name of the secure tag, created with TagManager&#x27;s TagValue API.
1631 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
1632 # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
1633 # or its network is deleted.
1634 },
1635 ],
1636 &quot;srcThreatIntelligences&quot;: [ # Names of Network Threat Intelligence lists.
1637 # The IPs in these lists will be matched against traffic source.
1638 &quot;A String&quot;,
1639 ],
1640 },
1641 &quot;priority&quot;: 42, # An integer indicating the priority of a rule in the list. The priority
1642 # must be a positive value between 0 and 2147483647.
1643 # Rules are evaluated from highest to lowest priority where 0 is the
1644 # highest priority and 2147483647 is the lowest priority.
1645 &quot;ruleName&quot;: &quot;A String&quot;, # An optional name for the rule. This field is not a unique identifier
1646 # and can be updated.
1647 &quot;ruleTupleCount&quot;: 42, # Output only. [Output Only] Calculation of the complexity of a single firewall policy
1648 # rule.
1649 &quot;securityProfileGroup&quot;: &quot;A String&quot;, # A fully-qualified URL of a SecurityProfile resource instance.
1650 # Example:
1651 # https://networksecurity.googleapis.com/v1/projects/{project}/locations/{location}/securityProfileGroups/my-security-profile-group
1652 # Must be specified if action is one of &#x27;apply_security_profile_group&#x27; or
1653 # &#x27;mirror&#x27;. Cannot be specified for other actions.
1654 &quot;targetForwardingRules&quot;: [ # A list of forwarding rules to which this rule applies.
1655 # This field allows you to control which load balancers get this rule.
1656 # For example, the following are valid values:
1657 #
1658 #
1659 # - https://www.googleapis.com/compute/v1/projects/project/global/forwardingRules/forwardingRule
1660 # - https://www.googleapis.com/compute/v1/projects/project/regions/region/forwardingRules/forwardingRule
1661 # - projects/project/global/
1662 # forwardingRules/forwardingRule
1663 # - projects/project/regions/region/forwardingRules/
1664 # forwardingRule
1665 &quot;A String&quot;,
1666 ],
1667 &quot;targetResources&quot;: [ # A list of network resource URLs to which this rule applies. This field
1668 # allows you to control which network&#x27;s VMs get this rule. If this field
1669 # is left blank, all VMs within the organization will receive the rule.
1670 &quot;A String&quot;,
1671 ],
1672 &quot;targetSecureTags&quot;: [ # A list of secure tags that controls which instances the firewall rule
1673 # applies to. If targetSecureTag are specified, then the
1674 # firewall rule applies only to instances in the VPC network that have one
1675 # of those EFFECTIVE secure tags, if all the target_secure_tag are in
1676 # INEFFECTIVE state, then this rule will be ignored.targetSecureTag may not be set at the same time astargetServiceAccounts.
1677 # If neither targetServiceAccounts nortargetSecureTag are specified, the firewall rule applies
1678 # to all instances on the specified network.
1679 # Maximum number of target label tags allowed is 256.
1680 {
1681 &quot;name&quot;: &quot;A String&quot;, # Name of the secure tag, created with TagManager&#x27;s TagValue API.
1682 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State of the secure tag, either `EFFECTIVE` or
1683 # `INEFFECTIVE`. A secure tag is `INEFFECTIVE` when it is deleted
1684 # or its network is deleted.
1685 },
1686 ],
1687 &quot;targetServiceAccounts&quot;: [ # A list of service accounts indicating the sets of instances that are
1688 # applied with this rule.
1689 &quot;A String&quot;,
1690 ],
1691 &quot;targetType&quot;: &quot;A String&quot;, # Target types of the firewall policy rule.
1692 # Default value is INSTANCES.
1693 &quot;tlsInspect&quot;: True or False, # Boolean flag indicating if the traffic should be TLS decrypted.
1694 # Can be set only if action = &#x27;apply_security_profile_group&#x27; and cannot
1695 # be set for other actions.
1696 },
1697 ],
1698 &quot;shortName&quot;: &quot;A String&quot;, # Output only. [Output Only] The short name of the firewall policy.
1699 &quot;type&quot;: &quot;A String&quot;, # Output only. [Output Only] The type of the firewall policy.
1700 },
1701 ],
1702 &quot;firewalls&quot;: [ # Effective firewalls on the network.
1703 { # Represents a Firewall Rule resource.
1704 #
1705 # Firewall rules allow or deny ingress traffic to, and egress traffic from your
1706 # instances. For more information, readFirewall rules.
1707 &quot;allowed&quot;: [ # The list of ALLOW rules specified by this firewall. Each rule specifies a
1708 # protocol and port-range tuple that describes a permitted connection.
1709 {
1710 &quot;IPProtocol&quot;: &quot;A String&quot;, # The IP protocol to which this rule applies. The protocol type is
1711 # required when creating a firewall rule. This value can either be one of the
1712 # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
1713 &quot;ports&quot;: [ # An optional list of ports to which this rule applies.
1714 # This field is only applicable for the UDP or TCP protocol.
1715 # Each entry must be either an integer or a range.
1716 # If not specified, this rule applies to connections through any port.
1717 #
1718 # Example inputs include: [&quot;22&quot;], [&quot;80&quot;,&quot;443&quot;],
1719 # and [&quot;12345-12349&quot;].
1720 &quot;A String&quot;,
1721 ],
1722 },
1723 ],
1724 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
1725 # text format.
1726 &quot;denied&quot;: [ # The list of DENY rules specified by this firewall. Each rule specifies a
1727 # protocol and port-range tuple that describes a denied connection.
1728 {
1729 &quot;IPProtocol&quot;: &quot;A String&quot;, # The IP protocol to which this rule applies. The protocol type is
1730 # required when creating a firewall rule. This value can either be one of the
1731 # following well known protocol strings (tcp, udp,icmp, esp, ah, ipip,sctp) or the IP protocol number.
1732 &quot;ports&quot;: [ # An optional list of ports to which this rule applies.
1733 # This field is only applicable for the UDP or TCP protocol.
1734 # Each entry must be either an integer or a range.
1735 # If not specified, this rule applies to connections through any port.
1736 #
1737 # Example inputs include: [&quot;22&quot;], [&quot;80&quot;,&quot;443&quot;],
1738 # and [&quot;12345-12349&quot;].
1739 &quot;A String&quot;,
1740 ],
1741 },
1742 ],
1743 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this field when you
1744 # create the resource.
1745 &quot;destinationRanges&quot;: [ # If destination ranges are specified, the firewall rule applies only to
1746 # traffic that has destination IP address in these ranges. These ranges must
1747 # be expressed inCIDR format. Both IPv4 and IPv6 are supported.
1748 &quot;A String&quot;,
1749 ],
1750 &quot;direction&quot;: &quot;A String&quot;, # Direction of traffic to which this firewall applies, either `INGRESS` or
1751 # `EGRESS`. The default is `INGRESS`. For `EGRESS` traffic, you cannot
1752 # specify the sourceTags fields.
1753 &quot;disabled&quot;: True or False, # Denotes whether the firewall rule is disabled. When set to true, the
1754 # firewall rule is not enforced and the network behaves as if it did not
1755 # exist. If this is unspecified, the firewall rule will be enabled.
1756 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
1757 # defined by the server.
1758 &quot;kind&quot;: &quot;compute#firewall&quot;, # Output only. [Output Only] Type of the resource. Always compute#firewall
1759 # for firewall rules.
1760 &quot;logConfig&quot;: { # The available logging options for a firewall rule. # This field denotes the logging options for a particular firewall rule. If
1761 # logging is enabled, logs will be exported to Cloud Logging.
1762 &quot;enable&quot;: True or False, # This field denotes whether to enable logging for a particular firewall
1763 # rule.
1764 &quot;metadata&quot;: &quot;A String&quot;, # This field can only be specified for a particular firewall rule if
1765 # logging is enabled for that rule. This field denotes whether to include
1766 # or exclude metadata for firewall logs.
1767 },
1768 &quot;name&quot;: &quot;A String&quot;, # Name of the resource; provided by the client when the resource is created.
1769 # The name must be 1-63 characters long, and comply withRFC1035.
1770 # Specifically, the name must be 1-63 characters long and match the regular
1771 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character
1772 # must be a lowercase letter, and all following characters (except for the
1773 # last character) must be a dash, lowercase letter, or digit. The last
1774 # character must be a lowercase letter or digit.
1775 &quot;network&quot;: &quot;A String&quot;, # URL of the network resource for this firewall rule. If not
1776 # specified when creating a firewall rule, the default network
1777 # is used:
1778 #
1779 # global/networks/default
1780 #
1781 # If you choose to specify this field, you can specify the network as a full
1782 # or partial URL. For example, the following are all valid URLs:
1783 #
1784 # -
1785 # https://www.googleapis.com/compute/v1/projects/myproject/global/networks/my-network
1786 # - projects/myproject/global/networks/my-network
1787 # - global/networks/default
1788 &quot;params&quot;: { # Additional firewall parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted
1789 # as part of resource payload.
1790 &quot;resourceManagerTags&quot;: { # Tag keys/values directly bound to this resource.
1791 # Tag keys and values have the same definition as resource
1792 # manager tags. The field is allowed for INSERT
1793 # only. The keys/values to set on the resource should be specified in
1794 # either ID { : } or Namespaced format
1795 # { : }.
1796 # For example the following are valid inputs:
1797 # * {&quot;tagKeys/333&quot; : &quot;tagValues/444&quot;, &quot;tagKeys/123&quot; : &quot;tagValues/456&quot;}
1798 # * {&quot;123/environment&quot; : &quot;production&quot;, &quot;345/abc&quot; : &quot;xyz&quot;}
1799 # Note:
1800 # * Invalid combinations of ID &amp; namespaced format is not supported. For
1801 # instance: {&quot;123/environment&quot; : &quot;tagValues/444&quot;} is invalid.
1802 &quot;a_key&quot;: &quot;A String&quot;,
1803 },
1804 },
1805 &quot;priority&quot;: 42, # Priority for this rule.
1806 # This is an integer between `0` and `65535`, both inclusive.
1807 # The default value is `1000`.
1808 # Relative priorities determine which rule takes effect if multiple rules
1809 # apply. Lower values indicate higher priority. For example, a rule with
1810 # priority `0` has higher precedence than a rule with priority `1`.
1811 # DENY rules take precedence over ALLOW rules if they have equal priority.
1812 # Note that VPC networks have implied
1813 # rules with a priority of `65535`. To avoid conflicts with the implied
1814 # rules, use a priority number less than `65535`.
1815 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
1816 &quot;sourceRanges&quot;: [ # If source ranges are specified, the firewall rule applies only to traffic
1817 # that has a source IP address in these ranges. These ranges must be
1818 # expressed inCIDR format. One or both of sourceRanges
1819 # and sourceTags may be set.
1820 # If both fields are set, the rule applies to traffic that has a
1821 # source IP address within sourceRanges OR a source IP
1822 # from a resource with a matching tag listed in thesourceTags field. The connection does not need to match
1823 # both fields for the rule to
1824 # apply. Both IPv4 and IPv6 are supported.
1825 &quot;A String&quot;,
1826 ],
1827 &quot;sourceServiceAccounts&quot;: [ # If source service accounts are specified, the firewall rules apply only to
1828 # traffic originating from an instance with a service account in this list.
1829 # Source service accounts cannot be used to control traffic to an instance&#x27;s
1830 # external IP address because service accounts are associated with an
1831 # instance, not an IP address.sourceRanges can be set at the same time assourceServiceAccounts.
1832 # If both are set, the firewall applies to traffic that
1833 # has a source IP address within the sourceRanges OR a source
1834 # IP that belongs to an instance with service account listed insourceServiceAccount. The connection does not need to match
1835 # both fields for the firewall to apply.sourceServiceAccounts cannot be used at the same time assourceTags or targetTags.
1836 &quot;A String&quot;,
1837 ],
1838 &quot;sourceTags&quot;: [ # If source tags are specified, the firewall rule applies only to traffic
1839 # with source IPs that match the primary network interfaces of VM instances
1840 # that have the tag and are in the same VPC network.
1841 # Source tags cannot be used to control traffic to an instance&#x27;s external IP
1842 # address, it only applies to traffic between instances in the same virtual
1843 # network. Because tags are associated with instances, not IP addresses.
1844 # One or both of sourceRanges and sourceTags may be
1845 # set. If both fields are set, the firewall applies to traffic that has a
1846 # source IP address within sourceRanges OR a source IP from a
1847 # resource with a matching tag listed in the sourceTags
1848 # field. The connection does not need to match both fields for the
1849 # firewall to apply.
1850 &quot;A String&quot;,
1851 ],
1852 &quot;targetServiceAccounts&quot;: [ # A list of service accounts indicating sets of instances located in the
1853 # network that may make network connections as specified inallowed[].targetServiceAccounts cannot be used at the same time astargetTags or sourceTags.
1854 # If neither targetServiceAccounts nor targetTags
1855 # are specified, the firewall rule applies to all instances on the specified
1856 # network.
1857 &quot;A String&quot;,
1858 ],
1859 &quot;targetTags&quot;: [ # A list of tags that controls which instances the firewall rule
1860 # applies to. If targetTags are specified, then the firewall
1861 # rule applies only to instances in the VPC network that have one of those
1862 # tags. If no targetTags are specified, the firewall rule
1863 # applies to all instances on the specified network.
1864 &quot;A String&quot;,
1865 ],
1866 },
1867 ],
1868 }</pre>
1869 </div>
1870
1871 <div class="method">
1872 <code class="details" id="insert">insert(project, body=None, requestId=None, x__xgafv=None)</code>
1873 <pre>Creates a network in the specified project using the data included
1874 in the request.
1875
1876 Args:
1877 project: string, Project ID for this request. (required)
1878 body: object, The request body.
1879 The object takes the form of:
1880
1881 { # Represents a VPC Network resource.
1882 #
1883 # Networks connect resources to each other and to the internet. For more
1884 # information, readVirtual Private Cloud (VPC) Network.
1885 &quot;IPv4Range&quot;: &quot;A String&quot;, # Deprecated in favor of subnet mode networks.
1886 # The range of internal addresses that are legal on this network. This
1887 # range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is
1888 # created.
1889 &quot;autoCreateSubnetworks&quot;: True or False, # Must be set to create a VPC network. If not set, a legacy network is
1890 # created.
1891 #
1892 # When set to true, the VPC network is created in auto mode.
1893 # When set to false, the VPC network is created in custom mode.
1894 #
1895 # An auto mode VPC network starts with one subnet per region. Each subnet
1896 # has a predetermined range as described inAuto mode VPC network IP ranges.
1897 #
1898 # For custom mode VPC networks, you can add subnets using the subnetworksinsert
1899 # method.
1900 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
1901 # text format.
1902 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this field when you
1903 # create the resource.
1904 &quot;enableUlaInternalIpv6&quot;: True or False, # Enable ULA internal ipv6 on this network. Enabling this feature will assign
1905 # a /48 from google defined ULA prefix fd20::/20.
1906 # .
1907 &quot;firewallPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the firewall policy the network is associated with.
1908 &quot;gatewayIPv4&quot;: &quot;A String&quot;, # [Output Only] The gateway address for default routing out of the network,
1909 # selected by Google Cloud.
1910 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
1911 # defined by the server.
1912 &quot;internalIpv6Range&quot;: &quot;A String&quot;, # When enabling ula internal ipv6, caller optionally can specify the /48
1913 # range they want from the google defined ULA prefix fd20::/20. The input
1914 # must be a valid /48 ULA IPv6 address and must be within the fd20::/20.
1915 # Operation will fail if the speficied /48 is already in used by another
1916 # resource. If the field is not speficied, then a /48 range will be randomly
1917 # allocated from fd20::/20 and returned via this field.
1918 # .
1919 &quot;kind&quot;: &quot;compute#network&quot;, # Output only. [Output Only] Type of the resource. Always compute#network for
1920 # networks.
1921 &quot;mtu&quot;: 42, # Maximum Transmission Unit in bytes.
1922 # The minimum value for this field is 1300 and the maximum value is 8896.
1923 # The suggested value is 1500, which is the default MTU used on the
1924 # Internet, or 8896 if you want to use Jumbo frames. If unspecified, the
1925 # value defaults to 1460.
1926 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
1927 # The name must be 1-63 characters long, and comply withRFC1035.
1928 # Specifically, the name must be 1-63 characters long and match the regular
1929 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
1930 # lowercase letter, and all following characters (except for the last
1931 # character) must be a dash, lowercase letter, or digit. The last character
1932 # must be a lowercase letter or digit.
1933 &quot;networkFirewallPolicyEnforcementOrder&quot;: &quot;A String&quot;, # The network firewall policy enforcement order. Can be either
1934 # AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to
1935 # AFTER_CLASSIC_FIREWALL if the field is not specified.
1936 &quot;networkProfile&quot;: &quot;A String&quot;, # A full or partial URL of the network profile to apply to this network.
1937 # This field can be set only at resource creation time. For example, the
1938 # following are valid URLs:
1939 #
1940 # - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}
1941 # - projects/{project_id}/global/networkProfiles/{network_profile_name}
1942 &quot;params&quot;: { # Additional network parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted
1943 # as part of resource payload.
1944 &quot;resourceManagerTags&quot;: { # Tag keys/values directly bound to this resource.
1945 # Tag keys and values have the same definition as resource
1946 # manager tags. The field is allowed for INSERT
1947 # only. The keys/values to set on the resource should be specified in
1948 # either ID { : } or Namespaced format
1949 # { : }.
1950 # For example the following are valid inputs:
1951 # * {&quot;tagKeys/333&quot; : &quot;tagValues/444&quot;, &quot;tagKeys/123&quot; : &quot;tagValues/456&quot;}
1952 # * {&quot;123/environment&quot; : &quot;production&quot;, &quot;345/abc&quot; : &quot;xyz&quot;}
1953 # Note:
1954 # * Invalid combinations of ID &amp; namespaced format is not supported. For
1955 # instance: {&quot;123/environment&quot; : &quot;tagValues/444&quot;} is invalid.
1956 &quot;a_key&quot;: &quot;A String&quot;,
1957 },
1958 },
1959 &quot;peerings&quot;: [ # Output only. [Output Only] A list of network peerings for the resource.
1960 { # A network peering attached to a network resource. The message includes the
1961 # peering name, peer network, peering state, and a flag indicating whether
1962 # Google Compute Engine should automatically create routes for the peering.
1963 &quot;autoCreateRoutes&quot;: True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
1964 # Indicates whether full mesh connectivity is created and managed
1965 # automatically between peered networks. Currently this field should always
1966 # be true since Google Compute Engine will automatically create and manage
1967 # subnetwork routes between two networks when peering state isACTIVE.
1968 &quot;connectionStatus&quot;: { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
1969 # as a whole.
1970 # local peering. This field provides information about the effective settings
1971 # for the connection as a whole, including pending delete/update requests for
1972 # CONSENSUS peerings.
1973 &quot;consensusState&quot;: { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
1974 # and delete for a consensus peering connection.
1975 # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
1976 # strategy to CONSENSUS.
1977 &quot;deleteStatus&quot;: &quot;A String&quot;, # The status of the delete request.
1978 &quot;updateStatus&quot;: &quot;A String&quot;, # The status of the update request.
1979 },
1980 &quot;trafficConfiguration&quot;: { # The active connectivity settings for the peering connection based on the
1981 # settings of the network peerings.
1982 &quot;exportCustomRoutesToPeer&quot;: True or False, # Whether custom routes are being exported to the peer network.
1983 &quot;exportSubnetRoutesWithPublicIpToPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being exported to the
1984 # peer network.
1985 &quot;importCustomRoutesFromPeer&quot;: True or False, # Whether custom routes are being imported from the peer network.
1986 &quot;importSubnetRoutesWithPublicIpFromPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being imported
1987 # from the peer network.
1988 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are being imported or
1989 # exported between peer networks.
1990 },
1991 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the update/delete semantics for this
1992 # peering connection.
1993 },
1994 &quot;exchangeSubnetRoutes&quot;: True or False, # Indicates whether full mesh connectivity is created and managed
1995 # automatically between peered networks. Currently this field should always
1996 # be true since Google Compute Engine will automatically create and manage
1997 # subnetwork routes between two networks when peering state isACTIVE.
1998 &quot;exportCustomRoutes&quot;: True or False, # Whether to export the custom routes to peer network. The default value is
1999 # false.
2000 &quot;exportSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are exported. The default value
2001 # is true, all subnet routes are exported.IPv4
2002 # special-use ranges are always
2003 # exported to peers and are not controlled by this field.
2004 &quot;importCustomRoutes&quot;: True or False, # Whether to import the custom routes from peer network. The default value is
2005 # false.
2006 &quot;importSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are imported. The default value
2007 # is false.IPv4
2008 # special-use ranges are always
2009 # imported from peers and are not controlled by this field.
2010 &quot;name&quot;: &quot;A String&quot;, # Name of this peering. Provided by the client when the peering is created.
2011 # The name must comply withRFC1035.
2012 # Specifically, the name must be 1-63 characters long and match regular
2013 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
2014 # lowercase letter, and all the following characters must be a dash,
2015 # lowercase letter, or digit, except the last character, which cannot be a
2016 # dash.
2017 &quot;network&quot;: &quot;A String&quot;, # The URL of the peer network. It can be either full URL or partial URL. The
2018 # peer network may belong to a different project. If the partial URL does not
2019 # contain project, it is assumed that the peer network is in the same project
2020 # as the current network.
2021 &quot;peerMtu&quot;: 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
2022 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are allowed to be imported or
2023 # exported between peer networks. The default value is IPV4_ONLY.
2024 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State for the peering.
2025 &quot;stateDetails&quot;: &quot;A String&quot;, # Output only. [Output Only] Details about the current state of the peering.
2026 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the semantics for updates and deletes to the
2027 # peering connection configuration.
2028 },
2029 ],
2030 &quot;routingConfig&quot;: { # A routing configuration attached to a network resource. The message # The network-level routing configuration for this network. Used by Cloud
2031 # Router to determine what type of network-wide routing behavior to enforce.
2032 # includes the list of routers associated with the network, and a flag
2033 # indicating the type of routing behavior to enforce network-wide.
2034 &quot;bgpAlwaysCompareMed&quot;: True or False, # Enable comparison of Multi-Exit Discriminators (MED) across routes with
2035 # different neighbor ASNs when using the STANDARD BGP best path selection
2036 # algorithm.
2037 &quot;bgpBestPathSelectionMode&quot;: &quot;A String&quot;, # The BGP best path selection algorithm to be employed within this network
2038 # for dynamic routes learned by Cloud Routers. Can be LEGACY
2039 # (default) or STANDARD.
2040 &quot;bgpInterRegionCost&quot;: &quot;A String&quot;, # Allows to define a preferred approach for handling inter-region cost in
2041 # the selection process when using the STANDARD BGP best path
2042 # selection algorithm. Can be DEFAULT orADD_COST_TO_MED.
2043 &quot;effectiveBgpAlwaysCompareMed&quot;: True or False, # Output only. [Output Only] Effective value of the bgp_always_compare_med
2044 # field.
2045 &quot;effectiveBgpInterRegionCost&quot;: &quot;A String&quot;, # Output only. [Output Only] Effective value of the bgp_inter_region_cost
2046 # field.
2047 &quot;routingMode&quot;: &quot;A String&quot;, # The network-wide routing mode to use. If set to REGIONAL,
2048 # this network&#x27;s Cloud Routers will only advertise routes with subnets
2049 # of this network in the same region as the router. If set toGLOBAL, this network&#x27;s Cloud Routers will advertise
2050 # routes with all subnets of this network, across regions.
2051 },
2052 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2053 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
2054 &quot;subnetworks&quot;: [ # [Output Only] Server-defined fully-qualified URLs for all subnetworks
2055 # in this VPC network.
2056 &quot;A String&quot;,
2057 ],
2058 }
2059
2060 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
2061 that if you must retry your request, the server will know to ignore the
2062 request if it has already been completed.
2063
2064 For example, consider a situation where you make an initial request and
2065 the request times out. If you make the request again with the same
2066 request ID, the server can check if original operation with the same
2067 request ID was received, and if so, will ignore the second request. This
2068 prevents clients from accidentally creating duplicate commitments.
2069
2070 The request ID must be
2071 a valid UUID with the exception that zero UUID is not supported
2072 (00000000-0000-0000-0000-000000000000).
2073 x__xgafv: string, V1 error format.
2074 Allowed values
2075 1 - v1 error format
2076 2 - v2 error format
2077
2078 Returns:
2079 An object of the form:
2080
2081 { # Represents an Operation resource.
2082 #
2083 # Google Compute Engine has three Operation resources:
2084 #
2085 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
2086 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
2087 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
2088 #
2089 # You can use an operation resource to manage asynchronous API requests.
2090 # For more information, readHandling
2091 # API responses.
2092 #
2093 # Operations can be global, regional or zonal.
2094 #
2095 # - For global operations, use the `globalOperations`
2096 # resource.
2097 # - For regional operations, use the
2098 # `regionOperations` resource.
2099 # - For zonal operations, use
2100 # the `zoneOperations` resource.
2101 #
2102 #
2103 #
2104 # For more information, read
2105 # Global, Regional, and Zonal Resources.
2106 #
2107 # Note that completed Operation resources have a limited
2108 # retention period.
2109 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
2110 # Not present otherwise.
2111 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
2112 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
2113 # set when the operation is created.
2114 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
2115 # text format.
2116 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
2117 # this field will be populated.
2118 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
2119 # operation.
2120 {
2121 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
2122 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
2123 # details. There is a set of defined message types to use for providing
2124 # details.The syntax depends on the error code. For example,
2125 # QuotaExceededInfo will have details when the error code is
2126 # QUOTA_EXCEEDED.
2127 {
2128 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
2129 #
2130 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
2131 # is not enabled:
2132 #
2133 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
2134 # &quot;domain&quot;: &quot;googleapis.com&quot;
2135 # &quot;metadata&quot;: {
2136 # &quot;resource&quot;: &quot;projects/123&quot;,
2137 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
2138 # }
2139 # }
2140 #
2141 # This response indicates that the pubsub.googleapis.com API is not enabled.
2142 #
2143 # Example of an error that is returned when attempting to create a Spanner
2144 # instance in a region that is out of stock:
2145 #
2146 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
2147 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
2148 # &quot;metadata&quot;: {
2149 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
2150 # }
2151 # }
2152 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
2153 # is typically the registered service name of the tool or product that
2154 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
2155 # generated by some common infrastructure, the error domain must be a
2156 # globally unique value that identifies the infrastructure. For Google API
2157 # infrastructure, the error domain is &quot;googleapis.com&quot;.
2158 &quot;metadatas&quot;: { # Additional structured details about this error.
2159 #
2160 # Keys must match a regular expression of `a-z+` but should
2161 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
2162 # length. When identifying the current value of an exceeded limit, the units
2163 # should be contained in the key, not the value. For example, rather than
2164 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
2165 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
2166 # instances that can be created in a single (batch) request.
2167 &quot;a_key&quot;: &quot;A String&quot;,
2168 },
2169 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
2170 # proximate cause of the error. Error reasons are unique within a particular
2171 # domain of errors. This should be at most 63 characters and match a
2172 # regular expression of `A-Z+[A-Z0-9]`, which represents
2173 # UPPER_SNAKE_CASE.
2174 },
2175 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
2176 #
2177 # For example, if a quota check failed with an error indicating the calling
2178 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
2179 # directly to the right place in the developer console to flip the bit.
2180 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
2181 { # Describes a URL link.
2182 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
2183 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
2184 },
2185 ],
2186 },
2187 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
2188 # which can be attached to an RPC error.
2189 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
2190 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
2191 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
2192 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
2193 },
2194 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
2195 &quot;dimensions&quot;: { # The map holding related quota dimensions.
2196 &quot;a_key&quot;: &quot;A String&quot;,
2197 },
2198 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
2199 # type or metric.
2200 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
2201 # or metric.
2202 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
2203 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
2204 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
2205 },
2206 },
2207 ],
2208 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
2209 # This property is optional.
2210 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
2211 },
2212 ],
2213 },
2214 &quot;getVersionOperationMetadata&quot;: {
2215 &quot;inlineSbomInfo&quot;: {
2216 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
2217 # appropriate identifiers.
2218 &quot;a_key&quot;: &quot;A String&quot;,
2219 },
2220 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
2221 # identifiers.
2222 &quot;a_key&quot;: &quot;A String&quot;,
2223 },
2224 },
2225 },
2226 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
2227 # message that was returned, such as `NOT FOUND`.
2228 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
2229 # status code that was returned. For example, a `404` means the
2230 # resource was not found.
2231 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
2232 # defined by the server.
2233 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
2234 # This value is inRFC3339
2235 # text format.
2236 &quot;instancesBulkInsertOperationMetadata&quot;: {
2237 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
2238 # Example key: zones/us-central1-a
2239 &quot;a_key&quot;: {
2240 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
2241 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
2242 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
2243 # error.
2244 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
2245 # if the flow is rolling forward or rolling back.
2246 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
2247 },
2248 },
2249 },
2250 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
2251 # Operation resources.
2252 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
2253 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
2254 # group of operations results from a `bulkInsert` API request.
2255 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
2256 # `update`, or `delete`, and so on.
2257 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
2258 # There is no requirement that this be linear or support any granularity of
2259 # operations. This should not be used to guess when the operation will be
2260 # complete. This number should monotonically increase as the operation
2261 # progresses.
2262 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
2263 # applicable when performing regional operations.
2264 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2265 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
2266 # this field will contain information on all underlying zonal actions and
2267 # their state.
2268 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
2269 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
2270 # Example key: zones/us-central1-a
2271 &quot;a_key&quot;: {
2272 &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
2273 # populated.
2274 # different programming environments, including REST APIs and RPC APIs. It is
2275 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
2276 # three pieces of data: error code, error message, and error details.
2277 #
2278 # You can find out more about this error model and how to work with it in the
2279 # [API Design Guide](https://cloud.google.com/apis/design/errors).
2280 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
2281 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
2282 # message types for APIs to use.
2283 {
2284 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
2285 },
2286 ],
2287 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
2288 # user-facing error message should be localized and sent in the
2289 # google.rpc.Status.details field, or localized by the client.
2290 },
2291 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
2292 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
2293 },
2294 },
2295 },
2296 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
2297 # This value is inRFC3339
2298 # text format.
2299 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
2300 # following:
2301 # `PENDING`, `RUNNING`, or `DONE`.
2302 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
2303 # operation.
2304 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
2305 # of the target resource.
2306 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
2307 # operations related to creating a snapshot, this points to the disk
2308 # that the snapshot was created from.
2309 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
2310 # `[email protected]` or
2311 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
2312 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
2313 # operation, this field will be populated.
2314 {
2315 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2316 # Engine returns NO_RESULTS_ON_PAGE if there
2317 # are no results in the response.
2318 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2319 # value format. For example:
2320 #
2321 # &quot;data&quot;: [
2322 # {
2323 # &quot;key&quot;: &quot;scope&quot;,
2324 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2325 # }
2326 {
2327 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2328 # returned. For example, for warnings where there are no results in a list
2329 # request for a particular zone, this key might be scope and
2330 # the key value might be the zone name. Other examples might be a key
2331 # indicating a deprecated resource and a suggested replacement, or a
2332 # warning about invalid network settings (for example, if an instance
2333 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2334 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2335 },
2336 ],
2337 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2338 },
2339 ],
2340 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
2341 # applicable when performing per-zone operations.
2342 }</pre>
2343 </div>
2344
2345 <div class="method">
2346 <code class="details" id="list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None, x__xgafv=None)</code>
2347 <pre>Retrieves the list of networks available to the specified project.
2348
2349 Args:
2350 project: string, Project ID for this request. (required)
2351 filter: string, A filter expression that filters resources listed in the response. Most
2352 Compute resources support two types of filter expressions:
2353 expressions that support regular expressions and expressions that follow
2354 API improvement proposal AIP-160.
2355 These two types of filter expressions cannot be mixed in one request.
2356
2357 If you want to use AIP-160, your expression must specify the field name, an
2358 operator, and the value that you want to use for filtering. The value
2359 must be a string, a number, or a boolean. The operator
2360 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
2361
2362 For example, if you are filtering Compute Engine instances, you can
2363 exclude instances named `example-instance` by specifying
2364 `name != example-instance`.
2365
2366 The `:*` comparison can be used to test whether a key has been defined.
2367 For example, to find all objects with `owner` label use:
2368 ```
2369 labels.owner:*
2370 ```
2371
2372 You can also filter nested fields. For example, you could specify
2373 `scheduling.automaticRestart = false` to include instances only
2374 if they are not scheduled for automatic restarts. You can use filtering
2375 on nested fields to filter based onresource labels.
2376
2377 To filter on multiple expressions, provide each separate expression within
2378 parentheses. For example:
2379 ```
2380 (scheduling.automaticRestart = true)
2381 (cpuPlatform = &quot;Intel Skylake&quot;)
2382 ```
2383 By default, each expression is an `AND` expression. However, you
2384 can include `AND` and `OR` expressions explicitly.
2385 For example:
2386 ```
2387 (cpuPlatform = &quot;Intel Skylake&quot;) OR
2388 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
2389 (scheduling.automaticRestart = true)
2390 ```
2391
2392 If you want to use a regular expression, use the `eq` (equal) or `ne`
2393 (not equal) operator against a single un-parenthesized expression with or
2394 without quotes or against multiple parenthesized expressions. Examples:
2395
2396 `fieldname eq unquoted literal`
2397 `fieldname eq &#x27;single quoted literal&#x27;`
2398 `fieldname eq &quot;double quoted literal&quot;`
2399 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
2400
2401 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
2402 The literal value must match the entire field.
2403
2404 For example, to filter for instances that do not end with name &quot;instance&quot;,
2405 you would use `name ne .*instance`.
2406
2407 You cannot combine constraints on multiple fields using regular
2408 expressions.
2409 maxResults: integer, The maximum number of results per page that should be returned.
2410 If the number of available results is larger than `maxResults`,
2411 Compute Engine returns a `nextPageToken` that can be used to get
2412 the next page of results in subsequent list requests. Acceptable values are
2413 `0` to `500`, inclusive. (Default: `500`)
2414 orderBy: string, Sorts list results by a certain order. By default, results
2415 are returned in alphanumerical order based on the resource name.
2416
2417 You can also sort results in descending order based on the creation
2418 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
2419 results based on the `creationTimestamp` field in
2420 reverse chronological order (newest result first). Use this to sort
2421 resources like operations so that the newest operation is returned first.
2422
2423 Currently, only sorting by `name` or
2424 `creationTimestamp desc` is supported.
2425 pageToken: string, Specifies a page token to use. Set `pageToken` to the
2426 `nextPageToken` returned by a previous list request to get
2427 the next page of results.
2428 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
2429 of failure. The default value is false.
2430
2431 For example, when partial success behavior is enabled, aggregatedList for a
2432 single zone scope either returns all resources in the zone or no resources,
2433 with an error code.
2434 x__xgafv: string, V1 error format.
2435 Allowed values
2436 1 - v1 error format
2437 2 - v2 error format
2438
2439 Returns:
2440 An object of the form:
2441
2442 { # Contains a list of networks.
2443 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
2444 &quot;items&quot;: [ # A list of Network resources.
2445 { # Represents a VPC Network resource.
2446 #
2447 # Networks connect resources to each other and to the internet. For more
2448 # information, readVirtual Private Cloud (VPC) Network.
2449 &quot;IPv4Range&quot;: &quot;A String&quot;, # Deprecated in favor of subnet mode networks.
2450 # The range of internal addresses that are legal on this network. This
2451 # range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is
2452 # created.
2453 &quot;autoCreateSubnetworks&quot;: True or False, # Must be set to create a VPC network. If not set, a legacy network is
2454 # created.
2455 #
2456 # When set to true, the VPC network is created in auto mode.
2457 # When set to false, the VPC network is created in custom mode.
2458 #
2459 # An auto mode VPC network starts with one subnet per region. Each subnet
2460 # has a predetermined range as described inAuto mode VPC network IP ranges.
2461 #
2462 # For custom mode VPC networks, you can add subnets using the subnetworksinsert
2463 # method.
2464 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
2465 # text format.
2466 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this field when you
2467 # create the resource.
2468 &quot;enableUlaInternalIpv6&quot;: True or False, # Enable ULA internal ipv6 on this network. Enabling this feature will assign
2469 # a /48 from google defined ULA prefix fd20::/20.
2470 # .
2471 &quot;firewallPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the firewall policy the network is associated with.
2472 &quot;gatewayIPv4&quot;: &quot;A String&quot;, # [Output Only] The gateway address for default routing out of the network,
2473 # selected by Google Cloud.
2474 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
2475 # defined by the server.
2476 &quot;internalIpv6Range&quot;: &quot;A String&quot;, # When enabling ula internal ipv6, caller optionally can specify the /48
2477 # range they want from the google defined ULA prefix fd20::/20. The input
2478 # must be a valid /48 ULA IPv6 address and must be within the fd20::/20.
2479 # Operation will fail if the speficied /48 is already in used by another
2480 # resource. If the field is not speficied, then a /48 range will be randomly
2481 # allocated from fd20::/20 and returned via this field.
2482 # .
2483 &quot;kind&quot;: &quot;compute#network&quot;, # Output only. [Output Only] Type of the resource. Always compute#network for
2484 # networks.
2485 &quot;mtu&quot;: 42, # Maximum Transmission Unit in bytes.
2486 # The minimum value for this field is 1300 and the maximum value is 8896.
2487 # The suggested value is 1500, which is the default MTU used on the
2488 # Internet, or 8896 if you want to use Jumbo frames. If unspecified, the
2489 # value defaults to 1460.
2490 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
2491 # The name must be 1-63 characters long, and comply withRFC1035.
2492 # Specifically, the name must be 1-63 characters long and match the regular
2493 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
2494 # lowercase letter, and all following characters (except for the last
2495 # character) must be a dash, lowercase letter, or digit. The last character
2496 # must be a lowercase letter or digit.
2497 &quot;networkFirewallPolicyEnforcementOrder&quot;: &quot;A String&quot;, # The network firewall policy enforcement order. Can be either
2498 # AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to
2499 # AFTER_CLASSIC_FIREWALL if the field is not specified.
2500 &quot;networkProfile&quot;: &quot;A String&quot;, # A full or partial URL of the network profile to apply to this network.
2501 # This field can be set only at resource creation time. For example, the
2502 # following are valid URLs:
2503 #
2504 # - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}
2505 # - projects/{project_id}/global/networkProfiles/{network_profile_name}
2506 &quot;params&quot;: { # Additional network parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted
2507 # as part of resource payload.
2508 &quot;resourceManagerTags&quot;: { # Tag keys/values directly bound to this resource.
2509 # Tag keys and values have the same definition as resource
2510 # manager tags. The field is allowed for INSERT
2511 # only. The keys/values to set on the resource should be specified in
2512 # either ID { : } or Namespaced format
2513 # { : }.
2514 # For example the following are valid inputs:
2515 # * {&quot;tagKeys/333&quot; : &quot;tagValues/444&quot;, &quot;tagKeys/123&quot; : &quot;tagValues/456&quot;}
2516 # * {&quot;123/environment&quot; : &quot;production&quot;, &quot;345/abc&quot; : &quot;xyz&quot;}
2517 # Note:
2518 # * Invalid combinations of ID &amp; namespaced format is not supported. For
2519 # instance: {&quot;123/environment&quot; : &quot;tagValues/444&quot;} is invalid.
2520 &quot;a_key&quot;: &quot;A String&quot;,
2521 },
2522 },
2523 &quot;peerings&quot;: [ # Output only. [Output Only] A list of network peerings for the resource.
2524 { # A network peering attached to a network resource. The message includes the
2525 # peering name, peer network, peering state, and a flag indicating whether
2526 # Google Compute Engine should automatically create routes for the peering.
2527 &quot;autoCreateRoutes&quot;: True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
2528 # Indicates whether full mesh connectivity is created and managed
2529 # automatically between peered networks. Currently this field should always
2530 # be true since Google Compute Engine will automatically create and manage
2531 # subnetwork routes between two networks when peering state isACTIVE.
2532 &quot;connectionStatus&quot;: { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
2533 # as a whole.
2534 # local peering. This field provides information about the effective settings
2535 # for the connection as a whole, including pending delete/update requests for
2536 # CONSENSUS peerings.
2537 &quot;consensusState&quot;: { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
2538 # and delete for a consensus peering connection.
2539 # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
2540 # strategy to CONSENSUS.
2541 &quot;deleteStatus&quot;: &quot;A String&quot;, # The status of the delete request.
2542 &quot;updateStatus&quot;: &quot;A String&quot;, # The status of the update request.
2543 },
2544 &quot;trafficConfiguration&quot;: { # The active connectivity settings for the peering connection based on the
2545 # settings of the network peerings.
2546 &quot;exportCustomRoutesToPeer&quot;: True or False, # Whether custom routes are being exported to the peer network.
2547 &quot;exportSubnetRoutesWithPublicIpToPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being exported to the
2548 # peer network.
2549 &quot;importCustomRoutesFromPeer&quot;: True or False, # Whether custom routes are being imported from the peer network.
2550 &quot;importSubnetRoutesWithPublicIpFromPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being imported
2551 # from the peer network.
2552 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are being imported or
2553 # exported between peer networks.
2554 },
2555 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the update/delete semantics for this
2556 # peering connection.
2557 },
2558 &quot;exchangeSubnetRoutes&quot;: True or False, # Indicates whether full mesh connectivity is created and managed
2559 # automatically between peered networks. Currently this field should always
2560 # be true since Google Compute Engine will automatically create and manage
2561 # subnetwork routes between two networks when peering state isACTIVE.
2562 &quot;exportCustomRoutes&quot;: True or False, # Whether to export the custom routes to peer network. The default value is
2563 # false.
2564 &quot;exportSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are exported. The default value
2565 # is true, all subnet routes are exported.IPv4
2566 # special-use ranges are always
2567 # exported to peers and are not controlled by this field.
2568 &quot;importCustomRoutes&quot;: True or False, # Whether to import the custom routes from peer network. The default value is
2569 # false.
2570 &quot;importSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are imported. The default value
2571 # is false.IPv4
2572 # special-use ranges are always
2573 # imported from peers and are not controlled by this field.
2574 &quot;name&quot;: &quot;A String&quot;, # Name of this peering. Provided by the client when the peering is created.
2575 # The name must comply withRFC1035.
2576 # Specifically, the name must be 1-63 characters long and match regular
2577 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
2578 # lowercase letter, and all the following characters must be a dash,
2579 # lowercase letter, or digit, except the last character, which cannot be a
2580 # dash.
2581 &quot;network&quot;: &quot;A String&quot;, # The URL of the peer network. It can be either full URL or partial URL. The
2582 # peer network may belong to a different project. If the partial URL does not
2583 # contain project, it is assumed that the peer network is in the same project
2584 # as the current network.
2585 &quot;peerMtu&quot;: 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
2586 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are allowed to be imported or
2587 # exported between peer networks. The default value is IPV4_ONLY.
2588 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State for the peering.
2589 &quot;stateDetails&quot;: &quot;A String&quot;, # Output only. [Output Only] Details about the current state of the peering.
2590 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the semantics for updates and deletes to the
2591 # peering connection configuration.
2592 },
2593 ],
2594 &quot;routingConfig&quot;: { # A routing configuration attached to a network resource. The message # The network-level routing configuration for this network. Used by Cloud
2595 # Router to determine what type of network-wide routing behavior to enforce.
2596 # includes the list of routers associated with the network, and a flag
2597 # indicating the type of routing behavior to enforce network-wide.
2598 &quot;bgpAlwaysCompareMed&quot;: True or False, # Enable comparison of Multi-Exit Discriminators (MED) across routes with
2599 # different neighbor ASNs when using the STANDARD BGP best path selection
2600 # algorithm.
2601 &quot;bgpBestPathSelectionMode&quot;: &quot;A String&quot;, # The BGP best path selection algorithm to be employed within this network
2602 # for dynamic routes learned by Cloud Routers. Can be LEGACY
2603 # (default) or STANDARD.
2604 &quot;bgpInterRegionCost&quot;: &quot;A String&quot;, # Allows to define a preferred approach for handling inter-region cost in
2605 # the selection process when using the STANDARD BGP best path
2606 # selection algorithm. Can be DEFAULT orADD_COST_TO_MED.
2607 &quot;effectiveBgpAlwaysCompareMed&quot;: True or False, # Output only. [Output Only] Effective value of the bgp_always_compare_med
2608 # field.
2609 &quot;effectiveBgpInterRegionCost&quot;: &quot;A String&quot;, # Output only. [Output Only] Effective value of the bgp_inter_region_cost
2610 # field.
2611 &quot;routingMode&quot;: &quot;A String&quot;, # The network-wide routing mode to use. If set to REGIONAL,
2612 # this network&#x27;s Cloud Routers will only advertise routes with subnets
2613 # of this network in the same region as the router. If set toGLOBAL, this network&#x27;s Cloud Routers will advertise
2614 # routes with all subnets of this network, across regions.
2615 },
2616 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
2617 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
2618 &quot;subnetworks&quot;: [ # [Output Only] Server-defined fully-qualified URLs for all subnetworks
2619 # in this VPC network.
2620 &quot;A String&quot;,
2621 ],
2622 },
2623 ],
2624 &quot;kind&quot;: &quot;compute#networkList&quot;, # Output only. [Output Only] Type of resource. Always compute#networkList for
2625 # lists of networks.
2626 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
2627 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
2628 # the query parameter pageToken in the next list request.
2629 # Subsequent list requests will have their own nextPageToken to
2630 # continue paging through the results.
2631 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
2632 &quot;warning&quot;: { # [Output Only] Informational warning message.
2633 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2634 # Engine returns NO_RESULTS_ON_PAGE if there
2635 # are no results in the response.
2636 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2637 # value format. For example:
2638 #
2639 # &quot;data&quot;: [
2640 # {
2641 # &quot;key&quot;: &quot;scope&quot;,
2642 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2643 # }
2644 {
2645 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2646 # returned. For example, for warnings where there are no results in a list
2647 # request for a particular zone, this key might be scope and
2648 # the key value might be the zone name. Other examples might be a key
2649 # indicating a deprecated resource and a suggested replacement, or a
2650 # warning about invalid network settings (for example, if an instance
2651 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2652 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2653 },
2654 ],
2655 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2656 },
2657 }</pre>
2658 </div>
2659
2660 <div class="method">
2661 <code class="details" id="listPeeringRoutes">listPeeringRoutes(project, network, direction=None, filter=None, maxResults=None, orderBy=None, pageToken=None, peeringName=None, region=None, returnPartialSuccess=None, x__xgafv=None)</code>
2662 <pre>Lists the peering routes exchanged over peering connection.
2663
2664 Args:
2665 project: string, Project ID for this request. (required)
2666 network: string, Name of the network for this request. (required)
2667 direction: string, The direction of the exchanged routes.
2668 Allowed values
2669 INCOMING - For routes exported from peer network.
2670 OUTGOING - For routes exported from local network.
2671 filter: string, A filter expression that filters resources listed in the response. Most
2672 Compute resources support two types of filter expressions:
2673 expressions that support regular expressions and expressions that follow
2674 API improvement proposal AIP-160.
2675 These two types of filter expressions cannot be mixed in one request.
2676
2677 If you want to use AIP-160, your expression must specify the field name, an
2678 operator, and the value that you want to use for filtering. The value
2679 must be a string, a number, or a boolean. The operator
2680 must be either `=`, `!=`, `&gt;`, `&lt;`, `&lt;=`, `&gt;=` or `:`.
2681
2682 For example, if you are filtering Compute Engine instances, you can
2683 exclude instances named `example-instance` by specifying
2684 `name != example-instance`.
2685
2686 The `:*` comparison can be used to test whether a key has been defined.
2687 For example, to find all objects with `owner` label use:
2688 ```
2689 labels.owner:*
2690 ```
2691
2692 You can also filter nested fields. For example, you could specify
2693 `scheduling.automaticRestart = false` to include instances only
2694 if they are not scheduled for automatic restarts. You can use filtering
2695 on nested fields to filter based onresource labels.
2696
2697 To filter on multiple expressions, provide each separate expression within
2698 parentheses. For example:
2699 ```
2700 (scheduling.automaticRestart = true)
2701 (cpuPlatform = &quot;Intel Skylake&quot;)
2702 ```
2703 By default, each expression is an `AND` expression. However, you
2704 can include `AND` and `OR` expressions explicitly.
2705 For example:
2706 ```
2707 (cpuPlatform = &quot;Intel Skylake&quot;) OR
2708 (cpuPlatform = &quot;Intel Broadwell&quot;) AND
2709 (scheduling.automaticRestart = true)
2710 ```
2711
2712 If you want to use a regular expression, use the `eq` (equal) or `ne`
2713 (not equal) operator against a single un-parenthesized expression with or
2714 without quotes or against multiple parenthesized expressions. Examples:
2715
2716 `fieldname eq unquoted literal`
2717 `fieldname eq &#x27;single quoted literal&#x27;`
2718 `fieldname eq &quot;double quoted literal&quot;`
2719 `(fieldname1 eq literal) (fieldname2 ne &quot;literal&quot;)`
2720
2721 The literal value is interpreted as a regular expression using GoogleRE2 library syntax.
2722 The literal value must match the entire field.
2723
2724 For example, to filter for instances that do not end with name &quot;instance&quot;,
2725 you would use `name ne .*instance`.
2726
2727 You cannot combine constraints on multiple fields using regular
2728 expressions.
2729 maxResults: integer, The maximum number of results per page that should be returned.
2730 If the number of available results is larger than `maxResults`,
2731 Compute Engine returns a `nextPageToken` that can be used to get
2732 the next page of results in subsequent list requests. Acceptable values are
2733 `0` to `500`, inclusive. (Default: `500`)
2734 orderBy: string, Sorts list results by a certain order. By default, results
2735 are returned in alphanumerical order based on the resource name.
2736
2737 You can also sort results in descending order based on the creation
2738 timestamp using `orderBy=&quot;creationTimestamp desc&quot;`. This sorts
2739 results based on the `creationTimestamp` field in
2740 reverse chronological order (newest result first). Use this to sort
2741 resources like operations so that the newest operation is returned first.
2742
2743 Currently, only sorting by `name` or
2744 `creationTimestamp desc` is supported.
2745 pageToken: string, Specifies a page token to use. Set `pageToken` to the
2746 `nextPageToken` returned by a previous list request to get
2747 the next page of results.
2748 peeringName: string, The response will show routes exchanged over the given peering connection.
2749 region: string, The region of the request. The response will include all subnet routes,
2750 static routes and dynamic routes in the region.
2751 returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case
2752 of failure. The default value is false.
2753
2754 For example, when partial success behavior is enabled, aggregatedList for a
2755 single zone scope either returns all resources in the zone or no resources,
2756 with an error code.
2757 x__xgafv: string, V1 error format.
2758 Allowed values
2759 1 - v1 error format
2760 2 - v2 error format
2761
2762 Returns:
2763 An object of the form:
2764
2765 {
2766 &quot;id&quot;: &quot;A String&quot;, # [Output Only] Unique identifier for the resource; defined by the server.
2767 &quot;items&quot;: [ # A list of ExchangedPeeringRoute resources.
2768 {
2769 &quot;destRange&quot;: &quot;A String&quot;, # The destination range of the route.
2770 &quot;imported&quot;: True or False, # True if the peering route has been imported from a peer. The actual import
2771 # happens if the field networkPeering.importCustomRoutes is true
2772 # for this network, and networkPeering.exportCustomRoutes is
2773 # true for the peer network, and the import does not result in a route
2774 # conflict.
2775 &quot;nextHopRegion&quot;: &quot;A String&quot;, # The region of peering route next hop, only applies to dynamic routes.
2776 &quot;priority&quot;: 42, # The priority of the peering route.
2777 &quot;type&quot;: &quot;A String&quot;, # The type of the peering route.
2778 },
2779 ],
2780 &quot;kind&quot;: &quot;compute#exchangedPeeringRoutesList&quot;, # Output only. [Output Only] Type of resource. Alwayscompute#exchangedPeeringRoutesList for exchanged peering
2781 # routes lists.
2782 &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for
2783 # list requests. If the number of results is larger thanmaxResults, use the nextPageToken as a value for
2784 # the query parameter pageToken in the next list request.
2785 # Subsequent list requests will have their own nextPageToken to
2786 # continue paging through the results.
2787 &quot;selfLink&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource.
2788 &quot;warning&quot;: { # [Output Only] Informational warning message.
2789 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
2790 # Engine returns NO_RESULTS_ON_PAGE if there
2791 # are no results in the response.
2792 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
2793 # value format. For example:
2794 #
2795 # &quot;data&quot;: [
2796 # {
2797 # &quot;key&quot;: &quot;scope&quot;,
2798 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
2799 # }
2800 {
2801 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
2802 # returned. For example, for warnings where there are no results in a list
2803 # request for a particular zone, this key might be scope and
2804 # the key value might be the zone name. Other examples might be a key
2805 # indicating a deprecated resource and a suggested replacement, or a
2806 # warning about invalid network settings (for example, if an instance
2807 # attempts to perform IP forwarding but is not enabled for IP forwarding).
2808 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
2809 },
2810 ],
2811 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
2812 },
2813 }</pre>
2814 </div>
2815
2816 <div class="method">
2817 <code class="details" id="listPeeringRoutes_next">listPeeringRoutes_next()</code>
2818 <pre>Retrieves the next page of results.
2819
2820 Args:
2821 previous_request: The request for the previous page. (required)
2822 previous_response: The response from the request for the previous page. (required)
2823
2824 Returns:
2825 A request object that you can call &#x27;execute()&#x27; on to request the next
2826 page. Returns None if there are no more items in the collection.
2827 </pre>
2828 </div>
2829
2830 <div class="method">
2831 <code class="details" id="list_next">list_next()</code>
2832 <pre>Retrieves the next page of results.
2833
2834 Args:
2835 previous_request: The request for the previous page. (required)
2836 previous_response: The response from the request for the previous page. (required)
2837
2838 Returns:
2839 A request object that you can call &#x27;execute()&#x27; on to request the next
2840 page. Returns None if there are no more items in the collection.
2841 </pre>
2842 </div>
2843
2844 <div class="method">
2845 <code class="details" id="patch">patch(project, network, body=None, requestId=None, x__xgafv=None)</code>
2846 <pre>Patches the specified network with the data included in the request.
2847 Only routingConfig can be modified.
2848
2849 Args:
2850 project: string, Project ID for this request. (required)
2851 network: string, Name of the network to update. (required)
2852 body: object, The request body.
2853 The object takes the form of:
2854
2855 { # Represents a VPC Network resource.
2856 #
2857 # Networks connect resources to each other and to the internet. For more
2858 # information, readVirtual Private Cloud (VPC) Network.
2859 &quot;IPv4Range&quot;: &quot;A String&quot;, # Deprecated in favor of subnet mode networks.
2860 # The range of internal addresses that are legal on this network. This
2861 # range is aCIDR specification, for example:192.168.0.0/16. Provided by the client when the network is
2862 # created.
2863 &quot;autoCreateSubnetworks&quot;: True or False, # Must be set to create a VPC network. If not set, a legacy network is
2864 # created.
2865 #
2866 # When set to true, the VPC network is created in auto mode.
2867 # When set to false, the VPC network is created in custom mode.
2868 #
2869 # An auto mode VPC network starts with one subnet per region. Each subnet
2870 # has a predetermined range as described inAuto mode VPC network IP ranges.
2871 #
2872 # For custom mode VPC networks, you can add subnets using the subnetworksinsert
2873 # method.
2874 &quot;creationTimestamp&quot;: &quot;A String&quot;, # Output only. [Output Only] Creation timestamp inRFC3339
2875 # text format.
2876 &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this field when you
2877 # create the resource.
2878 &quot;enableUlaInternalIpv6&quot;: True or False, # Enable ULA internal ipv6 on this network. Enabling this feature will assign
2879 # a /48 from google defined ULA prefix fd20::/20.
2880 # .
2881 &quot;firewallPolicy&quot;: &quot;A String&quot;, # Output only. [Output Only] URL of the firewall policy the network is associated with.
2882 &quot;gatewayIPv4&quot;: &quot;A String&quot;, # [Output Only] The gateway address for default routing out of the network,
2883 # selected by Google Cloud.
2884 &quot;id&quot;: &quot;A String&quot;, # Output only. [Output Only] The unique identifier for the resource. This identifier is
2885 # defined by the server.
2886 &quot;internalIpv6Range&quot;: &quot;A String&quot;, # When enabling ula internal ipv6, caller optionally can specify the /48
2887 # range they want from the google defined ULA prefix fd20::/20. The input
2888 # must be a valid /48 ULA IPv6 address and must be within the fd20::/20.
2889 # Operation will fail if the speficied /48 is already in used by another
2890 # resource. If the field is not speficied, then a /48 range will be randomly
2891 # allocated from fd20::/20 and returned via this field.
2892 # .
2893 &quot;kind&quot;: &quot;compute#network&quot;, # Output only. [Output Only] Type of the resource. Always compute#network for
2894 # networks.
2895 &quot;mtu&quot;: 42, # Maximum Transmission Unit in bytes.
2896 # The minimum value for this field is 1300 and the maximum value is 8896.
2897 # The suggested value is 1500, which is the default MTU used on the
2898 # Internet, or 8896 if you want to use Jumbo frames. If unspecified, the
2899 # value defaults to 1460.
2900 &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created.
2901 # The name must be 1-63 characters long, and comply withRFC1035.
2902 # Specifically, the name must be 1-63 characters long and match the regular
2903 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
2904 # lowercase letter, and all following characters (except for the last
2905 # character) must be a dash, lowercase letter, or digit. The last character
2906 # must be a lowercase letter or digit.
2907 &quot;networkFirewallPolicyEnforcementOrder&quot;: &quot;A String&quot;, # The network firewall policy enforcement order. Can be either
2908 # AFTER_CLASSIC_FIREWALL or BEFORE_CLASSIC_FIREWALL. Defaults to
2909 # AFTER_CLASSIC_FIREWALL if the field is not specified.
2910 &quot;networkProfile&quot;: &quot;A String&quot;, # A full or partial URL of the network profile to apply to this network.
2911 # This field can be set only at resource creation time. For example, the
2912 # following are valid URLs:
2913 #
2914 # - https://www.googleapis.com/compute/{api_version}/projects/{project_id}/global/networkProfiles/{network_profile_name}
2915 # - projects/{project_id}/global/networkProfiles/{network_profile_name}
2916 &quot;params&quot;: { # Additional network parameters. # Input only. [Input Only] Additional params passed with the request, but not persisted
2917 # as part of resource payload.
2918 &quot;resourceManagerTags&quot;: { # Tag keys/values directly bound to this resource.
2919 # Tag keys and values have the same definition as resource
2920 # manager tags. The field is allowed for INSERT
2921 # only. The keys/values to set on the resource should be specified in
2922 # either ID { : } or Namespaced format
2923 # { : }.
2924 # For example the following are valid inputs:
2925 # * {&quot;tagKeys/333&quot; : &quot;tagValues/444&quot;, &quot;tagKeys/123&quot; : &quot;tagValues/456&quot;}
2926 # * {&quot;123/environment&quot; : &quot;production&quot;, &quot;345/abc&quot; : &quot;xyz&quot;}
2927 # Note:
2928 # * Invalid combinations of ID &amp; namespaced format is not supported. For
2929 # instance: {&quot;123/environment&quot; : &quot;tagValues/444&quot;} is invalid.
2930 &quot;a_key&quot;: &quot;A String&quot;,
2931 },
2932 },
2933 &quot;peerings&quot;: [ # Output only. [Output Only] A list of network peerings for the resource.
2934 { # A network peering attached to a network resource. The message includes the
2935 # peering name, peer network, peering state, and a flag indicating whether
2936 # Google Compute Engine should automatically create routes for the peering.
2937 &quot;autoCreateRoutes&quot;: True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
2938 # Indicates whether full mesh connectivity is created and managed
2939 # automatically between peered networks. Currently this field should always
2940 # be true since Google Compute Engine will automatically create and manage
2941 # subnetwork routes between two networks when peering state isACTIVE.
2942 &quot;connectionStatus&quot;: { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
2943 # as a whole.
2944 # local peering. This field provides information about the effective settings
2945 # for the connection as a whole, including pending delete/update requests for
2946 # CONSENSUS peerings.
2947 &quot;consensusState&quot;: { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
2948 # and delete for a consensus peering connection.
2949 # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
2950 # strategy to CONSENSUS.
2951 &quot;deleteStatus&quot;: &quot;A String&quot;, # The status of the delete request.
2952 &quot;updateStatus&quot;: &quot;A String&quot;, # The status of the update request.
2953 },
2954 &quot;trafficConfiguration&quot;: { # The active connectivity settings for the peering connection based on the
2955 # settings of the network peerings.
2956 &quot;exportCustomRoutesToPeer&quot;: True or False, # Whether custom routes are being exported to the peer network.
2957 &quot;exportSubnetRoutesWithPublicIpToPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being exported to the
2958 # peer network.
2959 &quot;importCustomRoutesFromPeer&quot;: True or False, # Whether custom routes are being imported from the peer network.
2960 &quot;importSubnetRoutesWithPublicIpFromPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being imported
2961 # from the peer network.
2962 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are being imported or
2963 # exported between peer networks.
2964 },
2965 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the update/delete semantics for this
2966 # peering connection.
2967 },
2968 &quot;exchangeSubnetRoutes&quot;: True or False, # Indicates whether full mesh connectivity is created and managed
2969 # automatically between peered networks. Currently this field should always
2970 # be true since Google Compute Engine will automatically create and manage
2971 # subnetwork routes between two networks when peering state isACTIVE.
2972 &quot;exportCustomRoutes&quot;: True or False, # Whether to export the custom routes to peer network. The default value is
2973 # false.
2974 &quot;exportSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are exported. The default value
2975 # is true, all subnet routes are exported.IPv4
2976 # special-use ranges are always
2977 # exported to peers and are not controlled by this field.
2978 &quot;importCustomRoutes&quot;: True or False, # Whether to import the custom routes from peer network. The default value is
2979 # false.
2980 &quot;importSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are imported. The default value
2981 # is false.IPv4
2982 # special-use ranges are always
2983 # imported from peers and are not controlled by this field.
2984 &quot;name&quot;: &quot;A String&quot;, # Name of this peering. Provided by the client when the peering is created.
2985 # The name must comply withRFC1035.
2986 # Specifically, the name must be 1-63 characters long and match regular
2987 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
2988 # lowercase letter, and all the following characters must be a dash,
2989 # lowercase letter, or digit, except the last character, which cannot be a
2990 # dash.
2991 &quot;network&quot;: &quot;A String&quot;, # The URL of the peer network. It can be either full URL or partial URL. The
2992 # peer network may belong to a different project. If the partial URL does not
2993 # contain project, it is assumed that the peer network is in the same project
2994 # as the current network.
2995 &quot;peerMtu&quot;: 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
2996 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are allowed to be imported or
2997 # exported between peer networks. The default value is IPV4_ONLY.
2998 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State for the peering.
2999 &quot;stateDetails&quot;: &quot;A String&quot;, # Output only. [Output Only] Details about the current state of the peering.
3000 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the semantics for updates and deletes to the
3001 # peering connection configuration.
3002 },
3003 ],
3004 &quot;routingConfig&quot;: { # A routing configuration attached to a network resource. The message # The network-level routing configuration for this network. Used by Cloud
3005 # Router to determine what type of network-wide routing behavior to enforce.
3006 # includes the list of routers associated with the network, and a flag
3007 # indicating the type of routing behavior to enforce network-wide.
3008 &quot;bgpAlwaysCompareMed&quot;: True or False, # Enable comparison of Multi-Exit Discriminators (MED) across routes with
3009 # different neighbor ASNs when using the STANDARD BGP best path selection
3010 # algorithm.
3011 &quot;bgpBestPathSelectionMode&quot;: &quot;A String&quot;, # The BGP best path selection algorithm to be employed within this network
3012 # for dynamic routes learned by Cloud Routers. Can be LEGACY
3013 # (default) or STANDARD.
3014 &quot;bgpInterRegionCost&quot;: &quot;A String&quot;, # Allows to define a preferred approach for handling inter-region cost in
3015 # the selection process when using the STANDARD BGP best path
3016 # selection algorithm. Can be DEFAULT orADD_COST_TO_MED.
3017 &quot;effectiveBgpAlwaysCompareMed&quot;: True or False, # Output only. [Output Only] Effective value of the bgp_always_compare_med
3018 # field.
3019 &quot;effectiveBgpInterRegionCost&quot;: &quot;A String&quot;, # Output only. [Output Only] Effective value of the bgp_inter_region_cost
3020 # field.
3021 &quot;routingMode&quot;: &quot;A String&quot;, # The network-wide routing mode to use. If set to REGIONAL,
3022 # this network&#x27;s Cloud Routers will only advertise routes with subnets
3023 # of this network in the same region as the router. If set toGLOBAL, this network&#x27;s Cloud Routers will advertise
3024 # routes with all subnets of this network, across regions.
3025 },
3026 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3027 &quot;selfLinkWithId&quot;: &quot;A String&quot;, # Output only. [Output Only] Server-defined URL for this resource with the resource id.
3028 &quot;subnetworks&quot;: [ # [Output Only] Server-defined fully-qualified URLs for all subnetworks
3029 # in this VPC network.
3030 &quot;A String&quot;,
3031 ],
3032 }
3033
3034 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3035 that if you must retry your request, the server will know to ignore the
3036 request if it has already been completed.
3037
3038 For example, consider a situation where you make an initial request and
3039 the request times out. If you make the request again with the same
3040 request ID, the server can check if original operation with the same
3041 request ID was received, and if so, will ignore the second request. This
3042 prevents clients from accidentally creating duplicate commitments.
3043
3044 The request ID must be
3045 a valid UUID with the exception that zero UUID is not supported
3046 (00000000-0000-0000-0000-000000000000).
3047 x__xgafv: string, V1 error format.
3048 Allowed values
3049 1 - v1 error format
3050 2 - v2 error format
3051
3052 Returns:
3053 An object of the form:
3054
3055 { # Represents an Operation resource.
3056 #
3057 # Google Compute Engine has three Operation resources:
3058 #
3059 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
3060 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
3061 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
3062 #
3063 # You can use an operation resource to manage asynchronous API requests.
3064 # For more information, readHandling
3065 # API responses.
3066 #
3067 # Operations can be global, regional or zonal.
3068 #
3069 # - For global operations, use the `globalOperations`
3070 # resource.
3071 # - For regional operations, use the
3072 # `regionOperations` resource.
3073 # - For zonal operations, use
3074 # the `zoneOperations` resource.
3075 #
3076 #
3077 #
3078 # For more information, read
3079 # Global, Regional, and Zonal Resources.
3080 #
3081 # Note that completed Operation resources have a limited
3082 # retention period.
3083 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3084 # Not present otherwise.
3085 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3086 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3087 # set when the operation is created.
3088 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3089 # text format.
3090 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3091 # this field will be populated.
3092 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3093 # operation.
3094 {
3095 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3096 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3097 # details. There is a set of defined message types to use for providing
3098 # details.The syntax depends on the error code. For example,
3099 # QuotaExceededInfo will have details when the error code is
3100 # QUOTA_EXCEEDED.
3101 {
3102 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3103 #
3104 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3105 # is not enabled:
3106 #
3107 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3108 # &quot;domain&quot;: &quot;googleapis.com&quot;
3109 # &quot;metadata&quot;: {
3110 # &quot;resource&quot;: &quot;projects/123&quot;,
3111 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3112 # }
3113 # }
3114 #
3115 # This response indicates that the pubsub.googleapis.com API is not enabled.
3116 #
3117 # Example of an error that is returned when attempting to create a Spanner
3118 # instance in a region that is out of stock:
3119 #
3120 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3121 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3122 # &quot;metadata&quot;: {
3123 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3124 # }
3125 # }
3126 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3127 # is typically the registered service name of the tool or product that
3128 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3129 # generated by some common infrastructure, the error domain must be a
3130 # globally unique value that identifies the infrastructure. For Google API
3131 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3132 &quot;metadatas&quot;: { # Additional structured details about this error.
3133 #
3134 # Keys must match a regular expression of `a-z+` but should
3135 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3136 # length. When identifying the current value of an exceeded limit, the units
3137 # should be contained in the key, not the value. For example, rather than
3138 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3139 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3140 # instances that can be created in a single (batch) request.
3141 &quot;a_key&quot;: &quot;A String&quot;,
3142 },
3143 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3144 # proximate cause of the error. Error reasons are unique within a particular
3145 # domain of errors. This should be at most 63 characters and match a
3146 # regular expression of `A-Z+[A-Z0-9]`, which represents
3147 # UPPER_SNAKE_CASE.
3148 },
3149 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3150 #
3151 # For example, if a quota check failed with an error indicating the calling
3152 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3153 # directly to the right place in the developer console to flip the bit.
3154 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3155 { # Describes a URL link.
3156 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3157 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3158 },
3159 ],
3160 },
3161 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3162 # which can be attached to an RPC error.
3163 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3164 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3165 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3166 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3167 },
3168 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3169 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3170 &quot;a_key&quot;: &quot;A String&quot;,
3171 },
3172 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3173 # type or metric.
3174 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3175 # or metric.
3176 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3177 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3178 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3179 },
3180 },
3181 ],
3182 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3183 # This property is optional.
3184 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3185 },
3186 ],
3187 },
3188 &quot;getVersionOperationMetadata&quot;: {
3189 &quot;inlineSbomInfo&quot;: {
3190 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3191 # appropriate identifiers.
3192 &quot;a_key&quot;: &quot;A String&quot;,
3193 },
3194 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3195 # identifiers.
3196 &quot;a_key&quot;: &quot;A String&quot;,
3197 },
3198 },
3199 },
3200 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3201 # message that was returned, such as `NOT FOUND`.
3202 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3203 # status code that was returned. For example, a `404` means the
3204 # resource was not found.
3205 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3206 # defined by the server.
3207 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3208 # This value is inRFC3339
3209 # text format.
3210 &quot;instancesBulkInsertOperationMetadata&quot;: {
3211 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3212 # Example key: zones/us-central1-a
3213 &quot;a_key&quot;: {
3214 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3215 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3216 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3217 # error.
3218 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3219 # if the flow is rolling forward or rolling back.
3220 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3221 },
3222 },
3223 },
3224 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3225 # Operation resources.
3226 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3227 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3228 # group of operations results from a `bulkInsert` API request.
3229 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3230 # `update`, or `delete`, and so on.
3231 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3232 # There is no requirement that this be linear or support any granularity of
3233 # operations. This should not be used to guess when the operation will be
3234 # complete. This number should monotonically increase as the operation
3235 # progresses.
3236 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3237 # applicable when performing regional operations.
3238 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3239 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3240 # this field will contain information on all underlying zonal actions and
3241 # their state.
3242 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3243 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3244 # Example key: zones/us-central1-a
3245 &quot;a_key&quot;: {
3246 &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
3247 # populated.
3248 # different programming environments, including REST APIs and RPC APIs. It is
3249 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3250 # three pieces of data: error code, error message, and error details.
3251 #
3252 # You can find out more about this error model and how to work with it in the
3253 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3254 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3255 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3256 # message types for APIs to use.
3257 {
3258 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3259 },
3260 ],
3261 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3262 # user-facing error message should be localized and sent in the
3263 # google.rpc.Status.details field, or localized by the client.
3264 },
3265 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3266 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3267 },
3268 },
3269 },
3270 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3271 # This value is inRFC3339
3272 # text format.
3273 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3274 # following:
3275 # `PENDING`, `RUNNING`, or `DONE`.
3276 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3277 # operation.
3278 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3279 # of the target resource.
3280 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3281 # operations related to creating a snapshot, this points to the disk
3282 # that the snapshot was created from.
3283 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3284 # `[email protected]` or
3285 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3286 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3287 # operation, this field will be populated.
3288 {
3289 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3290 # Engine returns NO_RESULTS_ON_PAGE if there
3291 # are no results in the response.
3292 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3293 # value format. For example:
3294 #
3295 # &quot;data&quot;: [
3296 # {
3297 # &quot;key&quot;: &quot;scope&quot;,
3298 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3299 # }
3300 {
3301 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3302 # returned. For example, for warnings where there are no results in a list
3303 # request for a particular zone, this key might be scope and
3304 # the key value might be the zone name. Other examples might be a key
3305 # indicating a deprecated resource and a suggested replacement, or a
3306 # warning about invalid network settings (for example, if an instance
3307 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3308 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3309 },
3310 ],
3311 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3312 },
3313 ],
3314 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3315 # applicable when performing per-zone operations.
3316 }</pre>
3317 </div>
3318
3319 <div class="method">
3320 <code class="details" id="removePeering">removePeering(project, network, body=None, requestId=None, x__xgafv=None)</code>
3321 <pre>Removes a peering from the specified network.
3322
3323 Args:
3324 project: string, Project ID for this request. (required)
3325 network: string, Name of the network resource to remove peering from. (required)
3326 body: object, The request body.
3327 The object takes the form of:
3328
3329 {
3330 &quot;name&quot;: &quot;A String&quot;, # Name of the peering, which should conform to RFC1035.
3331 }
3332
3333 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3334 that if you must retry your request, the server will know to ignore the
3335 request if it has already been completed.
3336
3337 For example, consider a situation where you make an initial request and
3338 the request times out. If you make the request again with the same
3339 request ID, the server can check if original operation with the same
3340 request ID was received, and if so, will ignore the second request. This
3341 prevents clients from accidentally creating duplicate commitments.
3342
3343 The request ID must be
3344 a valid UUID with the exception that zero UUID is not supported
3345 (00000000-0000-0000-0000-000000000000).
3346 x__xgafv: string, V1 error format.
3347 Allowed values
3348 1 - v1 error format
3349 2 - v2 error format
3350
3351 Returns:
3352 An object of the form:
3353
3354 { # Represents an Operation resource.
3355 #
3356 # Google Compute Engine has three Operation resources:
3357 #
3358 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
3359 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
3360 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
3361 #
3362 # You can use an operation resource to manage asynchronous API requests.
3363 # For more information, readHandling
3364 # API responses.
3365 #
3366 # Operations can be global, regional or zonal.
3367 #
3368 # - For global operations, use the `globalOperations`
3369 # resource.
3370 # - For regional operations, use the
3371 # `regionOperations` resource.
3372 # - For zonal operations, use
3373 # the `zoneOperations` resource.
3374 #
3375 #
3376 #
3377 # For more information, read
3378 # Global, Regional, and Zonal Resources.
3379 #
3380 # Note that completed Operation resources have a limited
3381 # retention period.
3382 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3383 # Not present otherwise.
3384 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3385 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3386 # set when the operation is created.
3387 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3388 # text format.
3389 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3390 # this field will be populated.
3391 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3392 # operation.
3393 {
3394 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3395 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3396 # details. There is a set of defined message types to use for providing
3397 # details.The syntax depends on the error code. For example,
3398 # QuotaExceededInfo will have details when the error code is
3399 # QUOTA_EXCEEDED.
3400 {
3401 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3402 #
3403 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3404 # is not enabled:
3405 #
3406 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3407 # &quot;domain&quot;: &quot;googleapis.com&quot;
3408 # &quot;metadata&quot;: {
3409 # &quot;resource&quot;: &quot;projects/123&quot;,
3410 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3411 # }
3412 # }
3413 #
3414 # This response indicates that the pubsub.googleapis.com API is not enabled.
3415 #
3416 # Example of an error that is returned when attempting to create a Spanner
3417 # instance in a region that is out of stock:
3418 #
3419 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3420 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3421 # &quot;metadata&quot;: {
3422 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3423 # }
3424 # }
3425 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3426 # is typically the registered service name of the tool or product that
3427 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3428 # generated by some common infrastructure, the error domain must be a
3429 # globally unique value that identifies the infrastructure. For Google API
3430 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3431 &quot;metadatas&quot;: { # Additional structured details about this error.
3432 #
3433 # Keys must match a regular expression of `a-z+` but should
3434 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3435 # length. When identifying the current value of an exceeded limit, the units
3436 # should be contained in the key, not the value. For example, rather than
3437 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3438 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3439 # instances that can be created in a single (batch) request.
3440 &quot;a_key&quot;: &quot;A String&quot;,
3441 },
3442 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3443 # proximate cause of the error. Error reasons are unique within a particular
3444 # domain of errors. This should be at most 63 characters and match a
3445 # regular expression of `A-Z+[A-Z0-9]`, which represents
3446 # UPPER_SNAKE_CASE.
3447 },
3448 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3449 #
3450 # For example, if a quota check failed with an error indicating the calling
3451 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3452 # directly to the right place in the developer console to flip the bit.
3453 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3454 { # Describes a URL link.
3455 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3456 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3457 },
3458 ],
3459 },
3460 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3461 # which can be attached to an RPC error.
3462 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3463 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3464 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3465 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3466 },
3467 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3468 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3469 &quot;a_key&quot;: &quot;A String&quot;,
3470 },
3471 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3472 # type or metric.
3473 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3474 # or metric.
3475 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3476 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3477 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3478 },
3479 },
3480 ],
3481 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3482 # This property is optional.
3483 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3484 },
3485 ],
3486 },
3487 &quot;getVersionOperationMetadata&quot;: {
3488 &quot;inlineSbomInfo&quot;: {
3489 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3490 # appropriate identifiers.
3491 &quot;a_key&quot;: &quot;A String&quot;,
3492 },
3493 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3494 # identifiers.
3495 &quot;a_key&quot;: &quot;A String&quot;,
3496 },
3497 },
3498 },
3499 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3500 # message that was returned, such as `NOT FOUND`.
3501 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3502 # status code that was returned. For example, a `404` means the
3503 # resource was not found.
3504 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3505 # defined by the server.
3506 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3507 # This value is inRFC3339
3508 # text format.
3509 &quot;instancesBulkInsertOperationMetadata&quot;: {
3510 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3511 # Example key: zones/us-central1-a
3512 &quot;a_key&quot;: {
3513 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3514 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3515 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3516 # error.
3517 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3518 # if the flow is rolling forward or rolling back.
3519 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3520 },
3521 },
3522 },
3523 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3524 # Operation resources.
3525 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3526 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3527 # group of operations results from a `bulkInsert` API request.
3528 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3529 # `update`, or `delete`, and so on.
3530 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3531 # There is no requirement that this be linear or support any granularity of
3532 # operations. This should not be used to guess when the operation will be
3533 # complete. This number should monotonically increase as the operation
3534 # progresses.
3535 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3536 # applicable when performing regional operations.
3537 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3538 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3539 # this field will contain information on all underlying zonal actions and
3540 # their state.
3541 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3542 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3543 # Example key: zones/us-central1-a
3544 &quot;a_key&quot;: {
3545 &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
3546 # populated.
3547 # different programming environments, including REST APIs and RPC APIs. It is
3548 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3549 # three pieces of data: error code, error message, and error details.
3550 #
3551 # You can find out more about this error model and how to work with it in the
3552 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3553 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3554 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3555 # message types for APIs to use.
3556 {
3557 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3558 },
3559 ],
3560 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3561 # user-facing error message should be localized and sent in the
3562 # google.rpc.Status.details field, or localized by the client.
3563 },
3564 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3565 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3566 },
3567 },
3568 },
3569 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3570 # This value is inRFC3339
3571 # text format.
3572 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3573 # following:
3574 # `PENDING`, `RUNNING`, or `DONE`.
3575 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3576 # operation.
3577 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3578 # of the target resource.
3579 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3580 # operations related to creating a snapshot, this points to the disk
3581 # that the snapshot was created from.
3582 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3583 # `[email protected]` or
3584 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3585 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3586 # operation, this field will be populated.
3587 {
3588 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3589 # Engine returns NO_RESULTS_ON_PAGE if there
3590 # are no results in the response.
3591 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3592 # value format. For example:
3593 #
3594 # &quot;data&quot;: [
3595 # {
3596 # &quot;key&quot;: &quot;scope&quot;,
3597 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3598 # }
3599 {
3600 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3601 # returned. For example, for warnings where there are no results in a list
3602 # request for a particular zone, this key might be scope and
3603 # the key value might be the zone name. Other examples might be a key
3604 # indicating a deprecated resource and a suggested replacement, or a
3605 # warning about invalid network settings (for example, if an instance
3606 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3607 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3608 },
3609 ],
3610 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3611 },
3612 ],
3613 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3614 # applicable when performing per-zone operations.
3615 }</pre>
3616 </div>
3617
3618 <div class="method">
3619 <code class="details" id="requestRemovePeering">requestRemovePeering(project, network, body=None, requestId=None, x__xgafv=None)</code>
3620 <pre>Requests to remove a peering from the specified network. Applicable only
3621 for PeeringConnection with update_strategy=CONSENSUS.
3622
3623 Args:
3624 project: string, Project ID for this request. (required)
3625 network: string, Name of the network resource to remove peering from. (required)
3626 body: object, The request body.
3627 The object takes the form of:
3628
3629 {
3630 &quot;name&quot;: &quot;A String&quot;, # Name of the peering, which should conform to RFC1035.
3631 }
3632
3633 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3634 that if you must retry your request, the server will know to ignore the
3635 request if it has already been completed.
3636
3637 For example, consider a situation where you make an initial request and
3638 the request times out. If you make the request again with the same
3639 request ID, the server can check if original operation with the same
3640 request ID was received, and if so, will ignore the second request. This
3641 prevents clients from accidentally creating duplicate commitments.
3642
3643 The request ID must be
3644 a valid UUID with the exception that zero UUID is not supported
3645 (00000000-0000-0000-0000-000000000000).
3646 x__xgafv: string, V1 error format.
3647 Allowed values
3648 1 - v1 error format
3649 2 - v2 error format
3650
3651 Returns:
3652 An object of the form:
3653
3654 { # Represents an Operation resource.
3655 #
3656 # Google Compute Engine has three Operation resources:
3657 #
3658 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
3659 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
3660 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
3661 #
3662 # You can use an operation resource to manage asynchronous API requests.
3663 # For more information, readHandling
3664 # API responses.
3665 #
3666 # Operations can be global, regional or zonal.
3667 #
3668 # - For global operations, use the `globalOperations`
3669 # resource.
3670 # - For regional operations, use the
3671 # `regionOperations` resource.
3672 # - For zonal operations, use
3673 # the `zoneOperations` resource.
3674 #
3675 #
3676 #
3677 # For more information, read
3678 # Global, Regional, and Zonal Resources.
3679 #
3680 # Note that completed Operation resources have a limited
3681 # retention period.
3682 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3683 # Not present otherwise.
3684 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3685 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3686 # set when the operation is created.
3687 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3688 # text format.
3689 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3690 # this field will be populated.
3691 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3692 # operation.
3693 {
3694 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3695 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3696 # details. There is a set of defined message types to use for providing
3697 # details.The syntax depends on the error code. For example,
3698 # QuotaExceededInfo will have details when the error code is
3699 # QUOTA_EXCEEDED.
3700 {
3701 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3702 #
3703 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3704 # is not enabled:
3705 #
3706 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3707 # &quot;domain&quot;: &quot;googleapis.com&quot;
3708 # &quot;metadata&quot;: {
3709 # &quot;resource&quot;: &quot;projects/123&quot;,
3710 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
3711 # }
3712 # }
3713 #
3714 # This response indicates that the pubsub.googleapis.com API is not enabled.
3715 #
3716 # Example of an error that is returned when attempting to create a Spanner
3717 # instance in a region that is out of stock:
3718 #
3719 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
3720 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
3721 # &quot;metadata&quot;: {
3722 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
3723 # }
3724 # }
3725 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
3726 # is typically the registered service name of the tool or product that
3727 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
3728 # generated by some common infrastructure, the error domain must be a
3729 # globally unique value that identifies the infrastructure. For Google API
3730 # infrastructure, the error domain is &quot;googleapis.com&quot;.
3731 &quot;metadatas&quot;: { # Additional structured details about this error.
3732 #
3733 # Keys must match a regular expression of `a-z+` but should
3734 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
3735 # length. When identifying the current value of an exceeded limit, the units
3736 # should be contained in the key, not the value. For example, rather than
3737 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
3738 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
3739 # instances that can be created in a single (batch) request.
3740 &quot;a_key&quot;: &quot;A String&quot;,
3741 },
3742 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
3743 # proximate cause of the error. Error reasons are unique within a particular
3744 # domain of errors. This should be at most 63 characters and match a
3745 # regular expression of `A-Z+[A-Z0-9]`, which represents
3746 # UPPER_SNAKE_CASE.
3747 },
3748 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
3749 #
3750 # For example, if a quota check failed with an error indicating the calling
3751 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
3752 # directly to the right place in the developer console to flip the bit.
3753 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
3754 { # Describes a URL link.
3755 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
3756 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
3757 },
3758 ],
3759 },
3760 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
3761 # which can be attached to an RPC error.
3762 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
3763 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
3764 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
3765 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
3766 },
3767 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
3768 &quot;dimensions&quot;: { # The map holding related quota dimensions.
3769 &quot;a_key&quot;: &quot;A String&quot;,
3770 },
3771 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
3772 # type or metric.
3773 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
3774 # or metric.
3775 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
3776 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
3777 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
3778 },
3779 },
3780 ],
3781 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
3782 # This property is optional.
3783 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
3784 },
3785 ],
3786 },
3787 &quot;getVersionOperationMetadata&quot;: {
3788 &quot;inlineSbomInfo&quot;: {
3789 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
3790 # appropriate identifiers.
3791 &quot;a_key&quot;: &quot;A String&quot;,
3792 },
3793 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
3794 # identifiers.
3795 &quot;a_key&quot;: &quot;A String&quot;,
3796 },
3797 },
3798 },
3799 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
3800 # message that was returned, such as `NOT FOUND`.
3801 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
3802 # status code that was returned. For example, a `404` means the
3803 # resource was not found.
3804 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
3805 # defined by the server.
3806 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
3807 # This value is inRFC3339
3808 # text format.
3809 &quot;instancesBulkInsertOperationMetadata&quot;: {
3810 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
3811 # Example key: zones/us-central1-a
3812 &quot;a_key&quot;: {
3813 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
3814 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
3815 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
3816 # error.
3817 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
3818 # if the flow is rolling forward or rolling back.
3819 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
3820 },
3821 },
3822 },
3823 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
3824 # Operation resources.
3825 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
3826 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
3827 # group of operations results from a `bulkInsert` API request.
3828 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
3829 # `update`, or `delete`, and so on.
3830 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
3831 # There is no requirement that this be linear or support any granularity of
3832 # operations. This should not be used to guess when the operation will be
3833 # complete. This number should monotonically increase as the operation
3834 # progresses.
3835 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
3836 # applicable when performing regional operations.
3837 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
3838 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
3839 # this field will contain information on all underlying zonal actions and
3840 # their state.
3841 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
3842 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
3843 # Example key: zones/us-central1-a
3844 &quot;a_key&quot;: {
3845 &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
3846 # populated.
3847 # different programming environments, including REST APIs and RPC APIs. It is
3848 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
3849 # three pieces of data: error code, error message, and error details.
3850 #
3851 # You can find out more about this error model and how to work with it in the
3852 # [API Design Guide](https://cloud.google.com/apis/design/errors).
3853 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
3854 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
3855 # message types for APIs to use.
3856 {
3857 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
3858 },
3859 ],
3860 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
3861 # user-facing error message should be localized and sent in the
3862 # google.rpc.Status.details field, or localized by the client.
3863 },
3864 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
3865 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
3866 },
3867 },
3868 },
3869 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
3870 # This value is inRFC3339
3871 # text format.
3872 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
3873 # following:
3874 # `PENDING`, `RUNNING`, or `DONE`.
3875 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
3876 # operation.
3877 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
3878 # of the target resource.
3879 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
3880 # operations related to creating a snapshot, this points to the disk
3881 # that the snapshot was created from.
3882 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
3883 # `[email protected]` or
3884 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
3885 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
3886 # operation, this field will be populated.
3887 {
3888 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
3889 # Engine returns NO_RESULTS_ON_PAGE if there
3890 # are no results in the response.
3891 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
3892 # value format. For example:
3893 #
3894 # &quot;data&quot;: [
3895 # {
3896 # &quot;key&quot;: &quot;scope&quot;,
3897 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
3898 # }
3899 {
3900 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
3901 # returned. For example, for warnings where there are no results in a list
3902 # request for a particular zone, this key might be scope and
3903 # the key value might be the zone name. Other examples might be a key
3904 # indicating a deprecated resource and a suggested replacement, or a
3905 # warning about invalid network settings (for example, if an instance
3906 # attempts to perform IP forwarding but is not enabled for IP forwarding).
3907 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
3908 },
3909 ],
3910 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
3911 },
3912 ],
3913 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
3914 # applicable when performing per-zone operations.
3915 }</pre>
3916 </div>
3917
3918 <div class="method">
3919 <code class="details" id="switchToCustomMode">switchToCustomMode(project, network, requestId=None, x__xgafv=None)</code>
3920 <pre>Switches the network mode from auto subnet mode to custom subnet mode.
3921
3922 Args:
3923 project: string, Project ID for this request. (required)
3924 network: string, Name of the network to be updated. (required)
3925 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
3926 that if you must retry your request, the server will know to ignore the
3927 request if it has already been completed.
3928
3929 For example, consider a situation where you make an initial request and
3930 the request times out. If you make the request again with the same
3931 request ID, the server can check if original operation with the same
3932 request ID was received, and if so, will ignore the second request. This
3933 prevents clients from accidentally creating duplicate commitments.
3934
3935 The request ID must be
3936 a valid UUID with the exception that zero UUID is not supported
3937 (00000000-0000-0000-0000-000000000000).
3938 x__xgafv: string, V1 error format.
3939 Allowed values
3940 1 - v1 error format
3941 2 - v2 error format
3942
3943 Returns:
3944 An object of the form:
3945
3946 { # Represents an Operation resource.
3947 #
3948 # Google Compute Engine has three Operation resources:
3949 #
3950 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
3951 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
3952 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
3953 #
3954 # You can use an operation resource to manage asynchronous API requests.
3955 # For more information, readHandling
3956 # API responses.
3957 #
3958 # Operations can be global, regional or zonal.
3959 #
3960 # - For global operations, use the `globalOperations`
3961 # resource.
3962 # - For regional operations, use the
3963 # `regionOperations` resource.
3964 # - For zonal operations, use
3965 # the `zoneOperations` resource.
3966 #
3967 #
3968 #
3969 # For more information, read
3970 # Global, Regional, and Zonal Resources.
3971 #
3972 # Note that completed Operation resources have a limited
3973 # retention period.
3974 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
3975 # Not present otherwise.
3976 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
3977 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
3978 # set when the operation is created.
3979 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
3980 # text format.
3981 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
3982 # this field will be populated.
3983 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
3984 # operation.
3985 {
3986 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
3987 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
3988 # details. There is a set of defined message types to use for providing
3989 # details.The syntax depends on the error code. For example,
3990 # QuotaExceededInfo will have details when the error code is
3991 # QUOTA_EXCEEDED.
3992 {
3993 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
3994 #
3995 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
3996 # is not enabled:
3997 #
3998 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
3999 # &quot;domain&quot;: &quot;googleapis.com&quot;
4000 # &quot;metadata&quot;: {
4001 # &quot;resource&quot;: &quot;projects/123&quot;,
4002 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4003 # }
4004 # }
4005 #
4006 # This response indicates that the pubsub.googleapis.com API is not enabled.
4007 #
4008 # Example of an error that is returned when attempting to create a Spanner
4009 # instance in a region that is out of stock:
4010 #
4011 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4012 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4013 # &quot;metadata&quot;: {
4014 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4015 # }
4016 # }
4017 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4018 # is typically the registered service name of the tool or product that
4019 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4020 # generated by some common infrastructure, the error domain must be a
4021 # globally unique value that identifies the infrastructure. For Google API
4022 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4023 &quot;metadatas&quot;: { # Additional structured details about this error.
4024 #
4025 # Keys must match a regular expression of `a-z+` but should
4026 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4027 # length. When identifying the current value of an exceeded limit, the units
4028 # should be contained in the key, not the value. For example, rather than
4029 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4030 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4031 # instances that can be created in a single (batch) request.
4032 &quot;a_key&quot;: &quot;A String&quot;,
4033 },
4034 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4035 # proximate cause of the error. Error reasons are unique within a particular
4036 # domain of errors. This should be at most 63 characters and match a
4037 # regular expression of `A-Z+[A-Z0-9]`, which represents
4038 # UPPER_SNAKE_CASE.
4039 },
4040 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4041 #
4042 # For example, if a quota check failed with an error indicating the calling
4043 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4044 # directly to the right place in the developer console to flip the bit.
4045 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4046 { # Describes a URL link.
4047 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4048 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4049 },
4050 ],
4051 },
4052 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4053 # which can be attached to an RPC error.
4054 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4055 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4056 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4057 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4058 },
4059 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4060 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4061 &quot;a_key&quot;: &quot;A String&quot;,
4062 },
4063 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4064 # type or metric.
4065 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4066 # or metric.
4067 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4068 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4069 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4070 },
4071 },
4072 ],
4073 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4074 # This property is optional.
4075 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4076 },
4077 ],
4078 },
4079 &quot;getVersionOperationMetadata&quot;: {
4080 &quot;inlineSbomInfo&quot;: {
4081 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4082 # appropriate identifiers.
4083 &quot;a_key&quot;: &quot;A String&quot;,
4084 },
4085 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4086 # identifiers.
4087 &quot;a_key&quot;: &quot;A String&quot;,
4088 },
4089 },
4090 },
4091 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4092 # message that was returned, such as `NOT FOUND`.
4093 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4094 # status code that was returned. For example, a `404` means the
4095 # resource was not found.
4096 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4097 # defined by the server.
4098 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4099 # This value is inRFC3339
4100 # text format.
4101 &quot;instancesBulkInsertOperationMetadata&quot;: {
4102 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4103 # Example key: zones/us-central1-a
4104 &quot;a_key&quot;: {
4105 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4106 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4107 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4108 # error.
4109 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4110 # if the flow is rolling forward or rolling back.
4111 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4112 },
4113 },
4114 },
4115 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4116 # Operation resources.
4117 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4118 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4119 # group of operations results from a `bulkInsert` API request.
4120 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4121 # `update`, or `delete`, and so on.
4122 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4123 # There is no requirement that this be linear or support any granularity of
4124 # operations. This should not be used to guess when the operation will be
4125 # complete. This number should monotonically increase as the operation
4126 # progresses.
4127 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4128 # applicable when performing regional operations.
4129 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4130 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4131 # this field will contain information on all underlying zonal actions and
4132 # their state.
4133 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4134 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4135 # Example key: zones/us-central1-a
4136 &quot;a_key&quot;: {
4137 &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
4138 # populated.
4139 # different programming environments, including REST APIs and RPC APIs. It is
4140 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4141 # three pieces of data: error code, error message, and error details.
4142 #
4143 # You can find out more about this error model and how to work with it in the
4144 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4145 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4146 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4147 # message types for APIs to use.
4148 {
4149 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4150 },
4151 ],
4152 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4153 # user-facing error message should be localized and sent in the
4154 # google.rpc.Status.details field, or localized by the client.
4155 },
4156 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4157 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4158 },
4159 },
4160 },
4161 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4162 # This value is inRFC3339
4163 # text format.
4164 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4165 # following:
4166 # `PENDING`, `RUNNING`, or `DONE`.
4167 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4168 # operation.
4169 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4170 # of the target resource.
4171 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4172 # operations related to creating a snapshot, this points to the disk
4173 # that the snapshot was created from.
4174 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4175 # `[email protected]` or
4176 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4177 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4178 # operation, this field will be populated.
4179 {
4180 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4181 # Engine returns NO_RESULTS_ON_PAGE if there
4182 # are no results in the response.
4183 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4184 # value format. For example:
4185 #
4186 # &quot;data&quot;: [
4187 # {
4188 # &quot;key&quot;: &quot;scope&quot;,
4189 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4190 # }
4191 {
4192 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4193 # returned. For example, for warnings where there are no results in a list
4194 # request for a particular zone, this key might be scope and
4195 # the key value might be the zone name. Other examples might be a key
4196 # indicating a deprecated resource and a suggested replacement, or a
4197 # warning about invalid network settings (for example, if an instance
4198 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4199 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4200 },
4201 ],
4202 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4203 },
4204 ],
4205 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4206 # applicable when performing per-zone operations.
4207 }</pre>
4208 </div>
4209
4210 <div class="method">
4211 <code class="details" id="updatePeering">updatePeering(project, network, body=None, requestId=None, x__xgafv=None)</code>
4212 <pre>Updates the specified network peering with the data included in the
4213 request. You can only modify the NetworkPeering.export_custom_routes field
4214 and the NetworkPeering.import_custom_routes field.
4215
4216 Args:
4217 project: string, Project ID for this request. (required)
4218 network: string, Name of the network resource which the updated peering is belonging to. (required)
4219 body: object, The request body.
4220 The object takes the form of:
4221
4222 {
4223 &quot;networkPeering&quot;: { # A network peering attached to a network resource. The message includes the
4224 # peering name, peer network, peering state, and a flag indicating whether
4225 # Google Compute Engine should automatically create routes for the peering.
4226 &quot;autoCreateRoutes&quot;: True or False, # This field will be deprecated soon. Use theexchange_subnet_routes field instead.
4227 # Indicates whether full mesh connectivity is created and managed
4228 # automatically between peered networks. Currently this field should always
4229 # be true since Google Compute Engine will automatically create and manage
4230 # subnetwork routes between two networks when peering state isACTIVE.
4231 &quot;connectionStatus&quot;: { # [Output Only] Describes the state of a peering connection, not just the # Output only. [Output Only] The effective state of the peering connection
4232 # as a whole.
4233 # local peering. This field provides information about the effective settings
4234 # for the connection as a whole, including pending delete/update requests for
4235 # CONSENSUS peerings.
4236 &quot;consensusState&quot;: { # The status of update/delete for a consensus peering connection. Only set # The consensus state contains information about the status of update
4237 # and delete for a consensus peering connection.
4238 # when connection_status.update_strategy isCONSENSUS or a network peering is proposing to update the
4239 # strategy to CONSENSUS.
4240 &quot;deleteStatus&quot;: &quot;A String&quot;, # The status of the delete request.
4241 &quot;updateStatus&quot;: &quot;A String&quot;, # The status of the update request.
4242 },
4243 &quot;trafficConfiguration&quot;: { # The active connectivity settings for the peering connection based on the
4244 # settings of the network peerings.
4245 &quot;exportCustomRoutesToPeer&quot;: True or False, # Whether custom routes are being exported to the peer network.
4246 &quot;exportSubnetRoutesWithPublicIpToPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being exported to the
4247 # peer network.
4248 &quot;importCustomRoutesFromPeer&quot;: True or False, # Whether custom routes are being imported from the peer network.
4249 &quot;importSubnetRoutesWithPublicIpFromPeer&quot;: True or False, # Whether subnet routes with public IP ranges are being imported
4250 # from the peer network.
4251 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are being imported or
4252 # exported between peer networks.
4253 },
4254 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the update/delete semantics for this
4255 # peering connection.
4256 },
4257 &quot;exchangeSubnetRoutes&quot;: True or False, # Indicates whether full mesh connectivity is created and managed
4258 # automatically between peered networks. Currently this field should always
4259 # be true since Google Compute Engine will automatically create and manage
4260 # subnetwork routes between two networks when peering state isACTIVE.
4261 &quot;exportCustomRoutes&quot;: True or False, # Whether to export the custom routes to peer network. The default value is
4262 # false.
4263 &quot;exportSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are exported. The default value
4264 # is true, all subnet routes are exported.IPv4
4265 # special-use ranges are always
4266 # exported to peers and are not controlled by this field.
4267 &quot;importCustomRoutes&quot;: True or False, # Whether to import the custom routes from peer network. The default value is
4268 # false.
4269 &quot;importSubnetRoutesWithPublicIp&quot;: True or False, # Whether subnet routes with public IP range are imported. The default value
4270 # is false.IPv4
4271 # special-use ranges are always
4272 # imported from peers and are not controlled by this field.
4273 &quot;name&quot;: &quot;A String&quot;, # Name of this peering. Provided by the client when the peering is created.
4274 # The name must comply withRFC1035.
4275 # Specifically, the name must be 1-63 characters long and match regular
4276 # expression `[a-z]([-a-z0-9]*[a-z0-9])?`. The first character must be a
4277 # lowercase letter, and all the following characters must be a dash,
4278 # lowercase letter, or digit, except the last character, which cannot be a
4279 # dash.
4280 &quot;network&quot;: &quot;A String&quot;, # The URL of the peer network. It can be either full URL or partial URL. The
4281 # peer network may belong to a different project. If the partial URL does not
4282 # contain project, it is assumed that the peer network is in the same project
4283 # as the current network.
4284 &quot;peerMtu&quot;: 42, # Output only. [Output Only] Maximum Transmission Unit in bytes of the peer network.
4285 &quot;stackType&quot;: &quot;A String&quot;, # Which IP version(s) of traffic and routes are allowed to be imported or
4286 # exported between peer networks. The default value is IPV4_ONLY.
4287 &quot;state&quot;: &quot;A String&quot;, # Output only. [Output Only] State for the peering.
4288 &quot;stateDetails&quot;: &quot;A String&quot;, # Output only. [Output Only] Details about the current state of the peering.
4289 &quot;updateStrategy&quot;: &quot;A String&quot;, # The update strategy determines the semantics for updates and deletes to the
4290 # peering connection configuration.
4291 },
4292 }
4293
4294 requestId: string, An optional request ID to identify requests. Specify a unique request ID so
4295 that if you must retry your request, the server will know to ignore the
4296 request if it has already been completed.
4297
4298 For example, consider a situation where you make an initial request and
4299 the request times out. If you make the request again with the same
4300 request ID, the server can check if original operation with the same
4301 request ID was received, and if so, will ignore the second request. This
4302 prevents clients from accidentally creating duplicate commitments.
4303
4304 The request ID must be
4305 a valid UUID with the exception that zero UUID is not supported
4306 (00000000-0000-0000-0000-000000000000).
4307 x__xgafv: string, V1 error format.
4308 Allowed values
4309 1 - v1 error format
4310 2 - v2 error format
4311
4312 Returns:
4313 An object of the form:
4314
4315 { # Represents an Operation resource.
4316 #
4317 # Google Compute Engine has three Operation resources:
4318 #
4319 # * [Global](/compute/docs/reference/rest/v1/globalOperations)
4320 # * [Regional](/compute/docs/reference/rest/v1/regionOperations)
4321 # * [Zonal](/compute/docs/reference/rest/v1/zoneOperations)
4322 #
4323 # You can use an operation resource to manage asynchronous API requests.
4324 # For more information, readHandling
4325 # API responses.
4326 #
4327 # Operations can be global, regional or zonal.
4328 #
4329 # - For global operations, use the `globalOperations`
4330 # resource.
4331 # - For regional operations, use the
4332 # `regionOperations` resource.
4333 # - For zonal operations, use
4334 # the `zoneOperations` resource.
4335 #
4336 #
4337 #
4338 # For more information, read
4339 # Global, Regional, and Zonal Resources.
4340 #
4341 # Note that completed Operation resources have a limited
4342 # retention period.
4343 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The value of `requestId` if you provided it in the request.
4344 # Not present otherwise.
4345 &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Deprecated] This field is deprecated.
4346 &quot;description&quot;: &quot;A String&quot;, # [Output Only] A textual description of the operation, which is
4347 # set when the operation is created.
4348 &quot;endTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was completed. This value is inRFC3339
4349 # text format.
4350 &quot;error&quot;: { # [Output Only] If errors are generated during processing of the operation,
4351 # this field will be populated.
4352 &quot;errors&quot;: [ # [Output Only] The array of errors encountered while processing this
4353 # operation.
4354 {
4355 &quot;code&quot;: &quot;A String&quot;, # [Output Only] The error type identifier for this error.
4356 &quot;errorDetails&quot;: [ # [Output Only] An optional list of messages that contain the error
4357 # details. There is a set of defined message types to use for providing
4358 # details.The syntax depends on the error code. For example,
4359 # QuotaExceededInfo will have details when the error code is
4360 # QUOTA_EXCEEDED.
4361 {
4362 &quot;errorInfo&quot;: { # Describes the cause of the error with structured details.
4363 #
4364 # Example of an error when contacting the &quot;pubsub.googleapis.com&quot; API when it
4365 # is not enabled:
4366 #
4367 # { &quot;reason&quot;: &quot;API_DISABLED&quot;
4368 # &quot;domain&quot;: &quot;googleapis.com&quot;
4369 # &quot;metadata&quot;: {
4370 # &quot;resource&quot;: &quot;projects/123&quot;,
4371 # &quot;service&quot;: &quot;pubsub.googleapis.com&quot;
4372 # }
4373 # }
4374 #
4375 # This response indicates that the pubsub.googleapis.com API is not enabled.
4376 #
4377 # Example of an error that is returned when attempting to create a Spanner
4378 # instance in a region that is out of stock:
4379 #
4380 # { &quot;reason&quot;: &quot;STOCKOUT&quot;
4381 # &quot;domain&quot;: &quot;spanner.googleapis.com&quot;,
4382 # &quot;metadata&quot;: {
4383 # &quot;availableRegions&quot;: &quot;us-central1,us-east2&quot;
4384 # }
4385 # }
4386 &quot;domain&quot;: &quot;A String&quot;, # The logical grouping to which the &quot;reason&quot; belongs. The error domain
4387 # is typically the registered service name of the tool or product that
4388 # generates the error. Example: &quot;pubsub.googleapis.com&quot;. If the error is
4389 # generated by some common infrastructure, the error domain must be a
4390 # globally unique value that identifies the infrastructure. For Google API
4391 # infrastructure, the error domain is &quot;googleapis.com&quot;.
4392 &quot;metadatas&quot;: { # Additional structured details about this error.
4393 #
4394 # Keys must match a regular expression of `a-z+` but should
4395 # ideally be lowerCamelCase. Also, they must be limited to 64 characters in
4396 # length. When identifying the current value of an exceeded limit, the units
4397 # should be contained in the key, not the value. For example, rather than
4398 # `{&quot;instanceLimit&quot;: &quot;100/request&quot;}`, should be returned as,
4399 # `{&quot;instanceLimitPerRequest&quot;: &quot;100&quot;}`, if the client exceeds the number of
4400 # instances that can be created in a single (batch) request.
4401 &quot;a_key&quot;: &quot;A String&quot;,
4402 },
4403 &quot;reason&quot;: &quot;A String&quot;, # The reason of the error. This is a constant value that identifies the
4404 # proximate cause of the error. Error reasons are unique within a particular
4405 # domain of errors. This should be at most 63 characters and match a
4406 # regular expression of `A-Z+[A-Z0-9]`, which represents
4407 # UPPER_SNAKE_CASE.
4408 },
4409 &quot;help&quot;: { # Provides links to documentation or for performing an out of band action.
4410 #
4411 # For example, if a quota check failed with an error indicating the calling
4412 # project hasn&#x27;t enabled the accessed service, this can contain a URL pointing
4413 # directly to the right place in the developer console to flip the bit.
4414 &quot;links&quot;: [ # URL(s) pointing to additional information on handling the current error.
4415 { # Describes a URL link.
4416 &quot;description&quot;: &quot;A String&quot;, # Describes what the link offers.
4417 &quot;url&quot;: &quot;A String&quot;, # The URL of the link.
4418 },
4419 ],
4420 },
4421 &quot;localizedMessage&quot;: { # Provides a localized error message that is safe to return to the user
4422 # which can be attached to an RPC error.
4423 &quot;locale&quot;: &quot;A String&quot;, # The locale used following the specification defined at
4424 # https://www.rfc-editor.org/rfc/bcp/bcp47.txt.
4425 # Examples are: &quot;en-US&quot;, &quot;fr-CH&quot;, &quot;es-MX&quot;
4426 &quot;message&quot;: &quot;A String&quot;, # The localized error message in the above locale.
4427 },
4428 &quot;quotaInfo&quot;: { # Additional details for quota exceeded error for resource quota.
4429 &quot;dimensions&quot;: { # The map holding related quota dimensions.
4430 &quot;a_key&quot;: &quot;A String&quot;,
4431 },
4432 &quot;futureLimit&quot;: 3.14, # Future quota limit being rolled out. The limit&#x27;s unit depends on the quota
4433 # type or metric.
4434 &quot;limit&quot;: 3.14, # Current effective quota limit. The limit&#x27;s unit depends on the quota type
4435 # or metric.
4436 &quot;limitName&quot;: &quot;A String&quot;, # The name of the quota limit.
4437 &quot;metricName&quot;: &quot;A String&quot;, # The Compute Engine quota metric name.
4438 &quot;rolloutStatus&quot;: &quot;A String&quot;, # Rollout status of the future quota limit.
4439 },
4440 },
4441 ],
4442 &quot;location&quot;: &quot;A String&quot;, # [Output Only] Indicates the field in the request that caused the error.
4443 # This property is optional.
4444 &quot;message&quot;: &quot;A String&quot;, # [Output Only] An optional, human-readable error message.
4445 },
4446 ],
4447 },
4448 &quot;getVersionOperationMetadata&quot;: {
4449 &quot;inlineSbomInfo&quot;: {
4450 &quot;currentComponentVersions&quot;: { # A mapping of components to their currently-applied versions or other
4451 # appropriate identifiers.
4452 &quot;a_key&quot;: &quot;A String&quot;,
4453 },
4454 &quot;targetComponentVersions&quot;: { # A mapping of components to their target versions or other appropriate
4455 # identifiers.
4456 &quot;a_key&quot;: &quot;A String&quot;,
4457 },
4458 },
4459 },
4460 &quot;httpErrorMessage&quot;: &quot;A String&quot;, # [Output Only] If the operation fails, this field contains the HTTP error
4461 # message that was returned, such as `NOT FOUND`.
4462 &quot;httpErrorStatusCode&quot;: 42, # [Output Only] If the operation fails, this field contains the HTTP error
4463 # status code that was returned. For example, a `404` means the
4464 # resource was not found.
4465 &quot;id&quot;: &quot;A String&quot;, # [Output Only] The unique identifier for the operation. This identifier is
4466 # defined by the server.
4467 &quot;insertTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was requested.
4468 # This value is inRFC3339
4469 # text format.
4470 &quot;instancesBulkInsertOperationMetadata&quot;: {
4471 &quot;perLocationStatus&quot;: { # Status information per location (location name is key).
4472 # Example key: zones/us-central1-a
4473 &quot;a_key&quot;: {
4474 &quot;createdVmCount&quot;: 42, # [Output Only] Count of VMs successfully created so far.
4475 &quot;deletedVmCount&quot;: 42, # [Output Only] Count of VMs that got deleted during rollback.
4476 &quot;failedToCreateVmCount&quot;: 42, # [Output Only] Count of VMs that started creating but encountered an
4477 # error.
4478 &quot;status&quot;: &quot;A String&quot;, # [Output Only] Creation status of BulkInsert operation - information
4479 # if the flow is rolling forward or rolling back.
4480 &quot;targetVmCount&quot;: 42, # [Output Only] Count of VMs originally planned to be created.
4481 },
4482 },
4483 },
4484 &quot;kind&quot;: &quot;compute#operation&quot;, # Output only. [Output Only] Type of the resource. Always `compute#operation` for
4485 # Operation resources.
4486 &quot;name&quot;: &quot;A String&quot;, # [Output Only] Name of the operation.
4487 &quot;operationGroupId&quot;: &quot;A String&quot;, # Output only. [Output Only] An ID that represents a group of operations, such as when a
4488 # group of operations results from a `bulkInsert` API request.
4489 &quot;operationType&quot;: &quot;A String&quot;, # [Output Only] The type of operation, such as `insert`,
4490 # `update`, or `delete`, and so on.
4491 &quot;progress&quot;: 42, # [Output Only] An optional progress indicator that ranges from 0 to 100.
4492 # There is no requirement that this be linear or support any granularity of
4493 # operations. This should not be used to guess when the operation will be
4494 # complete. This number should monotonically increase as the operation
4495 # progresses.
4496 &quot;region&quot;: &quot;A String&quot;, # [Output Only] The URL of the region where the operation resides. Only
4497 # applicable when performing regional operations.
4498 &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for the resource.
4499 &quot;setCommonInstanceMetadataOperationMetadata&quot;: { # Output only. [Output Only] If the operation is for projects.setCommonInstanceMetadata,
4500 # this field will contain information on all underlying zonal actions and
4501 # their state.
4502 &quot;clientOperationId&quot;: &quot;A String&quot;, # [Output Only] The client operation id.
4503 &quot;perLocationOperations&quot;: { # [Output Only] Status information per location (location name is key).
4504 # Example key: zones/us-central1-a
4505 &quot;a_key&quot;: {
4506 &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
4507 # populated.
4508 # different programming environments, including REST APIs and RPC APIs. It is
4509 # used by [gRPC](https://github.com/grpc). Each `Status` message contains
4510 # three pieces of data: error code, error message, and error details.
4511 #
4512 # You can find out more about this error model and how to work with it in the
4513 # [API Design Guide](https://cloud.google.com/apis/design/errors).
4514 &quot;code&quot;: 42, # The status code, which should be an enum value of google.rpc.Code.
4515 &quot;details&quot;: [ # A list of messages that carry the error details. There is a common set of
4516 # message types for APIs to use.
4517 {
4518 &quot;a_key&quot;: &quot;&quot;, # Properties of the object. Contains field @type with type URL.
4519 },
4520 ],
4521 &quot;message&quot;: &quot;A String&quot;, # A developer-facing error message, which should be in English. Any
4522 # user-facing error message should be localized and sent in the
4523 # google.rpc.Status.details field, or localized by the client.
4524 },
4525 &quot;state&quot;: &quot;A String&quot;, # [Output Only] Status of the action, which can be one of the following:
4526 # `PROPAGATING`, `PROPAGATED`, `ABANDONED`, `FAILED`, or `DONE`.
4527 },
4528 },
4529 },
4530 &quot;startTime&quot;: &quot;A String&quot;, # [Output Only] The time that this operation was started by the server.
4531 # This value is inRFC3339
4532 # text format.
4533 &quot;status&quot;: &quot;A String&quot;, # [Output Only] The status of the operation, which can be one of the
4534 # following:
4535 # `PENDING`, `RUNNING`, or `DONE`.
4536 &quot;statusMessage&quot;: &quot;A String&quot;, # [Output Only] An optional textual description of the current status of the
4537 # operation.
4538 &quot;targetId&quot;: &quot;A String&quot;, # [Output Only] The unique target ID, which identifies a specific incarnation
4539 # of the target resource.
4540 &quot;targetLink&quot;: &quot;A String&quot;, # [Output Only] The URL of the resource that the operation modifies. For
4541 # operations related to creating a snapshot, this points to the disk
4542 # that the snapshot was created from.
4543 &quot;user&quot;: &quot;A String&quot;, # [Output Only] User who requested the operation, for example:
4544 # `[email protected]` or
4545 # `alice_smith_identifier (global/workforcePools/example-com-us-employees)`.
4546 &quot;warnings&quot;: [ # [Output Only] If warning messages are generated during processing of the
4547 # operation, this field will be populated.
4548 {
4549 &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute
4550 # Engine returns NO_RESULTS_ON_PAGE if there
4551 # are no results in the response.
4552 &quot;data&quot;: [ # [Output Only] Metadata about this warning in key:
4553 # value format. For example:
4554 #
4555 # &quot;data&quot;: [
4556 # {
4557 # &quot;key&quot;: &quot;scope&quot;,
4558 # &quot;value&quot;: &quot;zones/us-east1-d&quot;
4559 # }
4560 {
4561 &quot;key&quot;: &quot;A String&quot;, # [Output Only] A key that provides more detail on the warning being
4562 # returned. For example, for warnings where there are no results in a list
4563 # request for a particular zone, this key might be scope and
4564 # the key value might be the zone name. Other examples might be a key
4565 # indicating a deprecated resource and a suggested replacement, or a
4566 # warning about invalid network settings (for example, if an instance
4567 # attempts to perform IP forwarding but is not enabled for IP forwarding).
4568 &quot;value&quot;: &quot;A String&quot;, # [Output Only] A warning data value corresponding to the key.
4569 },
4570 ],
4571 &quot;message&quot;: &quot;A String&quot;, # [Output Only] A human-readable description of the warning code.
4572 },
4573 ],
4574 &quot;zone&quot;: &quot;A String&quot;, # [Output Only] The URL of the zone where the operation resides. Only
4575 # applicable when performing per-zone operations.
4576 }</pre>
4577 </div>
4578
4579 </body></html>