Debian Codegraph @

docs/dyn/compute_beta.sslPolicies.html

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